What is the hist_type2d_pertape?

[dayon]

In the document "1.2.3.2.12. Example: user_nl_clm namelist outputting some files in 1D Vector format", as displayed:​

hist_fincl2 = 'TG'
hist_fincl3 = 'TG'
hist_fincl4 = 'TG'
hist_fincl5 = 'TG'
hist_fincl6 = 'TG'
hist_dov2xy = .true., .false., .false., .false.
hist_type2d_pertape = ' ', 'GRID', 'COLS', ' '
hist_nhtfrq = 0, -24, -24, -24

when I follow the parameter "hist_type2d_pertape " the ./case.build failed, maybe it is hist_type1d_pertape rather than hist_type2d_pertape.
ERROR: in _validate_pair (package Build::NamelistDefinition): Variable name hist_type2d_pertape not found in /home/dayon/cesm2_1_3/components/clm/bld/namelist_files/namelist_definition_drv.xml, /home/dayon/cesm2_1_3/components/clm/bld/namelist_files/namelist_definition_drv_flds.xml, /home/dayon/cesm2_1_3/components/clm/bld/namelist_files/namelist_definition_clm4_5.xml

However, the hist_fincl* above is from 2 to 6, that is 5 streams. but why the hist_dov2xy, hist_type2d_pertape, and hist_nhtfrq only have 4 elements?

 

[oleson]

That section of the User's Guide does have a lot of errors in it, sorry!
It should be hist_type1d_pertape, not hist_type2d_pertape.

In combination with setting hist_dov2xy to .false., the hist_type1d_pertape variable allows you to output a given variable or variables as a 1D vector, either as "GRID" (grid cell), "LAND" (landunit), "COLS" (column), or "PFTS" (plant functional type).

A better example of how to use this for TG (which is a column-level variable) would be:

hist_fincl2 = 'TG'
hist_fincl3 = 'TG'
hist_dov2xy = .true., .false., .false.
hist_type1d_pertape = ' ', 'GRID', 'COLS'
hist_nhtfrq = 0, -24, -24

This would provide TG as a 2d gridcell-average monthly-average variable on the primary history file (h0), as a 1D gridcell-average daily-average variable on h1, and as a 1D column-level daily-average variable on h2.

Note that the LAND and COLS bug mentioned in the documentation has been fixed.

 

[dayon]

That section of the User's Guide does have a lot of errors in it, sorry!
It should be hist_type1d_pertape, not hist_type2d_pertape.

In combination with setting hist_dov2xy to .false., the hist_type1d_pertape variable allows you to output a given variable or variables as a 1D vector, either as "GRID" (grid cell), "LAND" (landunit), "COLS" (column), or "PFTS" (plant functional type).

A better example of how to use this for TG (which is a column-level variable) would be:

hist_fincl2 = 'TG'
hist_fincl3 = 'TG'
hist_dov2xy = .true., .false., .false.
hist_type1d_pertape = ' ', 'GRID', 'COLS'
hist_nhtfrq = 0, -24, -24

This would provide TG as a 2d gridcell-average monthly-average variable on the primary history file (h0), as a 1D gridcell-average daily-average variable on h1, and as a 1D column-level daily-average variable on h2.

Note that the LAND and COLS bug mentioned in the documentation has been fixed.

Thanks, oleson. your explanation is clear and detailed. Maybe there is a lot of errors in the User's Guide, it does need to be updated.