Convert LAS (Conversion)

Summary

Converts .las, .zlas, and .laz files between different LAS compression methods, file versions, and point record formats.

Usage

• This tool converts point cloud data in .las, .zlas, and .laz files. The output files can be created in a different file version and point record format, as long as the output supports the full range of classification codes and flags in the input. For example, if the input has file version 1.1 with point record format 1, it can be upgraded to file version 1.4 with point record format 6, but a version 1.4 file cannot be converted to an earlier version. Attributes from the input .las files that are not supported by the output will be lost.

• This tool is for converting entire .las files. Any layer filter settings that may be defined for the input LAS dataset will be ignored. To filter points by any combination of classification codes, classification flags, and return values, use the Extract LAS tool.

• Many .las, .zlas, and .laz files store the points in a manner that does not correspond with the spatial distribution of the data, resulting in a degraded display and analysis performance when reading the relatively scattered point records in a given spatial extent. The impact of this performance degradation is worsened by the size of the file being read: a large file with scattered records will take longer to process than a smaller file. It is recommended that you create the output files using the Rearrange Points option of the LAS Options parameter so that the binary records are stored in spatial clusters that are optimized for data access. This will usually improve performance. Rearranging points will extend this tool's overall processing time, as an intermediate .las file is created in the process, but the long-term advantages typically outweigh its one-time impact during file creation. The rearranged state of the data is also preserved in the .las file header and communicated in the .las file properties on the LAS dataset properties dialog box.

Parameters

Dialog

Label	Explanation	Data Type
Input LAS	The .las, .zlas, or .laz files that will be converted. Multiple files can be processed by specifying the folder containing the files or a LAS dataset.	Layer File; LAS Dataset Layer; Folder; File
Target Folder	The existing folder where the output files will be written.	Folder
File Version (Optional)	Specifies the file version that will be used for the output files. Same As Input—The output file version will be the same as the input. This is the default. 1.0—The base version for the LAS format that supported 256 class codes will be used. 1.1—The output file version will be 1.1. Class codes were reduced to 32, but support for classification flags was added. 1.2—The output file version will be 1.2. Support for red-green-blue (RGB) color channels and GPS time was added. 1.3—The output file version will be 1.3. Storage of lidar waveform data for point record formats that are not supported in the ArcGIS platform was added. 1.4— The output file version will be 1.4. Support for coordinate system definition using Well Known Text (WKT) convention, 256 class codes, up to 15 discrete returns per pulse, higher precision scan angle, and overlap classification flag was added.	String
Point Format (Optional)	Specifies the point record format that will be used for the output files. The available options will vary based on the output LAS format file version. 0—The base type for storing discrete LAS points that supports attributes such as lidar intensity, return values, scan angle, scan direction, and edge of flight line will be used. 1—GPS time is added to the attributes supported in point format 0, which will be used. 2—RGB values are added to the attributes supported in point format 0, which will be used. 3—RGB values and GPS time are added to the attributes supported in point format 0, which will be used. 6—The preferred base type for storing discrete LAS points in LAS file version 1.4 will be used. 7—RGB values are added to the attributes supported in point format 6, which will be used. 8—RGB and near-infrared values are added to the attributes supported in point format 6, which will be used.	String
Compression (Optional)	Specifies whether the output files will be stored in a compressed or uncompressed format. No Compression—Output files will be in the uncompressed LAS format (*.las). This format supports edits to classification codes and flags. This is the default. zLAS Compression—Output files will be compressed in the zLAS format (*.zlas). This format supports edits to classification codes and flags. LAZ Compression—Output files will be compressed in the LAZ format (*.laz). Edited zLAS to Non-Edited zLAS—Edited .zlas files will be converted to unedited .zlas files. Creating unedited *.zlas files preserves the classification edits while allowing the files to be usable in ArcGIS Pro 3.1 and earlier. When this option is used on a LAS dataset referencing any combination of .las files, edited .zlas files, and unedited .zlas files, only the edited .zlas files will be processed.	String
LAS Options (Optional)	Specifies the modifications that will be made to the output files that will reduce their size and improve their performance in display and analysis. Rearrange Points—Points will be rearranged to improve display and analysis performance. Statistics will be automatically computed during this process. This is the default. Remove Variable Length Records—Variable-length records that are added after the header as well as the points records of each file will be removed. Remove Extra Bytes—Extra bytes that may be present with each point from the input file will be removed.	String
Output LAS Dataset (Optional)	The output LAS dataset referencing the newly created .las files.	LAS Dataset
Define Input Coordinate System (Optional)	Specifies how the coordinate system of each input file will be defined. No LAS Files—The coordinate system of each input file will be defined by the information in its header. Any file that lacks spatial reference information will be treated as having an unknown coordinate system. This is the default. All LAS Files—The coordinate system of each input file will be defined by the Input Coordinate System parameter. LAS Files with No Spatial Reference—The coordinate system of any input file that does not have spatial reference information in its header will be defined by the Input Coordinate System parameter. No LAS Files—The coordinate system of each input file will be defined by the information in its header. Any file that lacks spatial reference information will be treated as having an unknown coordinate system. This is the default. All LAS Files—The coordinate system of each input file will be defined by the in_coordinate_system parameter. LAS Files with No Spatial Reference—The coordinate system of any input file that does not have spatial reference information in its header will be defined by the in_coordinate_system parameter.	String
Input Coordinate System (Optional)	The coordinate system that will be used to define the spatial reference of some or all input files based on the Define Input Coordinate System parameter value.	Coordinate System

