ProjectedSpatialReferenceSystem Class

Summary: Projected SRS is a result of application a projection to geographic SRS.
A projected SRS can be two dimensional or three dimensional.
If projected SRS is three dimensional, then it is actually a compound SRS of two dimensional projected SRS and one dimensional vertical SRS.

Module: aspose.gis.spatialreferencing

Full Name: aspose.gis.spatialreferencing.ProjectedSpatialReferenceSystem

Inheritance: SpatialReferenceSystem

Aspose.PSD Version: 25.9.0

Properties

NameTypeAccessDescription
angular_unitUnitrUnit, that is used for angular values in this SRS and for angular parameters of ProjectedSpatialReferenceSystem.projection.
Matches angular unit of ProjectedSpatialReferenceSystem.base.
as_compoundCompoundSpatialReferenceSystemrReturns this SRS converted to CompoundSpatialReferenceSystem.
Use SpatialReferenceSystem.is_compound to find out if conversion is possible.
as_geocentricGeocentricSpatialReferenceSystemrReturns this SRS converted to GeocentricSpatialReferenceSystem.
Use SpatialReferenceSystem.type to find out if conversion is possible.
as_geographicGeographicSpatialReferenceSystemrReturns this SRS converted to GeographicSpatialReferenceSystem.
Use SpatialReferenceSystem.type to find out if conversion is possible.
as_localLocalSpatialReferenceSystemrReturns this SRS converted to LocalSpatialReferenceSystem.
Use SpatialReferenceSystem.type to find out if conversion is possible.
as_projectedProjectedSpatialReferenceSystemrReturn this.
as_verticalVerticalSpatialReferenceSystemrReturns this SRS converted to VerticalSpatialReferenceSystem.
Use SpatialReferenceSystem.type to find out if conversion is possible.
axises_orderProjectedAxisesOrderrOrder of axises in this SRS.
If this SRS is not valid and has wrong axises directions, ProjectedAxisesOrder.INVALID is returned.
baseGeographicSpatialReferenceSystemrGeographic SRS to which ProjectedSpatialReferenceSystem.projection was applied to get this SRS.
dimensions_countintrReturns dimensions count in this SRS. For projected SRS this can be:
two - if this is single projected SRS.
three - if this is compound SRS, which consists of single, two dimensional, projected SRS and vertical SRS, that adds third dimension.
epsg_codeintrIf this objects identifier is EPSG identifier - return its code. Otherwise - return -1.
etrs89 [static]GeographicSpatialReferenceSystemrETRS 89 (EPSG:4258) spatial reference system.
etrs_89_lambert_azimuthal_equal_area [static]ProjectedSpatialReferenceSystemrETRS 89 / ETRS Lambert Azimuthal Equal Area (EPSG:3035) spatial reference system.
etrs_89_lambert_conformal_conic [static]ProjectedSpatialReferenceSystemrETRS 89 / Lambert Conformal Conic (EPSG:3034) spatial reference system.
geographic_datumGeographicDatumrReturns geographic datum of this SRS.
has_geographic_datumboolrReturns true, since projected SRS always have prime meridian.
has_prime_meridianboolrReturns true, since projected SRS always have prime meridian.
identifierIdentifierrIdentifier of this identifiable object.
is_compoundboolrReturns whether this SRS is compound (a union of two SRS).
Following combinations of SRS in compound SRS are considered valid:
Geographic SRS + Vertical SRS, in this case type of compound SRS will be SpatialReferenceSystemType.GEOGRAPHIC.
Projected SRS + Vertical SRS, in this case type of compound SRS will be SpatialReferenceSystemType.PROJECTED.
If combination of SRSs differs, type of compound SRS will be SpatialReferenceSystemType.UNKNOWN.
is_singleboolrReturns whether this SRS is single (not a union of two SRS).
is_validboolrSame as , but don’t return error message.
linear_unitUnitrUnit, that is used for linear dimensions in this SRS and for linear parameters of ProjectedSpatialReferenceSystem.projection.
nad83 [static]GeographicSpatialReferenceSystemrNAD 83 (EPSG:4269) spatial reference system.
namestringrName of this object.
osgb36 [static]GeographicSpatialReferenceSystemrOSGB 36 (EPSG:4277) spatial reference system.
osgb_36_british_national_grid [static]ProjectedSpatialReferenceSystemrOSGB 36 / British National Grid (EPSG:27700) spatial reference system.
prime_meridianPrimeMeridianrReturns prime meridian of this SRS.
projectionProjectionrProjection, that was applied to ProjectedSpatialReferenceSystem.base to get this SRS.
typeSpatialReferenceSystemTyperReturns SpatialReferenceSystemType.PROJECTED.
web_mercator [static]ProjectedSpatialReferenceSystemrWeb Mercator (EPSG:3857) spatial reference system.
wgs72 [static]GeographicSpatialReferenceSystemrWGS 72 (EPSG:4322) spatial reference system.
wgs84 [static]GeographicSpatialReferenceSystemrWGS 84 (EPSG:4326) spatial reference system.

