TINMAN 3D / REALTIME TERRAIN
Software Development Kit - User Manual

class Ellipsoid in Tinman.Terrain.Georef

Describes an ellipsoid.

sealed class Ellipsoid extends GeoObject

See also:

GeoRegistry

Configuration

Config

The configurator object for this type.

public static property Config { get }
type IConfigurator<Ellipsoid>
value [not-null] The configurator object.

ToConfig

Returns the configuration value that describes this object.

public override method ToConfig ()
type ConfigValue
returns [not-null] The configuration value.
overrides GeoObject.ToConfig

Remarks:

All configurable objects need to implement this interface. For simple types, it is preferable to delegate to ToValue.

The returned value may be of type Invalid, which means that this object in its current state cannot be described with the configuration API.

Before returning the resulting configuration value, Cache must be called on it, passing this IConfigurable object as parameter.

Serialization

SerialId

Serialization information about this type.

public static readonly field SerialId
type ISerialTypeInfo

Public / Constants

Airy_1830

Airy 1830

public static readonly field Airy_1830
type Ellipsoid

Remarks:

Semi major axis: 6377563.396 (Metre)
Inverse flattening: 299.3249646

Airy_Modified_1849

Airy Modified 1849

public static readonly field Airy_Modified_1849
type Ellipsoid

Remarks:

Semi major axis: 6377340.189 (Metre)
Inverse flattening: 299.3249646

Australian_National_Spheroid

Australian National Spheroid

public static readonly field Australian_National_Spheroid
type Ellipsoid

Remarks:

Semi major axis: 6378160 (Metre)
Inverse flattening: 298.25

Average_Terrestrial_System_1977

Average Terrestrial System 1977

public static readonly field Average_Terrestrial_System_1977
type Ellipsoid

Remarks:

Semi major axis: 6378135 (Metre)
Inverse flattening: 298.257

Bessel_1841

Bessel 1841

public static readonly field Bessel_1841
type Ellipsoid

Remarks:

Semi major axis: 6377397.155 (Metre)
Inverse flattening: 299.1528128

Bessel_Modified

Bessel Modified

public static readonly field Bessel_Modified
type Ellipsoid

Remarks:

Semi major axis: 6377492.018 (Metre)
Inverse flattening: 299.1528128

CGCS2000

CGCS2000

public static readonly field CGCS2000
type Ellipsoid

Remarks:

Semi major axis: 6378137 (Metre)
Inverse flattening: 298.257222101

Clarke_1866

Clarke 1866

public static readonly field Clarke_1866
type Ellipsoid

Remarks:

Semi major axis: 6378206.4 (Metre)
Semi minor axis: 6356583.8 (Metre)

Clarke_1866_Authalic_Sphere

Clarke 1866 Authalic Sphere

public static readonly field Clarke_1866_Authalic_Sphere
type Ellipsoid

Remarks:

Semi major axis: 6370997 (Metre)

Clarke_1880_Arc

Clarke 1880 (Arc)

public static readonly field Clarke_1880_Arc
type Ellipsoid

Remarks:

Semi major axis: 6378249.145 (Metre)
Inverse flattening: 293.4663077

Clarke_1880_Benoit

Clarke 1880 (Benoit)

public static readonly field Clarke_1880_Benoit
type Ellipsoid

Remarks:

Semi major axis: 6378300.789 (Metre)
Semi minor axis: 6356566.435 (Metre)

Clarke_1880_IGN

Clarke 1880 (IGN)

public static readonly field Clarke_1880_IGN
type Ellipsoid

Remarks:

Semi major axis: 6378249.2 (Metre)
Semi minor axis: 6356515 (Metre)

Clarke_1880_international_foot

Clarke 1880 (international foot)

public static readonly field Clarke_1880_international_foot
type Ellipsoid

Remarks:

Semi major axis: 20926202 (Foot)
Semi minor axis: 20854895 (Foot)

Clarke_1880_RGS

Clarke 1880 (RGS)

public static readonly field Clarke_1880_RGS
type Ellipsoid

Remarks:

Semi major axis: 6378249.145 (Metre)
Inverse flattening: 293.465

Clarke_1880_SGA_1922

Clarke 1880 (SGA 1922)

public static readonly field Clarke_1880_SGA_1922
type Ellipsoid

