Skip to main content

LIDAR_APPLY_COLOR

Updated

LIDAR_APPLY_COLOR

The LIDAR_APPLY_COLOR command applies RGB(I) colors to points in a point cloud from a reference image. This command requires the LiDAR add-on license.

The command supports the following parameters:

  • FILENAME - specifies the LiDAR layer(s) to colorize. You can use * to use all loaded raster imagery layers. This is the default. This parameter can be listed more than once to specify multiple input files, like FILENAME="FILENAME_1" FILENAME="FILENAME_2". You can also pass in the description of the layer if it isn't based on a file, such as a layer created by the script. When running the script in the context of the main map view (including loading a workspace) you can also pass in the value 'USER CREATED FEATURES' to have the 'User Created Features' layer updated or 'SELECTED LAYERS' to have any layers selected in the Control Center.
  • COLOR_LAYER - specifies the source raster image or elevation layer for color values. This parameter can be listed more than once to specify multiple input files. The default is to use all loaded raster image and elevation data.
  • APPLY_NIR - indicates whether to apply the NIR band in addition to RGB. Specify YES or TRUE, or list the parameter without a value to include NIR.
  • APPLY_TO_ALREADY_COLORED_LIDAR - indicates whether to apply colors to layers that already have colors. Specify YES or TRUE, or list the parameter without a value to overwrite existing colors.
  • COLOR_INTENSITY - use this to set the intensity of the lidar points from the images. The following values are supported:
    • GRAY - set the intensity from the grayscale equivalent of the pixel color
    • RED - set the intensity from the red band
    • GREEN - set the intensity from the green band
    • BLUE - set the intensity from the blue band
  • BAND_EXPORT_SETUP - defines the raster bands to use for colors. Required if APPLY_NIR is TRUE. Use the following format to specify what band from what layer to use for a given export band: output_band?input_band?layer_filename . So for example to assign the 4th (infrared) band in an export from the 1st (red) band in a previously loaded file name C:\data\input_file.tif, use the following parameter: BAND_EXPORT_SETUP="4?1?c:\data\input_file.tif". Note that you would include a separate BAND_EXPORT_SETUP parameter for each output band that you want to setup. If you leave off the filename then you all loaded data will be considered as input, with just the input-to-output band assignment being updated.
  • NUM_BANDS - indicates the number of BAND_EXPORT_SETUP commands. Required if APPLY_NIR is TRUE.

SAMPLE

Here is an example for applying color to lidar from separate COLOR_LAYER image bands:

LIDAR_APPLY_COLOR FILENAME="V:\LIDAR\Vermont\USGS_LPC_VT_EasternVermont_L1_2014_EVT2837_LAS_2017.laz" \
COLOR_LAYER="R:\Landsat8\LC80140292014203LGN00_B2.TIF" COLOR_LAYER="R:\Landsat8\LC80140292014203LGN00_B3.TIF" \
COLOR_LAYER="R:\Landsat8\LC80140292014203LGN00_B4.TIF" BAND_EXPORT_SETUP="1?1?R:\Landsat8\LC80140292014203LGN00_B2.TIF" \
BAND_EXPORT_SETUP="2?1?R:\Landsat8\LC80140292014203LGN00_B3.TIF" BAND_EXPORT_SETUP="3?1?R:\Landsat8\LC80140292014203LGN00_B4.TIF" \
NUM_BANDS="3" APPLY_NIR="NO" APPLY_TO_COLORED_LIDAR="YES"