You are here

Home » Data & Archives

Harvard Forest Data Archive

HF446

HURRECON Model for Estimating Hurricane Wind Speed, Direction, and Damage (R and Python)

Related Publications

Data

  • HF446-01: source code in R and Python v. 1.1

Overview

  • Lead: Emery Boose
  • Investigators:
  • Contact: Information Manager
  • Start date:
  • End date:
  • Status: complete
  • Location: Global
  • Latitude: -90 to +90 degrees
  • Longitude: -180 to +180 degrees
  • Elevation:
  • Datum: WGS84
  • Taxa:
  • Release date: 2024
  • Language: English
  • EML file: knb-lter-hfr.446.1
  • DOI: digital object identifier
  • EDI: data package
  • DataONE: data package
  • Related links:
  • Study type: modeling
  • Research topic: ecological informatics and modelling
  • LTER core area: disturbance patterns
  • Keywords: geographic information systems, hurricane damage, meteorology, models, region, wind
  • Abstract:

    The HURRECON model estimates wind speed, wind direction, enhanced Fujita scale wind damage, and duration of EF0 to EF5 winds as a function of hurricane location and maximum sustained wind speed. Results may be generated for a single site or an entire region. Hurricane track and intensity data may be imported directly from the US National Hurricane Center's HURDAT2 database. HURRECON is available in R and Python. The R version is available on CRAN as HurreconR.

    The model is an updated version of the original HURRECON model written in Borland Pascal for use with Idrisi (see HF025). New features include support for: (1) estimating wind damage on the enhanced Fujita scale, (2) importing hurricane track and intensity data directly from HURDAT2, (3) creating a land-water file with user-selected geographic coordinates and spatial resolution, and (4) creating plots of site and regional results. The model equations for estimating wind speed and direction, including parameter values for inflow angle, friction factor, and wind gust factor (over land and water), are unchanged from the original HURRECON model. For more details and sample datasets, see the project website on GitHub (https://github.com/hurrecon-model).

  • Methods:

    Getting Started

    Here are the basic steps for using the model: (1) Create a directory for a set of related model runs with subdirectories for input and output files as described below. (2) Create a site file ("sites.csv") with geographic coordinates for one or more study sites. (3) Download or create geographic and political boundary shapefiles for the desired geographic region. The coordinate system should be latitude/longitude (degrees). Rename these files so the first name of each file is "boundaries". (4) Create a land-water file ("land_water.tif") for the region. (5) Create a parameter file ("parameters.csv") with parameters for all hurricanes and (optionally) for particular hurricanes. (6) Create an input hurricane track file ("input_tracks.csv") for the geographic region. If desired, this file can be created directly from HURDAT2. (7) Run the model to create site and regional estimates. Use the plot functions to view model results.

    Details

    All user functions begin with "hurrecon". Input CSV files have a single header line that contains variable names. Model results are generated for two cover types: water and land. Datetimes are assumed to be UTC (GMT). Raster files are in GeoTiff format. Geographic coordinates are assumed to be latitude/longitude (degrees). The following measurement units are used throughout: bearing and direction = degrees, distance = kilometers, speed = meters/second, time = minutes or hours.

    The user specifies a path (hur_path) for a given set of model runs. Input and output files are stored on the following subdirectories of this path: hur_path/input, hur_path/region, hur_path/region-all, hur_path/region-dt, hur_path/site, hur_path/site-all, hur_path/vector. The input subdirectory contains input files. The site and region subdirectories contain site and regional output files, respectively. Shapefiles that contain geographic and political boundaries for viewing regional results are stored on the vector subdirectory.

    The following input files are required: sites.csv, boundaries.*, land_water.tif, parameters.csv, input_tracks.csv. All input files (except boundary files) are located on the input subdirectory. The sites file contains the name, location, and cover type (water = 1, land = 2) of each study site. Variables: site_name, latitude, longitude, cover_type.

    The sites file contains the name, location, and cover type (water = 1, land = 2) of each study site. Variables: site_name, latitude, longitude, cover_type.

    The boundary files are vector shapefiles that are used for creating maps of regional results. These files are located on the vector subdirectory.

    The land-water file is a raster GeoTiff file that specifies the cover type (water = 1, land = 2) for each cell across a region. The geographic coordinates and the number of rows and columns of the land-water file are used to set the geographic window and spatial resolution for regional modeling.

    The parameters file contains model parameters (radius of maximum winds and scaling parameter) for all hurricanes and (optionally) for individual hurricanes. Variables: hur_id, rmw, s_par. This file must contain at least one record (hur_id = ALL) that specifies the default values of rmw and s_par. Values typically range from 20 to 100 km for rmw and from 1.2 to 1.5 for s_par, depending on the region.

    The input tracks file contains location and maximum wind speed for each position of each hurricane for a given set of model runs. Variables: hur_id, name, date_time, jd, status, latitude, longitude, wind_max.

    The input tracks file may be created directly from HURDAT2. Use the hurrecon_reformat_hurdat2 function to reformat a HUTDAT2 file as hurdat2_tracks.csv, rename this file to input_tracks.csv, and copy this file to the input subdirectory.

    The hurrecon_extract_tracks function is used to extract the data needed for a particular set of model runs. This function uses the input tracks file and the land-water file to create input files (ids.csv, tracks.csv, tracks-all.csv) required for the hurrecon_model functions.

    Model Functions

    The hurrecon_reformat_hurdat2 function reformats data from HURDAT2 for use with HURRECON. This is normally a one-time operation for a given version of HURDAT2. Hurricane IDs in HURDAT2 are reformatted to facilitate sorting by year (e.g. AL031935 becomes AL1935-03).

    The hurrecon_set_path function sets the path for the current set of model runs. The hurrecon_get_path function returns the current path. Use hurrecon_set_path before using other functions.

    The hurrecon_create_land_water function creates a land-water raster file in GeoTiff format using the specified minimum and maximum latitude and longitude, the number of rows and columns, and vector boundary files in shapefile format used to set the cover type of each cell. The land-water file is used by other functions to get the spatial parameters required for regional modeling. The hurrecon_extract_tracks function extracts data from an input tracks file (which may be derived from HURDAT2) for use with a particular land-water file. Optional parameters may be used to broaden the geographic area or adjust the minimum hurricane intensity when selecting hurricane tracks.

    The hurrecon_model functions generate output for a single hurricane and a single site (all datetimes), all hurricanes for a single site (peak values), a single hurricane for a specified geographic region (peak values or specified datetime), and all hurricanes for a specified geographic region (peak values). If save is TRUE (default), results are written to the site, site-all, region, region-all, or region-dt subdirectory as CSV or GeoTiff files. The default time step for site results is 1 minute. The default time step for regional results is calculated as the time required to traverse one cell in the vertical direction at 20 meters per second, rounded to one of these values: 1, 2, 3, 5, 10, 15, 30, or 60 minutes.

    The hurrecon_summarize_land_water function displays information about the current land-water file. The hurrecon_summarize_tracks function displays information about the current track files. The hurrecon_summarize_site function displays peak values for a single hurricane and a single site. The hurrecon_summarize_region function summarizes regional output for a single hurricane.

    The hurrecon_plot_site functions create time-series and scatter plots for a single hurricane and time-series plots for all hurricanes for a given site. The hurrecon_plot_tracks function creates a map of the land-water file with selected hurricane tracks. The hurrrecon_plot_region functions create maps of regional results for a single hurricane or for all hurricanes.

    Model Equations

    The sustained wind speed (Vs) at any point P in the northern hemisphere is estimated as: Vs = F[Vm - S(1 - sin T)Vh/2] * Sqrt[(Rm/R)^B * exp(1 - (Rm/R)^B)] where: F = scaling parameter for the effects of friction (water = 1.0, land = 0.8), Vm = maximum sustained wind speed over water anywhere in hurricane, S = scaling parameter for asymmetry due to forward motion of hurricane (1.0), T = clockwise angle between forward motion of hurricane and radial line to P, Vh = forward speed of hurricane, Rm = radius of maximum winds, R = radial distance from hurricane center to point P, and B = scaling parameter controlling shape of wind profile curve.

    The peak wind gust speed (Vg) at point P is estimated as: Vg = G * Vs where: G = gust factor (water = 1.2, land = 1.5).

    The wind direction (D) in degrees at point P is estimated as: D = Az - 90 - I where: Az = azimuth from point P to hurricane center and I = cross-isobar inflow angle (water = 20 degrees, land = 40 degrees). In the southern hemisphere: T = counterclockwise angle between forward motion of hurricane and radial line to P and D = Az + 90 + I.

  • Organization: Harvard Forest. 324 North Main Street, Petersham, MA 01366, USA. Phone (978) 724-3302. Fax (978) 724-3595.

  • Project: The Harvard Forest Long-Term Ecological Research (LTER) program examines ecological dynamics in the New England region resulting from natural disturbances, environmental change, and human impacts. (ROR).

  • Funding: National Science Foundation LTER grants: DEB-8811764, DEB-9411975, DEB-0080592, DEB-0620443, DEB-1237491, DEB-1832210.

  • Use: This dataset is released to the public under Creative Commons CC0 1.0 (No Rights Reserved). Please keep the dataset creators informed of any plans to use the dataset. Consultation with the original investigators is strongly encouraged. Publications and data products that make use of the dataset should include proper acknowledgement.

  • License: Creative Commons Zero v1.0 Universal (CC0-1.0)

  • Citation: Boose E. 2024. HURRECON Model for Estimating Hurricane Wind Speed, Direction, and Damage (R and Python). Harvard Forest Data Archive: HF446 (v.1). Environmental Data Initiative: https://doi.org/10.6073/pasta/1416f19219e3824de0c372a143a73f3e.

Detailed Metadata

HF446-01: source code in R and Python v. 1.1

  • Compression: zip
  • Format: R and Python scripts
  • Type: model