Geographic Datasets (dataset)

geonames

class GeoName(geonameid, name, asciiname, alt_names, lat, lon, feature_class, feature_code, country_code, alt_country_code, admin1_code, admin2_code, admin3_code, admin4_code, population, elevation, dem, timezone, modification_date)

admin1_code

Alias for field number 10

admin2_code

Alias for field number 11

admin3_code

Alias for field number 12

admin4_code

Alias for field number 13

alt_country_code

Alias for field number 9

alt_names

Alias for field number 3

asciiname

Alias for field number 2

country_code

Alias for field number 8

dem

Alias for field number 16

elevation

Alias for field number 15

feature_class

Alias for field number 6

feature_code

Alias for field number 7

geonameid

Alias for field number 0

lat

Alias for field number 4

lon

Alias for field number 5

modification_date

Alias for field number 18

name

Alias for field number 1

population

Alias for field number 14

timezone

Alias for field number 17

class GeoName2(name, asciiname, lat, lon, population, feature_code)

asciiname

Alias for field number 1

feature_code

Alias for field number 5

lat

Alias for field number 2

lon

Alias for field number 3

name

Alias for field number 0

population

Alias for field number 4

class Country(ISO, name, capital, population, area, feature_code, lat, lon)

ISO

Alias for field number 0

area

Alias for field number 4

capital

Alias for field number 2

feature_code

Alias for field number 5

lat

Alias for field number 6

lon

Alias for field number 7

name

Alias for field number 1

population

Alias for field number 3

gshhg

Interface to the GSHHG (coastlines, rivers and borders) database.

The Global Self-consistent Hierarchical High-resolution Geography Database (GSHHG) is a collection of polygons representing land, lakes, rivers and political borders.

If the database is not already available, it will be downloaded automatically on first use.

For more information about GSHHG, see http://www.soest.hawaii.edu/pwessel/gshhg/.

Note

If you use this dataset, please cite:

Wessel, P., and W. H. F. Smith, A Global Self-consistent, Hierarchical, High-resolution Shoreline Database, J. Geophys. Res., 101, #B4, pp. 8741-8743, 1996.

class Polygon(gshhg_file, offset, *attr)

Representation of a GSHHG polygon.

property points

Points of the polygon.

Array of (lat, lon) pairs, shape (N, 2).

Return type:

numpy.ndarray

is_land()

Check if the polygon is land.

Return type:

bool

is_lake()

Check if the polygon is a lake.

Return type:

bool

is_island_in_lake()

Check if the polygon is an island in a lake.

Return type:

bool

is_pond_in_island_in_lake()

Check if the polygon is pond on an island in a lake.

Return type:

bool

is_antarctic_icefront()

Check if the polygon is antarctic icefront.

Return type:

bool

is_antarctic_grounding_line()

Check if the polygon is antarctic grounding line.

Return type:

bool

contains_point(point)

Check if point lies in polygon.

Parameters:

point (tuple) – (lat, lon) [deg]

Return type:

bool

See pyrocko.orthodrome.contains_points().

contains_points(points)

Check if points lie in polygon.

Parameters:

points (numpy.ndarray) – Array of (lat lon) pairs, shape (N, 2) [deg].

See pyrocko.orthodrome.contains_points().

Returns:

Bool array of shape (N,)

class GSHHG(gshhg_file)