Coordinate Systems#

CoordinateSystem#

class pyproj.crs.CoordinateSystem#

New in version 2.2.0.

Coordinate System for CRS

name#

The name of the coordinate system.

Type:

str

axis_list#

returns: The Axis list for the coordinate system. :rtype: list[Axis]

static from_json(unicode coordinate_system_json_str)#

New in version 2.5.0.

Create Coordinate System from a JSON string.

Parameters:

coordinate_system_json_str (str) – Coordinate System JSON string.

Return type:

CoordinateSystem

static from_json_dict(dict coordinate_system_dict)#

New in version 2.5.0.

Create Coordinate System from a JSON dictionary.

Parameters:

coordinate_system_dict (str) – Coordinate System dictionary.

Return type:

CoordinateSystem

static from_string(unicode coordinate_system_string)#

New in version 2.5.0.

Note

Only works with PROJ JSON.

Create a Coordinate System from a string.

Parameters:

coordinate_system_string (str) – Coordinate System string.

Return type:

CoordinateSystem

classmethod from_user_input(cls, user_input)#

New in version 2.5.0.

Create cls from user input:

  • PROJ JSON string

  • PROJ JSON dict

  • WKT string

  • An authority string

  • An EPSG integer code

  • An iterable of (“auth_name”, “auth_code”)

  • An object with a to_json method.

Parameters:

user_input (str, dict, int, Iterable[str, str]) – Input to create cls.

Return type:

cls

is_exact_same(self, other)#

Compares projection objects to see if they are exactly the same.

remarks#

New in version 2.4.0.

Returns:

Remarks about object.

Return type:

str

scope#

New in version 2.4.0.

Returns:

Scope of object.

Return type:

str

to_cf(self, bool rotated_pole=False)#

New in version 3.0.0.

This converts a pyproj.crs.CoordinateSystem axis to a list of Climate and Forecast (CF) Version 1.8 dicts.

Parameters:

rotated_pole (bool, default=False) – If True, the geographic coordinates are on a rotated pole grid. This corresponds to the rotated_latitude_longitude grid_mapping_name.

Returns:

CF-1.8 version of the CoordinateSystem.

Return type:

list[dict]

to_json(self, bool pretty=False, int indentation=2)#

New in version 2.4.0.

Convert the object to a JSON string.

Parameters:

  • pretty (bool, default=False) – If True, it will set the output to be a multiline string.

  • indentation (int, default=2) – If pretty is True, it will set the width of the indentation.

Return type:

str

to_json_dict(self)#

New in version 2.4.0.

Convert the object to a JSON dictionary.

Return type:

dict

to_wkt(self, version=WktVersion.WKT2_2019, pretty=False, output_axis_rule=None)#

Convert the projection to a WKT string.

Version options:

  • WKT2_2015

  • WKT2_2015_SIMPLIFIED

  • WKT2_2019

  • WKT2_2019_SIMPLIFIED

  • WKT1_GDAL

  • WKT1_ESRI

New in version 3.6.0: output_axis_rule

Parameters:

  • version (pyproj.enums.WktVersion, default=pyproj.enums.WktVersion.WKT2_2019) – The version of the WKT output.

  • pretty (bool, default=False) – If True, it will set the output to be a multiline string.

  • output_axis_rule (bool, optional, default=None) – If True, it will set the axis rule on any case. If false, never. None for AUTO, that depends on the CRS and version.

Return type:

str

Axis#

class pyproj._crs.Axis#

New in version 2.0.0.

Coordinate System Axis

name#
Type:

str

abbrev#
Type:

str

direction#
Type:

str

unit_conversion_factor#
Type:

float

unit_name#
Type:

str

unit_auth_code#
Type:

str

unit_code#
Type:

str

Ellipsoidal2DCS#

class pyproj.crs.coordinate_system.Ellipsoidal2DCS(axis: Ellipsoidal2DCSAxis | str = Ellipsoidal2DCSAxis.LONGITUDE_LATITUDE)[source]#

Bases: CoordinateSystem

New in version 2.5.0.

This generates an Ellipsoidal 2D Coordinate System

static __new__(cls, axis: Ellipsoidal2DCSAxis | str = Ellipsoidal2DCSAxis.LONGITUDE_LATITUDE)[source]#
Parameters:

axis (pyproj.crs.enums.Ellipsoidal2DCSAxis or str, optional) – This is the axis order of the coordinate system. Default is pyproj.crs.enums.Ellipsoidal2DCSAxis.LONGITUDE_LATITUDE.

Ellipsoidal3DCS#

class pyproj.crs.coordinate_system.Ellipsoidal3DCS(axis: Ellipsoidal3DCSAxis | str = Ellipsoidal3DCSAxis.LONGITUDE_LATITUDE_HEIGHT)[source]#

Bases: CoordinateSystem

New in version 2.5.0.

This generates an Ellipsoidal 3D Coordinate System

static __new__(cls, axis: Ellipsoidal3DCSAxis | str = Ellipsoidal3DCSAxis.LONGITUDE_LATITUDE_HEIGHT)[source]#
Parameters:

axis (pyproj.crs.enums.Ellipsoidal3DCSAxis or str, optional) – This is the axis order of the coordinate system. Default is pyproj.crs.enums.Ellipsoidal3DCSAxis.LONGITUDE_LATITUDE_HEIGHT.

Cartesian2DCS#

class pyproj.crs.coordinate_system.Cartesian2DCS(axis: Cartesian2DCSAxis | str = Cartesian2DCSAxis.EASTING_NORTHING)[source]#

Bases: CoordinateSystem

New in version 2.5.0.

This generates an Cartesian 2D Coordinate System

static __new__(cls, axis: Cartesian2DCSAxis | str = Cartesian2DCSAxis.EASTING_NORTHING)[source]#
Parameters:

axis (pyproj.crs.enums.Cartesian2DCSAxis or str, optional) – This is the axis order of the coordinate system. Default is pyproj.crs.enums.Cartesian2DCSAxis.EASTING_NORTHING.

VerticalCS#

class pyproj.crs.coordinate_system.VerticalCS(axis: VerticalCSAxis | str = VerticalCSAxis.GRAVITY_HEIGHT)[source]#

Bases: CoordinateSystem

New in version 2.5.0.

This generates an Vertical Coordinate System

static __new__(cls, axis: VerticalCSAxis | str = VerticalCSAxis.GRAVITY_HEIGHT)[source]#
Parameters:

axis (pyproj.crs.enums.VerticalCSAxis or str, optional) – This is the axis direction of the coordinate system. Default is pyproj.crs.enums.VerticalCSAxis.GRAVITY_HEIGHT.