org.tinfour.gis.utils

Class VertexReaderLas

java.lang.Object

org.tinfour.gis.utils.VertexReaderLas

All Implemented Interfaces:

Closeable, AutoCloseable, IVertexReader

public class VertexReaderLas
extends Object
implements IVertexReader, Closeable

Constructor Summary

Constructors

Constructor and Description
VertexReaderLas(File file)

Method Summary

Modifier and Type	Method and Description
void	close()
ICoordinateTransform	getCoordinateTransform() Gets the coordinate transform associated with this instance.
LinearUnits	getLinearUnits() Gets the linear units for the coordinate system used by the data.
long	getNumberOfVerticesInSource() Gets the number of vertices in the source file
double	getXMax() Gets the maximum x coordinate in the sample
double	getXMin() Gets the minimum x coordinate in the sample
double	getYMax() Gets the maximum y coordinate in the sample
double	getYMin() Gets the minimum y coordinate in the sample
double	getZMax() Gets the maximum z coordinate in the sample
double	getZMin() Gets the minimum z coordinate in the sample
boolean	isSourceInGeographicCoordinates() Indicates whether the source data was in geographic coordinates
List<Vertex>	read(IMonitorWithCancellation monitor)
void	setCoordinateTransform(ICoordinateTransform transform) Sets a coordinate transform to be used for mapping values from the source file to vertex coordinates.
void	setFilter(ILasRecordFilter filter) Set a filter to be used when reading the content of a LAS file
void	setLinearUnits(LinearUnits linearUnits) Sets the linear units for the coordinate system used by the horizontal (x and y) coordinates of the data.
void	setMaximumNumberOfVertices(long maximumNumberOfVertices) Set the maximum number of vertices to load from a file.

Methods inherited from class java.lang.Object

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

Constructor Detail

VertexReaderLas

public VertexReaderLas(File file)
                throws IOException

Throws:

IOException

Method Detail

setFilter

public void setFilter(ILasRecordFilter filter)

Set a filter to be used when reading the content of a LAS file

Parameters:

filter - a valid filter or a null if all records are to be accepted.

setMaximumNumberOfVertices

public void setMaximumNumberOfVertices(long maximumNumberOfVertices)

Set the maximum number of vertices to load from a file. This setting is provided in response to the potential for a Lidar file to contain a very large number of vertices.

Parameters:

maximumNumberOfVertices - a positive integer

read

public List<Vertex> read(IMonitorWithCancellation monitor)
                  throws IOException

Specified by:

read in interface IVertexReader

Throws:

IOException

getXMin

public double getXMin()

Gets the minimum x coordinate in the sample

Specified by:

getXMin in interface IVertexReader

Returns:

a valid floating point value

getXMax

public double getXMax()

Gets the maximum x coordinate in the sample

Specified by:

getXMax in interface IVertexReader

Returns:

a valid floating point value

getYMin

public double getYMin()

Gets the minimum y coordinate in the sample

Specified by:

getYMin in interface IVertexReader

Returns:

a valid floating point value

getYMax

public double getYMax()

Gets the maximum y coordinate in the sample

Specified by:

getYMax in interface IVertexReader

Returns:

a valid floating point value

getZMin

public double getZMin()

Gets the minimum z coordinate in the sample

Specified by:

getZMin in interface IVertexReader

Returns:

a valid floating point value

getZMax

public double getZMax()

Gets the maximum z coordinate in the sample

Specified by:

getZMax in interface IVertexReader

Returns:

a valid floating point value

isSourceInGeographicCoordinates

public boolean isSourceInGeographicCoordinates()

Indicates whether the source data was in geographic coordinates

Specified by:

isSourceInGeographicCoordinates in interface IVertexReader

Returns:

true if the source data used geographic coordinates; otherwise, false.

getLinearUnits

public 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.

Returns:

a valid enumeration instance

setLinearUnits

public void setLinearUnits(LinearUnits linearUnits)

Sets the linear units for the coordinate system used by the horizontal (x and y) coordinates of the data. This method is intended for cases when the application can provide information that is not otherwise available in the source data.

Parameters:

linearUnits - a valid instance

getCoordinateTransform

public ICoordinateTransform getCoordinateTransform()

Gets the coordinate transform associated with this instance. May be null if no coordinate transform was set.

Specified by:

getCoordinateTransform in interface IVertexReader

Returns:

a valid transform or a null if none was set.

setCoordinateTransform

public void setCoordinateTransform(ICoordinateTransform transform)

Sets a coordinate transform to be used for mapping values from the source file to vertex coordinates.

Specified by:

setCoordinateTransform in interface IVertexReader

Parameters:

transform - a valid transform or a null if none is to be applied.

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

getNumberOfVerticesInSource

public long getNumberOfVerticesInSource()

Gets the number of vertices in the source file

Returns:

a positive integer value