Introduction

1. Foreword

This users' manual describes the models and tools developed at the IPSL Climate Modeling Center.

For common computing centers, this website provides information on how to:

• download reference configurations
• compile
  • the source codes of the different model components
  • the coupling interface (ocean-atmosphere) and the coupler
• perform a reference experiment (including input files)
• monitor its execution
• produce and store raw outputs
• produce, store and share ATLAS and standard analyses

2. About this documentation

Read about the history of this documentation here.

3. News

See here important news related to the use of the tools described in the documentation.

4. Reference configurations

Several model configurations, couple one or more of the IPSL modeles together, are available through the Platforme tools described in this manual. Read more about the differnt configuration in chapter Doc/Config.

5. Mailing List

There are two mailing lists:

• platform-users: the subscription to the list is open to everyone => ​https://listes.ipsl.fr/sympa/subscribe/platform-users . The purpose of this list is to organize and facilitate the communication between users of the IPSL models and tools (in particular libIGCM and modipsl). Discussions in French or in English are open to all users. Messages can be posted at platform-users@ipsl.fr.
• Training team mailing list: for more information about the trainings organized by the Platform group, you can contact the training team => platform-training-team@listes.ipsl.fr

6. How to use the IPSL Climate Modeling Center models and tools

• Check your computing resources (e.g. computing time, disk quota) available at your computing center
• Find the model configuration you need (several configurations might suit your project)
• Let the person in charge of this model configuration know that you are planning on using it
• Install the reference configuration and perform a first test simulation
• Check that this first simulation ran successfully and plot the outputs
• Change this configuration step by step to adapt it to your project needs
• A recommended starting point is hands on exercises from the basic training course, see Doc/Training. These exercises can be done individually at your personal account on one of the platforms included in libIGCM. All commands are listed in the text for the exercises.
• Participate to the next training session (next paragraph)
• Be fluent in unix, programming and data management and visualisation (latest paragraph)

Please don't hesitate to ask questions to platform-users_@… to receive help from other users. Please also help other users if you know the answer to a question.

7. Workshops

7.1. Training courses

The platform group at the IPSL Climate Modeling Center organizes training courses on how to use the IPSL models and tools. These courses aim to cover the content of this documentation.

More information, dates and inscription are available here : Doc/Training

7.2. External courses

Computing centers such as IDRIS organize workshops on supercomputing. Those workshops might be useful to all users of the models and tools presented here (Fortran, MPI/OMP). Some IPSL model development teams also offer workshops on how to use their particular model. More information can be found here:

• Technical workshops
  • Fortran, MPI/OpenMP, etc : ​http://cours.idris.fr
  • Workshops organized by the "maison de la simulation" : ​http://www.maisondelasimulation.fr
  • Workshops organized by the PRACE Advanced Training Centres (PATCs) ​http://www.training.prace-ri.eu/

• Workshops on IPSL models
  • LMDZ : ​http://lmdz.lmd.jussieu.fr
  • ORCHIDEE : ​http://forge.ipsl.fr/orchidee/wiki/GroupActivities/Contact
  • INCA : ​http://inca.lsce.ipsl.fr/index.html
  • NEMO : ​http://www.nemo-ocean.eu/About-Us

7.3. Technical prerequisites

7.3.1. Unix

• Introduction à Unix (cours de l'IDRIS) : ​http://www.idris.fr/formations/utilisation-unix/
• Advanced Bash-Scripting Guide . Mendel Cooper. version 6.1 30 Sep 2009.
  • version HTML ​http://www.tldp.org/LDP/abs/html/
  • version PDF ​http://www.tldp.org/LDP/abs/abs-guide.pdf

• Portable Shell Programming : ​http://www.gnu.org/software/autoconf/manual/autoconf.html#Portable-Shell

7.3.2. Editors

7.3.2.1. Emacs

• FAQ : ​http://www.faqs.org/faqs/GNU-Emacs-FAQ/

7.3.2.2. vi

• help : ​http://vimdoc.sourceforge.net/htmldoc/help.html

7.3.3. Langages

7.3.3.1. Fortran

• IDRIS courses : . documents : ​http://www.idris.fr/formations/fortran/ prochains cours : ​https://cours.idris.fr/

7.3.3.2. Python

• Python and CDAT tips : ​http://www.johnny-lin.com/cdat_tips/
• Note memory and python :
  • problem : ​http://evanjones.ca/python-memory.html

7.3.4. Visualisation tools

7.3.4.1. ferret

• ferret - Data visualisation and analysis : ​http://ferret.pmel.noaa.gov/Ferret/
  • Fast-Atlas - IPSL simulation monitoring : ​https://github.com/PBrockmann/fast / ​https://github.com/PBrockmann/atlas
  • Climaf - IPSL simulation monitoring : ​https://climaf.readthedocs.io/en/master/
  • On line demonstrations : ​https://ferret.pmel.noaa.gov/Ferret/documentation/ferret-tutorials

7.3.5. Sources

7.3.5.1. SVN

• Official site : ​http://subversion.apache.org/
• Subversion Best Practices : ​https://subversion.apache.org/source-code
• Examples :
  • ​https://community.kde.org/Policies/Commit_Policy
  • ​http://www.rubico.info/docs/introduction-subversion/svnintro.pdf

7.3.6. Tools

7.3.6.1. nco

• nco (NetCDF operators) : ​http://nco.sourceforge.net/

7.3.6.2. cdo

• cdo : ​https://code.zmaw.de/projects/cdo
• CDO is a collection of command line Operators to manipulate and analyse Climate and NWP model Data. There are more than 600 operators available.

8. Glossary

A list of the acronyms used in this manual can be found at this page

---