CreatePointCloudSubProject Task
This task divides an existing ENVI LiDAR project into a number of subprojects for simultaneous processing by a number of ENVI Services Engine (ESE) workers. The creation of multiple projects for processing by multiple ESE workers is necessary to prevent project corruption due to concurrent access. The spatial division of the input ENVIPointCloud object into new subprojects is controlled by the SUB_RECT property, but the data extents of the subprojects will always be rounded up to the next 32 x 32 meter tile boundary.
Example
The following example code creates four sub-projects that could be used by ESE workers.
; Start the application
e = ENVI(/HEADLESS)
; Open a file
file = FILEPATH('DataSample.las', ROOT_DIR=e.ROOT_DIR, $
SUBDIRECTORY = ['data','lidar'])
pointcloud = e.OpenPointCloud(file, $
PROJECT_URI=Filepath('DataSample', /TMP))
dataRange = pointcloud.DATA_RANGE
dataRangeX = dataRange[3] - dataRange[0]
dataRangeY = dataRange[4] - dataRange[1]
dataCenterX = dataRange[0] + (dataRangeX * 0.5)
dataCenterY = dataRange[1] + (dataRangeY * 0.5)
; Create 4 subprojects, each spanning approximately a quarter of the data extents
; Note the actual subproject data extents will be rounded up to the next 32 x 32 meter tile boundary
subProjectDataRange1 = [dataRange[0], dataRange[1], dataCenterX, dataCenterY]
subProjectDataRange2 = [dataCenterX, dataRange[1], dataRange[3], dataCenterY]
subProjectDataRange3 = [dataRange[0], dataCenterY, dataCenterX, dataRange[4]]
subProjectDataRange4 = [dataCenterX, dataCenterY, dataRange[3], dataRange[4]]
subProjectUri1 = 'C:\DataSampleSubset1\DataSampleSubset1.ini'
subProjectUri2 = 'C:\DataSampleSubset2\DataSampleSubset2.ini'
subProjectUri3 = 'C:\DataSampleSubset3\DataSampleSubset3.ini'
subProjectUri4 = 'C:\DataSampleSubset4\DataSampleSubset4.ini'
task = ENVITask('CreatePointCloudSubProject')
task.INPUT_POINT_CLOUD = pointcloud
task.Execute, URI=subProjectUri1, SUB_RECT=subProjectDataRange1, ERROR=error
task.Execute, URI=subProjectUri2, SUB_RECT=subProjectDataRange2, ERROR=error
task.Execute, URI=subProjectUri3, SUB_RECT=subProjectDataRange3, ERROR=error
task.Execute, URI=subProjectUri4, SUB_RECT=subProjectDataRange4, ERROR=error
; only one dataset open at a time
pointcloud.Close
; open each subproject and print the data extents
subProject1 = e.OpenPointCloud(subProjectUri1)
subDataRange1 = subProject1.DATA_RANGE
subProject1.Close
subProject2 = e.OpenPointCloud(subProjectUri2)
subDataRange2 = subProject2.DATA_RANGE
subProject2.Close
subProject3 = e.OpenPointCloud(subProjectUri3)
subDataRange3 = subProject3.DATA_RANGE
subProject3.Close
subProject4 = e.OpenPointCloud(subProjectUri4)
subDataRange4 = subProject4.DATA_RANGE
subProject4.Close
; print data ranges for the subprojects
print, subDataRange1
print, subDataRange2
print, subDataRange3
print, subDataRange4
Syntax
Result = ENVITask('CreatePointCloudSubProject')
Input properties (Set, Get): INPUT_POINT_CLOUD, SUB_RECT, URI
Output properties (Get only): None
Properties marked as "Set" are those that you can set to specific values. You can also retrieve their current values any time.
Methods
This task inherits the following methods from ENVITask:
Properties
This task inherits the following properties from ENVITask:
This task also contains the following properties:
INPUT_POINT_CLOUD
An ENVIPointCloud object that references the project that the subprojects will be created from.
SUB_RECT
A four-element double-precision array expressing the spatial range of the required subproject. Specify the values in the coordinate system used by the ENVIPointCloud SPATIALREF property. The array is of the form [x1, y1, x2, y2], where:
- x1 = the minimum X value to include in the subproject
- y1 = the minimum Y value to include in the subproject
- x2 = the maximum X value to include in the subproject
- y2 = the maximum Y value to include in the subproject
The actual data extents of the created subproject will be rounded up to the next 32 x 32 meter tile boundary.
If the SUB_RECT property is not specified, then the entire data extents of the original point cloud object are used.
URI
A scalar string that is a fully-qualified path and name of the new subproject .ini
file.
Version History
ENVI 5.3 |
Introduced |
API Version
4.2
See Also
ENVITask, ENVI::OpenPointCloud, ENVIPointCloud, ENVIPointCloudProductsInfo, ENVIPointCloudQuery, ENVISpatialSubsetPointCloud, ENVIPointCloudSpatialRef, ENVIPointCloudViewer, ENVIPointCloudFilter, ENVIPointCloudMetadata, PointCloudFeatureExtraction Task, ColorPointCloud Task, CreatePointCloud Task