Remarks:

Semi major axis: 6378249.2 (Metre)
Inverse flattening: 293.46598

Danish_1876

Danish 1876

public static readonly field Danish_1876
type Ellipsoid

Remarks:

Semi major axis: 6377019.27 (Metre)
Inverse flattening: 300

Everest_1830_1937_Adjustment

Everest 1830 (1937 Adjustment)

public static readonly field Everest_1830_1937_Adjustment
type Ellipsoid

Remarks:

Semi major axis: 6377276.345 (Metre)
Inverse flattening: 300.8017

Everest_1830_1962_Definition

Everest 1830 (1962 Definition)

public static readonly field Everest_1830_1962_Definition
type Ellipsoid

Remarks:

Semi major axis: 6377301.243 (Metre)
Inverse flattening: 300.8017255

Everest_1830_1967_Definition

Everest 1830 (1967 Definition)

public static readonly field Everest_1830_1967_Definition
type Ellipsoid

Remarks:

Semi major axis: 6377298.556 (Metre)
Inverse flattening: 300.8017

Everest_1830_1975_Definition

Everest 1830 (1975 Definition)

public static readonly field Everest_1830_1975_Definition
type Ellipsoid

Remarks:

Semi major axis: 6377299.151 (Metre)
Inverse flattening: 300.8017255

Everest_1830_Modified

Everest 1830 Modified

public static readonly field Everest_1830_Modified
type Ellipsoid

Remarks:

Semi major axis: 6377304.063 (Metre)
Inverse flattening: 300.8017

Everest_1830_RSO_1969

Everest 1830 (RSO 1969)

public static readonly field Everest_1830_RSO_1969
type Ellipsoid

Remarks:

Semi major axis: 6377295.664 (Metre)
Inverse flattening: 300.8017

GEM_10C

GEM 10C

public static readonly field GEM_10C
type Ellipsoid

Remarks:

Semi major axis: 6378137 (Metre)
Inverse flattening: 298.257223563

GRS_1967

GRS 1967

public static readonly field GRS_1967
type Ellipsoid

Remarks:

Semi major axis: 6378160 (Metre)
Inverse flattening: 298.247167427

GRS_1967_Modified

GRS 1967 Modified

public static readonly field GRS_1967_Modified
type Ellipsoid

Remarks:

Semi major axis: 6378160 (Metre)
Inverse flattening: 298.25

GRS_1980

GRS 1980

public static readonly field GRS_1980
type Ellipsoid

Remarks:

Semi major axis: 6378137 (Metre)
Inverse flattening: 298.257222101

GRS_1980_Authalic_Sphere

GRS 1980 Authalic Sphere

public static readonly field GRS_1980_Authalic_Sphere
type Ellipsoid

Remarks:

Semi major axis: 6371007 (Metre)

GSK_2011

GSK-2011

public static readonly field GSK_2011
type Ellipsoid

Remarks:

Semi major axis: 6378136.5 (Metre)
Inverse flattening: 298.2564151

Helmert_1906

Helmert 1906

public static readonly field Helmert_1906
type Ellipsoid

Remarks:

Semi major axis: 6378200 (Metre)
Inverse flattening: 298.3

Hough_1960

Hough 1960

public static readonly field Hough_1960
type Ellipsoid

Remarks:

Semi major axis: 6378270 (Metre)
Inverse flattening: 297

Hughes_1980

Hughes 1980

public static readonly field Hughes_1980
type Ellipsoid

Remarks:

Semi major axis: 6378273 (Metre)
Semi minor axis: 6356889.449 (Metre)

IAG_1975

IAG 1975

public static readonly field IAG_1975
type Ellipsoid

Remarks:

Semi major axis: 6378140 (Metre)
Inverse flattening: 298.257

Indonesian_National_Spheroid

Indonesian National Spheroid

public static readonly field Indonesian_National_Spheroid
type Ellipsoid

Remarks:

Semi major axis: 6378160 (Metre)
Inverse flattening: 298.247

International_1924

International 1924

public static readonly field International_1924
type Ellipsoid

Remarks:

Semi major axis: 6378388 (Metre)
Inverse flattening: 297

International_1924_Authalic_Sphere

International 1924 Authalic Sphere

public static readonly field International_1924_Authalic_Sphere
type Ellipsoid

