This icon returns a GRIB field of one of the following :
- potential temperature
- equivalent potential temperature
- saturated equivalent potential temperature
Inputs are temperature, logarithm of surface pressure (lnsp) (only if the input data is specified in model levels) and specific humidity (only if calculating equivalent potential temperature). See Holton, 3rd Ed, Appendix D, eq. D-9, for details on the scientific background
The generated fields can be simply visualised or saved as GRIB files.
From Macro/Python the icon can be called via the following set of functions: pott_m() , eqpott_m(), seqpott_m(), pott_pl() , eqpott_pl() and seqpott_pl() (see description below).
The Potential Temperature Editor
The Potential Temperature editor belongs to a type of editors known as family editors which allows related sets of input specifications to be grouped in the same icon editor. The main computation type can be set via the Application parameter which offers these options:
- Potential Temperature - To derive a potential temperature field from temperature data (and lnsp if using model levels)
- Equivalent Potential Temperature - To derive an equivalent potential temperature field from temperature and humidity data (and lnsp if using model levels)
- Saturated Equivalent Potential Temperature - To derive a saturated equivalent potential temperature field from temperature data (and lnsp if using model levels)
There is an additional top level option called Level Type to select the level type:
- Model Levels - Derives the output using model levels. Requires an lnsp field additional to the temperature (and specific humidity) input data.
- Pressure Levels - Derives the output using pressure levels. Requires only the temperature (and specific humidity) input data.
To operate with this icon first you need to select which type of potential temperature field you want to create (parameter Application) then set the type of level of your input (parameter Level Type ). The available parameters will then change in the editor according to your selection.
Script functions
In order to use this icon from Macro/Python you ned to use a different function for each top level parameter combination. For model levels the corresponding set of functions are as follows:
pott_m() , eqpott_m(), seqpott_m()
while for pressure levels the names are similar but take a different suffix:
pott_pl() , eqpott_pl() and seqpott_pl()
Lnsp
Specifies the lnsp field as a GRIB icon. Only available/required when Level Type is set to Model Levels.
Temperature
Specifies the temperature field as a GRIB icon on either model or pressure levels.
Humidity
Specifies the specific humidity field as a GRIB icon on either model or pressure levels. Only available/required when Application is set to Equivalent Potential Temperature.