Package com.luciad.format.e57

Class TLcdE57ModelDescriptor

java.lang.Object

com.luciad.model.TLcdModelDescriptor

com.luciad.format.lidar.ALcdLIDARModelDescriptor

com.luciad.format.e57.TLcdE57ModelDescriptor

All Implemented Interfaces:

com.luciad.internal.format.las.ILinPointCloudModelDescriptor, ILcdDataModelDescriptor, ILcdDataSourceModelDescriptor<ILcdDataSource>, ILcdModelDescriptor, Serializable

public class TLcdE57ModelDescriptor
extends ALcdLIDARModelDescriptor
implements ILcdDataSourceModelDescriptor<ILcdDataSource>, com.luciad.internal.format.las.ILinPointCloudModelDescriptor

Model descriptor for data decoded from an E57 (.e57) file.

• It contains various fields available in the .e57 header.
• It implements ILcdDataModelDescriptor and getPropertyRange to see what properties are available in this model.

Data model

Although the elements in the model are not data objects themselves, you can still use the data model to access properties of individual points when you use it to build expressions for use in styling.

The data model has a single type that consists of the properties available in the source file. Only the properties available in the source file are available in the data type, for example if a file does contain color information, but does not contain timestamp information, the data type will have a ALcdLIDARModelDescriptor.COLOR property, but not an TIME_STAMP property.

You can find the names of all the possible properties as constant fields in TLcdE57ModelDescriptor: ALcdLIDARModelDescriptor.COLOR, ALcdLIDARModelDescriptor.INTENSITY, ROW_INDEX, COLUMN_INDEX, and so on.

You can use getPropertyRange(com.luciad.datamodel.TLcdDataProperty) to get the extent (minimum and maximum value) of a specific property in this specific model.

Since:

2018.1

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	COLUMN_INDEX	The column index property.
static final String	E57_TYPE_NAME	The type name of the data source.
static final String	RETURN_COUNT	The return count property.
static final String	RETURN_INDEX	The return index property.
static final String	ROW_INDEX	The row index property.
static final String	TIME_STAMP	The time stamp property.

Fields inherited from class com.luciad.format.lidar.ALcdLIDARModelDescriptor

COLOR, HEIGHT, INTENSITY

Constructor Summary

Constructors

Constructor	Description
TLcdE57ModelDescriptor(String aSourceName, String aDisplayName, String aGUID, long aNumberOfPoints, Instant aCreationTime, TLcdDataType aPointDataType, Map<TLcdDataProperty,TLcdInterval> aPropertyRanges)	Creates a new TLcdE57ModelDescriptor

Method Summary

Modifier and Type	Method	Description
Instant	getCreationTime()	Gets the time instant when the E57 file was created, if available
ILcdDataSource	getDataSource()	Returns the object that was used to decode the corresponding model.
TLcdDataType	getDataType()	Returns the single data type that describes the individual points in the elements of this model.
String	getGUID()	Gets the globally unique identifier of this dataset, if available
Set<TLcdDataType>	getModelTypes()	Returns a single data type that describes the individual points in the elements of this model.
long	getNumberOfPoints()	Returns the Number Of Point Records as specified in the .e57 header.
ILcdInterval	getPropertyRange(TLcdDataProperty aProperty)	Returns the range of values for the given property for this model.

Methods inherited from class com.luciad.format.lidar.ALcdLIDARModelDescriptor

getDataModel, getModelElementTypes

Methods inherited from class com.luciad.model.TLcdModelDescriptor

getDisplayName, getSourceName, getTypeName, setDisplayName, setSourceName, setTypeName, sourceNameToDisplayName

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.luciad.model.ILcdModelDescriptor

getDisplayName, getSourceName, getTypeName

Field Details

E57_TYPE_NAME

public static final String E57_TYPE_NAME

The type name of the data source.

See Also:

• Constant Field Values

ROW_INDEX

public static final String ROW_INDEX

The row index property. An Integer.

See Also:

• Constant Field Values

COLUMN_INDEX

public static final String COLUMN_INDEX

The column index property. An Integer.

See Also:

• Constant Field Values

RETURN_INDEX

public static final String RETURN_INDEX

The return index property. An Integer.

See Also:

• Constant Field Values

RETURN_COUNT

public static final String RETURN_COUNT

The return count property. An Integer.

See Also:

• Constant Field Values

TIME_STAMP

public static final String TIME_STAMP

The time stamp property. A Double.

See Also:

• Constant Field Values

Constructor Details

TLcdE57ModelDescriptor

public TLcdE57ModelDescriptor(String aSourceName,
 String aDisplayName,
 String aGUID,
 long aNumberOfPoints,
 Instant aCreationTime,
 TLcdDataType aPointDataType,
 Map<TLcdDataProperty,TLcdInterval> aPropertyRanges)

Creates a new TLcdE57ModelDescriptor

Since:

2020.1

Method Details

getDataSource

public ILcdDataSource getDataSource()

Description copied from interface: ILcdDataSourceModelDescriptor

Returns the object that was used to decode the corresponding model.

Specified by:

getDataSource in interface ILcdDataSourceModelDescriptor<ILcdDataSource>

Returns:

an object describing the data source(s) of the corresponding model. This can be null, e.g. when the model was not decoded by using an ILcdDataSource.

See Also:

• ILcdModelDecoder

getModelTypes

public Set<TLcdDataType> getModelTypes()

Returns a single data type that describes the individual points in the elements of this model.

See class javadoc for more details on the data model.

Specified by:

getModelTypes in interface ILcdDataModelDescriptor

Returns:

The single data type that describes the individual points in the elements of this model.

getPropertyRange

public ILcdInterval getPropertyRange(TLcdDataProperty aProperty)

Description copied from class: ALcdLIDARModelDescriptor

Returns the range of values for the given property for this model.

Only returns an interval for properties with numeric values, otherwise returns null.

Also returns null if the property is not available in the data type of this model.

Specified by:

getPropertyRange in class ALcdLIDARModelDescriptor

Parameters:

aProperty - the property to get the range for.

Returns:

The range, or null if the property is not available in the file, or if the property does not have a range.

getDataType

public TLcdDataType getDataType()

Returns the single data type that describes the individual points in the elements of this model.

This is the same data type as in getModelTypes().

See class javadoc for more details on the data model.

Returns:

The single data type that describes the individual points in the elements of this model.

getGUID

public String getGUID()

Gets the globally unique identifier of this dataset, if available

Returns:

the globally unique identifier of this dataset

getNumberOfPoints

public long getNumberOfPoints()

Returns the Number Of Point Records as specified in the .e57 header.

Note: the actual amount of points in the model may be different, for example because of filtering or setting a maximum.

Specified by:

getNumberOfPoints in interface com.luciad.internal.format.las.ILinPointCloudModelDescriptor

Returns:

The number of points in the file.

getCreationTime

public Instant getCreationTime()

Gets the time instant when the E57 file was created, if available

Returns:

the time instant when the E57 file was created