Scheduled Downtime
On Tuesday 24 October 2023 @ 5pm MT the forums will be in read only mode in preparation for the downtime. On Wednesday 25 October 2023 @ 5am MT, this website will be down for maintenance and expected to return online later in the morning.
Normal Operations
The forums are back online with normal operations. If you notice any issues or errors related to the forums, please reach out to help@ucar.edu

What is the hist_type2d_pertape?

dayon

Member

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?
 

Attachments

  • 1.jpg
    1.jpg
    264.1 KB · Views: 5

oleson

Keith Oleson
CSEG and Liaisons
Staff member
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

Member
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.
 
Top