BuildIndexFromUSGSProjectIndexItem: LidarIndexR - Create spatial index by reading LAS/LAZ file...

BuildIndexFromUSGSProjectIndexItemR Documentation

LidarIndexR – Create spatial index by reading LAS/LAZ file headers associated with a USGS project index item.

Description

Longer description

Usage

BuildIndexFromUSGSProjectIndexItem(
  projectItem,
  folderName,
  outputFile,
  projString = NULL,
  outputCRS = NULL,
  fileType = "\\.las|\\.laz",
  dirFormat = "ls",
  appendCols = c("workunit_id", "ql", "collect_start", "collect_end", "p_method",
    "horiz_crs", "vert_crs"),
  dimensionThreshold = 50000,
  rebuild = FALSE,
  quiet = FALSE
)

Arguments

projectItem

Data frame of sf object with information for a single USGS lidar project as found in the USGS FESM index.

folderName

Folder name on the baseURL containing LAS/LAZ files.

outputFile

Full path and file name on the local file system for the index file.

projString

A valid projection string that can be used with the crs parameter in st_sf. projString should represent the projection of the point data. If using EPSG codes, do not enclose the EPSG number in quotes.

outputCRS

A valid projection string that can be used with the crs parameter in st_transform to reproject the index.

fileType

Any valid string for the pattern parameter in grep(). "$" will be appended to the string to search for file/folder names ending with values in fileType.

dirFormat

String indicating the expected directory format for the URL. Valid values are "dir" if the URL returns the Date, Time, Attribute/Size, and file name; "ls" if the URL returns directory information similar to the UNIX ls -al command; or "" if you want the function to try to determine the directory format.

appendCols

List of column numbers or column names for information from the projectItem to append to individual tile records in the index. If column names conflict with existing column names, they will be adjusted to remove the conflict. if NULL, no column information is appended.

dimensionThreshold

Size threshold used to omit files from the index. This is intended to help omit invalid LAS.LAZ files from the index. If the height or width of the point tile exceeds the threshold, the tile will ne omitted.

rebuild

Boolean. If TRUE, the index is always created. If FALSE, the index is only created if it does not already exist.

quiet

Boolean to control display of status information. If TRUE, information is not displayed. Otherwise, status information is displayed.

Value

Boolean indicating success (TRUE) or failure (FALSE).

Examples

## Not run: 
BuildIndexFromUSGSProjectIndexItem()

## End(Not run)

bmcgaughey1/LidarIndexR documentation built on April 14, 2025, 6:07 p.m.