= Biometeorology parameters =
[[TracNav(doc/app/partoc|nocollapse)]]

== Biometeorology Module ==

With r3XXX a Biometeorology Module (Biomet_Mod) was implemented in PALM. It can provide spatially distributed values of the three thermal indices 

- Perceived Temperature (PT, see Staiger et al. (2012))
- Universal Thermal Climate Index (UTCI, see Jendritzky et al. (2012))
- Physiologically Equivalent Temperature (PET, see Höppe (1993))

that describe thermal perception / thermal stress of a sample human being under the local meteorological conditions. 

[=#steering '''Steering:]\\
\\\\
NAMELIST group name: [=#inipar '''biometeorology_parameters''']\\
----
The module is enabled as soon as the namelist biometeorology_parameters exists. The calculation of the individual indices can be '''switched off (default is on)''' by setting them to .F. This of course requires the Biomet_Mod to be enabled (see above).

||='''Parameter Name'''  =||='''[[../fortrantypes|FORTRAN]]\\[[../fortrantypes|Type]]'''  =||='''Default\\Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; width: 150px"
[=#biom_pt '''biom_pt''']
}}}
{{{#!td style="vertical-align:top; width: 50px"
L
}}}
{{{#!td style="vertical-align:top; width: 75px"
.T.
}}}
{{{#!td
Switch the calculation of Perceived Temperature off (.F.) or on (.T.).
}}}
||
{{{#!td style="vertical-align:top; width: 150px"
[=#biom_utci '''biom_utci''']
}}}
{{{#!td style="vertical-align:top; width: 50px"
L
}}}
{{{#!td style="vertical-align:top; width: 75px"
.T.
}}}
{{{#!td
Switch the calculation of Universal Thermal Climate Index off (.F.) or on (.T.).
}}}
||
{{{#!td style="vertical-align:top; width: 150px"
[=#biom_pet '''biom_pet''']
}}}
{{{#!td style="vertical-align:top; width: 50px"
L
}}}
{{{#!td style="vertical-align:top; width: 75px"
.T.
}}}
{{{#!td 
Switch the calculation of Physiologically Equivalent Temperature off (.F.) or on (.T.).
}}}
|----------------

\\\\




==== Output ====

Output by the Biomet_Mod is always two dimensional and is provided for the cell level closest to 1.1 m above ground level. All parameters are available for instantaneous and time-averaged input. A list of output quantities can be found below.
Output can be written to 2d and/or 3d files, where only the layer z=0 will be used.
To enable the output of the given quantity, please add
||= '''quantity''' =||= '''long name''' =||= '''unit''' =||= '''input type\\(instantaneous or averaged)''' =||= '''output file\\(2d or 3d)''' =||
|----------------
 {{{#!td style="vertical-align:top; width: 50px"
'biom_pt'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Perceived Temperature
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
instantanious input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
z=0 layer in 3d file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_pet'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Physiologically Equivalent Temperature
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
instantanious input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
z=0 layer in 3d file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_utci'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Universal Thermal Climate Index
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
instantanious input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
z=0 layer in 3d file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_pt_av'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Perceived Temperature
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
averaged input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
z=0 layer in 3d file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_pet_av'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Physiologically Equivalent Temperature
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
averaged input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
z=0 layer in 3d file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_utci_av'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Universal Thermal Climate Index
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
averaged input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
z=0 layer in 3d file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_pt_xy'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Perceived Temperature
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
instantanious input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
2d (xy) file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_pet_xy'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Physiologically Equivalent Temperature
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
instantanious input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
2d (xy) file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_utci_xy'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Universal Thermal Climate Index
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
instantanious input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
2d (xy) file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_pt_xy_av'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Perceived Temperature
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
averaged input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
2d (xy) file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_pet_xy_av'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Physiologically Equivalent Temperature
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
averaged input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
2d (xy) file
}}}
||
{{{#!td style="vertical-align:top; width: 50px"
'biom_utci_xy_av'
}}}
 {{{#!td style="vertical-align:top; width: 50px"
Universal Thermal Climate Index
}}}
 {{{#!td style="vertical-align:top; width: 50px"
°C
}}}
 {{{#!td style="vertical-align:top; width: 50px"
averaged input
}}}
 {{{#!td style="vertical-align:top; width: 50px"
2d (xy) file
}}}
||
|----------------
to the 
'''data_output'''  
section.

\\\\




==== Proofs: ====
- Staiger, H.; Laschewski, G.; and Graetz, A., 2012: The perceived temperature - a versatile index for the assessment of the human thermal environment. Part A: scientific basics. International Journal of Biometeorology 56(1), 165–176. doi: 10.1007/s00484-011-0409-6.
- Jendritzky, G.; Dear, de R.; and Havenith, G., 2012: UTCI-Why another thermal index? Int J Biometeorol (56), 421–428.
- Höppe, P. R., 1999: The physiological equivalent temperature – a universal index for the biometeorological assessment of the thermal environment. Int J Biometeorol 43, 71–75.



==== [#steering Steering] ====
==== [#string2 String2] ====
==== [#string3 String3] ====

Since r31xx biometeorology models are available in PALM....Biomet_Mod and UV exposure....

Short description of both modules. From here, we will then link to more detailed descriptions.

\\\\
NAMELIST group name: [=#biometpar '''biometeorology_parameters''']\\
----
\\\\
[=#steering '''Steering:]\\
||='''Parameter Name'''  =||='''[[../fortrantypes|FORTRAN]]\\[[../fortrantypes|Type]]'''  =||='''Default\\Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; width: 150px"
[=#land_category '''land_category''']
}}}
{{{#!td style="vertical-align:top; width: 50px"
I
}}}
{{{#!td style="vertical-align:top; width: 75px"
1
}}}
{{{#!td
Category for land surface.\\\\
Here, a detailed description follows...Maybe also link to an example input file.
}}}
|----------------