Skip to content

Latest commit

 

History

History
221 lines (159 loc) · 4.82 KB

api.rst

File metadata and controls

221 lines (159 loc) · 4.82 KB

API Reference

This page provides an auto-generated summary of climpred's API. For more details and examples, refer to the relevant chapters in the main part of the documentation.

High-Level Classes

climpred.classes

A primary feature of climpred is our prediction ensemble objects, :py~climpred.classes.HindcastEnsemble and :py~climpred.classes.PerfectModelEnsemble. Users can append their initialized ensemble to these classes, as well as an arbitrary number of verification products (assimilations, reconstructions, observations), control runs, and uninitialized ensembles.

HindcastEnsemble

A HindcastEnsemble is a prediction ensemble that is initialized off of some form of observations (an assimilation, renanalysis, etc.). Thus, it is anticipated that forecasts are verified against observation-like products. Read more about the terminology here.

HindcastEnsemble

Add and Retrieve Datasets

HindcastEnsemble.__init__ HindcastEnsemble.add_observations HindcastEnsemble.add_uninitialized HindcastEnsemble.get_initialized HindcastEnsemble.get_observations HindcastEnsemble.get_uninitialized

Analysis Functions

HindcastEnsemble.verify HindcastEnsemble.compute_persistence HindcastEnsemble.compute_uninitialized

Pre-Processing

HindcastEnsemble.smooth

PerfectModelEnsemble

A PerfectModelEnsemble is a prediction ensemble that is initialized off of a control simulation for a number of randomly chosen initialization dates. Thus, forecasts cannot be verified against real-world observations. Instead, they are compared to one another and to the original control run. Read more about the terminology here.

PerfectModelEnsemble

Add and Retrieve Datasets

PerfectModelEnsemble.__init__ PerfectModelEnsemble.add_control PerfectModelEnsemble.get_initialized PerfectModelEnsemble.get_control PerfectModelEnsemble.get_uninitialized

Analysis Functions

PerfectModelEnsemble.bootstrap PerfectModelEnsemble.compute_metric PerfectModelEnsemble.compute_persistence PerfectModelEnsemble.compute_uninitialized

Generate Data

PerfectModelEnsemble.generate_uninitialized

Direct Function Calls

A user can directly call functions in climpred. This requires entering more arguments, e.g. the initialized ensemble :py~xarray.core.dataset.Dataset/:pyxarray.core.dataarray.DataArray directly as well as a verification product. Our object :py~climpred.classes.HindcastEnsemble and :py~climpred.classes.PerfectModelEnsemble wrap most of these functions, making the analysis process much simpler. Once we have wrapped all of the functions in their entirety, we will likely depricate the ability to call them directly.

Bootstrap

climpred.bootstrap

bootstrap_compute bootstrap_hindcast bootstrap_perfect_model bootstrap_uninit_pm_ensemble_from_control_cftime bootstrap_uninitialized_ensemble dpp_threshold varweighted_mean_period_threshold

Prediction

climpred.prediction

compute_hindcast compute_perfect_model

Reference

climpred.reference

compute_persistence compute_uninitialized

Metrics

climpred.metrics

Metric _get_norm_factor

Comparisons

climpred.comparisons

Comparison

Statistics

climpred.stats

autocorr corr decorrelation_time dpp rm_poly rm_trend varweighted_mean_period

Tutorial

climpred.tutorial

load_dataset

Preprocessing

climpred.preprocessing.shared

load_hindcast rename_to_climpred_dims rename_SLM_to_climpred_dims

climpred.preprocessing.mpi

get_path