CST_Summary: Generate a Summary of the data and metadata in the s2dv_cube...

View source: R/CST_Summary.R

CST_SummaryR Documentation

Generate a Summary of the data and metadata in the s2dv_cube object

Description

This function prints the summary of the data and metadata of an object of class s2dv_cube.

Usage

CST_Summary(data, show_loaded_files = FALSE, show_NA = FALSE, var_dim = "var")

Arguments

data

An s2dv_cube object containing: - data: N-dimensional array with named dimensions - dim: Dimensions, including var (variables). - attrs: Attributes such as VarName and Metadata. - coords: Named list with coordinates of dimensions.

show_loaded_files

A logical value indicating if the names of the loaded files will be displayed in the output or not. Default = FALSE.

show_NA

A logical value indicating if details of NA values in the loaded object will be displayed in the output or not. Default = FALSE.

var_dim

A character string indicating the name of the variable dimension. Default = "var".

Details

The function uses the data and metadata from the loaded s2dv_cube object to generate a summary of the object.The summary includes : - months: Months that have been loaded. - range: Range of the dates that have been loaded. - dimensions: Object dimensions. - Statistical summary of the data in data: Basic statistical summary of the data. - Variable: Loaded Variables, along with their units (units:) - NA-Indices per Dimension: Index with NA values per dimension - Number of NAs in NA-Indices per Dimensions: Number of NAs, in the Indices with NA values per dimension - Loaded files: Successfully loaded Files

Value

Does not return a value. This function prints a detailed summary of an s2dv_cube object to the console.

Author(s)

Theertha Kariyathan, theertha.kariyathan@bsc.es

See Also

CST_Start or s2dv_cube for creating an s2dv cube object.

Examples

# Example 1:
CST_Summary(data = lonlat_temp_st$exp)

# Example 2:
## Not run: 
# s2dv cube paths
repos1 <- "/esarchive/exp/ecmwf/system4_m1/monthly_mean/$var$_f6h/$var$_$sdate$.nc"
repos2 <- "/esarchive/exp/ecmwf/system5_m1/monthly_mean/$var$_f6h/$var$_$sdate$.nc"

# Create data cube
data <- CST_Start(dat = list(
                  list(name = 'system4_m1', path = repos1),
                  list(name = 'system5_m1', path = repos2)),
                  var = c('tas', 'sfcWind'),
                  sdate = '20170101',
                  ensemble = indices(1),
                  time = indices(1:3),
                  lat = indices(1:5),
                  lon = indices(1:5),
                  synonims = list(lat = c('lat', 'latitude'),
                                  lon = c('lon', 'longitude')),
                  return_vars = list(time = 'sdate',
                                     longitude = 'dat',
                                     latitude = 'dat'),
                  metadata_dims = c('dat', 'var'),
                  retrieve = TRUE)

# Generate summary
CST_Summary(data)

## End(Not run)


CSTools documentation built on Nov. 14, 2025, 5:07 p.m.