Methods

NameDescription
create_compound(name, head, tail, identifier)Create compound SRS.
create_from_epsg(epsg)Create a spatial reference system based the specified EPSG code.
create_from_wkt(wkt)Creates a new SpatialReferenceSystem based on WKT (Well-Known Text) string.
create_geocentric(parameters, identifier)Create geocentric SRS from custom parameters.
create_geographic(parameters, identifier)Create geographic SRS from custom parameters.
create_local(name, datum, unit, axises, identifier)Create local Spatial Reference System.
create_projected(parameters, identifier)Create projected SRS from custom parameters.
create_transformation_to(target_srs)Creates transformation from this SpatialReferenceSystem to another SpatialReferenceSystem.
create_vertical(name, vertical_datum, vertical_unit, vertical_axis, identifier)Create vertical SRS.
export_to_wkt()Returns representation of this SRS as WKT string.
The result WKT string will match OGC 01-009 specification, usually named “WKT1”.
get_axis(dimension)Get Axis that describes dimension.
get_unit(dimension)Get Unit of dimension.
is_equivalent(other)Detects whether this SRS is equivalent to other SRS. SpatialReferenceSystem.is_equivalent(srs1, srs2).
is_equivalent(srs1, srs2)Determines if two SRS are equivalent.
Same coordinates of equivalent SRS match same place on Earth.
Some parameters of equivalent SRS can be different, for example IdentifiableObject.name.
try_create_from_epsg(epsg, value)Create a spatial reference system based the specified EPSG code.
try_create_from_wkt(wkt, value)Creates a new SpatialReferenceSystem based on WKT (Well-Known Text) string.
try_create_transformation_to(target_srs, value)Creates transformation from this SpatialReferenceSystem to another SpatialReferenceSystem.
validate(error_message)Determine if this SRS is valid.

Method: create_compound(name, head, tail, identifier) [static]

 create_compound(name, head, tail, identifier) 

Create compound SRS.

Parameters:

ParameterTypeDescription
namestringName of new SRS.
headSpatialReferenceSystemHead SRS of new SRS.
tailSpatialReferenceSystemTail SRS of new SRS.
identifierIdentifierIdentifier, that will be attached to SRS. Attaching an Identifier will not modify other SRS parameters.
Its up to you to ensure consistency of identifier and SRS parameters.

Returns

TypeDescription
CompoundSpatialReferenceSystemNew Compound SRS.

Method: create_from_epsg(epsg) [static]

 create_from_epsg(epsg) 

Create a spatial reference system based the specified EPSG code.

Parameters:

ParameterTypeDescription
epsgintEPSG code of the spatial reference system.

Returns

TypeDescription
SpatialReferenceSystemA new spatial reference system with the specified EPSG code.

Method: create_from_wkt(wkt) [static]

 create_from_wkt(wkt) 

Creates a new SpatialReferenceSystem based on WKT (Well-Known Text) string.

Parameters:

ParameterTypeDescription
wktstringWKT string.

Returns

TypeDescription
SpatialReferenceSystemNew SpatialReferenceSystem.

Method: create_geocentric(parameters, identifier) [static]

 create_geocentric(parameters, identifier) 

Create geocentric SRS from custom parameters.

Parameters:

ParameterTypeDescription
parametersGeocentricSpatialReferenceSystemParametersParameters to create from.
identifierIdentifierIdentifier, that will be attached to SRS. Attaching an Identifier will not modify other SRS parameters.
Its up to you to ensure consistency of identifier and SRS parameters.

Returns

TypeDescription
GeocentricSpatialReferenceSystemNew Geocentric SRS.

Method: create_geographic(parameters, identifier) [static]

 create_geographic(parameters, identifier) 

Create geographic SRS from custom parameters.

Parameters:

ParameterTypeDescription
parametersGeographicSpatialReferenceSystemParametersParameters to create from.
identifierIdentifierIdentifier, that will be attached to SRS. Attaching an Identifier will not modify other SRS parameters.
Its up to you to ensure consistency of identifier and SRS parameters.

Returns

TypeDescription
GeographicSpatialReferenceSystemNew Geographic SRS.

Method: create_local(name, datum, unit, axises, identifier) [static]

 create_local(name, datum, unit, axises, identifier) 

Create local Spatial Reference System.

Parameters:

ParameterTypeDescription
namestringName of Spatial Reference System.
datumLocalDatumDatum to be used in SRS.
unitUnitUnit to be used in SRS.
axisesSystem.Collections.Generic.ICollectionAxises to be used in SRS. Must be non empty
identifierIdentifierIdentifier, that will be attached to SRS. Attaching an Identifier will not modify other SRS parameters.
Its up to you to ensure consistency of identifier and SRS parameters.

Returns

TypeDescription
LocalSpatialReferenceSystemNew Local Spatial Reference System.

Method: create_projected(parameters, identifier) [static]

 create_projected(parameters, identifier) 

