Tip
Need help? Please let us know in the UMEP Community.
Please report issues with the manual on the GitHub Issues.
Please cite SUEWS with proper information from our Zenodo page.
3.5. 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 |
3.5.1. 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 |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
︙ |
3.5.2. 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: