Getting started#

A guide to enable you to start productively using ValEnsPy as efficiently as possible.

Installation#

ValEnsPy has ESMF as a non-python dependency. Therefore, when installing ValEnsPy with pip, ensure that ESMF (esmpy) is already installed in the environment if you wish to use regridding functionality.

Warning

To install ValEnsPy on Windows see the advanced installation page.

Working with conda?

Using Conda (Recommended)

Prefer pip?

Using pip

In-depth instructions?

Installing on Windows? Installing from source or with pip? Check the advanced installation page.

Why ValEnsPy?#

By utilizing the exisisting xarray ecosystem, ValEnsPy provides a flexible and powerful framework for working with gridded climate and weather data from data processing to diagnostics and from single model evaluations up to multiple ensemble comparisons.

Still not convinced? Check out the Why ValEnsPy page.

What do I need to get started?#

  • A working installation <advanced_install> of ValEnsPy.

  • A basic understanding of xarray in particular the newly introduced DataTree functionality.

  • A basic understanding of pandas

Got what it takes? Check out the quick overview page to learn the key concepts of ValEnsPy or check out the examples.