Note

  1. Please report issues with the manual on the GitHub page.

  2. Please cite SUEWS with proper information from our Zenodo page.

4.5. CBL input files

Main references for this part of the model: Onomura et al. (2015) [Shiho2015] and Cleugh and Grimmond (2001) [CG2001].

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

4.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 [Shiho2015].

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

4.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: