act.utils.convert_2d_to_1d¶
- act.utils.convert_2d_to_1d(ds, parse=None, variables=None, keep_name_if_one=False, use_dim_value_in_name=False, dim_labels=None)[source]¶
Function to convert a single 2D variable into multiple 1D variables using the second dimension in the new variable name.
- Parameters:
ds (xarray.dataset) – Object containing 2D variable to be converted
parse (str or None) – Coordinate dimension name to parse along. If set to None will guess the non-time dimension is the parse dimension.
variables (str or list of str) – Variable name or names to parse. If not provided will attempt to parse all two dimensional variables with the parse coordinate dimension.
keep_name_if_one (boolean) – Option to not modify the variable name if the coordinate dimension has only one value. Essentially converting a 2D (i.e. (100,1) variable into a 1D variable (i.e. (100)).
use_dim_value_in_name (boolean) – Option to use value from the coordinate dimension in new variable name instead of indexing number. Will use the value prepended to the units of the dimension.
dim_labels (str or list of str) – Allows for use of custom label to append to end of variable names
- Returns:
A new object copied from input object with the multi-dimensional
variable split into multiple single-dimensional variables.
Example
# This will get the name of the coordinate dimension so it does not need to # be hard coded. >>> parse_dim = (list(set(list(ds.dims)) - set([‘time’])))[0]
# Now use the parse_dim name to parse the variable and return new object. >>> new_ds = convert_2d_to_1d(ds, parse=parse_dim)