coordinate_reference_systems

Attributes

`CANNOT_TRANSFORM_FIRST`
`CRS_MAPPING`
`CYLINDRICAL_COORDINATE_SYSTEMS`
`DEFAULT_CRS`

Functions

`dict_to_crs`(kwargs)	Convert a dictionary representation of a CRS into a cartopy CRS.
`is_cylindrical`(crs)	Determine whether a CRS is cylindrical.
`parse_crs`(crs)	Convert a string or dictionary representation of a CRS into a cartopy CRS.
`string_to_crs`(string)	Convert a string name of a CRS into a cartopy CRS.

Module Contents

coordinate_reference_systems.CANNOT_TRANSFORM_FIRST

coordinate_reference_systems.CRS_MAPPING

coordinate_reference_systems.CYLINDRICAL_COORDINATE_SYSTEMS

coordinate_reference_systems.DEFAULT_CRS

coordinate_reference_systems.dict_to_crs(kwargs)

Convert a dictionary representation of a CRS into a cartopy CRS.

Parameters:: crs (dict) – A dictionary representation of a CRS to be parsed and converted into a cartopy CRS. Must include a “name” key matching the name of a cartopy CRS, plus and keyword arguments to be passed to the CRS constructor.

Example

>>> earthkit.maps.domains.parse_crs(
...     {"name": "PlateCarree", "central_longitude": 50}
... )
<Derived Projected CRS: +proj=eqc +ellps=WGS84 +a=6378137.0 +lon_0=50 +to_ ...>
Name: unknown
Axis Info [cartesian]:
- E[east]: Easting (unknown)
- N[north]: Northing (unknown)
- h[up]: Ellipsoidal height (metre)
Area of Use:
- undefined
Coordinate Operation:
- name: unknown
- method: Equidistant Cylindrical
Datum: unknown
- Ellipsoid: WGS 84
- Prime Meridian: Greenwich

Return type:: cartopy.crs.CRS

coordinate_reference_systems.is_cylindrical(crs)

Determine whether a CRS is cylindrical.

Parameters:: crs (cartopy.crs.CRS) – The coordinate reference system for which to determine whether is is cyclindrical.
Return type:: bool

coordinate_reference_systems.parse_crs(crs)

Convert a string or dictionary representation of a CRS into a cartopy CRS.

Parameters:: crs (str, dict or cartopy.crs.CRS) – Some representation of a CRS to be parsed and converted into a cartopy CRS. If a string, must be the name of a cartopy CRS. If a dictionary, must include a “name” key matching the name of a cartopy CRS, plus and keyword arguments to be passed to the CRS constructor.

Example

>>> earthkit.maps.domains.parse_crs("PlateCarree")
<Derived Projected CRS: +proj=eqc +ellps=WGS84 +a=6378137.0 +lon_0=0.0 +to ...>
Name: unknown
Axis Info [cartesian]:
- E[east]: Easting (unknown)
- N[north]: Northing (unknown)
- h[up]: Ellipsoidal height (metre)
Area of Use:
- undefined
Coordinate Operation:
- name: unknown
- method: Equidistant Cylindrical
Datum: unknown
- Ellipsoid: WGS 84
- Prime Meridian: Greenwich
>>> earthkit.maps.domains.parse_crs(
...     {"name": "PlateCarree", "central_longitude": 50}
... )
<Derived Projected CRS: +proj=eqc +ellps=WGS84 +a=6378137.0 +lon_0=50 +to_ ...>
Name: unknown
Axis Info [cartesian]:
- E[east]: Easting (unknown)
- N[north]: Northing (unknown)
- h[up]: Ellipsoidal height (metre)
Area of Use:
- undefined
Coordinate Operation:
- name: unknown
- method: Equidistant Cylindrical
Datum: unknown
- Ellipsoid: WGS 84
- Prime Meridian: Greenwich

Return type:: cartopy.crs.CRS

coordinate_reference_systems.string_to_crs(string)

Convert a string name of a CRS into a cartopy CRS.

Parameters:: crs (dict) – A string matching the name of a cartopy CRS.

Example

>>> earthkit.maps.domains.parse_crs("PlateCarree")
<Derived Projected CRS: +proj=eqc +ellps=WGS84 +a=6378137.0 +lon_0=0.0 +to ...>
Name: unknown
Axis Info [cartesian]:
- E[east]: Easting (unknown)
- N[north]: Northing (unknown)
- h[up]: Ellipsoidal height (metre)
Area of Use:
- undefined
Coordinate Operation:
- name: unknown
- method: Equidistant Cylindrical
Datum: unknown
- Ellipsoid: WGS 84
- Prime Meridian: Greenwich

Return type:: cartopy.crs.CRS