ASTM E57 Writer Parameters
Point Cloud Component Mapping
Use this matrix to map FME point cloud components to E57 element names.
Each point cloud may contain an arbitrary set of components, and each component may have an arbitrary data type. For example, /data3D/0/points/colorRed could be mapped to FME component color_red.
The table below lists the set of standard E57 component names, and the corresponding default FME component name:
E57 Element | FME Component |
---|---|
cartesianX | x |
cartesianY | y |
cartesianZ | z |
sphericalRange | sphericalRange |
sphericalAzimuth | sphericalAzimuth |
sphericalElevation | sphericalElevation |
rowIndex | rowIndex |
columnIndex | columnIndex |
returnCount | number_of_returns |
returnIndex | return |
timeStamp | timeStamp |
intensity | intensity |
colorRed | color_red |
colorGreen | color_green |
colorBlue | color_blue |
cartesianInvalidState | cartesianInvalidState |
sphericalInvalidState | sphericalInvalidState |
isTimeStampInvalid | isTimeStampInvalid |
isIntensityInvalid | isIntensityInvalid |
Point clouds in E57 may have either Cartesian coordinates or spherical coordinates. If a dataset only contains spherical coordinates, the cartesianX, cartesianY, and cartesianZ elements may still be selected as part of the component map (in which case the spherical values will be converted to Cartesian values).
Write Point Groups
Point clouds written to E57 can be split into logical groups of points. Splitting a point cloud into groups may allow an application reading an E57 dataset to filter points more quickly.
- Unchecked by default: Do not split point clouds into groups.
- When checked: Split point clouds into groups.
Group By Element
Specifies the E57 element by which the points will be grouped, either by rowIndex or columnIndex.
Each distinct value for the specified element defines a group. For example, if grouping by rowIndex, and the input point cloud has points with rowIndex values of 0, 1, and 2, three groups are created. Group values are not required to be consecutive or sorted. For example, it is permissible to have two groups, with values of 6 then 4.
The specified element must exist in the component map. If the corresponding component is not present on an input point cloud, groups are not written for that point cloud.
Create Contiguous Point Groups
Specifies whether point groups should be contiguous. In contiguous point groups, all points in a group are consecutive. For example, there would not be points for group 0, followed by points for group 1, followed by more points for group 0. Contiguous groups may allow an application reading an E57 dataset to filter points more quickly that non-contiguous groups.
Points are Ordered By Group
When creating contiguous point groups, specifies whether the points are already ordered.
- No: Points are not assumed to be ordered, so the writer enforces order.
- Yes: Points are assumed to be ordered already. If the points are, in fact, already ordered, this option improves performance. If they are not ordered, the writer fails.
Raster
Default Raster Format
Specifies the underlying format to which rasters are written.