spatialBehaviour {StormR} | R Documentation |
Computing wind behaviour and summary statistics over given areas
Description
The spatialBehaviour() function allows computing wind speed and direction for each cell of a regular grid (i.e., a raster) for a given tropical cyclone or set of tropical cyclones. It also allows to compute three associated summary statistics.
Usage
spatialBehaviour(
sts,
product = "MSW",
windThreshold = NULL,
method = "Willoughby",
asymmetry = "Chen",
empiricalRMW = FALSE,
spaceRes = "2.5min",
tempRes = 60,
verbose = 2
)
Arguments
sts |
|
product |
character vector. Desired output statistics:
|
windThreshold |
numeric vector. Minimal wind threshold(s) (in |
method |
character. Model used to compute wind speed and direction. Three different models are implemented:
|
asymmetry |
character. If
|
empiricalRMW |
logical. Whether (TRUE) or not (FALSE) to compute
the radius of maximum wind ( |
spaceRes |
character. Spatial resolution. Can be |
tempRes |
numeric. Temporal resolution (min). Can be |
verbose |
numeric. Whether or not the function should display informations about the process and/or outputs. Can be:
|
Details
Storm track data sets, such as those extracted from IBRTrACKS (Knapp et
al., 2010), usually provide observation at a 3- or 6-hours temporal
resolution. In the spatialBehaviour() function, linear interpolations are
used to reach the temporal resolution specified in the tempRes
argument
(default value = 60 min). When product = "MSW"
, product = "PDI"
,
or product = "Exposure"
the focal()
function from the terra
R package
is used to smooth the results using moving windows.
The Holland (1980) model, widely used in the literature, is based on the 'gradient wind balance in mature tropical cyclones. The wind speed distribution is computed from the circular air pressure field, which can be derived from the central and environmental pressure and the radius of maximum winds.
with,
where, is the tangential wind speed (in
),
is the shape parameter,
is the air density set to
,
being the base of natural logarithms (~2.718282),
the maximum sustained wind speed (in
),
is the pressure at outermost closed isobar of the storm (in
),
is the pressure at the centre of the storm (in
),
is the distance to the eye of the storm (in
),
is the radius of maximum sustained wind speed (in
),
is the Coriolis force (in
, and
being the latitude).
The Willoughby et al. (2006) model is an empirical model fitted to aircraft observations. The model considers two regions: inside the eye and at external radii, for which the wind formulations use different exponents to better match observations. In this model, the wind speed increases as a power function of the radius inside the eye and decays exponentially outside the eye after a smooth polynomial transition across the eyewall.
with,
and
where, is the tangential wind speed (in
),
is the maximum sustained wind speed (in
),
is the distance to the eye of the storm (in
),
is the radius of maximum sustained wind speed (in
),
is the latitude of the centre of the storm,
.
Asymmetry can be added to Holland (1980) and Willoughby et al. (2006) wind fields as follows,
where, is the combined asymmetric wind field,
is symmetric wind field,
is the translation speed of the storm, and
is function of
, the distance to the eye of the storm (in
).
Two formulations of C proposed by Miyazaki et al. (1962) and Chen (1994) are implemented.
Miyazaki et al. (1962)
Chen (1994)
where, is the radius of maximum sustained wind speed (in
)
The Boose et al. (2004) model, or “HURRECON” model, is a modification of the Holland (1980) model. In addition to adding asymmetry, this model treats of water and land differently, using different surface friction coefficient for each.
with,
where, is the tangential wind speed (in
),
is a scaling parameter for friction (
in water,
in land),
is the maximum sustained wind speed (in
),
is a scaling parameter for asymmetry (usually set to
),
is the oriented angle (clockwise/counter clockwise in Northern/Southern Hemisphere) between
the forward trajectory of the storm and a radial line from the eye of the storm to point $r$
is the storm velocity (in
),
is the radius of maximum sustained wind speed (in
),
is the distance to the eye of the storm (in
),
is the shape parameter,
is the air density (in
),
is the pressure at outermost closed isobar of the storm (in
), and
is the pressure at the centre of the storm (
in
).
Value
The spatialBehaviour() function returns SpatRaster objects (in WGS84).
The number of layers in the output depends on the number of storms in the inputs,
on the desired product
, as well as the tempRes
argument:
if
product = "MSW"
, the function returns one layer for eachStorm
. The names of the layer follow the following terminology, the name of the storm in capital letters and “MSW” separated by underscores (e.g., "PAM_MSW"),if
product = "PDI"
, the function returns one layer for eachStorm
. The names of the layer follow the following terminology, the name of the storm in capital letters and “PDI” separated by underscores (e.g., "PAM_PDI"),if
product ="Exposure"
, the function returns one layer for each wind speed values in thewindThreshold
argument and for eachStorm
. The names of the layer follow the following terminology, the name of the storm in capital letters, "Exposure", and the threshold value separated by underscores (e.g., "PAM_Exposure_18", "PAM_Exposure_33", ...),if
product = "Profiles"
the function returns one layer for wind speed and one layer for wind direction for each observation or interpolated observation and eachStorm
. The names of the layer follow the following terminology, the name of the storm in capital letters, "Speed" or "Direction", and the indices of the observation separated by underscores (e.g., "PAM_Speed_41", "PAM_Direction_41",...).
References
Boose, E. R., Serrano, M. I., & Foster, D. R. (2004). Landscape and regional impacts of hurricanes in Puerto Rico. Ecological Monographs, 74(2), Article 2. https://doi.org/10.1890/02-4057
Chen, K.-M. (1994). A computation method for typhoon wind field. Tropic Oceanology, 13(2), 41–48.
Holland, G. J. (1980). An Analytic Model of the Wind and Pressure Profiles in Hurricanes. Monthly Weather Review, 108(8), 1212–1218. https://doi.org/10.1175/1520-0493(1980)108<1212:AAMOTW>2.0.CO;2
Knapp, K. R., Kruk, M. C., Levinson, D. H., Diamond, H. J., & Neumann, C. J. (2010). The International Best Track Archive for Climate Stewardship (IBTrACS). Bulletin of the American Meteorological Society, 91(3), Article 3. https://doi.org/10.1175/2009bams2755.1
Miyazaki, M., Ueno, T., & Unoki, S. (1962). The theoretical investigations of typhoon surges along the Japanese coast (II). Oceanographical Magazine, 13(2), 103–117.
Willoughby, H. E., Darling, R. W. R., & Rahn, M. E. (2006). Parametric Representation of the Primary Hurricane Vortex. Part II: A New Family of Sectionally Continuous Profiles. Monthly Weather Review, 134(4), 1102–1120. https://doi.org/10.1175/MWR3106.1
Examples
# Creating a stormsDataset
sds <- defStormsDataset()
# Geting storm track data for tropical cyclone Pam (2015) near Vanuatu
pam <- defStormsList(sds = sds, loi = "Vanuatu", names = "PAM")
# Computing maximum sustained wind speed generated by Pam (2015) near Vanuatu
# using default settings
msw.pam <- spatialBehaviour(pam)
# Computing PDI generated by Pam (2015) near Vanuatu using the Holland model without asymmetry
pdi.pam <- spatialBehaviour(pam, method = "Holland", product = "PDI", asymmetry = "None")
# Computing duration of exposure to Saffir-Simpson hurricane wind scale threshold values
# during Pam (2015) near Vanuatu using default settings
exp.pam <- spatialBehaviour(pam, product = "Exposure")
# Computing wind speed and direction profiles generated by Pam (2015) near Vanuatu
# using Boose model
prof.pam <- spatialBehaviour(pam, product = "Profiles", method = "Boose")