Skip to contents

Read a bathymetric or elevation raster

Source: R/input.R
read_bathy.Rd

Reads a local raster file with terra::rast() and optionally validates that the result is usable as a bathymetric or elevation surface.

Usage

read_bathy(path, ..., check = TRUE)

Arguments

path

Local raster file path.

...

Additional arguments passed to terra::rast().

check

Logical. If TRUE, validate the raster before returning it.

Value

A terra::SpatRaster.

Details

read_bathy() is data-source agnostic. The input can be any local raster format supported by terra, including GeoTIFF and many GDAL-readable files. The function treats the raster as a user-supplied terrain surface and preserves its values, CRS, resolution, and vertical sign convention.

See also

as_bathy(), validate_bathy(), prepare_bathy()

Examples

path <- blueterra_example("bathy")
bathy <- read_bathy(path)
bathy
#> class       : SpatRaster
#> size        : 90, 190, 1  (nrow, ncol, nlyr)
#> resolution  : 19.98372, 19.98372  (x, y)
#> extent      : 134960.3, 138757.2, 204151.7, 205950.2  (xmin, xmax, ymin, ymax)
#> coord. ref. : NAD83 / Puerto Rico & Virgin Is. (EPSG:32161)
#> source      : laparguera_slope_bathy.tif
#> name        :     bathy_m
#> min value   : -427.298889
#> max value   :  -15.878815