View Source

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 script (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.

Please note that in order to use this icon from script (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.