Package org.hortonmachine.gears.io.las.core

Class ALasReader

java.lang.Object

org.hortonmachine.gears.io.las.core.Las

org.hortonmachine.gears.io.las.core.ALasReader

All Implemented Interfaces:

AutoCloseable

Direct Known Subclasses:

LasReaderBuffered, LaszipReader

public abstract class ALasReader
extends Las
implements AutoCloseable

Interface for las readers.

Author:

Andrea Antonello (www.hydrologis.com)

Constructor Summary

Constructors

Constructor	Description
ALasReader()

Method Summary

Modifier and Type	Method	Description
abstract void	close()	Close the las data source and free resources.
abstract ILasHeader	getHeader()	Get the las header.
abstract File	getLasFile()	Get a reference to the las file.
abstract LasRecord	getNextPoint()	Read the next record into a LasRecord object.
abstract LasRecord	getPointAt(long pointPosition)	Reads a dot at a given point position.
abstract LasRecord	getPointAtAddress(long address)	Reads a dot at a given address.
abstract boolean	hasNextPoint()	Check if there are still data available.
abstract void	open()	Open the las data source.
abstract double[]	readNextLasXYZAddress()	Reads the position and the record address in the file of the next point.
abstract void	rewind()	Rewind the iterator to start from scratch.
abstract void	seek(long pointNumber)	Move to a given point in the file.
abstract void	setOverrideGpsTimeType(int type)	Overrides the time type.

Methods inherited from class org.hortonmachine.gears.io.las.core.Las

getReader, getReader, getWriter

Methods inherited from class java.lang.Object

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

Constructor Detail

ALasReader

public ALasReader()

Method Detail

open

public abstract void open()
                   throws Exception

Open the las data source.

Throws:

Exception

close

public abstract void close()
                    throws Exception

Close the las data source and free resources.

Specified by:

close in interface AutoCloseable

Throws:

Exception

getLasFile

public abstract File getLasFile()

Get a reference to the las file.

Returns:

the las file.

getHeader

public abstract ILasHeader getHeader()

Get the las header.

Returns:

the las header.

hasNextPoint

public abstract boolean hasNextPoint()
                              throws IOException

Check if there are still data available.

Returns:

true if there are still data to read.

Throws:

IOException

getNextPoint

public abstract LasRecord getNextPoint()
                                throws IOException

Read the next record into a LasRecord object.

Returns:

the read object or null if none available.

Throws:

IOException

rewind

public abstract void rewind()
                     throws IOException

Rewind the iterator to start from scratch.

Throws:

IOException

getPointAtAddress

public abstract LasRecord getPointAtAddress(long address)
                                     throws IOException

Reads a dot at a given address.

Parameters:

address - the file address of the record to read.

Returns:

the read record.

Throws:

IOException

getPointAt

public abstract LasRecord getPointAt(long pointPosition)
                              throws IOException

Reads a dot at a given point position.

Parameters:

pointPosition - the point position.

Returns:

the read record.

Throws:

IOException

readNextLasXYZAddress

public abstract double[] readNextLasXYZAddress()
                                        throws IOException

Reads the position and the record address in the file of the next point.

Returns:

the array containing [x, y, z, address].

Throws:

IOException

seek

public abstract void seek(long pointNumber)
                   throws IOException

Move to a given point in the file.

The position starts with 0 at the first point position.

Note that not hasNextPoint() can be called after seek, getNextPoint() must be called directly instead.

Parameters:

pointNumber - the number of records to skip.

Throws:

IOException

setOverrideGpsTimeType

public abstract void setOverrideGpsTimeType(int type)

Overrides the time type.

The time type is sometimes found set wrong by certain softwares. This gives the possibility to override it and allow for proper time conversion.

Parameters:

type - the type to set.