Create a proxy data cube, which renames specific bands of a data cube.
Usage
rename_bands(cube, ...)
Arguments
Argument
Description
cube
source data cube
…
named arguments with bands that will be renamed, see Details
Details
The result data cube always contains the same number of bands. No subsetting is done if only names for some of the bands are provided. In this case, only provided bands are renamed whereas other bands keep their original name. Variable arguments must be named by the old band name and the new names must be provided as simple character values (see example).
Value
proxy data cube object
Note
This function returns a proxy object, i.e., it will not start any computations besides deriving the shape of the result.
Examples
# create image collection from example Landsat data only # if not already done in other examplesif (!file.exists(file.path(tempdir(), "L8.db"))) { L8_files <-list.files(system.file("L8NY18", package ="gdalcubes"),".TIF", recursive =TRUE, full.names =TRUE)create_image_collection(L8_files, "L8_L1TP", file.path(tempdir(), "L8.db"), quiet =TRUE) }L8.col =image_collection(file.path(tempdir(), "L8.db"))v =cube_view(extent=list(left=388941.2, right=766552.4, bottom=4345299, top=4744931, t0="2018-04", t1="2018-07"),srs="EPSG:32618", nx =497, ny=526, dt="P1M")L8.cube =raster_cube(L8.col, v) L8.rgb =select_bands(L8.cube, c("B02", "B03", "B04"))L8.rgb
A data cube proxy object
Dimensions:
low high count pixel_size chunk_size
t 2018-04-01 2018-07-31 4 P1M 1
y 4345299 4744931 526 759.756653992395 384
x 388941.2 766552.4 497 759.781086519115 384
Bands:
name offset scale nodata unit
1 B02 0 1 NaN
2 B03 0 1 NaN
3 B04 0 1 NaN
A data cube proxy object
Dimensions:
low high count pixel_size chunk_size
t 2018-04-01 2018-07-31 4 P1M 1
y 4345299 4744931 526 759.756653992395 384
x 388941.2 766552.4 497 759.781086519115 384
Bands:
name offset scale nodata unit
1 blue 0 1 NaN
2 green 0 1 NaN
3 red 0 1 NaN
Source Code
# rename_bandsRename bands of a data cube```{r include=FALSE}library(gdalcubes)```## DescriptionCreate a proxy data cube, which renames specific bands of a data cube.## Usage```rrename_bands(cube, ...)```## Arguments| Argument | Description ||:------------|:----------------------------------|| cube | source data cube || ... | named arguments with bands that will be renamed, see Details |## DetailsThe result data cube always contains the same number of bands. No subsetting is done if only names for some of the bands are provided. In this case, only provided bands are renamed whereas other bands keep their original name. Variable arguments must be named by the old band name and the new names must be providedas simple character values (see example).## Valueproxy data cube object## NoteThis function returns a proxy object, i.e., it will not start any computations besides deriving the shape of the result.## Examples```{r}# create image collection from example Landsat data only # if not already done in other examplesif (!file.exists(file.path(tempdir(), "L8.db"))) { L8_files <-list.files(system.file("L8NY18", package ="gdalcubes"),".TIF", recursive =TRUE, full.names =TRUE)create_image_collection(L8_files, "L8_L1TP", file.path(tempdir(), "L8.db"), quiet =TRUE) }L8.col =image_collection(file.path(tempdir(), "L8.db"))v =cube_view(extent=list(left=388941.2, right=766552.4, bottom=4345299, top=4744931, t0="2018-04", t1="2018-07"),srs="EPSG:32618", nx =497, ny=526, dt="P1M")L8.cube =raster_cube(L8.col, v) L8.rgb =select_bands(L8.cube, c("B02", "B03", "B04"))L8.rgbL8.rgb =rename_bands(L8.cube, B02 ="blue", B03 ="green", B04 ="red")L8.rgb```