*OBS Section

RFM Driver Table Sections: Observer Location

13DEC23
Type
Secondary Section — depends on OBS Flag.

Description
Specify observer position in altitude [km] and, optionally, horizontal angle [deg].

Format
PARAM=VALUE pairs, any order [6]
ParamTypeDescription Units
HGTOBS R Observer altitude [2] km
PREOBS R Observer pressure [2] hPa
PSIOBS R Observer horizontal angle [3] [4] deg
Type: R=Real

The allowed range of HGTOBS or PREOBS depends on the viewing geometry specified in the *TAN section, to ensure that the resulting path always intersects the atmosphere at some point.
Circular Geometry
*TAN/*GEO Tangent Point Altitude HGTOBS ≥ highest tangent point
*ELE Elevation Angle ≥ 0 HGTOBS within atmosphere
Elevation Angle < 0 HGTOBS low enough so path intersects atmosphere
Plane Parallel Geometry
*SEC+ZEN Upward viewing HGTOBS within atmosphere
*SEC+NAD Downward viewing No restriction

Notes
  1. Where the observer location is not specified (ie OBS Flag not enabled) it is assumed that the observer is either somewhere between the top of the atmosphere and infinity — the precise altitude makes no difference since the path is specified by tangent height or zenith angle — or, with ZEN flag, at the surface. With the GRA Flag, all tangent points are then taken to lie at PSI=0.
  2. Either HGTOBS or PREOBS can be specified, but not both. HGTOBS additionally requires that a height profile is specified in the *ATM section (a pressure profile is always required).
  3. When the GRA Flag is specified (2D atmosphere), all viewing is assumed to be in the direction +ve to −ve horizontal angle, ie the observer location would normally be specified as a positive angle (subtended at the centre of the earth, so about 110km for 1 deg) relative to the atmospheric profile locations specified in the *ATM section.
  4. When used in conjunction with the GRA Flag, the observer location PSIOBS determines the horizontal angle of the tangent point(s) relative to the reference profile (PSI=0). This information is written to the .pth diagnostics file.
  5. See LEV Flag for method of generating outputs equivalent to multiple observer altitudes within a single run.
  6. For compatibility with older versions of the RFM, the *OBS section can also contain just a single numerical value interpreted as HGTOBS and, if GRA Flag enabled, a second value interpreted as PSIOBS.

Examples
*OBS HGTOBS=25.0 ! Observer at 25 km. (1-D atmosphere)
*OBS PREOBS=100.0 ! Observer at 100 hPa PSIOBS=4.0 ! +4 deg from ref (2-D atmosphere).

Bugs
Bug#30 (Fixed v5.11)