Remarks:

Semi major axis: 6371228 (Metre)

Krassowsky_1940

Krassowsky 1940

public static readonly field Krassowsky_1940
type Ellipsoid

Remarks:

Semi major axis: 6378245 (Metre)
Inverse flattening: 298.3

NWL_9D

NWL 9D

public static readonly field NWL_9D
type Ellipsoid

Remarks:

Semi major axis: 6378145 (Metre)
Inverse flattening: 298.25

OSU86F

OSU86F

public static readonly field OSU86F
type Ellipsoid

Remarks:

Semi major axis: 6378136.2 (Metre)
Inverse flattening: 298.257223563

OSU91A

OSU91A

public static readonly field OSU91A
type Ellipsoid

Remarks:

Semi major axis: 6378136.3 (Metre)
Inverse flattening: 298.257223563

Plessis_1817

Plessis 1817

public static readonly field Plessis_1817
type Ellipsoid

Remarks:

Semi major axis: 6376523 (Metre)
Inverse flattening: 308.64

PZ_90

PZ-90

public static readonly field PZ_90
type Ellipsoid

Remarks:

Semi major axis: 6378136 (Metre)
Inverse flattening: 298.257839303

Struve_1860

Struve 1860

public static readonly field Struve_1860
type Ellipsoid

Remarks:

Semi major axis: 6378298.3 (Metre)
Inverse flattening: 294.73

War_Office

War Office

public static readonly field War_Office
type Ellipsoid

Remarks:

Semi major axis: 6378300 (Metre)
Inverse flattening: 296

WGS_72

WGS 72

public static readonly field WGS_72
type Ellipsoid

Remarks:

Semi major axis: 6378135 (Metre)
Inverse flattening: 298.26

WGS_84

WGS 84

public static readonly field WGS_84
type Ellipsoid

Remarks:

Semi major axis: 6378137 (Metre)
Inverse flattening: 298.257223563

Zach_1812

Zach 1812

public static readonly field Zach_1812
type Ellipsoid

Remarks:

Semi major axis: 6376045 (Metre)
Inverse flattening: 310

Public / Attributes

Eccentricity

Eccentricity: e

public property Eccentricity { get }
type float64
value The value of e.

Remarks:

Equal to sqrt(2 * abs(f) - sqr(f))

EccentricitySqr

Squared eccentricity: e^2

public property EccentricitySqr { get }
type float64
value The value of e^2.

Remarks:

Equal to 2 * abs(f) - sqr(f)

FaceBounds

Returns the map bounds of Face for this ellipsoid.

public property FaceBounds { get }
type Box2D
value The map bounds.

Flattening

Flattening: f

public property Flattening { get }
type float64
value The value of f:
> 0 : oblate
< 0 : prolate
= 0 : sphere

Remarks:

Equal to (a - b) / a. Defaults to 0 (i.e. a sphere).

InverseFlattening

The inverse flattening (1/f) or 0 if flattening is zero.

public property InverseFlattening { get }
type float64
value The value of 1/f.

IsSphere

Does this parameter bag define an ellipsoid that is actually a sphere?

public property IsSphere { get }
type bool
value true if the ellipsoid is a sphere, false if not.

Name

The human-readable name of this object.

public property Name { get }
type string
value [not-empty] The object name.
inherited GeoObject.Name

RadiusOfAuthalicSphere

Radius of authalic sphere: RA

public property RadiusOfAuthalicSphere { get }
type float64
value Radius of authalic sphere.

Remarks:

Radius of sphere having same surface area as ellipsoid.

Equal to a * sqrt((1 - ((1 - sqr(e)) / (2 * e)) * (ln((1 - e) / (1 + e)))) * 0.5))

SecondEccentricity

Second eccentricity: e'

public property SecondEccentricity { get }
type float64
value The value of e'

Remarks:

Equal to = sqrt(sqr(e) / (1 - sqr(e)))

SemiMajorAxis

The semi-major axis: b

public property SemiMajorAxis { get }
type float64
value The value of a

SemiMinorAxis

The semi-minor axis: b

public property SemiMinorAxis { get }
type float64
value The value of b

SerialType

Returns the serial type of this object.

public property SerialType { get }
type ISerialTypeInfo
value [not-null] The serial type.
inherited SerializableBase.SerialType

