| | 1 | {{{ |
| | 2 | #!html |
| | 3 | <h1>Introduction</h1> |
| | 4 | }}} |
| | 5 | ---- |
| | 6 | [[TOC(heading=Table of contents,depth=1,inline)]] |
| | 7 | [[PageOutline(1,Table of contents,pullout)]] |
| | 8 | ---- |
| | 9 | |
| | 10 | # Foreword # |
| | 11 | |
| | 12 | This users' manual describes the models and tools developed at the IPSL Climate Modeling Center. |
| | 13 | |
| | 14 | For common hardware Homes (also called "machines"), this website provides information on how to: |
| | 15 | * download reference configurations |
| | 16 | * compile |
| | 17 | - the source codes of the different model components |
| | 18 | - the coupling interface (ocean-atmosphere) and the coupler |
| | 19 | * perform a reference experiment (including input files) |
| | 20 | * monitor its execution |
| | 21 | * produce and store raw outputs |
| | 22 | * produce, store and share ATLAS and standard analyses |
| | 23 | |
| | 24 | |
| | 25 | # Reference configurations # |
| | 26 | Several model configurations (coupled and forced) are available and described in this manual. Recommended configurations are: |
| | 27 | |
| | 28 | ## The ''_v5'' configurations ## |
| | 29 | * IPSLCM5_v5 : the reference IPSL coupled model for CMIP5-type simulations including atmosphere, land surface, ocean, sea ice and the carbon cycle |
| | 30 | * LMDZOR_v5 : atmosphere-land only |
| | 31 | * LMDZORINCA_v5 : atmosphere-land-tropospheric chemistry |
| | 32 | * LMDZREPR_v5 : atmosphere-stratospheric chemistry |
| | 33 | * IPSLCM5CHT_v5 : the reference coupled model with tropospheric chemistry |
| | 34 | * IPSLCM5CHS_v5 : the reference coupled model with stratospheric chemistry |
| | 35 | |
| | 36 | ## Other forced configurations ## |
| | 37 | * NEMO : the ocean model including sea ice and marine biogeochemistry |
| | 38 | * ORCHIDEE_SVN_AR5 : the land surface scheme used for the reference CMIP5 simulations |
| | 39 | * ORCHIDEE_TAG : the latest reference version of the land surface model |
| | 40 | |
| | 41 | # Workshops # |
| | 42 | |
| | 43 | ## Training courses ## |
| | 44 | |
| | 45 | The Home group at the IPSL Climate Modeling Center organizes training courses on how to use the IPSL models and tools. These courses aims to cover the content of this documentation. [[BR]] |
| | 46 | |
| | 47 | |
| | 48 | More information, dates and inscription are available here : [wiki:Train] |
| | 49 | |
| | 50 | ## External courses ## |
| | 51 | |
| | 52 | 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: |
| | 53 | |
| | 54 | * Technical workshops |
| | 55 | * Fortran, MPI/OpenMP, etc : http://cours.idris.fr |
| | 56 | * Workshops organized by the "maison de la simulation" : http://www.maisondelasimulation.fr |
| | 57 | * Workshops organized by the PRACE Advanced Training Centres (PATCs) http://www.training.prace-ri.eu/ |
| | 58 | |
| | 59 | * Workshops on IPSL models |
| | 60 | * LMDZ : http://lmdz.lmd.jussieu.fr |
| | 61 | * ORCHIDEE : http://forge.ipsl.jussieu.fr/orchidee/wiki/Contact |
| | 62 | * INCA : http://www-lsceinca.cea.fr/pp_contact.html |
| | 63 | * NEMO : http://www.nemo-ocean.eu/About-Us |
| | 64 | # Mailing List # |
| | 65 | |
| | 66 | There are two mailing lists: |
| | 67 | * '''Home-users''' : the subscription to the list is open to everyone: [http://courriel.ipsl.jussieu.fr/mailman/listinfo/platform-users http://courriel.ipsl.jussieu.fr/mailman/listinfo/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.jussieu.fr. |
| | 68 | |
| | 69 | * '''esci''' : this list provides the latest information on ongoing developments. Subscription is available on request (esci_@_ipsl.jussieu.fr) for users who want to take part in these developments. |
| | 70 | |
| | 71 | # How to use the IPSL Climate Modeling Center models and tools # |
| | 72 | |
| | 73 | * Check your computing resources (e.g. computing time, disk quota) available at your [wiki:DocBenv computing center] |
| | 74 | * Find the model configuration you need (several configurations might suit your project) |
| | 75 | * Let the person in charge of this model configuration know that you are planning on using it |
| | 76 | * Install the reference configuration and perform a first test simulation |
| | 77 | * Check that this first simulation ran successfully and plot the outputs |
| | 78 | * Change this configuration step by step to adapt it to your project needs |
| | 79 | * A recommended starting point is [https://forge.ipsl.jussieu.fr/igcmg_doc/attachment/wiki/Train/TD_LMDZOR_v5.pdf the worksheet of the "Basic" workshop]. This worksheet contains the necessary commands to install and run a reference simulation in the LMDZOR configuration. |
| | 80 | |
| | 81 | The present manual should allow you to master these steps. |
| | 82 | |
| | 83 | [[NoteBox(note, Please don't hesitate to ask questions to Home-users_@_ipsl.jussieu.fr to receive help from other users. Please also help other users if you know the answer to a question., 600px)]] |
| | 84 | |
| | 85 | # [wiki:DocAintroAvocab Glossary] # |
| | 86 | A list of the acronyms used in this manual can be found at [wiki:DocAintroAvocab this page] |
| | 87 | |
| | 88 | ---- |
