METplus Practical Session Guide (Feb 2019) | METplus Setup > METplus: How to Run

Running METplus

Running METplus involves invoking the python script, master_metplus.py from any directory followed by a list of configuration files using the -c option for each additional conf file (conf files are specified relative to the METplus/parm directory).

Reminder: The default set of conf files are always read in and processed in the following order;
metplus_system.conf, metplus_data.conf, metplus_runtime.conf, metplus_logging.conf.

Example: Run the default configuration

If you have configured METplus correctly and run master_metplus.py with only your custom conf file, it will generate a usage statement to indicate that other config files are required to perform a useful tasks. It will generate an error statement if something is amiss.

Run master_metplus.py on the command line:

master_metplus.py -c mycustom.conf

THE EXAMPLES BELOW SHOW THE SYNTAX FOR PASSING IN CONF FILES AND ARE NOT MEANT TO BE RUN.
However, feel free to run the command and become familiar with the errors that are generated when referring to a path and/or conf file that does not exist.

Remember: Additional conf files are processed after the metplus_config files in the order specified on the command line.
Order matters, since each successive conf file will override any variable defined in a previous conf file.

NOTE: The processing order allows for structuring your conf files from general (variables shared-by-all) to specific (variables shared-by-few).

Syntax: Running a use_case configuration

master_metplus.py -c use_cases/<use_case>/use_case.conf

Syntax: Runing a use_case/examples configuration

master_metplus.py -c use_cases/<use_case>/use_case.conf -c use_cases/<use_case>/examples/some_example.conf

Syntax: Runing a use_case/examples configuration with your CUSTOM conf.

master_metplus.py -c use_cases/<use_case>/use_case.conf -c use_cases/<use_case>/examples/some_example.conf -c mycustom.conf