Changeset 1718 for trunk/src/STAtmosphere.h

Timestamp:

03/29/10 14:46:23 (14 years ago)

Author:

Max Voronkov

Message:

updated documentation to reflect better interpretation of the pressure

File:

• trunk/src/STAtmosphere.h (modified) (3 diffs)

trunk/src/STAtmosphere.h

@@ -89 +89 @@
    * Constructor with explicitly given parameters of the atmosphere 
    * @param[in] temperature air temperature at the observatory (K)
+   * @param[in] pressure air pressure at the sea level if the observatory elevation 
+   *            is set to non-zero value (note, by default is set to 200m) or at the 
+   *            observatory ground level if the elevation is set to 0. (The value is in Pascals)
    * @param[in] pressure air pressure at the observatory (Pascals)
    * @param[in] humidity air humidity at the observatory (fraction)
@@ -104 +107 @@
    * Set the new weather station data, recompute the model 
    * @param[in] temperature air temperature at the observatory (K)
-   * @param[in] pressure air pressure at the observatory (Pascals)
+   * @param[in] pressure air pressure at the sea level if the observatory elevation 
+   *            is set to non-zero value (note, by default is set to 200m) or at the 
+   *            observatory ground level if the elevation is set to 0. (The value is in Pascals)
    * @param[in] humidity air humidity at the observatory (fraction)
    **/
@@ -111 +116 @@
   /**
    * Set the elevation of the observatory (height above mean sea level)
+   *
+   * The observatory elevation affects only interpretation of the pressure supplied as part 
+   * of the weather data, if this value is non-zero, the pressure (e.g. in setWeather or 
+   * constructor) is that at mean sea level. If the observatory elevation is set to zero, 
+   * regardless on real elevation, the pressure is that at the observatory ground level.
+   *
    * By default, 200m is assumed.
    * @param[in] elev elevation in metres