Command Line

Command line options come in two flavours: short hand (e.g. -f) and long (e.g., –config-file).

Options:

--help

--version, -v

--config-file, -f

--config, -c

--remove, -r

--remove-module, -d

--add-module, -m

In addition to specifying the configuration file to run with, it can be used to specific configuration options. Any configuration that is configurable via configuration files can be specified on the command line. This is done so that configuration files do not need to be written during, for example, uncertainty analysis.

Note

Values specified on the commandline over-ride existing values in the configuration file

help

Prints the available options.

version

Prints the version of CHM along with the git commit.

config-file

Specifies a configuration file to use. This is required.

./CHM --config-file CHM_test.json

./CHM -f CHM_test.json

config

This enables changing a configuration value from the command line. The value is specified with a fully qualified configuation path. This can change any aspect of the configuration file, but an example with a module’s configuration is given below.

For example, to change the module moduleA value of b the configuration file would be

{

   "config":
   {
      "moduleA":
      {
         "b": 3.14
      }
   }

}

Therefore, the commandline variant would be:

-c config.moduleA.b:3.14

Multiple configuration values can be specified via multiple -c arguments:

-c config.moduleA.b:3.14 -c option.debug_level:"error"

Note

This cannot be used to modify the list values ([ ]) for the modules section. Please use the add/remove module feature to modify those.

remove

Removes a configuration parameter. Removals are processed after any -–config parameters are parsed, so -r will override -c. A fully qualified path to the configuration is required. For example this configuration

{

   "option":
   {
      "option_a": true,
      "option_b": 1234,
   }

}

could have option_a removed

-r option.option_b

Because the removal happens after any modification with -c, the following to add option_c has no effect:

-c option.option_c:2 -r option.option_c

Note

This cannot be used to modify the list values ([ ]) for the modules section. Please use the add/remove module feature to modify those.

remove-module

Removes a module

-d Marsh_shading_iswr

add-module

Adds a module to the list. Adding configuration options with -c can be done before or after this call.

-m snobal -m Marsh_shading_iswr