Installation

Required Dependencies

• Python 3.11 or later
• numpy
• pandas
• xarray
• netcdf4
• matplotlib
• seaborn
• cartopy
• pooch
• xregrid
• monet-stats
• pytspack
• dask
• pillow
• scipy

Optional Dependencies

Some features require additional dependencies: - geopandas, rasterio, shapely: For advanced spatial masking (pip install monet[regions]) - monetio: For reading various model and observation formats (pip install monet[obs])

Instructions

The simplest way to install MONET and its complex dependencies (like ESMF for xregrid) is using conda or micromamba:

conda install -c conda-forge monet

This will install MONET along with all required dependencies.

Installing from Source

To install MONET from source, you can use pip. It is recommended to install it in a pre-configured environment with dependencies already installed (especially those requiring compilation like esmpy).

pip install git+https://github.com/noaa-oar-arl/monet.git

Or manually:

git clone https://github.com/noaa-oar-arl/monet.git
cd monet
pip install .

Python 3.11 Notes

Developers may be interested in the Python 3.11 release notes. The most relevant change for MONET is a general speedup, but review the summary for other potential impacts.

Development Environment

For developers, you can create a dedicated environment using the provided environment-dev.yml file:

conda env create -f environment-dev.yml
conda activate monet-dev
pip install -e .