stacks_functions: Stacks functions
In e-sensing/EOCubes: Earth Observation Data Cubes Management and Client

Description Usage Arguments Details Value Functions See Also Examples

These functions provides basic operations to work with stacks. Stacks are a set of GeoTif reference locations organized by tile, date interval, and bands.

stacks(cube, bands = NULL, which = NULL, start_reference = NULL,
  stack_length = NULL, starts_interval = "12 months", from = NULL,
  to = NULL)

timeline_intervals(timeline, start_reference = NULL,
  stack_length = NULL, starts_interval = NULL)

stack_length(stacks)

prune_stacks(stacks, stack_length)

time_series(cube, longitude, latitude, bands = cube_bands(cube),
  from = NULL, to = NULL, crs = cube_crs(cube))

`cube`	A `EOCubes_cube` data structure.
`bands`	A `character` vector with band names to be retrieved.
`which`	A `logical` or `integer` vector indicating which tile to be stacked. If `NULL` (default) all tiles are stacked.
`start_reference`	A `Date` value used to compute the start dates of each break given the `starts_interval` parameter and the timeline of each tile.
`stack_length`	A `numeric` positive value informing the length of each stack.
`starts_interval`	A `character` value containing the interval between two consecutives breaks' start dates.
`from`	A `Date` value to filter dates.
`to`	A `Date` value to filter dates.
`timeline`	A `Date` vector representing all images' acquisition dates.
`stacks`	A `EOCubes_stacks` object.
`longitude`	A `numeric` value informing the longitute (X).
`latitude`	A `numeric` value informing the latitude (Y).
`crs`	An `integer` (EPSG code) or `character` (proj4)

The parameter which can be used to filter which tiles must be stacked, hence which tiles must be fetched. Fetching tiles can be an expensive task. You can filter tiles that intersects your area of interest by providing which parameter. The parameters from and to filter the range of timeline considered in stacking procedure. For all other parameters see the details of timeline_intervals function.

The function timeline_intervals generate an EOCubes_intervals object that represents a list of from/to dates indicating ranges. Each interval is computed considering a start date of reference (start_reference) which is used to mark many start dates throughout the timeline, according to an interval given by starts_interval parameter. Thereafter, the end 'marks' are computed so that each interval have the length given by stack_length parameter.

If no start_reference is informed, you must omit stack_length and starts_interval parameters. In this case, the interval will comprehends all timeline.

The from and to parameters defines an interval to filter timeseries length. The longitude and latitude parameters must be in crs projection. The default value for crs is the same as the cube crs.

An EOCubes_stacks object.

An EOCubes_intervals object.

A list of integer.

An EOCubes_stacks object.

An EOCubes_timeseries object.

stacks: Returns a new EOCubes_stacks object that represents stacks for each band and each date intervals.
timeline_intervals: Returns an EOCubes_intervals indicating where to break the timeline.
stack_length: Returns a list of integer with the lengths of each stack.
prune_stacks: Returns an EOCubes_stacks object where each stack has the same length given by stack_length.
time_series: Returns an EOCubes_timeseries object that represents a set of band timeseries from some date intervals.

remote, cube, tiles_which

x <- remote("localhost")
cub1 <- cube("MOD13Q1/006", x)
tiles_index <- tiles_which(cub1, "h12v10")
stk1 <- stacks(cub1, bands = c("evi", "ndvi"),
               which = tiles_index,
               start_reference = "2014-01-01", stack_length = 23,
               starts_interval = "year", from = "2013-06-01",
               to = "2015-06-01")
stack_length(stk1)
prune_stacks(stk1, 23)