Create projected SRS from custom parameters.

Parameters:

ParameterTypeDescription
parametersProjectedSpatialReferenceSystemParametersParameters to create from.
identifierIdentifierIdentifier, that will be attached to SRS. Attaching an Identifier will not modify other SRS parameters.
Its up to you to ensure consistency of identifier and SRS parameters.

Returns

TypeDescription
ProjectedSpatialReferenceSystemNew Projected SRS.

Method: create_transformation_to(target_srs)

 create_transformation_to(target_srs) 

Creates transformation from this SpatialReferenceSystem to another SpatialReferenceSystem.

Parameters:

ParameterTypeDescription
target_srsSpatialReferenceSystemAnother SpatialReferenceSystem.

Returns

TypeDescription
SpatialReferenceSystemTransformationTransformation from this SpatialReferenceSystem to another SpatialReferenceSystem.

Method: create_vertical(name, vertical_datum, vertical_unit, vertical_axis, identifier) [static]

 create_vertical(name, vertical_datum, vertical_unit, vertical_axis, identifier) 

Create vertical SRS.

Parameters:

ParameterTypeDescription
namestringName of SRS. If .
vertical_datumVerticalDatumDatum to be used in SRS.
vertical_unitUnitUnit to be used in SRS. If , Unit.meter will be used.
vertical_axisAxisAxis with “up” or “down” direction, to be used in SRS. If , axis with up direction will be used.
identifierIdentifierIdentifier, that will be attached to SRS. Attaching an Identifier will not modify other SRS parameters.
Its up to you to ensure consistency of identifier and SRS parameters.

Returns

TypeDescription
VerticalSpatialReferenceSystemNew Vertical SRS.

Method: export_to_wkt()

 export_to_wkt() 

Returns representation of this SRS as WKT string.
The result WKT string will match OGC 01-009 specification, usually named “WKT1”.

Returns

TypeDescription
stringWKT representation of this SRS.

Method: get_axis(dimension)

 get_axis(dimension) 

Get Axis that describes dimension.

Parameters:

ParameterTypeDescription
dimensionintNumber of dimension.

Returns

TypeDescription
AxisAxis that describes dimension.

Method: get_unit(dimension)

 get_unit(dimension) 

Get Unit of dimension.

Parameters:

ParameterTypeDescription
dimensionintNumber of dimension.

Returns

TypeDescription
UnitUnit of dimension.

Method: is_equivalent(other)

 is_equivalent(other) 

Detects whether this SRS is equivalent to other SRS. SpatialReferenceSystem.is_equivalent(srs1, srs2).

Parameters:

ParameterTypeDescription
otherSpatialReferenceSystemOther SRS.

Returns

TypeDescription
boolbool value, indicating whether this SRS is equivalent to other SRS.

Method: is_equivalent(srs1, srs2) [static]

 is_equivalent(srs1, srs2) 

Determines if two SRS are equivalent.
Same coordinates of equivalent SRS match same place on Earth.
Some parameters of equivalent SRS can be different, for example IdentifiableObject.name.

Parameters:

ParameterTypeDescription
srs1SpatialReferenceSystemFirst SRS.
srs2SpatialReferenceSystemSecond SRS.

Returns

TypeDescription
boolbool value, indicating whether two SRS are equivalent.

Method: try_create_from_epsg(epsg, value) [static]

 try_create_from_epsg(epsg, value) 

Create a spatial reference system based the specified EPSG code.

Parameters:

ParameterTypeDescription
epsgintEPSG code of the spatial reference system.
valueSpatialReferenceSystem[]When this methods returns , contains a SRS with the specified EPSG code; otherwise,
contains .

Returns

TypeDescription
boolif specified EPSG code is known and SRS was created; otherwise.

Method: try_create_from_wkt(wkt, value) [static]

 try_create_from_wkt(wkt, value) 

Creates a new SpatialReferenceSystem based on WKT (Well-Known Text) string.

Parameters:

ParameterTypeDescription
wktstringWKT string.
valueSpatialReferenceSystem[]When this methods returns , contains an SRS created from WKT; otherwise,
contains .

Returns

TypeDescription
boolif SRS was successfully created; otherwise.

Method: try_create_transformation_to(target_srs, value)

 try_create_transformation_to(target_srs, value) 

Creates transformation from this SpatialReferenceSystem to another SpatialReferenceSystem.

Parameters:

ParameterTypeDescription
target_srsSpatialReferenceSystemAnother SpatialReferenceSystem.
valueSpatialReferenceSystemTransformation[]When this methods returns , contains a transformation; otherwise, contains .

Returns

TypeDescription
boolTransformation from this SpatialReferenceSystem to another SpatialReferenceSystem.

Method: validate(error_message)

 validate(error_message) 

Determine if this SRS is valid.

Parameters:

ParameterTypeDescription
error_messageStringIf method return , then this is description of invalidity.

Returns

TypeDescription
boolif SRS is valid, otherwise.