Currently, this node supports E57 and LAS lidar files. Neither of these formats guarantee that the point clouds are near the origin. However, both formats assume the z-axis points upwards instead of the y-axis.
This SOP reads a lidar file and imports a point cloud from its data. It provides the option of reading several additional attributes from the file, provided that these attributes exist in the file. There are also filtering options to work with large point clouds.
In E57 files, some attributes (such as position) may come with associated data that marks certain points as having "invalid" values. In these cases, a group will be created that contains all "invalid" points for that attribute.
This node will try to read as little from the provided file as possible to reduce cook times when changing parameters, particularly in the Attributes section. However, with large files, long cook times are unavoidable. It is recommended that you write the point cloud to a
file once you're satisfied with it, so that you can simply read the
.bgeo in the future with the File SOP and get faster cook times.
To work with the point cloud as a VDB primitive, you can use the Convert VDB Points SOP.
The name of the lidar file.
The prefix of the created groups, which represent separate scans stored in the file. Applies to E57 files only, as LAS files do not support multiple scans.
The type of filtering used on the point cloud.
Do not apply any filtering.
Filter the point cloud by a specified range.
Filter the point cloud by setting a maximum number of points.
The node will be unable to cache its previous output if this parameter is changed. To avoid this, set this parameter before setting File.
Select ___ of ___
When Filter Type is Range, every (number in the left field) points for every (number in the right field) points are read, for each scan in the file.
Try to keep these numbers small, as otherwise you may lose detail from the point cloud.
Max Number of Points
When Filter Type is Maximum, do not read more points than the specified number. These points will be sampled from the entire file.
Delete Invalid Points
Deletes every point in an "invalid group". Applies to E57 files only.
Enabling this option will restrict the node’s incremental reading capabilities, and can significantly increase subsequent cook times.
The origin of color data read from the file.
Do not read any color data.
From Point Cloud
Read color data from the point scans. When reading E57 files, an invalid group may be created.
Read color data from the embedded images. This data only exists in E57 files.
Include the intensity of the laser pulse that brought the point data. When reading E57 files, an invalid group may be created.
Row and Column
Include the row and column indices of the point cloud, if it is also represented in the file as a grid. This data only exists in E57 files.
Include the return index and the number of returns of the laser pulse that brought the point data.
Include the timestamps for when the laser pulse brought each point to the scanner. When reading E57 files, an invalid group may be created.
Include the surface normals of the points. This data only exists in E57 files.
For E57 files, include the rigid transforms associated with each scan. These are created as matrix4 detail attributes named "<prefix>transform1", "<prefix>transform2", etc. where <prefix> is the value specified in the Group Prefix parameter.
For E57 files, create the string array global attribute, scannames, that lists the names of the scans in the same order that the groups are numbered. Not all scans have names; if a name is missing, then its corresponding value in the array will be the empty string.