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: