Reference-Compatible Outdoor Wet Bulb Globe Temperature

Computes outdoor wet bulb globe temperature using the reference-compatible Liljegren numerical model described by Liljegren et al. (2008) . Provides dependency-free, vectorized access to the native calculation with explicit input units, per-row validation, and deterministic failure reporting.

lwbgt

lwbgt provides dependency-free, vectorized R access to the Liljegren outdoor WBGT C kernel. The same numerical kernel powers the Python, Julia, Swift, and native C interfaces. Input names and units match the native and Python APIs.

Install from CRAN:

install.packages("lwbgt")

If CRAN is unavailable, use R-universe:

install.packages("lwbgt", repos = "https://zyf0717.r-universe.dev")

library(lwbgt)

input <- lwbgt_input(
    year = 2024, month = 4, day = 15, hour = 14, minute = 30,
    gmt_offset_hours = 8, averaging_minutes = 60, urban = 1,
    latitude_deg_north = 1.3521, longitude_deg_east = 103.8198,
    solar_w_m2 = 742, pressure_hpa = 1008.4,
    air_temperature_c = 32.1, relative_humidity_percent = 68,
    wind_speed_m_s = 2.8, wind_height_m = 10,
    vertical_temperature_difference_c = 1
)
calculate(input)
esat(273.15)

calculate(input, psychrometric = FALSE) skips the independent psychrometric wet-bulb solve and returns NA for that column. It is calculated by default; the other calculations are unchanged. Skipping a failed psychrometric solve can allow a row to return successful WBGT results.

Rows with missing, invalid, or non-convergent inputs return a nonzero status and NA numerical outputs without preventing other rows from being calculated.

See the input guide for sourcing and fallback assumptions, the compatibility policy for numerical guarantees and reference comparisons, and the documentation index for the shared kernel and its interfaces.