Python

arcpy.conversion.ConvertLas(in_las, target_folder, {file_version}, {point_format}, {compression}, {las_options}, {out_las_dataset}, {define_coordinate_system}, {in_coordinate_system})

Name	Explanation	Data Type
in_las	The .las, .zlas, or .laz files that will be converted. Multiple files can be processed by specifying the folder containing the files or a LAS dataset.	Layer File; LAS Dataset Layer; Folder; File
target_folder	The existing folder where the output files will be written.	Folder
file_version (Optional)	Specifies the file version that will be used for the output files. SAME_AS_INPUT—The output file version will be the same as the input. This is the default. 1.0—The base version for the LAS format that supported 256 class codes will be used. 1.1—The output file version will be 1.1. Class codes were reduced to 32, but support for classification flags was added. 1.2—The output file version will be 1.2. Support for red-green-blue (RGB) color channels and GPS time was added. 1.3—The output file version will be 1.3. Storage of lidar waveform data for point record formats that are not supported in the ArcGIS platform was added. 1.4— The output file version will be 1.4. Support for coordinate system definition using Well Known Text (WKT) convention, 256 class codes, up to 15 discrete returns per pulse, higher precision scan angle, and overlap classification flag was added.	String
point_format (Optional)	Specifies the point record format that will be used for the output files. The available options will vary based on the output LAS format file version. 0—The base type for storing discrete LAS points that supports attributes such as lidar intensity, return values, scan angle, scan direction, and edge of flight line will be used. 1—GPS time is added to the attributes supported in point format 0, which will be used. 2—RGB values are added to the attributes supported in point format 0, which will be used. 3—RGB values and GPS time are added to the attributes supported in point format 0, which will be used. 6—The preferred base type for storing discrete LAS points in LAS file version 1.4 will be used. 7—RGB values are added to the attributes supported in point format 6, which will be used. 8—RGB and near-infrared values are added to the attributes supported in point format 6, which will be used.	String
compression (Optional)	Specifies whether the output files will be stored in a compressed or uncompressed format. NO_COMPRESSION—Output files will be in the uncompressed LAS format (*.las). This format supports edits to classification codes and flags. This is the default. ZLAS—Output files will be compressed in the zLAS format (*.zlas). This format supports edits to classification codes and flags. LAZ—Output files will be compressed in the LAZ format (*.laz). EDITED_ZLAS_TO_NON_EDITED—Edited .zlas files will be converted to unedited .zlas files. Creating unedited *.zlas files preserves the classification edits while allowing the files to be usable in ArcGIS Pro 3.1 and earlier. When this option is used on a LAS dataset referencing any combination of .las files, edited .zlas files, and unedited .zlas files, only the edited .zlas files will be processed.	String
las_options [las_options,...] (Optional)	Specifies the modifications that will be made to the output files that will reduce their size and improve their performance in display and analysis. REARRANGE_POINTS—Points will be rearranged to improve display and analysis performance. Statistics will be automatically computed during this process. This is the default. REMOVE_VLR—Variable-length records that are added after the header as well as the points records of each file will be removed. REMOVE_EXTRA_BYTES—Extra bytes that may be present with each point from the input file will be removed.	String
out_las_dataset (Optional)	The output LAS dataset referencing the newly created .las files.	LAS Dataset
define_coordinate_system (Optional)	Specifies how the coordinate system of each input file will be defined. NO_FILES—The coordinate system of each input file will be defined by the information in its header. Any file that lacks spatial reference information will be treated as having an unknown coordinate system. This is the default. ALL_FILES—The coordinate system of each input file will be defined by the in_coordinate_system parameter. FILES_MISSING_PROJECTION—The coordinate system of any input file that does not have spatial reference information in its header will be defined by the in_coordinate_system parameter.	String
in_coordinate_system (Optional)	The coordinate system that will be used to define the spatial reference of some or all input files based on the define_coordinate_system parameter value.	Coordinate System

Code sample

ConvertLas example 1 (Python window)

The following sample demonstrates the use of this tool in the Python window.

import arcpy
arcpy.conversion.ConvertLas('2014_survey.zlas', '2014_unclassified_collection', 
                            '1.4', 7, 'NO_COMPRESSION',
                            ['REMOVE_VLR', 'REMOVE_EXTRA_BYTES', 'REARRANGE_POINTS'], 
                            '2014_unclassified_collection/2014_Survey_Collection.lasd')

Environments

Current Workspace, Scratch Workspace