db_get_las_bounds: Query bounding polygons of imported LAS images

Description Usage Arguments Value

View source: R/db_functions.R

Description

This function queries the 'las_metadata' table with optional subsetting based on LAS image file names and/or capture dates. It returns an 'sf' spatial data frame containing the source file name, start and end capture dates and times, and bounding rectangle of the point cloud as a polygon. If no file name or date constraints are specified, all records in the table are returned.

Usage

1
2
3
4
5
6
7
8
db_get_las_bounds(
  dbsettings,
  mapnames = NULL,
  with.purpose = c("general", "postfire", "all"),
  file.pattern = NULL,
  capture.start = NULL,
  capture.end = NULL
)

Arguments

dbsettings

A named list of database connection settings returned by db_connect_postgis or db_create_postgis.

mapnames

An optional list of map names. The default (NULL) is to include all map names. Case is ignored.

with.purpose

One of 'general' (default) for general purpose imagery; 'postfire' for specially flown, post-fire imagery; or 'all' for all imagery. May be abbreviated.

file.pattern

A string pattern to match LAS source file names. Matching is done ignoring case. The pattern can be any of the following:

  • A plain string - to return file names containing this string;

  • An SQL string expression with '%' wildcard - e.g. 'Bega%5946%';

  • A regular expression - e.g. '^Bega.+5946'.

The default (NULL) means match any file name.

capture.start

Beginning of time window for LAS images. Can be specified as a character string or an object of class Date, POSIXct or POSIXlt. The default NULL means no start time constraint.

capture.end

End of time window for LAS images. Can be specified as a character string or an object of class Date, POSIXct or POSIXlt. The default NULL means no end time constraint.

Value

An 'sf' spatial data frame containing the source file name, start and end capture dates and times, and bounding rectangle of the point cloud as a polygon.


mbedward/CERMBlidarpostgis documentation built on Nov. 14, 2021, 7:15 p.m.