Flags and Command Line Options

Submodel Report Flags

To generate various kinds of reports, a flag must be set. To set the option through the interface, use the output tab of the Configuration screen. A flag number is entered in the box in the appropriate submodel. A flag of zero, '0', will result in no output being generated to the listed file. It should be noted that generating these files may create large file sizes and significantly slow the execution of the WEPS model.

Submodel	file name(s)	description

& flag no.

Hydrology

0	no output generated

1	hydro.out	daily output

2	water.out	hourly output for each day

3	hydro.out & water.out	generates both files

4	temp.out	daily soil temperature output by layer

5	temp.out & hydro.out	generates both files

6	temp.out & water.out	generates both files

7	temp.out & water.out & hydro.out	generates all three files

Soil

0	no output generated

1	soil.out	daily submodel output

Management

0	no output generated

1	manage.out	daily submodel output

Crop

0	no output generated

1	crop.out	daily submodel output

Decomposition

0	no output generated

1	dabove.out	daily above-ground submodel output

2	dbelow.out	daily below-ground submodel output

3	dabove.out & dbelow.out	generates both files

Erosion

0	no output generated

1	erosion.out	currently generates an empty file

eegt.out	currently generates an empty file

eros.tmp	currently generates an empty file

subday.out	daily wind direction and subdaily (i.e., hourly) wind speeds

3	emit.out	Subdaily (e.g. hourly) suspension

A flag of one, '1', for any submodel generates the file 'plot.out', which contains a variety of output variables on a daily basis. This file is suitable for input into spreadsheets or plotting packages for plotting of daily data. See the header of the file or contact the WEPS developers for more information on the variables output to 'plot.out'.

Command Line Options

Windgen 4

Usage: wind_gen4 -D -V -v -h -l -f dbfile -o outfile -s # -x # -r # -b # -y #-u # -d # -?

-D	debug flag

-V	display version and exit

-v	set the verbose option

-h	do not display output title heading

-l	display long (additional) output

-f dbfile	specify wind database file (wind_gen.wdb)

-o outfile	specify output file (stdout)

-s #	specify station WBAN no.

-x #	specify station database index no.

-r #	specify random number seed (default = 54321)

-b #	specify beginning simulation (calendar) year (default = 1)

-y #	specify number of years to simulate (default = 1)

-u #	specify storm duration length in hours (default = 6)

-d #	specify number of days to build storms from (default = 5)

-?	Display the available command line options

The wind station WBAN code number is required. Note that only the "-f" option (with the location of the appropriate wind_gen database file to access) is required for WEPS 1.0. All other options are either automatically added internally by WEPS 1.0 or are optional. Those that WEPS 1.0 automatically sets are:

-s #

-y #

-o outfile

Those that can be added to the command line and should work within WEPS 1.0 are:

-D

-v

-x #

-r #

-b #

-u #

-d #

Those that can't be specified when wind_gen4 is run within WEPS 1.0 are:

-V

-l

-h

-?

Cligen Version 5.2254

CLIGEN V-5.2254 - Climate Generator w/ QC-SNDG

Usage: cligen -S -s -I -o -b -y -f -F -H -r -t -I# -v -V -? -O

-S<state number>

-s<station ID number>

-i<input file name>

-o<output file name>

-b<beginning year>

-y<duration in years>

-f	old WEPS record format

-F	overwrite output file if it exists

-H	omit header output

-r<random seed>

-t<Sim Type (WEPP: 4=SglStm, 5=Contin)>

-I0	no interpolation (default)

-I1	linear interpolation

-I2	Fourier interpolation

-I3	interpolation to preserve avgs

-v

-V	verbose

-h, -?, -\\?, /h	help

-O <option 6 – observed data filename>

Make sure there are no spaces between each flag and its parameter. If command line options are omitted, CLIGEN will interactively request the required information.

Note that the "-I" option (with the location of the appropriate cligen database file to access), the "-b" option (specifying the start year; usually 1), the "-t" option with value "5", and the "-F" option are all required for WEPS 1.0. All other options are either automatically added internally by WEPS 1.0, are optional, or not applicable when used with WEPS 1.0.

