Learn R Programming

terra (version 1.8-54)

sds: Create a SpatRasterDataset

Description

Methods to create a SpatRasterDataset. This is an object to hold "sub-datasets", each represented by a SpatRaster that may have multiple layers. All sub-datasets must have the same raster geometry (extent and resolution). You can use a SpatRasterCollection (see sprc) to combine SpatRasters with different geometries.

See describe for getting information about the sub-datasets present in a file.

Usage

# S4 method for missing
sds(x) 

# S4 method for character sds(x, ids=0, opts=NULL, raw=FALSE, noflip=FALSE, guessCRS=TRUE, domains="")

# S4 method for SpatRaster sds(x, ...)

# S4 method for list sds(x)

# S4 method for array sds(x, crs="", extent=NULL)

Value

SpatRasterDataset

Arguments

x

character (filename), or SpatRaster, or list of SpatRasters, or missing. If multiple filenames are provided, it is attempted to make SpatRasters from these, and combine them into a SpatRasterDataset

ids

optional. vector of integer subdataset ids. Ignored if the first value is not a positive integer

opts

character. GDAL dataset open options

raw

logical. If TRUE, scale and offset values are ignored

noflip

logical. If TRUE, a raster (e.g. JPEG image) that is not georeferenced and that GDAL assigns a flipped extent to (ymax < ymin), is not considered flipped. This avoids the need to flip the raster vertically

guessCRS

logical. If TRUE and the file does not specify a CRS but has an extent that is within longitude/latitude bounds, the longitude/latitude crs is assigned to the SpatRaster

domains

character. Metadata domains to read (see metags to retrieve their values if there are any). "" is the default domain

crs

character. Description of the Coordinate Reference System (map projection) in PROJ.4, WKT or authority:code notation. If this argument is missing, and the x coordinates are within -360 .. 360 and the y coordinates are within -90 .. 90, longitude/latitude is assigned

extent

SpatExtent

...

additional SpatRaster objects

See Also

sprc, describe

Examples

Run this code
s <- rast(system.file("ex/logo.tif", package="terra"))   
x <- sds(s, s/2)
names(x) <- c("first", "second")
x
length(x)

# extract the second SpatRaster
x[2]

a <- array(1:9, c(3,3,3,3))
sds(a)

Run the code above in your browser using DataLab