Skip to contents

Compute three-dimensional cell volumes for an ocean cube

Source: R/cube_grid_geometry.R
cube_cell_volume.Rd

Volumes combine geodesic horizontal cell areas with explicit vertical layer thicknesses. No scientific cube values are read or aggregated; the result is grid geometry, not a spatial indicator.

Usage

cube_cell_volume(x, depth_bounds = NULL, unit = c("m3", "km3"))

Arguments

x

An ocean_cube() with rectilinear horizontal coordinates and a finite depth axis.

depth_bounds

Explicit vertical interfaces or paired bounds. If NULL, metadata attached to the cube is used.

unit

Output unit, either cubic metres ("m3") or cubic kilometres ("km3").

Value

A longitude-by-latitude-by-depth numeric array.

Details

This operation is valid only for rectilinear horizontal cells and dimensional metric ocean depth with explicit valid bounds. CF height, pressure, dimensionless, and parametric vertical coordinates cannot be used as geometric thickness.