Geodetic Datasource

GeoCalc contains a copy of the extensive geodetic parameter database used by Geographic Calculator, and a GUI tool that can be used for selecting, editing, or viewing.Over 3500 coordinate systems are available for use out of the box, as well as hundreds of other unit definitions, areas of use, datums, and others; so it can be helpful for developers or users to be able to browse the datasource visually.

You can extend GeoCalc's datasource to support an unlimited number of custom linear and angular units, ellipsoids, datums, datum transformations, and coordinate systems. The parameters for each master definition are stored within an XML database file referred to as the Geodetic Datasource, a file named geodata.xml.  All user-defined parameters will be stored in a file named custom.xml

The types of geodetic elements available in the viewer correspond to classes that exist in GeoCalc:

• Units of Measure

  • Linear Units - Units for measuring straight line, Cartesian distances.
  • Angular Units - Type of units for measuring rotation.
  • Scalar Units - Unit of measure for scale factor.
• Prime Meridians - The Prime Meridian represents the line of longitude that is designated as 0 degrees.  All other lines of longitude are expressed by the angle by which they deviate from the Prime Meridian.  Together with the equator of an Ellipsoid, the Prime Meridian defines the origin of a Geodetic Coordinate System.  A Prime Meridian is defined by the angle that separates it from the Greenwich Meridian.  
• Ellipsoids - An Ellipsoid gives a Datum its size and shape.  An Ellipsoid does not have an origin and cannot be used as a base model for coordinates on its own.
• Datums - A Datum is the base model that maps are built on.  All coordinate systems must have a datum associated with them to be related to any other map.  Without a known datum, coordinates are meaningless.
• Coordinate Transformations - Coordinate Transformations (Concatenated, Datum, Parametric or Vertical) - Parameters to transform coordinates from one Coordinate System to another.
• Coordinate Systems (Coordinate Reference Systems) - A Coordinate System is a complete definition needed to express the context of a set of map data.
• Point Styles (Coordinate Points) - A Point Style is used to define the orientation of axes used and the type of units used in the system.
• Areas of Use - Define a geographic extent within which a particular object is intended to be used.
• Usage - Defines how and where a coordinate system, datum or transformation is intended to be used. A usage includes both scope and extent. Area of use represents the geographic extent. A coordinate system or transformation can be tied to multiple usages.
• Scope - Description of the primary purpose to which a coordinate reference system, datum or coordinate operation is applied.

To begin using the datasource GUI, you will have to initialize a DataSource object and one of the Editor or Picker classes (such as DataSourceEditor or TransformPicker), and then call Show() on it (or pass it to a WPF window, if you are using WPF). A detailed explanation and some sample code of how to do this can be found in Lesson 4 and Lesson 5 of the Getting Started with GeoCalc guide.