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:
Interactive mode: At the command-line, type
and follow the prompts. You will be asked to set a series of parameters. Press
<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.
Preconfigured run mode: Each time you run the script generator, it writes a
makeItSo.config file at:
Once you've run the script generator via interactive mode (see above), open up a
*makeItSo.config file 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.
This will create the following run scripts:
First, the hdf5 module needs to be loaded before MFLFM can be built.
Build MFLFM as normal.
To turn on HDF5 support, makeItSo.py needs to be run in expert mode. (Warning: This may prompt you to enter dozens of model parameters). Not using expert mode will default back to HDF4.
When the model parameter option "IO_EXTENSIONS( hdf ):" is reached, enter "hdf5". Entering "hdf", or just hitting return will default back to HDF4.
HDF5 file support for MFLFM is now turned on. Run MFLFM as normal, there should be .hdf5 files in the run directory.
Add HDFnompi path to HDF5 libraries.
There was also issues with finding the szip library, so EXTRA_LIBS needs to set to find szip.
Add HDFnompi path to HDF5 libraries.
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.