wiki:Doc/Intro

Version 25 (modified by jgipsl, 4 years ago) (diff)

--

Introduction



1. Foreword

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

For common hardware platforms (also called "machines"), 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

Doc/Intro/About

3. News

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

4. Reference configurations

Several model configurations (coupled and forced) are available and described in this manual. Recommended configurations are:

4.1. The _v5 configurations

  • IPSLCM5_v5 : the reference IPSL coupled model for CMIP5-type simulations including atmosphere, land surface, ocean, sea ice and the carbon cycle
  • LMDZOR_v5 : atmosphere-land only
  • LMDZOR_v6 : atmosphere-land only, newer version of land model
  • LMDZORINCA_v6 : atmosphere-land-tropospheric chemistry
  • LMDZREPR_v5 : atmosphere-stratospheric chemistry
  • IPSLCM6CHT : the reference coupled model with tropospheric chemistry
  • IPSLCM5CHS_v5 : the reference coupled model with stratospheric chemistry

4.2. Other forced configurations

  • NEMO : the ocean model including sea ice and marine biogeochemistry
  • ORCHIDEE_TRUNK : the latest reference version of the land surface model

4.3. Future configurations

  • IPSLCM6A-VLR / IPSLCM6.0-LR : futures configurations for CMIP-6 simulations including atmosphere, land surface, ocean, sea ice and the carbon cycle. Under development.

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_@….
  • esci : this list provides the latest information on ongoing developments. Subscription is available on request (esci_@…) for users who want to take part in these developments.

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 Train. 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 : Train

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:

7.3. Technical prerequisites

7.3.1. Unix

7.3.2. Editors

7.3.2.1. Emacs

7.3.2.2. vi

7.3.3. Langages

7.3.3.1. Fortran

7.3.3.2. Python

7.3.4. Visualisation tools

7.3.4.1. ferret

7.3.5. Sources

7.3.5.1. SVN

7.3.6. Tools

7.3.6.1. nco

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.

7.3.7. Programming

  • These notes are part of a course on software development skills for scientists and engineers being prepared by Greg Wilson for the Python Software Foundation

8. Glossary

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