MzCartography Class |
Note: This API is now obsolete.
There are 3 levels of coordinates: Geographical coordinates (longitude, latitude) in degrees, projection coordinates (easting, northing), and model/user grid coordinates (x,y).
The ProjectionString defines the mapping from geographical coordinates to projection coordinates. See MzMapProjection for details on the projection string.
The LonOrigin, LatOrigin and Orientation defines the origin and the orientation of the model grid coordinates. It defines how the model grid coordinate system is translated and rotated, and is used to define a local coordinate system for e.g. a 2D grid axis from a dfs2 file.
See Orientation for the definition of the orientation. The model coordinates are rotated around its origin.
If Orientation is zero, and LonOrigin and LatOrigin matches the origin of the projection coordinate system (from ProjectionOrigin(String, Double, Double)), then projection coordinates equals model grid coordinates. Example: UTM-31 has projection origin at (lon,lat) = (3,0).
Inheritance HierarchyNamespace: DHI.Generic.Cartography
Assembly: DHI.Generic.MIKEZero.DFS (in DHI.Generic.MIKEZero.DFS.dll) Version: 19.0.0.0 (11.1.1.1111)
SyntaxThe MzCartography type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | MzCartography(String) |
Create and initialize a cartography object using the
specified projection string.
|
| MzCartography(String, Double, Double) |
Create and initialize a cartography object using the
specified projection string, setting the origin of the user
defined model coordinates to the
lonOrigin, latOrigin |
| MzCartography(String, Double, Double, Double) |
Create and initialize a cartography object using the
specified projection string, setting the origin of the user
defined model coordinates to the
lonOrigin, latOrigin, rotated
orientation.
|
Properties| Name | Description | |
|---|---|---|
 | LatOrigin |
Get the origin latitude coordinaet of the model grid coordinate system.
|
| LonOrigin |
Get the origin longitude coordinaet of the model grid coordinate system.
|
| Orientation |
Get the orientation of the model grid coordinate system.
The orientation is the angle in degrees between true north and the coordinate system y-axis in deg., measured positive clockwise. |
| Projection |
Get the map projection that this cartography object uses.
|
| ProjectionName |
The short name of a projection.
The short name is not unique amongst all WKT projections If the ProjectionString is not a WKT projection string, the ProjectionString itself is returned as the short name. |
| ProjectionNorth |
Returns the angle between projection north and a line parallel to the
model grid.
This is NOT the same as the Orientation, the orientation is towards true north, this is towards projection north. |
| ProjectionString |
Returns the WKT projection string, or one of the projection abbreviation strings.
|
Methods| Name | Description | |
|---|---|---|
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
| Geo2Proj |
Convert coordinates from geographical coordinates to projection coordinates
|
| Geo2Xy |
Convert coordinates from geographical coordinates to model x-y coordinates
|
| GetHashCode | Serves as the default hash function. (Inherited from Object.) |
| GetTrueNorth |
Returns the angle between true north and a line parallel to the
model grid passing through (x,y).
|
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| Proj2Geo |
Convert coordinates from projection coordinates to geographical coordinates
|
| Proj2Xy |
Convert coordinates from projetion coordinates to model x-y coordinates
|
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Xy2Geo |
Convert coordinates from model x-y coordinates to geographical coordinates
|
| Xy2Proj |
Convert coordinates from model x-y coordinates to projection coordinates
|
See Also