Those that WEPS 1.0 automatically sets are:

-S#

-s#

-y#

-ooutfile

Those that can be added to the command line and should work within WEPS 1.0 are:

-r#

-I0

-I1

-I2

-I3

-V

Those that can't be specified when cligen5110 is run within WEPS 1.0 are:

-v

-h

-?

-t# (with options values other than 5)

WEPS 1.0

Usage: weps -? -C# -E# -I# -L# -l# -O# -p# -P./ -R# -S# -s# -w# -Y -X#

where # represents the options listed:

Valid command line options:

-? Display the help screen

-h Display the help screen

-C WEPS crop calibration mode

0 = Do not run crop calibration (default)

1 = Run crop calibration

-E Simulate \"erosion\" in WEPS run

0 = Do not run the erosion submodel

1 = Run the erosion submodel (default)

-I Specify if initialization is done and if so, the # loops

0 = No initialization

1 = Runs one management cycle (default)

2 = Runs x management cycles

-L Specify soil layer thickness to scale layer splitting (mm)

Specify -L2 for layer splitting to use 2 mm (no decimals) (default)

-l Specify rate of soil layer thickness increase with depth for

layer splitting in percent increase of layer thickness

Specify -l50 to 50 percent for each layer (no decimals). l25 is default.

-O Generate stand alone erosion input file on simulation day

Specify -O2932 to output file on simulation day 2932

-o Generate stand alone erosion input file on DD/MM/YY

Specify -o020901 to output file on day 2 month 9 year 1

Day and month must be 2 digits, Year can be 1 to 4 digits. Default is no file generated.

-p Select soil puddling with saturation all above freezing

0 = disable (default)

1 = enable

-P Specify path to WEPS project run directory

Must be specified if other command line switches are used.

Must be the last option specified. Default is ./

Specifying only the path without the \"-P\" option only works if no other command line switches are specified (e.g., \"weps path_to_weps.run_file\")

-R WEPS debug messages dumped to screen

0 = no debug messages sent to screen (default)

1 = 1st-level debug messages sent to screen

2 = 1st- and 2nd-level debug messages sent to screen

3 = 1st-, 2nd-, and-3rd level debug messages sent to screen

-S Vary type of value input for 1/3 bar, 15 bar water

0 = 1/3bar(vol) 15bar(vol)

1 = 1/3bar(vol) 15bar(grav)

2 = 1/3bar(grav) 15bar(grav)

3 = use texture-based calculation

4 = use Rawls texture for full properties (default)

Override 1/3bar, 15bar, bulk density w/ texture estimate

-s Specify soil ifc file input format type

0 = new format (additional parameters) (default)

1 = old format (slope set in weps.run)

-w Specify method of weighting for layer conductivity and flow

0 = arithmetic mean method (default)

1 = layer thickness proportional method

2 = internodal method, Darcian mean

-Y Optional functional yield/residue ratio

0 = Use full staged biomass partitioning

1 = Use functional yield/residue ratio (default)

-X Specify maximum wind speed cap (m/s)

Specify -X25.0 to limit input wind speeds to a maximum of 25.0 m/s.

If -X0, no cap is set (default).

Default options are set to:

-C0 -E1 -I1 -L2 -l25 -Oo(no file) -p0 -P./ -R0 -S4 -s0 -w0 -Y1 -X0

Note that only the "-P" option is required for WEPS 1.0. (It must be the last option specified if more than one option is listed because WEPS 1.0 appends the current WEPS Project Run directory path before executing the WEPS science model.

The options that the WEPS 1.0 interface set automatically are:

-Ppath

WEPS 1.0 assumes that the user has specified "-P" (as the last option) within the WEPS 1.0 configuration panel without the "path". WEPS 1.0 appends the path of the current WEPS Project Run directory before executing the WEPS science model.

Those that can be added to the command line and should work within WEPS 1.0 are:

-I#

-S#

-s#

-R#

-O

-o

-E#

-C#

-Y#

Those that can't be specified when run within the WEPS 1.0 interface are:

-h

-?