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_p() , eqpott_p() and seqpott_p() (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:

There is an additional top level option called Level Type to select the level type:

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.


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_p() , eqpott_p() and seqpott_p()


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.