MergeRaster: FUSION R command line interface - Merge ASCII raster files...

View source: R/MergeRaster.R

MergeRasterR Documentation

FUSION R command line interface – Merge ASCII raster files into a single ASCII raster file.

Description

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

Usage

MergeRaster(
  outputfile = NULL,
  inputfile = NULL,
  quiet = FALSE,
  verbose = FALSE,
  version = FALSE,
  newlog = FALSE,
  log = NULL,
  locale = FALSE,
  overlap = NULL,
  compare = FALSE,
  precision = NULL,
  nodata = NULL,
  use64bit = TRUE,
  runCmd = TRUE,
  saveCmd = TRUE,
  cmdFile = NULL,
  cmdClear = FALSE,
  echoCmd = FALSE,
  comment = NULL
)

Arguments

outputfile

character (required): Name for the output ASCII raster file containing the merged data.

inputfile

character (required): File name template for ASCII raster files to be merged, a list of ASCII raster file names, or text file containing a list of ASCII raster file names with the ".txt" extension. If you are specifying a single input file on the command line, the file extension cannot be ".txt".

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).

overlap

character: Specify how overlap areas should be treated. Operators are: "average", "min", "max", "add", "new." The new operator populates a pixel using the value from the last .DTM file containing ASCII raster file containing valid data for the pixel.

compare

boolean: Reports if values in cells common to two or more input files are different by more than 0.001.

precision

numeric: Output value with # digits to the right of the decimal point. Default precision is 4 digits.

nodata

numeric: Use value (#) to indicate no data in the output file. Default NODATA value is -9999.

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(), IntensityImage(), JoinDB(), MergeDTM(), MergeData(), RepairGridDTM(), ReturnDensity(), SplitDTM(), SurfaceSample(), SurfaceStats(), TINSurfaceCreate(), ThinData(), TopoMetrics(), TreeSeg(), fusionwrapr-package

Examples

## Not run: 
MergeRaster("merged_grnd.asc", "*.asc")

## End(Not run)

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