AWSM Configuration File Reference

The AWSM config file is a combination of SMRF and AWSM’s own configuration files. Pleas refer to the Reference for SMRF Configuration Files for any questions regarding the configuration file sections from SMRF which are as follows:

  • topo
  • time
  • stations
  • csv
  • gridded
  • mysql
  • air_temperature
  • vapor pressure
  • wind
  • precip
  • albedo
  • thermal
  • soil_temp
  • output
  • logging
  • system

All other sections and details for AWSM configuration files can be seen in the below.

For configuration file syntax information please visit http://inicheck.readthedocs.io/en/latest/

awsm master

make_in
Convert SMRF outputs to iSnobal inputs
Default: True
Type: bool

make_nc
Convert iSnobal outputs to netCDF
Default: True
Type: bool

mask_isnobal
Mask iSnobal outputs
Default: False
Type: bool

prompt_dirs
ask yes or no when making new directories
Default: False
Type: bool

run_ipysnobal
Run iPySnobal like iSnobal
Default: False
Type: bool

run_isnobal
Run iSnobal for specified simulation
Default: True
Type: bool

run_smrf
Specifies whether or not to run SMRF
Default: True
Type: bool

run_smrf_ipysnobal
Run SMRF and iPySnobal together
Default: False
Type: bool

paths

basin
name of basin to run
Default: None
Type: string

desc
description for set of runs
Default: None
Type: string

folder_date_style
style of date that gets appended to generated folders
Default: wyhr
Type: string
Options: wyhr day start_end

isops
if running operational or development
Default: False
Type: bool

path_dr
path to starting drive MUST exist
Default: None
Type: directory

proj
name of project if running devel
Default: None
Type: string

grid

active_layer
height of iSnobal active layer
Default: 0.25
Type: float

csys
coordinate type
Default: UTM
Type: string
Options: UTM

nbits
number of bits for IPW images
Default: 16
Type: int

thresh_medium
medium mass threshold for timestep refinement
Default: 10
Type: int

thresh_normal
normal mass threshold for timestep refinement
Default: 60
Type: int

thresh_small
small mass threshold for timestep refinement
Default: 1
Type: int

files

prev_mod_file
last snow output file from iSnobal for restart
Default: None
Type: filename

roughness_init
standard init file used only for roughness band
Default: None
Type: filename

awsm system

daily_folders
seperate daily output folders mainly for HRRR
Default: False
Type: bool

em_name
name of energetics ouput file without extension
Default: em
Type: string

ithreads
numbers threads for running iSnobal
Default: 1
Type: int

log_level
level of information to be logged
Default: debug
Type: string
Options: debug info error

log_to_file
log to file or print to screen
Default: True
Type: bool

output_frequency
frequency of iSnobal outputs in hours
Default: 24
Type: int

run_for_nsteps
number of timesteps to run iSnobal This is optional
Default: None
Type: int

snow_name
name of snow ouput file without extension
Default: snow
Type: string

variables
Variables for PySnobal to output after being calculated
Default: thickness snow_density specific_mass liquid_water temp_surf temp_lower temp_snowcover thickness_lower water_saturation net_rad sensible_heat latent_heat snow_soil precip_advected sum_eb evaporation snowmelt SWI cold_content
Type: string
Options: thickness snow_density specific_mass liquid_water temp_surf temp_lower temp_snowcover thickness_lower water_saturation net_rad sensible_heat latent_heat snow_soil precip_advected sum_eb evaporation snowmelt SWI cold_content

isnobal restart

depth_thresh
threshold in meters for low snow depths for restart
Default: 0.05
Type: float

restart_crash
whether or not to restart from crashed run
Default: False
Type: bool

wyh_restart_output
last iSnobal output hour to restart from
Default: None
Type: int

ipysnobal

forcing_data_type
file type from which to get input data
Default: ipw
Type: string
Options: ipw netcdf

ipysnobal initial conditions

init_file
full path to init file or last output file
Default: None
Type: filename

input_type
type of file for initializing ipysnobal run
Default: ipw
Type: string
Options: netcdf ipw ipw_out netcdf_out

ipysnobal constants

z_g
depth of soil temperature in meters
Default: 0.5
Type: float

z_t
height of temperature in meters
Default: 5.0
Type: float

z_u
height of wind speed in meters
Default: 5.0
Type: float