---

WindSpd.c File Reference

#include "WindSpd.h"

Go to the source code of this file.

Functions
int	GetWindSpeedMpsFIXEDFromProps (ChHashTable * proptbl, double fbedhgtm, int month, int day, int hour, unsigned int row, unsigned int col, double * wspmps)
	retrieves time and space dependent windspeed, in m/s, at a cell. More...
int	GetWindSpeedMpsRANDUFromProps (ChHashTable * proptbl, double fbedhgtm, int month, int day, int hour, unsigned int row, unsigned int col, double * wspmps)
	retrieves time and space dependent windspeed, in m/s, at a cell. More...
int	GetWindSpeedMpsRANDHFromProps (ChHashTable * proptbl, double fbedhgtm, int month, int day, int hour, unsigned int row, unsigned int col, double * wspmps)
	retrieves time and space dependent windspeed, in m/s, at a cell. More...
int	GetWindSpeedMpsSPATIALFromProps (ChHashTable * proptbl, double fbedhgtm, int month, int day, int hour, unsigned int row, unsigned int col, double * wspmps)
	retrieves time and space dependent windspeed, in m/s, at a cell. More...
double	ConvertWindSpeedAtRefHgtToArbitraryHgt (double wsmps, double refhgtm, double hgtm)
	Given a windspeed at a reference height in m/s returns an adjusted windspeed at arbitrary height. More...

---

Detailed Description

Author(s):

Marco Morais

Date:

2000-2001

HFire (Highly Optmized Tolerance Fire Spread Model) Library Copyright (C) 2001 Marco Morais

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Definition in file WindSpd.c.

---

Function Documentation

double ConvertWindSpeedAtRefHgtToArbitraryHgt ( double wsmps, double refhgtm, double hgtm )

Given a windspeed at a reference height in m/s returns an adjusted windspeed at arbitrary height. Given a windspeed argument assumed to be taken at a reference height (usu. 20 feet, height of RAWS- Remote Automated Weather Station), returns the windspeed experienced at the height supplied as an argument. The formula used approximates a log profile and is described in (Albini and Baughman, 1979). The approach used here assumes the same logarithmic windspeed profile is valid for both daytime and nighttime. When correctinng windspeed for calculating dead fuel moisture, Rothermel (1986) suggests that the log profile is innapropriate during nighttime conditions. In addition, Beer (1990) suggests that the assumption of a logarithmic profile may be innapropriate when local atmospheric conditions are unstable. The macro WIND_SPD_REF_HGT_TO_MIDFLAME calls this function to retrieve the windspeed experienced in the distance halfway between the top of the fuel bed and the top of the flame above the fuel bed. Parameters: wsmps   value of windspeed in meters/sec at reference height above fuel bed refhgtm   reference height above fuel bed windspeed has been measured at, in meters hgtm   height at which the value for windspeed will be returned, in meters Return values: double   Windspeed corrected to an arbitrary height, in meters/sec Definition at line 200 of file WindSpd.c.

int ConvertWindSpeedUnitsToMps ( DblTwoDArray * wsp_tbl, const char * units )

Definition at line 224 of file WindSpd.c.

int GetWindSpeedMpsFIXEDFromProps ( ChHashTable * proptbl, double fbedhgtm, int month, int day, int hour, unsigned int row, unsigned int col, double * wspmps )

retrieves time and space dependent windspeed, in m/s, at a cell. Using this option each cell in the simulation domain is assigned the same windspeed based upon index into a table of historical values See also: ChHashTable , Check the config file documentation Parameters: proptbl   ChHashTable of simulation properties fbedhgtm   height of the fuel bed in meters month   date to retreive live fuel moisture for day   date to retreive live fuel moisture for hour   date to retreive live fuel moisture for row   index of cell to retrieve moisture from col   index of cell to retrieve moisture from wspmps   if function returns successfully, windspeed in m/s Return values: ERR_SUCCESS   (0) if operation successful, an error code otherwise Note: Best use of this facility is as follows: int error_status = SomeFunctionXXX(); if ( error_status ) // something bad happened Definition at line 27 of file WindSpd.c.

int GetWindSpeedMpsRANDHFromProps ( ChHashTable * proptbl, double fbedhgtm, int month, int day, int hour, unsigned int row, unsigned int col, double * wspmps )

retrieves time and space dependent windspeed, in m/s, at a cell. Using this option each cell in the simulation domain is assigned the same windspeed based upon random index into a table of historical values See also: ChHashTable , Check the config file documentation Parameters: proptbl   ChHashTable of simulation properties fbedhgtm   height of the fuel bed in meters month   date to retreive live fuel moisture for day   date to retreive live fuel moisture for hour   date to retreive live fuel moisture for row   index of cell to retrieve moisture from col   index of cell to retrieve moisture from wspmps   if function returns successfully, windspeed in m/s Return values: ERR_SUCCESS   (0) if operation successful, an error code otherwise Note: Best use of this facility is as follows: int error_status = SomeFunctionXXX(); if ( error_status ) // something bad happened Definition at line 123 of file WindSpd.c.

int GetWindSpeedMpsRANDUFromProps ( ChHashTable * proptbl, double fbedhgtm, int month, int day, int hour, unsigned int row, unsigned int col, double * wspmps )

retrieves time and space dependent windspeed, in m/s, at a cell. Using this option each cell in the simulation domain is assigned the same windspeed based upon a constrained uniform random number generating function See also: ChHashTable , Check the config file documentation Parameters: proptbl   ChHashTable of simulation properties fbedhgtm   height of the fuel bed in meters month   date to retreive live fuel moisture for day   date to retreive live fuel moisture for hour   date to retreive live fuel moisture for row   index of cell to retrieve moisture from col   index of cell to retrieve moisture from wspmps   if function returns successfully, windspeed in m/s Return values: ERR_SUCCESS   (0) if operation successful, an error code otherwise Note: Best use of this facility is as follows: int error_status = SomeFunctionXXX(); if ( error_status ) // something bad happened Definition at line 95 of file WindSpd.c.

int GetWindSpeedMpsSPATIALFromProps ( ChHashTable * proptbl, double fbedhgtm, int month, int day, int hour, unsigned int row, unsigned int col, double * wspmps )

retrieves time and space dependent windspeed, in m/s, at a cell. Using this option each cell in the simulation domain is assigned a unique windspeed based upon index into a raster of windspeeds See also: ChHashTable , Check the config file documentation Parameters: proptbl   ChHashTable of simulation properties fbedhgtm   height of the fuel bed in meters month   date to retreive live fuel moisture for day   date to retreive live fuel moisture for hour   date to retreive live fuel moisture for row   index of cell to retrieve moisture from col   index of cell to retrieve moisture from wspmps   if function returns successfully, windspeed in m/s Return values: ERR_SUCCESS   (0) if operation successful, an error code otherwise Note: Best use of this facility is as follows: int error_status = SomeFunctionXXX(); if ( error_status ) // something bad happened Definition at line 189 of file WindSpd.c.

---