Running the Land Surface Model (
wsim.lsm utility runs one or more iterations of the WSIM Land Surface Model.
Usage is as follows:
wsim_lsm --state <file> \ [--forcing <file>]... \ --flowdir <file> \ --wc <file> \ --elevation <file> \ --results <file> \ --next_state <file> \ [--loop n]
--stateis a netCDF file representing the input state of the model. It must provide four variables:
Dramount of detained runoff in millimeters
Dsamount of detained snowmelt in millimeters
Snowpacksnowpack water equivalent in millimeters
Wssoil moisture in millimeters
snowmelt_monththe number of consecutive months of melting conditions
In addition, the state file must define a global attribute
yearmonthat specifies a year and month
YYYYMMformat. The state file will be considered to represent conditions at the start of this month.
--forcingspecifies one or more netCDF files of forcing data to be used, with each file providing data for a single model iteration. Multiple
--forcingarguments may be provided, and each argument may refer to a single file or a glob of multiple files. Forcing data will be applied in a character-sort order based on the file names of the inputs, not the order in which they are specified. Each forcing file must contain the following variables:
Tthe average monthly temperature in degrees Celsius
Prthe total monthly precipitation (rainfall and snowfall) in millimeters
pWetDaysthe fraction of days during which precipitation falls
--wca file providing the soil moisture holding capacity in millimeters
--elevationa file providing land surface elevation in meters
--flowdira file providing a surface flow direction matrix (as described in Flow Direction Specification)
The following arguments define model outputs:
--resultsa netCDF file to which model results will be written. If the filename contains the pattern
%T, results from all model iteration will be written to disk as separate files, with the filename formed by substituting the timestep year-month for
%T. If the
%Tpattern is not present in the filename, only the results of the final iteration will be written to disk.
--next_statea netCDF file to which a model state will be written, suitable for use in a subsequent model iteration. Substitution of
%Tis performed in the same manner as for the
--loopwill cause the input forcing data to be cycled multiple times. This is useful during model spin-up.