Tip

  1. Need help? Please let us know in the UMEP Community.

  2. Please report issues with the manual on the GitHub Issues.

  3. 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

CBL_initial_data.txt

Gives initial data every morning * when CBL slab model starts running. * filename must match the InitialData_FileName in CBLInput.nml * fixed formats.

CBLInput.nml

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: