Note

Please report issues with the manual on the GitHub 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: