Repository Mirror for your Cloud Server and Webhosting

Title:

Calculating Heat Stress

Version:

0.0.2

Description:

Implements the simpler and faster heat index, which matches the values of the original 1979 heat index and its 2022 extension for air temperatures above 300 K (27 C, 80 F) and with only minor differences at lower temperatures. Also implements an algorithm for calculating the thermodynamic (and psychrometric) wet-bulb (and ice-bulb) temperature.

URL:

https://heatindex.org

License:

MIT + file LICENSE

Encoding:

UTF-8

RoxygenNote:

7.3.2

Imports:

Rcpp

LinkingTo:

Rcpp

SystemRequirements:

C++17

NeedsCompilation:

yes

Packaged:

2025-07-18 00:16:39 UTC; davidromps

Author:

Yi-Chuan Lu

[aut], David M. Romps

[aut, cre]

Maintainer:

David M. Romps <romps@berkeley.edu>

Repository:

CRAN

Date/Publication:

2025-07-18 08:40:07 UTC

Heat index

Description

heatindex is a simpler and faster version of the heat index that was originally defined in 1979, used by the U.S. National Weather Service, extended to all combinations of temperature and humidity in 2022, and then made simpler and faster in 2025. This simpler and faster version uses a simpler set of physiological equations and a faster computational algorithm without altering the values of the heat index above 300 K (27 C, 80 F) and with only minor changes in the heat index at lower temperatures.

Usage

heatindex(T, rh)

Arguments

T

The absolute air temperature in Kelvin. This can be a single number, a vector, a matrix, or an array, but its dimensions must match those of rh.

rh

The relative humidity of the air, with values in the range of 0 to 1, with respect to saturation over liquid water for air temperatures over 273.16 K and with respect to saturation over ice for air temperatures lower than 273.16 K. This can be a single number, a vector, a matrix, or an array, but its dimensions must match those of T.

Value

The values of the heat index, in Kelvin, in the same shape as T and rh.

Author(s)

Yi-Chuan Lu yclu@berkeley.edu and David M. Romps romps@berkeley.edu

References

Steadman, R. G. (1979). The assessment of sultriness. Part I: A temperature-humidity index based on human physiology and clothing science. Journal of Applied Meteorology, 18, 861-873. doi:10.1175/1520-0450(1979)018<0861:TAOSPI>2.0.CO;2

Lu, X. and Romps, D. M. (2022). Extending the heat index. Journal of Applied Meteorology, 61, 10, 1367–1383. doi:10.1175/jamc-d-22-0021.1

Lu et al. (2025). Simpler and faster: an improved heat index. In review. For citation details, see https://heatindex.org/docs/citation/.

Examples

heatindex(300,0.5)
heatindex(295:305,0:10/10)

Relative humidity from wet-bulb temperature

Description

rh_from_wetbulb calculates the relative humidity from the thermodynamic (or psychrometric) wet-bulb (or ice-bulb) temperature using the Rankine-Kirchhoff approximations.

Usage

rh_from_wetbulb(
  p,
  T,
  Tw,
  psychrometric = FALSE,
  icebulb = FALSE,
  verbose = TRUE,
  lewis = 0.85
)

Arguments

p

The total air pressuire in Pa. This can be a single number, a vector, a matrix, or an array.

T

The absolute air temperature in Kelvin. This can be a single number, a vector, a matrix, or an array.

Tw

The thermodynamic (or psychrometric) wet-bulb (or ice-bulb) temperature in Kelving. This can be a single number, a vector, a matrix, or an array.

psychrometric

A logical indicating whether to interpret Tw as the psychrometric (if TRUE) or thermodynamic (if FALSE) version. Default is FALSE.

icebulb

A logical indicating whether to interpret Tw as the ice-bulb (if TRUE) or wet-bulb (if FALSE) version. Default is FALSE.

verbose

A logical indicating whether or not to print warning messages. Default is TRUE.

lewis

The Lewis number for moist air. Default is 0.85.

Value

Relative humidity in the same shape as p, T, and Tw. The relative humidity is reported with respect to liquid water if T is greater than or equal to 273.16 K and with respect to ice if T is less than 273.16 K.

Author(s)

David M. Romps romps@berkeley.edu

References

Romps, D. M. (2025). Wet-bulb temperature from pressure, relative humidity, and air temperature. In review.

Examples

rh_from_wetbulb(1e5,300,290)
rh_from_wetbulb(1e5,301:310,290)
rh_from_wetbulb(1e5,301:310,291:300)
rh_from_wetbulb(1:10*1e4,301:310,291:300)

Wet-bulb temperature

Description

wetbulb calculates the thermodynamic (or psychrometric) wet-bulb (or ice-bulb) temperature using the Rankine-Kirchhoff approximations.

Usage

wetbulb(
  p,
  T,
  rh,
  psychrometric = FALSE,
  icebulb = FALSE,
  verbose = TRUE,
  lewis = 0.85
)

Arguments

p

The total air pressuire in Pa. This can be a single number, a vector, a matrix, or an array.

T

The absolute air temperature in Kelvin. This can be a single number, a vector, a matrix, or an array.

rh

psychrometric

A logical indicating whether to calculate the thermodynamic wet-bulb temperature (if FALSE) or the psychometric (a.k.a., ventilated or aspirated) wet-bulb temperature (if TRUE). Default is FALSE.

icebulb

A logical indicating whether to calculate the temperature of an ice-bulb (if TRUE) or wet-bulb (if FALSE). Default is FALSE.

verbose

A logical indicating whether or not to print warning messages. Default is TRUE.

lewis

The Lewis number for moist air. Default is 0.85.

Value

The values of the wet-bulb temperature, in Kelvin, in the same shape as p, T, and rh.

Author(s)

David M. Romps romps@berkeley.edu

References

Romps, D. M. (2025). Wet-bulb temperature from pressure, relative humidity, and air temperature. In review.

Examples

wetbulb(1e5,300,0)
wetbulb(1e5,301:310,0)
wetbulb(1e5,301:310,1:10/10)
wetbulb(1:10*1e4,301:310,1:10/10)