org.tinfour.demo.viewer.backplane

Class ModelFromText

java.lang.Object

org.tinfour.demo.viewer.backplane.ModelAdapter

org.tinfour.demo.viewer.backplane.ModelFromText

All Implemented Interfaces:

IModel

public class ModelFromText
extends ModelAdapter
implements IModel

A model for managing data taken from a text or comma-separated-value file

Field Summary

Fields inherited from class org.tinfour.demo.viewer.backplane.ModelAdapter

serialIndex

Constructor Summary

Constructors

Constructor and Description
ModelFromText(File file) Construct a model tied to the specified file.

Method Summary

Modifier and Type	Method and Description
String	getDescription() Gets a shortdescription of the model
org.tinfour.utils.LinearUnits	getLinearUnits() Gets the linear units for the coordinate system used by the data.
void	load(org.tinfour.common.IMonitorWithCancellation monitor) Read the specified file.
String	toString()

Methods inherited from class org.tinfour.demo.viewer.backplane.ModelAdapter

addConstraints, areConstraintsLoaded, areVerticesLoaded, geo2xy, getArea, getConstraints, getCoordinateTransform, getFile, getFormattedCoordinates, getFormattedX, getFormattedY, getMaxX, getMaxY, getMaxZ, getMinX, getMinY, getMinZ, getName, getNominalPointSpacing, getPerimeterVertices, getReferenceReductionFactor, getReferenceTin, getTimeToLoadInMillis, getTimeToSortInMillis, getVertexCount, getVertexForIndex, getVertexList, hasConstraints, hasConstraintsSource, hasVertexSource, isCoordinateSystemGeographic, isLoaded, xy2geo

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.tinfour.demo.viewer.backplane.IModel

addConstraints, areConstraintsLoaded, areVerticesLoaded, geo2xy, getArea, getConstraints, getCoordinateTransform, getFile, getFormattedCoordinates, getFormattedX, getFormattedY, getMaxX, getMaxY, getMaxZ, getMinX, getMinY, getMinZ, getName, getNominalPointSpacing, getPerimeterVertices, getReferenceReductionFactor, getReferenceTin, getTimeToLoadInMillis, getTimeToSortInMillis, getVertexCount, getVertexForIndex, getVertexList, hasConstraints, hasConstraintsSource, hasVertexSource, isCoordinateSystemGeographic, isLoaded, xy2geo

Constructor Detail

ModelFromText

public ModelFromText(File file)

Construct a model tied to the specified file.

Delimiters Specifications in text files depend on the presence of a delimiter character to separate data fields given on a single line. Typically delimiters are specified using a space, tab, comma, or pipe (vertical bar character). Files with the extension ".csv" (for comma-separated-value) are assumed to be comma-delimited. Otherwise, the constructor will attempt to inspect the content of the specified file and determine the delimiter based on internal clues. If a file includes a mix of potential delimiters, such as both spaces and commas, the delimiter will be determined on the basis of precedence (in increasing order, space, tab, comma, and pipe).

An application may also override the automatically determined delimiter through the setDelimiter() method. Geographic coordinates If the values in the file are in geographic coordinates, the input file must include a header row indicating which columns are latitude and longitude. This feature serves two purposes, it informs the model that the coordinates are geographic and it dispels any ambiguity about which column is which. Geographic coordinate values must be giving in standard decimal numeric form using negative numbers for southern latitudes and western longitudes (quadrants and degrees-minutes-seconds notion are not supported at this time).

For example:

    latitude, longitude, z
      42.5,     73.33,   2001
 

Parameters:

file - a valid text or comma-separated value file

Method Detail

load

public void load(org.tinfour.common.IMonitorWithCancellation monitor)
          throws IOException

Read the specified file.

Specified by:

load in interface IModel

Overrides:

load in class ModelAdapter

Parameters:

monitor - an optional monitor for tracking progress (null if not used)

Throws:

IOException - In the event of a non-recoverable error related to I/O or file access.

getDescription

public String getDescription()

Description copied from interface: IModel

Gets a shortdescription of the model

Specified by:

getDescription in interface IModel

Overrides:

getDescription in class ModelAdapter

Returns:

a valid string.

getLinearUnits

public org.tinfour.utils.LinearUnits getLinearUnits()

Gets the linear units for the coordinate system used by the data. It is assumed that the vertical and horizontal coordinate systems will be in the same unit system, though assumption could change in a future implementation.

Specified by:

getLinearUnits in interface IModel

Overrides:

getLinearUnits in class ModelAdapter

Returns:

at this time, the method always returns LinearUnits.UNDEFINED

toString

public String toString()

Overrides:

toString in class Object