/phyocean-envs

Mamba/Anaconda envs for ocean sciences

Primary LanguageJupyter NotebookGNU General Public License v3.0GPL-3.0

PhyOcean environments

ยตMamba/Anaconda environments for ocean physics. PhyOceans envs could be considered as "know good sets" of software and libraries useful for working at LOPS Laboratory (but it's not mandatory). These environments are useful to start with data processing instead of fighting in dependencies hell.

But what is an environment ? An environment is a set of tools installed inside a folder instead of system-wide. Classically, environments are useful when you don't have system administration rights (HPC center, workstation locked by evil sysadmin) or when you have to switch between versions of the same modules.

Environments could be preinstalled by system administrators or built by users on home-directories (local or network).

Why using PhyOcean instead of choosing your products yourself ?

  • Dehydrated software (just add water)
  • Commons envs to share scripts with your colleagues
  • Not only for Python
  • (Tested with our needs) no yet a reality

Two environments are fixed per year (May and November), fromveur environment had no fixed versions, so use it with caution.

Available environments (stable)

PhyOcean 2023.11

Category Items
๐Ÿšจ Python 3.10, JupyterLab 4, Cuda 11.8 (๐Ÿง), Dask 2024.2, Numpy 1.26, Pandas 2.2, Tensorflow 2.11, Scikit 1.12, xarray 2024.1, PyFerret
Python Cartopy 0.22, matplotlib, holoview, hvplot, Cerbere (๐Ÿง), gsw, gpxpy, rasterio, Bokeh, Cython 3.0.8, netcdf4 1.6, wxpython
Python (data) Zarr 2.17, intake, s3fs, cdsapi, Cerbere, Google Cloud Storage, ESGF Pyclient, ncview (๐Ÿง and ๐Ÿ), NCO Tools, Wekeo hda
Development mpi4py 3.1.4, f2py, Gcc/gfortran 12.2, Spyder, nodeJS, Sphinx

PhyOcean 2023.05

Category Items
๐Ÿšจ Python 3.10, JupyterLab 4, Cuda 11.8 (๐Ÿง), Dask 2023.5, Numpy 1.24, Pandas 2.0, Tensorflow 2.11, Scikit 1.10, xarray 2023.5, PyFerret
Python Cartopy 0.21, matplotlib, holoview, hvplot, Cerbere (๐Ÿง), gsw, gpxpy, rasterio, Bokeh, Cython 0.29, netcdf4 1.6, wxpython
Python (data) Zarr 2.14, intake, s3fs, cdsapi, Cerbere, Google Cloud Storage, ESGF Pyclient, ncview (๐Ÿง and ๐Ÿ), NCO Tools, Wekeo hda
Development mpi4py 3.1.4, f2py, Gcc/gfortran 12.2, Spyder, nodeJS, Sphinx

Old environments

Please see dedicated page.


Dev environments (unstable)

PhyOcean "Fromveur"

  • Platform(s) : ๐Ÿง ๐Ÿ
  • Codename: phyocean-fromveur
  • Downloads : linux | macos | win

๐Ÿšจ Software versions are not pinned. Software/modules could be added or removed... Please read yaml file for details.

Using PhyOcean envs at LOPS

JupyterHub users, PhyOcean envs are pre-registered on LOPS JupyterHub services (see LOPS internal docs)

LOPS-IUEM users, these environments are available with module on workstations or computing facilities.

module load envs/phyocean-2021.11

Using PhyOcean envs on your computer

MicroMamba

โš ๏ธ bash & zsh shell on Linux & OS X only

microMamba is an open-source implementation of Conda, it aims to be lighter and faster than Conda. microMamba is fully compatible with Conda packages, repositories (conda-forge) and environment files.

First, install microMamba, read install instructions from Mamba documentation.

micromamba create -f phyocean-2022.05.yaml

Next, activate env with

micromamba activate phyocean-2022.05

Conda/Anaconda

First, install Anaconda, read install instructions from Anaconda documentation.

Download chosen environment file. Latest stable is phyocean-2022.05.linux.yaml or unfixed phyocean-fromveur.yaml.

conda env create -f ~/Downloads/phyocean-2022.05.yaml

Next, activate env with

conda activate phyocean-2022.05