IntensityImage: FUSION R command line interface - Creates images using the...

In bmcgaughey1/fusionwrapr: R Interface to FUSION-LTK Command Line Programs

FUSION R command line interface – Creates images using the intensity values from a point cloud.

Description

IntensityImage creates command lines for the FUSION IntensityImage program and optionally executes them.

Usage

IntensityImage(
  cellsize = NULL,
  imagefile = NULL,
  datafile = NULL,
  quiet = FALSE,
  verbose = FALSE,
  version = FALSE,
  newlog = FALSE,
  log = NULL,
  locale = FALSE,
  nolaszipdll = FALSE,
  skipfilecheck = FALSE,
  minint = NULL,
  maxint = NULL,
  intrange = NULL,
  intcell = NULL,
  void = NULL,
  allreturns = FALSE,
  lowest = FALSE,
  lowall = FALSE,
  saveint = FALSE,
  rasterorigin = FALSE,
  diskonly = FALSE,
  hist = FALSE,
  jpg = FALSE,
  projection = NULL,
  class = NULL,
  ignoreoverlap = FALSE,
  use64bit = TRUE,
  runCmd = TRUE,
  saveCmd = TRUE,
  cmdFile = NULL,
  cmdClear = FALSE,
  echoCmd = FALSE,
  comment = NULL
)

Arguments

cellsize	numeric (required): Pixel size for the intensity image (same units as LIDAR data).
imagefile	character (required): Name for the image file.
datafile	character (required): Name(s) of lidar data files.
quiet	boolean: Suppress all output during the run.
verbose	boolean: Display all status information during the run.
version	boolean: Report version information and exit with no processing.
newlog	boolean: Erase the existing log file and start a new log
log	character: Use the name specified for the log file.
locale	boolean: Adjust program logic to input and output locale-specific numeric formats (e.g. use a comma for the decimal separator).
nolaszipdll	boolean: Suppress the use of the LASzip dll (c) Martin Isenburg... removes support for compressed LAS (LAZ) files. This option is only useful for programs that read or write point files.
skipfilecheck	boolean: Skip logic that checks for valid point files and removes those that are invalid prior to the start of point processing. This option is designed to overcome some limitations with windows and wildcard processing. This option is only useful for programs that read point data.
minint	numeric: Minimum intensity percentile used for the image (default: 2.0).
maxint	numeric: Maximum intensity percentile used for the image (default: 98.0).
intrange	character: "min,max": Force the scaling of intensity values using the specified min and max values. Setting the min value to -1 should force the output range to start with 1 instead of 0. Doing this in combination with void="0,0,0" will allow you to identify areas with no data in the output image as they will have a value of 0 for all color bands.
intcell	numeric: Cell size multiplier for intermediate images.
void	character: "R,G,B": Color for areas with no data (default is red (255,0,0)).
allreturns	boolean: Use all returns to create the intensity image.
lowest	boolean: Use lowest return in pixel to assign intensity value...should be used with /allreturns for best effect.
lowall	boolean: Combines lowest=TRUE and allreturns=TRUE switches...will have no effect if used with either lowest=TRUE or allreturns=TRUE.
saveint	boolean: Save the intermediate image files.
rasterorigin	boolean: Force alignment to match other raster products generated from point data (offsets the origin of the image by 1/2 pixel.
diskonly	boolean: Do not attempt to read all returns into memory for processing.
hist	boolean: Produce the intensity histogram data files.
jpg	boolean: Save the intensity image using the JPEG format (default is BMP).
projection	character: "filename": Associate the specified projection filename with image products.
class	character: "#,#,#,...": LAS files only: Specifies that only points with classification values listed are to be included in the subsample. Classification values should be separated by a comma. e.g. (2,3,4,5) and can range from 0 to 31. If the first character in string is ~, the list is interpreted as the classes you DO NOT want included in the subsample. e.g. /class:~2,3 would include all class values EXCEPT 2 and 3.
ignoreoverlap	boolean: Ignore points with the overlap flag set (LAS V1.4+ format).
use64bit	boolean: indicates 64-bit version of the program should be used.
runCmd	boolean: indicates command line should be executed.
saveCmd	boolean: indicates command line should be written to a file.
cmdFile	character: contains the name of the file to which commands should be written.
cmdClear	boolean: indicates file for commands should be deleted (cleared) before the command line is written.
echoCmd	boolean: indicates command line should be displayed.
comment	character string containing comment to be written to command file before writing the actual command. Only used when runCmd = FALSE and saveCmd = TRUE. When written, there is always a blank line before the comment line in the command file.

Value

Return value depends on runCmd. if runCmd = TRUE, return value is the (invisible) integer value return from the operating system after running the command. if runCmd = FALSE, return value is the (invisible) command line.

Multiple Commands

LTKFunctions generate a separate command for each item when the required parameters are lists. This is useful when you want to use the same command and options but different input data and output files. However, this works only when the switches and options are the same for all commands (not lists). If you try to use a list of switches and/or options and a list of input files, you will produce commands using all sets of switches and/or options for every input file.

See Also

Other LTKFunctions: CSV2Grid(), CanopyMaxima(), CanopyModel(), Catalog(), ClipDTM(), ClipData(), CloudMetrics(), Cover(), DTMDescribe(), DensityMetrics(), FilterData(), FirstLastReturn(), GridMetrics(), GridSample(), GridSurfaceCreate(), GridSurfaceStats(), GroundFilter(), JoinDB(), MergeDTM(), MergeData(), MergeRaster(), RepairGridDTM(), ReturnDensity(), SplitDTM(), SurfaceSample(), SurfaceStats(), TINSurfaceCreate(), ThinData(), TopoMetrics(), TreeSeg(), fusionwrapr-package

Examples

## Not run: 
IntensityImage(2.0, "IntImage.jpg", "*.las", jpg = TRUE)

## End(Not run)

bmcgaughey1/fusionwrapr documentation built on Dec. 1, 2024, 7:13 a.m.