Tip
Need help? Please let us know in the SUEWS Community.
Please report issues with the manual on GitHub Issues (or use Report Issue for This Page for page-specific feedback).
Please cite SUEWS with proper information from our Zenodo page.
Warning
DEPRECATED: This table-based input format is deprecated as of 2025. Please use the modern YAML format instead. See our transition guide for migration help.
- orphan:
CBL input files#
Main references for this part of the model: Onomura et al. [2015] and Cleugh and Grimmond [2001].
If CBL slab model is used (CBLUse = 1 in RunControl.nml) the following files are needed.
Filename |
Purpose |
|---|---|
Gives initial data every morning * when CBL slab model starts running. * filename must match the InitialData_FileName in CBLInput.nml * fixed formats. |
|
Specifies run options, parameters and input file names. * Can be in any order |
CBL_initial_data.txt#
This file should give initial data every morning when CBL slab model starts running. The file name should match the InitialData_FileName in CBLInput.nml.
Definitions and example file of initial values prepared for Sacramento.
No. |
Column name |
Description |
|---|---|---|
1 |
id |
Day of year [DOY] |
2 |
zi0 |
Initial convective boundary layer height (m) |
3 |
gamt_Km |
Vertical gradient of potential temperature (K m-1) strength of the inversion |
4 |
gamq_gkgm |
Vertical gradient of specific humidity (g kg-1 m-1) |
5 |
Theta+_K |
Potential temperature at the top of CBL (K) |
6 |
q+_gkg |
Specific humidity at the top of CBL (g kg-1) |
7 |
Theta_K |
Potential temperature in CBL (K) |
8 |
q_gkg |
Specific humidiy in CBL (g kg-1) |
gamt_Km and gamq_gkgm written to two significant figures are required for the model performance in appropriate ranges [Onomura et al., 2015].
id |
zi0 |
gamt_Km |
gamq_gkgm |
Theta+_K |
q+_gkg |
theta_K |
q_gkg |
|---|---|---|---|---|---|---|---|
234 |
188 |
0.0032 |
0.00082 |
290.4 |
9.6 |
288.7 |
8.3 |
235 |
197 |
0.0089 |
0.089 |
290.2 |
8.4 |
288.3 |
8.7 |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
CBLInput.nml#
sample file of CBLInput.nml looks like
&CBLInput
EntrainmentType=1 ! 1.Tennekes and Driedonks(1981), 2.McNaughton and Springgs(1986), 3.Rayner and Watson(1991),4.Tennekes(1973),
QH_choice=1 ! 1.suews 2.lumps 3.obs
CO2_included=0
cblday(236)=1
cblday(258)=1
cblday(259)=1
cblday(260)=1
cblday(285)=1
cblday(297)=1
wsb=-0.01
InitialData_use=1
InitialDataFileName='CBLinputfiles/CBL_initial_data.txt'
sondeflag=0
FileSonde(234)='CBLinputfiles\Sonde_Sc_1991_0822_0650.txt'
FileSonde(235)='CBLinputfiles\Sonde_Sc_1991_0823_0715.txt'
FileSonde(236)='CBLinputfiles\Sonde_Sc_1991_0824_0647.txt'
FileSonde(238)='CBLinputfiles\Sonde_Sc_1991_0826_0642.txt'
FileSonde(239)='CBLinputfiles\Sonde_Sc_1991_0827_0640.txt'
FileSonde(240)='CBLinputfiles\Sonde_Sc_1991_0828_0640.txt'
/
Note
The file contents can be in any order.
The parameters and their setting instructions are provided through the links below: