Documents · Verb reference

zscore

Return a standardized anomaly verb (z-score) along dim.

Callable type: Grammar verb / pipe stage · Browse: Transform

Usage

from cubedynamics import verbs as v
v.zscore(dim='time', *, over=None, keep_dim=True, std_eps=0.0001, skipna=True)

Arguments

Argument	Meaning	Default
dim	See implementation docstring below; no parameter-specific description supplied.	'time'
over	See implementation docstring below; no parameter-specific description supplied.	None
keep_dim	See implementation docstring below; no parameter-specific description supplied.	True
std_eps	See implementation docstring below; no parameter-specific description supplied.	0.0001
skipna	See implementation docstring below; no parameter-specific description supplied.	True

Accepts

An xarray DataArray or Dataset with the dimensions required by the selected operation. VirtualCube support is operation-specific; consult the implementation notes.

Returns

A callable stage. Applying it returns the transformed xarray object (or the supported VirtualCube result).

Order / grammar behavior

Apply before reductions that remove a required dimension. Choose the reduction dimensions explicitly; keep_dim=False removes reduced axes.

Minimal example

Run from the repository root after python -m pip install -e '.[vignettes]'. Uses the checked observational PRISM fixture; no network is required.

from pathlib import Path
import xarray as xr
import matplotlib.pyplot as plt
from cubedynamics import pipe, verbs as v

# Frozen, reviewed PRISM observations; run from the repository root.
path = Path("tests/fixtures/real_data/prism_boulder_january_2024.nc")
with xr.open_dataset(path, engine="scipy") as observed:
    cube = observed["tmax"].load()
assert cube.attrs["units"] == "degC"

result = (pipe(cube) | v.zscore(dim="time")).unwrap()
result.isel(time=0).plot()
plt.show()

Works with