check_names() verifies whether LAS/LAZ/COPC file names conform to the
German AdV standard for tiled LiDAR data. File names are expected to
follow the schema: prefix_utmzone_minx_miny_tilesize_region_year.laz.
Example: 3dm_32_547_5724_1_ni_2024.laz.
See the ADV standard for details.
Usage
check_names(
path,
prefix = "3dm",
region = NULL,
from_csv = NULL,
copc = FALSE,
full.names = FALSE
)Arguments
- path
Character vector. Paths to LAS/LAZ/COPC files, directories containing such files, or a VPC object already loaded in R.
- prefix
Character scalar. Naming prefix (default:
"3dm").- region
Optional character vector of two-letter region codes. If
NULL, the region is automatically inferred from file bounding boxes.- from_csv
Optional path to CSV file for year determination. If provided, used to match acquisition dates for tiles without GPStime.
- copc
Logical. Whether the files are expected to be COPC (
.copc.laz).- full.names
Logical. If
TRUE, returns full file paths inname_isandname_should; otherwise, only the base file names.
Value
A data.frame with one row per file and columns:
- name_is
Existing file name or path
- name_should
Expected file name according to AdV standard
- correct
Logical indicating whether the existing name matches the standard
Examples
folder <- system.file("extdata", package = "managelidar")
las_files <- list.files(folder, full.names = TRUE, pattern = "*20240327.laz")
las_files |> check_names()
#> Error in loadNamespace(x): there is no package called ‘lasR’