IGeoPathReader
Description
- Derived from
- Extended by
-
GeoPathReader abstract
IGeoPathReaderGeneric
Base interface for classes that read components of a geo path from a tabular data source, where columns map to geo path components and rows map to geo path samples.
The process for reading geo path components is structured as follows:
-
Choose a suitable implementation class for reading the format of the data source at hand and create a IGeoPathReader object.
-
Call Component to register the geo path components to consume.
-
Use GeoPathReaderComponent.Column1 or GeoPathReaderComponent.Column2 to map geo path components to data source columns.
-
Optionally use GeoPathReaderComponent.Value to specify default values for unmapped geo path components or a linear value transformation.
-
Optionally use IGeoPathReaderGeneric.Vertical to configure a conversion to apply to the vertical coordinates that are read from the data source.
-
Use ReadComponents to read plain geo path components or IGeoPathReaderGeneric.ReadSample to read geo path samples of a specific type. Alternatively, use any of the
ReadAll*
helper methods.
Public / Methods
Component
Registers the given geo path component.
If possible, the given geo path component in identifier will be merged with an existing identifier (see GeoPathComponentId.Merge), so that the reader always uses identifiers that are most specific, with respect to their special "any" field values. This also ensures that the same GeoPathReaderComponent object is returned for mergeable identifiers.
ComponentId
Returns the identifier of the given geo path component.
This method accesses the list of identifiers, which is sorted by the natural order of GeoPathComponentId values. So the order in which the calls to Component are made is irrelevant, it does not influence the order of the list elements. Consequently, each time Component is called, the order of the list elements may change.
ReadComponents
Reads the next tuple of geo path components.
The given values in array will be written to as follows:
values[idx][n] := value
where idx
is the geo path component index (see Components) and value
is the component value that has been read from the mapped data source column.
- IOException
-
If an I/O error has occurred.
Public / Attributes
Extensions
AsGeo
Uses GeoPathSampleTrait to create a IGeoPathReaderGeneric object that wraps this reader and reads GeoPathSample values.
This method delegates to GeoPathReaderGeneric.Wrap.
AsGround
Uses GroundPathSampleTrait to create a IGeoPathReaderGeneric object that wraps this reader and reads GroundPathSample values.
This method delegates to GeoPathReaderGeneric.Wrap.
ReadAllComponents
Reads all remaining path samples into a GeoPathComponents container.
- IOException
-
If an I/O error has occurred.
- See also