SerialVersion

Returns the serial data version.

public virtual property SerialVersion { get }
type int32
value [>=1] The serial data version tag.
inherited SerializableBase.SerialVersion

Remarks:

An ISerializable implementation is required to support all versions up to the one returned by SerialVersion.

See also:

ISerializable.Serialize
ISerializable.Deserialize

Type

The type of this geo object.

public property Type { get }
type GeoObjectType
value The geo object type.
inherited GeoObject.Type

Unit

The unit of the ellipsoid semi axes.

public property Unit { get }
type UnitOfMeasure
value [not-null] The unit of measure.

Public / Constructors

Ellipsoid

Creates a new instance of Ellipsoid.

public constructor Ellipsoid (float64 semiMajorAxis, float64 semiMinorAxis = 0, float64 inverseFlattening = 0, UnitOfMeasure unit = null, string name = null)
params semiMajorAxis [>0] The semi major axis (a).
  semiMinorAxis The semi minor axis (b) or 0. Defaults to 0.
  inverseFlattening The inverse flattening (1/f) or 0. Defaults to 0.
  unit The unit of measure to use. If null, Metre will be used. Defaults to null.
  name Human-readable name of the geo object. If empty or null, UserDefined will be used instead. Defaults to null.

Public / Methods

Deserialize

Initializes the state of this object from the given data stream.

public override method Deserialize (int32 serialVersion, ISerializer data)
type ISerializable
params serialVersion [>=1] The serial data version.
  data [not-null] The serial data stream.
returns [not-null] The deserialized object. This will typically be this, but in some circumstances, another instance may be returned (e.g. singletons).
overrides GeoObject.Deserialize

Remarks:

The Deserialize method will be called immediately after the object has been instantiated via its default constructor.

The provided serialVersion number is guaranteed to be equal to or less than the SerialVersion returned by this object (i.e. ISerializable object must provide backwards compatibility).

See also:

ISerializable.Serialize
ISerializable.SerialVersion

Equals

Compares this object with the given one.

[Pure]
public override method Equals (IGeoObject other)
type bool
params other The object to compare to.
returns true if this object is equal to other, false if not.
overrides GeoObject.Equals

Compares this object with the given one.

[Pure]
public override sealed method Equals (object other)
type bool
params other The object to compare to.
returns true if this object is equal to other, false if not.
inherited GeoObject.Equals

GetHashCode

[Pure]
public override sealed method GetHashCode ()
type int32
inherited GeoObject.GetHashCode

RadiusOfConformalSphere

Radius of conformal sphere: RC

[Pure]
public method RadiusOfConformalSphere (float64 phi)
type float64
params phi The latitude angle, in radians.
returns Radius of conformal sphere.

Remarks:

This is a function of latitude and therefore not constant. When used for spherical projections the use of Latitude (or Parallel1 as relevant to method) for phi is suggested, except if the projection is equal area when RadiusOfAuthalicSphere should be used.

RadiusOfCurvatureInTheMeridian

Radius of curvature in the meridian: rho

[Pure]
public method RadiusOfCurvatureInTheMeridian (float64 phi)
type float64
params phi The latitude angle, in radians.
returns Radius of curvature in the meridian.

Remarks:

Radius of curvature of the ellipsoid in the plane of the meridian at latitude phi.

RadiusOfCurvatureInThePrimeVertical

Radius of curvature in the prime vertical: nu.

[Pure]
public method RadiusOfCurvatureInThePrimeVertical (float64 phi)
type float64
params phi The latitude angle, in radians.
returns Radius of curvature in the prime vertical.

Remarks:

Radius of curvature of the ellipsoid perpendicular to the meridian at latitude phi.

Serialize

Serializes the current state of this object to the given data stream.

public override method Serialize (ISerializer data)
params data [not-null] The serial data stream.
overrides GeoObject.Serialize

See also:

ISerializable.Deserialize
ISerializable.SerialVersion

ToString

[Pure]
public override sealed method ToString ()
type string
inherited GeoObject.ToString

ToUnit

Converts the length unit of this ellipsoid.

[Pure]
public method ToUnit (UnitOfMeasure unit)
type Ellipsoid
params unit [not-null] The length unit to convert to.
returns [not-null] The resulting ellipsoid.