gws.gis.crs

package documentation

(source)

Undocumented

From __init__.py:

Class	`Crs`	Undocumented
Exception	`Error`	Undocumented
Function	`best_axis`	Return the 'best guess' axis under given circumstances.
Function	`best_bounds`	Return the best one from the list of supported bounds.
Function	`best_match`	Return a crs from the list that most closely matches the given crs.
Function	`get`	Undocumented
Function	`parse`	Undocumented
Function	`require`	Undocumented
Constant	`WEBMERCATOR`	Undocumented
Constant	`WEBMERCATOR_BOUNDS`	Undocumented
Constant	`WEBMERCATOR_RADIUS`	Undocumented
Constant	`WEBMERCATOR_SQUARE`	Undocumented
Constant	`WGS84`	Undocumented
Constant	`WGS84_BOUNDS`	Undocumented
Function	`_axis_and_unit`	Undocumented
Function	`_best_match`	Undocumented
Function	`_get_crs`	Undocumented
Function	`_make_crs`	Undocumented
Function	`_parse`	Undocumented
Function	`_pyproj_crs_object`	Undocumented
Function	`_pyproj_transformer`	Undocumented
Function	`_transform_extent`	Undocumented
Function	`_unparse`	Undocumented
Constant	`_AXES_AND_UNITS`	Undocumented
Variable	`_aliases`	Undocumented
Variable	`_formats`	Undocumented
Variable	`_obj_cache`	Undocumented
Variable	`_parse_formats`	Undocumented
Variable	`_pyproj_cache`	Undocumented
Variable	`_transformer_cache`	Undocumented

WGS84 = (source) ¶

Undocumented

Value

Crs(srid=4326,
    proj4text='+proj=longlat +datum=WGS84 +no_defs +type=crs',
    wkt='GEOGCRS["WGS 84",ENSEMBLE["World Geodetic System 1984 ensemble",MEMBER[↵
"World Geodetic System 1984 (Transit)"],MEMBER["World Geodetic System 1984 (G730↵
)"],MEMBER["World Geodetic System 1984 (G873)"],MEMBER["World Geodetic System 19↵
84 (G1150)"],MEMBER["World Geodetic System 1984 (G1674)"],MEMBER["World Geodetic↵
 System 1984 (G1762)"],MEMBER["World Geodetic System 1984 (G2139)"],ELLIPSOID["W↵
...

WGS84_BOUNDS = (source) ¶

Undocumented

Value

gws.Bounds(crs=WGS84, extent=WGS84.extent)

WEBMERCATOR = (source) ¶

Undocumented

Value

Crs(srid=3857,
    proj4text='+proj=merc +a=6378137 +b=6378137 +lat_ts=0 +lon_0=0 +x_0=0 +y_0=0↵
 +k=1 +units=m +nadgrids=@null +wktext +no_defs +type=crs',
    wkt='PROJCRS["WGS 84 / Pseudo-Mercator",BASEGEOGCRS["WGS 84",ENSEMBLE["World↵
 Geodetic System 1984 ensemble",MEMBER["World Geodetic System 1984 (Transit)"],M↵
EMBER["World Geodetic System 1984 (G730)"],MEMBER["World Geodetic System 1984 (G↵
873)"],MEMBER["World Geodetic System 1984 (G1150)"],MEMBER["World Geodetic Syste↵
...

WEBMERCATOR_BOUNDS = (source) ¶

Undocumented

Value

gws.Bounds(crs=WEBMERCATOR, extent=WEBMERCATOR.extent)

WEBMERCATOR_RADIUS: int = (source) ¶

Undocumented

Value

WEBMERCATOR_SQUARE = (source) ¶

Undocumented

Value

((-math.pi*WEBMERCATOR_RADIUS), (-math.pi*WEBMERCATOR_RADIUS), (+math.pi*WEBMERCATOR_RADIUS), (+math.pi*WEBMERCATOR_RADIUS))

def get(crs_name: gws.CrsName) -> t.Optional[gws.ICrs]: (source) ¶

Undocumented

def parse(crs_name: gws.CrsName) -> tuple[gws.CrsFormat, t.Optional[gws.ICrs]]: (source) ¶

Undocumented

def require(crs_name: gws.CrsName) -> gws.ICrs: (source) ¶

Undocumented

def best_match(crs: gws.ICrs, supported_crs: list[gws.ICrs]) -> gws.ICrs: (source) ¶

Return a crs from the list that most closely matches the given crs.

Parameters
crs:`gws.ICrs`	target CRS
supported_crs:`list[gws.ICrs]`	CRS list
Returns
`gws.ICrs`	A CRS object

def _best_match(crs, supported_crs): (source) ¶

Undocumented

def best_bounds(crs: gws.ICrs, supported_bounds: list[gws.Bounds]) -> gws.Bounds: (source) ¶

Return the best one from the list of supported bounds.

Parameters
crs:`gws.ICrs`	target CRS
supported_bounds:`list[gws.Bounds]`
Returns
`gws.Bounds`	A Bounds object

def best_axis(crs: gws.ICrs, protocol: gws.OwsProtocol = None, protocol_version: str = None, crs_format: gws.CrsFormat = None, inverted_crs: t.Optional[list[gws.ICrs]] = None) -> gws.Axis: (source) ¶

Return the 'best guess' axis under given circumstances.

Parameters
crs:`gws.ICrs`	target CRS
protocol:`gws.OwsProtocol`	OWS protocol (WMS, WFS...)
protocol_version:`str`	protocol version
crs_format:`gws.CrsFormat`	the format the target_crs was obtained from
inverted_crs:`t.Optional[list[gws.ICrs]]`	user-provided list of CRSes known to have an inverted (YX) axis
Returns
`gws.Axis`	An axis

def _get_crs(crs_name): (source) ¶

Undocumented

def _pyproj_crs_object(srid) -> t.Optional[pyproj.crs.CRS]: (source) ¶

Undocumented

def _pyproj_transformer(srid_from, srid_to) -> pyproj.transformer.Transformer: (source) ¶

Undocumented

def _transform_extent(ext, srid_from, srid_to): (source) ¶

Undocumented

def _make_crs(srid, pp, au): (source) ¶

Undocumented

_AXES_AND_UNITS = (source) ¶

Undocumented

Value

{'Easting/metre,Northing/metre': (gws.Axis.xy, gws.Uom.m),
 'Northing/metre,Easting/metre': (gws.Axis.yx, gws.Uom.m),
 'Geodetic latitude/degree,Geodetic longitude/degree': (gws.Axis.yx,
                                                        gws.Uom.deg),
 'Geodetic longitude/degree,Geodetic latitude/degree': (gws.Axis.xy,
                                                        gws.Uom.deg),
 'Easting/US survey foot,Northing/US survey foot': (gws.Axis.xy, gws.Uom.us_ft),
...

def _axis_and_unit(pp): (source) ¶

Undocumented

_formats = (source) ¶

Undocumented

_parse_formats = (source) ¶

Undocumented

_aliases: dict = (source) ¶

Undocumented

def _parse(crs_name): (source) ¶

Undocumented

def _unparse(srid, fmt): (source) ¶

Undocumented

_obj_cache: dict = (source) ¶

Undocumented

_pyproj_cache: dict = (source) ¶

Undocumented

_transformer_cache: dict = (source) ¶

Undocumented