IGeoRegistry

Description

interface Tinman.Terrain.Georef.IGeoRegistry

Derived from

ISerializable
IValidatable
IEquatable<IGeoRegistry>

Extended by

GeoRegistry sealed

Base interface for classes that represent a registry of geo objects.

Public / Methods

Build​Config

public method BuildConfig → ()

returns → IGeoRegistry

this

Builds the config types for this registry.

The IGeoObject entries in this registry are grouped by their GeoAuthority, i.e. the GeoObjectId.Authority of their GeoObjectId. For each such authority, a set of config types is built:

The token NAME is the result of ConfigScript.MakeIdentifier for GeoAuthority.Name. The same method is used to generate the names of the generated enumeration items, see ConfigItem.Name. The string representation of the GeoObjectId is used as the tag, see EnumItem.Tag.

ConfigException

If an existing config type has the same name as a config type being built and both types cannot be merged, because they specify conflicting data.

Consolidate

[Pure]
public method Consolidate → ()

returns → GeoRegistry

The consolidated geo registry, which may be this.

Consolidates this geo registry.

This method re-organizes the geo objects in the registry in order to fix validation problems (IValidatable.Validate), if possible. The returned geo registry will behave in the same way as this one.

Lookup

3 overloads

[Pure]
public method Lookup1 → (3)

type in : GeoObjectType

The geo object type.

key in : string

[not-empty]
The geo object key.

authority in : GeoAuthority

[not-null]
The geo authority.

returns → IGeoObject

The geo object.

Performs a geo registry lookup.

GeorefException

If no geo object has been found.

[Pure]
public method Lookup2 → (1)

type in : GeoObjectType

The geo object type.

returns → IGeoObject [ ]

All geo objects of the given type, sorted ascending by their ID.

Performs a geo registry lookup.

[Pure]
public method Lookup3 → ()

returns → IGeoObject [ ]

All geo objects in the registry, sorted ascending by their ID.

Performs a geo registry lookup.

Lookup​Alias

[Pure]
public method LookupAlias → (1)

key in : GeoObjectId

The geo object key, which may be a primary one or an alias.

returns → GeoObjectId

The primary geo object key or null iff key in is null.

Performs a lookup for a geo object key alias.

Lookup​Ids

2 overloads

[Pure]
public method LookupIds1 → (2)

type in : GeoObjectType

The geo object type.

which opt : int32 = 0

Chooses which IDs to return:
< 0 : only aliases
= 0 : objects and aliases
> 0 : only objects

returns → ISortedSetConst<GeoObjectId>

All IDs of geo objects of the given type.

Performs a geo registry lookup.

[Pure]
public method LookupIds2 → (1)

which opt : int32 = 0

Chooses which IDs to return:
< 0 : only aliases
= 0 : objects and aliases
> 0 : only objects

returns → ISortedSetConst<GeoObjectId>

All IDs of geo objects in the registry.

Performs a geo registry lookup.

Lookup​Null

[Pure]
public method LookupNull → (3)

type in : GeoObjectType

The geo object type.

key in : string

[not-empty]
The geo object key.

authority in : GeoAuthority

[not-null]
The geo authority.

returns → IGeoObject

The geo object or null if not found.

Performs a geo registry lookup.

Resolve

[Pure]
public method Resolve → (1)

geoObject in : IGeoObject

The geo object to resolve or null.

returns → IGeoObject

The resolved geo object or geoObject in if the reverse lookup did not find an existing geo object.

Resolves the given geo object by performing a reverse lookup, followed by a forward lookup, using the found geo object key.

Reverse​Lookup

[Pure]
public method ReverseLookup → (1)

obj in : IGeoObject

[not-null]
The geo object to find.

returns → GeoObjectId

The geo object ID or null if not found.

Performs a reverse geo registry lookup.

Public / Attributes

Name

[Constant]
public attribute Name → (get)

value : string

[not-null]
The geo registry name.

Human-readable name of this geo registry.

Extensions

Contains

[Pure]
public static method Contains → (1)

other in : IGeoRegistry

The other geo registry or null.

returns → bool

true if other in is a subset of this geo registry,
false if not.

Checks if the given other in geo registry is a subset of this one or equal to this one.

Current​Global​Push

[ThreadSafe]
public static method CurrentGlobalPush → ()

returns → IGeoRegistry

this

Makes this registry the active one, in the global scope.

See also

GeoRegistry.Current
GeoRegistry.CurrentGlobalPop

Current​Local​Push

[ThreadSafe]
public static method CurrentLocalPush → ()

returns → IGeoRegistry

this

Makes this registry the active one, in the thread-local scope.

See also

GeoRegistry.Current
GeoRegistry.CurrentLocalPop

Lookup

2 overloads

[Pure]
public static method Lookup1 → (3)

type in : GeoObjectType

The geo object type.

key in : int32

The geo object key.

authority in : GeoAuthority

[not-null]
The geo authority.

returns → IGeoObject

The geo object.

Performs a geo registry lookup.

GeorefException

If no geo object has been found.

[Pure]
public static method Lookup2 → (1)

key in : GeoObjectId

[not-null]
The geo object key.

returns → IGeoObject

The geo object.

Performs a geo registry lookup.

GeorefException

If no geo object has been found.

Lookup​Datum​Operation

[Pure]
public static method LookupDatumOperation → (2)

source in : CoordinateSystem

[not-null]
The source coordinate system.

target in : CoordinateSystem

[not-null]
The target coordinate system.

returns → IDatumTransform

The IDatumTransform of the found DatumOperation or null.

Looks for a DatumOperation that performs datum conversion between the given coordinate systems and returns its IDatumTransform.

This method will return unique results only. If one or more possible conversions exist, null is returned. In this case, the calling code must provide a datum conversion.

Lookup​Null

2 overloads

[Pure]
public static method LookupNull1 → (3)

type in : GeoObjectType

The geo object type.

key in : int32

The geo object key.

authority in : GeoAuthority

[not-null]
The geo authority.

returns → IGeoObject

The geo object or null if not found.

Performs a geo registry lookup.

[Pure]
public static method LookupNull2 → (1)

key in : GeoObjectId

The geo object key.

returns → IGeoObject

The geo object or null if not found.

Performs a geo registry lookup.