The easiest way to configure models coupled to the LFM is via the script generator affectionately named "Make It So". MakeItSo requires Python >= 2.4.
Once you've set the corresponding environment variables, learn more about MakeItSo via the
There are two ways to run the script generator:
<enter>for the default value or
? <enter>for more information on a particular variable. Once you've entered all model parameters & environment setup, MakeItSo will create input files & job scripts necessary to run the code.
makeItSo.configfile at: Once you've run the script generator via interactive mode (see above), open up a
*makeItSo.configfile with a text editor. You can edit run parameters, save the file and configure a new run using this simple text file. Execute: MakeItSo will create all the input files & job scripts necessary to run the code.
Make It So will print instructions and create a set of files:
Follow the instructions displayed by Make It So to run the code.
Say you ran MakeItSo to generate a 2 hour run of LFM. You should have several files in your run directory, including:
LFM-001.sh: 50 minute spinup interval
LFM-002.sh: Job script for 1st hour of run
LFM-003.sh: Job script for 2nd hour of run
SW-SM-DAT: 6 hours of solar wind data from OMNI
LFM_makeItSo.config: configuration file for MakeItSo.
You execute the job scripts and your 2 hour run (plus 50 minute spinup) have completed. Let's say you want to restart the run and continue for an additional 2 hours. There are two ways to do this:
LFM_makeItSo.configand set the stop top tim 2 hours later
LFM-004.sh. This will pick up where the previous job script left off and continue executing the model.
Adding a new environment to MakeItSo is an advanced topic. Do not hesitate to ask for help with initial configuration.
We have tested MakeItSo on a variety of systems. You can customize for your particular machine in two ways:
You can permanently add your environment by defining all parameters in a QUEING-ENVIRONMENT.yml file. This file must reside in the
MakeItSo/Environments subdirectory. It describes the computer (MPI installation, flags for the number of processors, etc) and any queue information that is required. We recommend that you start with a pre-existing environment & extend it to your own environment. For example, see LSF.yml or SGE.yml.
At runtime, MakeItSo will locate this YAML file & provide an interface to the user to set up the environment.
You can modify a pre-configured environment at run-time. Start makeItSo.py in "expert" mode (Warning: This may prompt you to enter dozens of model parameters)
When prompted for an environment, select the one most similar to yours. If you are working on a Linux desktop computer, select "Standard Linux Bourne shell without a queue". You will be asked to enter a series of parameters related to your compute environment. You must know the settings used to compile the LTR prerequisites.