= Biometeorology module =

The PALM biometeorology module ([source:palm/trunk/SOURCE/biometeorology_mod.f90]) consists of the two separate module parts "Human Thermal Comfort Module" (HTCM) and "UV Exposure Model" (UVEM). 

== Human Thermal Comfort Module (HTCM) ==

The Human Thermal Comfort Module (HTCM) ca be used to calculate thermal indices estimating the thermal perception of humans considering the conditions within the model domain. HTCM supports the two dimensional calculation of there thermal indices:[[BR]]
- Perceived Temperature (perct*)
- Universal Thermal Climate Index (utci*)
- Physiologically Equivalent Temperature (pet*)
All three indices can be calculated based on instantaneous or on time-averaged input parameters. A detailed description about the three indices can be found in the [wiki:doc/app/biometeorology_parameters#References respective publications].

To meet the recommendations of the [wiki:doc/tec/mas agent module], an instationary version of the perceived temperature (ipt) has been developed and added to the HTCM to estimate the thermal perception of the agents while moving through the model domain. 

= Reference =

The HTCM is described in more detail in Fröhlich, D. and Matzarakis, A.: "Calculating human thermal comfort and thermal stress in the PALM model system 6.0". Submitted to Geoscientific Model Development (GMD), Special Issue: The PALM model system 6.0 for atmospheric and oceanic boundary-layer flows: model description and applications in urban environments.

----

This documentation contains several pages:
 [wiki:doc/app/biometeorology_parameters INPUT]:: List of all namelist parameters that can be used to control the HTCM\\\\
 [wiki:doc/tec/biomet/examples EXAMPLE SETUPS]:: Files to carry out example runs using HTCM\\\\
 [wiki:doc/tec/biomet/output OUTPUT]:: Description of all output given by HTCM: files and messages\\\\
 [wiki:doc/tec/biomet/implementation CODE STRUCTURE]:: Description of the technical implementation of HTCM into PALM\\\\
Click on any icon below to get to the respective part of the documentation.\\\\

[[Image(button_input.png,120px,link=wiki:doc/app/biometeorology_parameters)]]
[[Image(button_ex_setup.png,120px,link=wiki:doc/tec/biomet/examples)]] 
[[Image(6_button_output.png,120px,link=wiki:doc/tec/biomet/output)]]
[[Image(button_code_structure.png,120px,link=wiki:doc/tec/biomet/implementation)]]  \\\\\\\\  

[[Image(r3591_klein_rueppurr_jarda_bio_perct*_xy.gif, 1100)]]

== UV Exposure Model (UVEM) ==

With r3477 a UV Exposure Model has been added to PALM. It can be used to calculate the Vitamin D,,3,, weighted exposure of a human within an urban environment.\\

This documentation contains several sections:
 INPUT:: List of all namelist parameters that can be used to steer the uv exposure model\\\\
 EXAMPLE SETUPS:: Files to carry out example runs using the uv exposure model\\\\
 BASIC MODEL:: Description of the basic uv exposure model parameters and equation\\\\
 OBSTACLES:: Description of the parameter environmental obstacles (e.g. trees, buildings), which is essential to perform calculations of the human exposure in urban environments\\\\
 OUTPUT:: Description of all output given by the uv exposure model\\\\
 CODE STRUCTURE:: Description of the technical implementation of the uv exposure model into PALM\\\\
Click on any icon below to get to the respective part of the documentation.\\\\

[[Image(1_button_input.png,120px,link=wiki:doc/app/biometeorology_parameters)]] 
[[Image(2_button_ex_setup.png,120px,link=browser:palm/trunk/EXAMPLES/bio_meteorology/)]] 
[[Image(3_basicExpo.png,120px,link=wiki:doc/tec/biomet/uv_basic_model)]] 
[[Image(5_Obs.png,120px,link=wiki:doc/tec/biomet/uv_obstacles)]] 
[[Image(6_button_output.png,120px,link=wiki:doc/tec/biomet/uv_output)]]
[[Image(7_button_code_structure.png,120px,link=wiki:doc/tec/biomet/uv_implementation)]]  \\\\\\\\
   
[[Image(Expo_berlin_legend.gif,740)]]\\\\
Exposure map for the vitamin D,,3,, production of a human on June 21 (clear sky) at Ernst-Reuter-Platz in Berlin.\\
The human wears summer clothing (face, neck, arms & hands are exposed) and is always orientated towards the sun.