The extent
argument expects a simple list with elementes left
, right
, bottom
, top
, t0
(start date/time), t1
(end date/time) or an image collection object.
In the latter case, the extent
function is automatically called on the image collection object to get the full spatiotemporal extent of the collection. In the former case, datetimes
are expressed as ISO8601 datetime strings.
The function can be used in three different ways. First, if the cube argument is given, the function simply returns the data cube view of the provided cube and ignores any other values. Second, the function can
be used to create data cube views from scratch by defining the extent, the spatial reference system, and for each dimension either the cell size (dx, dy, dt) or the total number of cells (nx, ny, nt).
Third, the function can update an existing data cube view by overwriting specific fields. In this case, the extent or some elements of the extent may be missing.
In some cases, the extent of the view is automatically extended if the provided resolution would end within a pixel. For example,
if the spatial extent covers an area of 1km x 1km and dx = dy = 300m, the extent would be enlarged to 1.2 km x 1.2km. The alignment will be reported to the user in
a diagnostic message.