Historique de la page

...

Initial setup

1) Set up SSM environment

Do this part only when running on clusters of "The Alliance" (Compute Canada). On our UQAM servers this is already done at account creation.
You need to do part 1) only once!

...

     Set up the SSM environment

2) Set up the "GEM model environment"

You need to do part 2) only once!

...

     Set up the GEM model environment

Extra model scripts

You need to do part 3) only once as well - unless there is an update for the scripts.

...

You are done now with the general model setup.

Ancre
config_files config_files

The configuration files

GEM needs four respectively five configuration files (short: "config" files) to run:

...

Once you are ready to run your first "real" simulations, ask me (winger.katja@uqam.ca) or one of your colleagues for a set of config files you can start from!

Launching the simulation

1) Set the model environment

You need to set the model environment in every window from which you want to run/launch the model or in which you want to create the model executable. This is not to be confused with the initial setup. Here you just need to set which model version you want to use to get access certain environment variables and get additions to the PATH.

...

Among others, these commands also sets the environment variables $gemdyn and $rpnphy which contain the directory name under which you can find all models dynamic resp. physics routines

2) Start the model

1. Go into your config directory (the directory in which you have your config files - see above).
   
   
2. Launch the model with one of the following two commands:
   

   a)  Um_lance

   This is the basic way to submit the model. It can be used when running the model on our UQAM server as well as for short (one job) simulations on clusters of The Alliance. If your simulation consists of more than one month the model will run one job per month. At the end of each month/job the next month will get submitted automatically => which can lead to multiple long queued times on clusters of The Alliance.
   If you are using the little example config files from above you should use 'Um_lance' to submit the example simulation.

   b)  Chunk_lance

   To avoid extra queued times 'Chunk_lance' will execute as many months as it can in the given wall time of the job (BACKEND_time_mod). At the end of each job the next job will get submitted automatically. While 'Chunk_lance' can be used for all types of simulations it is especially useful for longer simulations.

   If the model crashes and you want to resubmit it to continue the simulation, all you have to do is go back into you config file directory, set the model environment, and execute 'Chunk_lance' again.

   If ever you want to restart a simulation from the very beginning, you can do so by executing:

         Chunk_lance  -start

   You can find more information about Chunk_lance on our wiki by clicking 'here'.

While the model is running

Check that your simulation is running

To check if your simulation is running use the command:
            qs

...

You can find more information on the following wiki:
   Batch jobs
   Check on batch jobs

What happens while the model is running

The model itself will run under the "execution directory" you created above, called:
    ~/MODEL_EXEC_RUN/machine_name/experiment_name

...

Note: The model does not depend on the post processing jobs. Even if one of these jobs aborts, the model will continue running.

Listings

While the model is running the listings (log files) will appear under the directory:
            ~/listings/${TRUE_HOST}
There names will all start with ${GEM_exp}_*.

Once a job/month finished properly they will all get archived under:
            ${CLIMAT_archdir}/Listings/listings_${GEM_exp}.zip

Model output

While the model is running the output will be under:
            ~/MODEL_EXEC_RUN/${TRUE_HOST}/${GEM_exp}/RUNMOD/output/cfg_0000/firststep_...

...

        dp...  : dynamics on pressure level
        dm... : dynamics on model levels
        pm... : physics on model levels
        pp...  : physics on pressure levels

What to do with the model output

There are several ways to look at the model output, which is in the RPN standard file format, and to modify it.
Have a look at this web page for some examples.

...