All Classes Functions
List of all members | Public Member Functions
IPromeApp Class Reference

Interface PromeApp. More...

import "PrometheusCOM.idl";

Collaboration diagram for IPromeApp:
Collaboration graph

Public Member Functions

HRESULT Initialize ()
 
HRESULT UnInitialize ()
 
HRESULT ImportFuelsLookup ([in]const BSTR fileName)
 
HRESULT ExportFuelsLookup ([in]const BSTR FileName)
 
HRESULT ImportFuelGrid ([in]const BSTR projFileName, [in]const BSTR fileName)
 
HRESULT ExportFuelGrid ([in]const BSTR projFileName, [in]const BSTR fileName)
 
HRESULT ImportElevation ([in]const BSTR projFileName, [in]const BSTR elevationFile)
 
HRESULT ExportElevationSlopeAspect ([in]const BSTR projFileName, [in]const BSTR elevationFile, [in]const BSTR slopeFile, [in]const BSTR aspectFile)
 
HRESULT CreateGrid ([in]unsigned short xsize, [in]unsigned short ysize, [in]double latitude, [in]double longitude, [in]double xllcorner, [in]double yllcorner, [in]double resolution, [in]unsigned char fuel_index)
 
HRESULT GetGridDimension ([out]unsigned short *xDim, [out]unsigned short *yDim)
 
HRESULT GetGridLLCLocation ([out]double *lat, [out]double *lon)
 
HRESULT GetLLCOffset ([out]double *offX, [out]double *offY)
 
HRESULT SetBooleanAttribute ([in]unsigned short attribute_key, [in]VARIANT_BOOL value)
 
HRESULT GetBooleanAttribute ([in]unsigned short attribute_key, [out, retval]VARIANT_BOOL *value)
 
HRESULT SetIntegerAttribute ([in]unsigned short attribute_key, [in]int value)
 
HRESULT GetIntegerAttribute ([in]unsigned short attribute_key, [out, retval]int *value)
 
HRESULT SetDoubleAttribute ([in]unsigned short attribute_key, [in]double value)
 
HRESULT GetDoubleAttribute ([in]unsigned short attribute_key, [out, retval]double *value)
 
HRESULT SetStringAttribute ([in]unsigned short attribute_key, [in]BSTR value)
 
HRESULT GetStringAttribute ([in]unsigned short attribute_key, [out, retval]BSTR *value)
 
HRESULT GetGridValue ([in]unsigned short X, [in]unsigned short Y, [out]int *fuel_index)
 
HRESULT GetFuelIndexByName ([in]const BSTR FuelName, [out]unsigned char *lut_index)
 
HRESULT GetFuelNameByIndex ([in]int input_fuel_index, [out]BSTR *FuelName)
 
HRESULT CreateNewFuelFrom ([in]const BSTR OldFuelName, [in]const BSTR NewFuelName, [out]int *fuel_index)
 
HRESULT CreateNewFuelFromIndex ([in]int source_input_index, [in]const BSTR NewFuelName, [out]int *NewFuelIndex)
 
HRESULT DeleteFuel ([in]const BSTR FuelName)
 
HRESULT SetFuelDoubleAttribute ([in]int fuel_index, [in]unsigned short attribute_key, [in]double value)
 
HRESULT GetFuelDoubleAttribute ([in]int fuel_index, [in]unsigned short attribute_key, [out, retval]double *value)
 
HRESULT Ignition_Create ([in]const BSTR IgnitionName)
 
HRESULT Ignition_PutTime ([in]const BSTR IgnitionName, [in]const BSTR StartTime)
 
HRESULT Ignition_GetTime ([in]const BSTR IgnitionName, [out, retval]BSTR *StartTime)
 
HRESULT Ignition_Count ([in]const BSTR IgnitionName, [out, retval]int *count)
 
HRESULT Ignition_Clear ([in]const BSTR IgnitionName)
 
HRESULT Ignition_Size ([in]const BSTR IgnitionName, [in]int index, [out, retval]int *count)
 
HRESULT Ignition_MaxSize ([in]const BSTR IgnitionName, [out, retval]int *count)
 
HRESULT Ignition_Set ([in]const BSTR IgnitionName, [in]int index, [in]unsigned short ignition_type, [in] SAFEARRAY(double) xy_pairs)
 
HRESULT Ignition_Get ([in]const BSTR IgnitionName, [in]int index, [out]unsigned short *ignition_type, [out]int *ignition_size, [out]SAFEARRAY(double)*xy_pairs)
 
HRESULT Ignition_Type ([in]const BSTR IgnitionName, [in]int index, [out, retval]unsigned short *type)
 
HRESULT Ignition_Import ([in]const BSTR IgnitionName, [in]const BSTR fileName)
 
HRESULT Ignition_Export ([in]const BSTR IgnitionName, [in]const BSTR fileName)
 
HRESULT Ignition_Delete ([in]const BSTR IgnitionName)
 
HRESULT Ignition_Number ([out, retval]int *count)
 
HRESULT Ignition_PutName ([in]int index, [in]const BSTR IgnitionName)
 
HRESULT Ignition_GetName ([in]int index, [out, retval]BSTR *IgnitionName)
 
HRESULT Ignition_GetIndex ([in]const BSTR IgnitionName, [out, retval]int *index)
 
HRESULT Scenario_Create ([in]const BSTR ScenarioName)
 
HRESULT Scenario_Copy ([in]const BSTR fromScenarioName, [in]const BSTR newScenarioName)
 
HRESULT Scenario_SetDoubleAttribute ([in]const BSTR ScenarioName, [in]unsigned short attribute_key, [in]double value)
 
HRESULT Scenario_GetDoubleAttribute ([in]const BSTR ScenarioName, [in]unsigned short attribute_key, [out, retval]double *value)
 
HRESULT Scenario_SetBooleanAttribute ([in]const BSTR ScenarioName, [in]unsigned short attribute_key, [in]VARIANT_BOOL value)
 
HRESULT Scenario_GetBooleanAttribute ([in]const BSTR ScenarioName, [in]unsigned short attribute_key, [out, retval]VARIANT_BOOL *value)
 
HRESULT Scenario_SetIntegerAttribute ([in]const BSTR ScenarioName, [in]unsigned short attribute_key, [in]int value)
 
HRESULT Scenario_GetIntegerAttribute ([in]const BSTR ScenarioName, [in]unsigned short attribute_key, [out, retval]int *value)
 
HRESULT Scenario_SetTime ([in]const BSTR ScenarioName, [in]const BSTR StartTime, [in]const BSTR EndTime)
 
HRESULT Scenario_GetTime ([in]const BSTR ScenarioName, [out]BSTR *StartTime, [out]BSTR *EndTime)
 
HRESULT Scenario_SetBurnCondition ([in]const BSTR ScenarioName, [in]int Day, [in]VARIANT_BOOL Effective, [in]int StartHour, [in]int EndHour, [in]double WSThreshold, [in]double RHThreshold, [in]double FWIThreshold)
 
HRESULT Scenario_GetBurnCondition ([in]const BSTR ScenarioName, [in]int Day, [out]VARIANT_BOOL *Effective, [out]int *StartHour, [out]int *EndHour, [out]double *WSThreshold, [out]double *RHThreshold, [out]double *FWIThreshold)
 
HRESULT Scenario_SetDefaultBurnCondition ([in]const BSTR ScenarioName, [in]VARIANT_BOOL Effective, [in]int StartHour, [in]int EndHour, [in]double WSThreshold, [in]double RHThreshold, [in]double FWIThreshold)
 
HRESULT Scenario_GetDefaultBurnCondition ([in]const BSTR ScenarioName, [out]VARIANT_BOOL *Effective, [out]int *StartHour, [out]int *EndHour, [out]double *WSThreshold, [out]double *RHThreshold, [out]double *FWIThreshold)
 
HRESULT Scenario_GetIgnitionCount ([in]const BSTR ScenarioName, [out, retval]int *count)
 
HRESULT Scenario_AddIgnition ([in]const BSTR ScenarioName, [in]const BSTR FireID)
 
HRESULT Scenario_RemoveIgnition ([in]const BSTR ScenarioName, [in]const BSTR FireID)
 
HRESULT Scenario_IgnitionAtIndex ([in]const BSTR ScenarioName, [in]int index, [out, retval]BSTR *FireID)
 
HRESULT Scenario_IndexOfIgnition ([in]const BSTR ScenarioName, [in]const BSTR FireID, [out, retval]int *index)
 
HRESULT Scenario_GetVectorCount ([in]const BSTR ScenarioName, [out, retval]int *count)
 
HRESULT Scenario_AddVector ([in]const BSTR ScenarioName, [in]const BSTR VectorName)
 
HRESULT Scenario_RemoveVector ([in]const BSTR ScenarioName, [in]const BSTR VectorName)
 
HRESULT Scenario_VectorAtIndex ([in]const BSTR ScenarioName, [in]int index, [out, retval]BSTR *VectorName)
 
HRESULT Scenario_IndexOfVector ([in]const BSTR ScenarioName, [in]const BSTR VectorName, [out, retval]int *index)
 
HRESULT Scenario_GetWxStreamCount ([in]const BSTR ScenarioName, [out, retval]int *count)
 
HRESULT Scenario_AddWxStream ([in]const BSTR ScenarioName, [in]const BSTR StationName, [in]const BSTR StreamName)
 
HRESULT Scenario_RemoveWxStream ([in]const BSTR ScenarioName, [in]const BSTR StationName, [in]const BSTR StreamName)
 
HRESULT Scenario_WxStreamAtIndex ([in]const BSTR ScenarioName, [in]int index, [out]BSTR *StationName, [out]BSTR *StreamName)
 
HRESULT Scenario_IndexOfWxStream ([in]const BSTR ScenarioName, [in]const BSTR StationName, [in]const BSTR StreamName, [out, retval]int *index)
 
HRESULT Scenario_GetFilterCount ([in]const BSTR ScenarioName, [out, retval]int *count)
 
HRESULT Scenario_InsertFilter ([in]const BSTR ScenarioName, [in]const BSTR FilterID, [in]int index)
 
HRESULT Scenario_RemoveFilter ([in]const BSTR ScenarioName, [in]const BSTR FilterID)
 
HRESULT Scenario_FilterAtIndex ([in]const BSTR ScenarioName, [in]int index, [out, retval]BSTR *FilterID)
 
HRESULT Scenario_IndexOfFilter ([in]const BSTR ScenarioName, [in]const BSTR FilterID, [out, retval]int *index)
 
HRESULT Scenario_Delete ([in]const BSTR ScenarioName)
 
HRESULT Scenario_Number ([out, retval]int *count)
 
HRESULT Scenario_PutName ([in]int index, [in]const BSTR ScenarioName)
 
HRESULT Scenario_GetName ([in]int index, [out, retval]BSTR *ScenarioName)
 
HRESULT Scenario_GetIndex ([in]const BSTR ScenarioName, [out, retval]int *index)
 
HRESULT Scenario_GetGridValue ([in]const BSTR ScenarioName, [in]unsigned short X, [in]unsigned short Y, [out]int *fuel_index)
 
HRESULT Simulate ([in]const BSTR ScenarioName)
 
HRESULT SimulateThreeSteps ([in]const BSTR ScenarioName, [out]long *StepResult)
 
HRESULT SimulateEightSteps ([in]const BSTR ScenarioName, [out]long *StepResult)
 
HRESULT GetAreaChange ([in]const BSTR ScenarioName, [out, retval]double *areaChange)
 
HRESULT GetArea ([in]const BSTR ScenarioName, [out, retval]double *area)
 
HRESULT GetNumOfVertices ([in]const BSTR ScenarioName, [out, retval]long *Num)
 
HRESULT GetIndexVertex ([in]const BSTR ScenarioName, [in]long index, [in, out]double *X, [in, out]double *Y)
 
HRESULT GetNumOfNewVertices ([in]const BSTR ScenarioName, [out, retval]long *ResultNum)
 
HRESULT SimulateStep ([in]const BSTR ScenarioName)
 
HRESULT SimulateStop ([in]const BSTR ScenarioName)
 
HRESULT SimulateRestart ([in]const BSTR ScenarioName)
 
HRESULT ExportScenarioFireFront ([in]const BSTR ScenarioName, [in]const BSTR FileName, [in]const BSTR StartTime, [in]const BSTR EndTime, [in]int only_active, [in]int only_exterior, [in]int combine_all, [in]const BSTR perimeter_units, [in]const BSTR area_units)
 
HRESULT IsXYBurned ([in]const BSTR ScenarioName, [in]double X, [in]double Y, [out, retval]int *burned)
 
HRESULT GetXYParameters ([in]const BSTR ScenarioName,[in]double X, [in]double Y, [in]unsigned short interp_method, [out]double *ros, [out]double *fi,[out]double *raz,[out]double *sfc,[out]double *cfb,[out]double *cfc,[out]double *tfc)
 
HRESULT GetBurnedBox ([in]const BSTR ScenarioName, [out]int *left, [out]int *right, [out]int *bottom, [out]int *top)
 
HRESULT WxStation_Create ([in]const BSTR StationName)
 
HRESULT WxStation_Delete ([in]const BSTR StationName)
 
HRESULT WxStation_SetLocation (const BSTR StationName, [in]double Latitude, [in]double Longitude, [in]double Elevation)
 
HRESULT WxStation_GetLocation (const BSTR StationName, [out]double *Latitude, [out]double *Longitude, [out]double *Elevation)
 
HRESULT WxStation_Number ([out, retval]int *count)
 
HRESULT WxStation_PutName ([in]int index, [in]const BSTR StationName)
 
HRESULT WxStation_GetName ([in]int index, [out, retval]BSTR *StationName)
 
HRESULT WxStation_GetIndex ([in]const BSTR StationName, [out, retval]int *index)
 
HRESULT WxStream_Create ([in]const BSTR StationName, [in]const BSTR StreamName, [in]const BSTR StartTime)
 
HRESULT WxStream_Import ([in]const BSTR StationName, [in]const BSTR StreamName, [in]const BSTR fileName)
 
HRESULT WxStream_Export ([in]const BSTR StationName, [in]const BSTR StreamName, [in]const BSTR fileName, [in]int flags)
 
HRESULT WxStream_Delete ([in]const BSTR StationName, [in]const BSTR StreamName)
 
HRESULT WxStream_Number ([in]const BSTR StationName, [in, out]int *NumOfStreams)
 
HRESULT WxStream_PutName ([in]const BSTR StationName, [in]int index, [in]const BSTR StreamName)
 
HRESULT WxStream_GetName ([in]const BSTR StationName, [in]int index, [out, retval]BSTR *StreamName)
 
HRESULT WxStream_GetIndex ([in]const BSTR StationName, [in]const BSTR StreamName, [out, retval]int *index)
 
HRESULT WxStream_GetStartTime ([in]const BSTR StationName, [in]const BSTR StreamName, [out, retval]BSTR *StartTime)
 
HRESULT WxStream_SetDoubleAttribute ([in]const BSTR StationName, [in]const BSTR StreamName, [in]unsigned short attribute_key, [in]double value)
 
HRESULT WxStream_GetDoubleAttribute ([in]const BSTR StationName, [in]const BSTR StreamName, [in]unsigned short attribute_key, [out, retval]double *value)
 
HRESULT WxStream_SetBooleanAttribute ([in]const BSTR StationName, [in]const BSTR StreamName, [in]unsigned short attribute_key, [in]VARIANT_BOOL value)
 
HRESULT WxStream_GetBooleanAttribute ([in]const BSTR StationName, [in]const BSTR StreamName, [in]unsigned short attribute_key, [out, retval]VARIANT_BOOL *value)
 
HRESULT WxStream_SetIntegerAttribute ([in]const BSTR StationName, [in]const BSTR StreamName, [in]unsigned short attribute_key, [in]int value)
 
HRESULT WxStream_GetIntegerAttribute ([in]const BSTR StationName, [in]const BSTR StreamName, [in]unsigned short attribute_key, [out, retval]int *value)
 
HRESULT WxStream_EditWeatherDaily ([in]const BSTR StationName, [in]const BSTR StreamName, [in]const BSTR Day, [in]double MinTemp, [in]double MaxTemp, [in]double MinWS, [in]double MaxWS, [in]double MinRH, [in]double Preci, [in]double WD)
 
HRESULT WxStream_EditWeatherHourly ([in]const BSTR StationName, [in]const BSTR StreamName, [in]const BSTR Day, [in]long Hour, [in]double Temp, [in]double RH, [in]double WS, [in]double Preci, [in]double WD)
 
HRESULT WxStream_AddWeatherDaily ([in]const BSTR StationName, [in]const BSTR StreamName, [in]double min_temp, [in]double max_temp, [in]double min_ws, [in]double max_ws, [in]double rh, [in]double precip, [in]double wd)
 
HRESULT WxStream_ClearAllWeatherData ([in]const BSTR StationName, [in]const BSTR StreamName)
 
HRESULT Vector_Create ([in]const BSTR VectorName, [in]SAFEARRAY(double) xy_pairs, int is_polygon)
 
HRESULT Vector_Import ([in]const BSTR VectorName, [in]const BSTR fileName)
 
HRESULT Vector_Export ([in]const BSTR VectorName, [in]const BSTR fileName)
 
HRESULT Vector_Delete ([in]const BSTR VectorName)
 
HRESULT Vector_Number ([out, retval]int *count)
 
HRESULT Vector_PutName ([in]int index, [in]const BSTR VectorName)
 
HRESULT Vector_GetName ([in]int index, [out, retval]BSTR *VectorName)
 
HRESULT Vector_GetIndex ([in]const BSTR VectorName, [out, retval]int *index)
 
HRESULT Vector_PutWidth ([in]const BSTR VectorName, [in]double width)
 
HRESULT Vector_GetWidth ([in]const BSTR VectorName, [out, retval]double *width)
 
HRESULT Filter_Delete ([in]const BSTR FilterName)
 
HRESULT Filter_Number ([out, retval]int *count)
 
HRESULT Filter_PutName ([in]int index, [in]const BSTR FilterName)
 
HRESULT Filter_GetName ([in]int index, [out, retval]BSTR *FilterName)
 
HRESULT Filter_GetType ([in]int index, [out, retval]BSTR *FilterName)
 
HRESULT Filter_GetIndex ([in]const BSTR FilterName, [out, retval]int *index)
 
HRESULT Filter_FuelGrid_Create ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_FuelGrid_Export ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_Greenup_Create ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_Greenup_Export ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_Greenup_Set ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [in]int greenup_on)
 
HRESULT Filter_Greenup_Get ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [out, retval]int *greenup_on)
 
HRESULT Filter_CBH_Create ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_CBH_Export ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_CBH_Set ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [in]double cbh)
 
HRESULT Filter_CBH_Get ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [out, retval]double *cbh)
 
HRESULT Filter_TreeHeight_Create ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_TreeHeight_Export ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_TreeHeight_Set ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [in]double height)
 
HRESULT Filter_TreeHeight_Get ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [out, retval]double *height)
 
HRESULT Filter_PC_Create ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_PC_Export ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_PC_Set ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [in]int percent)
 
HRESULT Filter_PC_Get ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [out, retval]int *percent)
 
HRESULT Filter_PDF_Create ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_PDF_Export ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_PDF_Set ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [in]int percent)
 
HRESULT Filter_PDF_Get ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [out, retval]int *percent)
 
HRESULT Filter_CureGrass_Create ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_CureGrass_Export ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_CureGrass_Set ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [in]int percent)
 
HRESULT Filter_CureGrass_Get ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [out, retval]int *percent)
 
HRESULT Filter_FuelLandscape_Create ([in]const BSTR FilterName)
 
HRESULT Filter_FuelPoly_Create ([in]const BSTR FilterName)
 
HRESULT Filter_Fuel_SetRelationship ([in]const BSTR FilterName, [in]unsigned short source_fuel_index, [in]unsigned short dest_fuel_index)
 
HRESULT Filter_Fuel_GetRelationship ([in]const BSTR FilterName, [out]unsigned short *source_fuel_index, [out]unsigned short *dest_fuel_index)
 
HRESULT Filter_FuelPoly_Count ([in]const BSTR FilterName, [out, retval]int *count)
 
HRESULT Filter_FuelPoly_Clear ([in]const BSTR FilterName)
 
HRESULT Filter_FuelPoly_Size ([in]const BSTR FilterName, [in]int index, [out, retval]int *count)
 
HRESULT Filter_FuelPoly_MaxSize ([in]const BSTR FilterName, [out, retval]int *count)
 
HRESULT Filter_FuelPoly_Set ([in]const BSTR FilterName, [in]SAFEARRAY(double) xy_pairs, [out]int *index)
 
HRESULT Filter_FuelPoly_Get ([in]const BSTR FilterName, [in]int index, [out]int *ignition_size, [out]SAFEARRAY(double)*xy_pairs)
 
HRESULT Filter_FuelPoly_Import ([in]const BSTR FilterName, [in]const BSTR fileName)
 
HRESULT Filter_FuelPoly_Export ([in]const BSTR FilterName, [in]const BSTR fileName)
 
HRESULT Filter_FuelPoly_Area ([in]const BSTR FilterName, [out, retval]double *area)
 
HRESULT Filter_WxPoly_Create ([in]const BSTR FilterName)
 
HRESULT Filter_Wx_SetTime ([in]const BSTR FilterName, [in]const BSTR StartTime, [in]const BSTR EndTime)
 
HRESULT Filter_Wx_GetTime ([in]const BSTR FilterName, [out]BSTR *StartTime, [out]BSTR *EndTime)
 
HRESULT Filter_WxPoly_SetRule ([in]const BSTR FilterName, [in]int raw_input, [in]unsigned short operation, [in]double value)
 
HRESULT Filter_WxPoly_GetRule ([in]const BSTR FilterName, [in]int raw_input, [out]unsigned short *operation, [out]double *value)
 
HRESULT Filter_WxPoly_Count ([in]const BSTR FilterName, [out, retval]int *count)
 
HRESULT Filter_WxPoly_Clear ([in]const BSTR FilterName)
 
HRESULT Filter_WxPoly_Size ([in]const BSTR FilterName, [in]int index, [out, retval]int *count)
 
HRESULT Filter_WxPoly_MaxSize ([in]const BSTR FilterName, [out, retval]int *count)
 
HRESULT Filter_WxPoly_Set ([in]const BSTR FilterName, [in]SAFEARRAY(double) xy_pairs, [out]int *index)
 
HRESULT Filter_WxPoly_Get ([in]const BSTR FilterName, [in]int index, [out]int *ignition_size, [in, out]SAFEARRAY(double)*xy_pairs)
 
HRESULT Filter_WxPoly_Import ([in]const BSTR FilterName, [in]const BSTR fileName)
 
HRESULT Filter_WxPoly_Export ([in]const BSTR FilterName, [in]const BSTR fileName)
 
HRESULT Filter_WxPoly_Area ([in]const BSTR FilterName, [out, retval]double *area)
 
HRESULT Filter_WxLandscapeWD_Create ([in]const BSTR FilterName)
 
HRESULT Filter_WxLandscapeWS_Create ([in]const BSTR FilterName)
 
HRESULT Filter_WxLandscape_SetTimeSpan ([in]const BSTR FilterName, [in]const BSTR StartTimeOfDay, [in]const BSTR EndTimeOfDay)
 
HRESULT Filter_WxLandscape_GetTimeSpan ([in]const BSTR FilterName, [out]BSTR *StartTimeOfDay, [out]BSTR *EndTimeOfDay)
 
HRESULT Filter_WxLandscapeWD_Import ([in]const BSTR FilterName, [in]const unsigned short sector, [in]const double speed, [in] const BSTR prj_file_name, [in]const BSTR grid_file_name)
 
HRESULT Filter_WxLandscapeWD_Export ([in]const BSTR FilterName, [in]const unsigned short sector, [in]const double speed, [in] const BSTR prj_file_name, [in]const BSTR grid_file_name)
 
HRESULT Filter_WxLandscapeWD_SetSectorMode ([in]const BSTR FilterName, [in]int mode)
 
HRESULT Filter_WxLandscapeWD_GetSectorMode ([in]const BSTR FilterName, [out, retval]int *mode)
 
HRESULT Filter_WxLandscapeWD_Remove ([in]const BSTR FilterName, [in]const unsigned short sector, [in]const double speed)
 
HRESULT Filter_WxLandscapeWD_GetCount ([in]const BSTR FilterName, [in]const unsigned short sector, [out, retval]unsigned short *count)
 
HRESULT Filter_WxLandscapeWD_GetWindSpeeds ([in]const BSTR FilterName, [in]const unsigned short sector, [out]unsigned short *count, [in, out]SAFEARRAY(double)*speed_array)
 
HRESULT Filter_WxLandscapeWD_GetFilenames ([in]const BSTR FilterName, [in]const unsigned short sector, [out]SAFEARRAY(BSTR)*filenames)
 
HRESULT Filter_WxLandscapeWD_GetSectorCount ([in]const BSTR FilterName, [out, retval]unsigned short *count)
 
HRESULT Filter_WxLandscapeWD_GetSectorAngles ([in]const BSTR FilterName, [in]const unsigned short sector, [out]double *min_angle, [out]double *max_angle)
 
HRESULT Filter_WxLandscapeWD_ModifySectors ([in]const BSTR FilterName, [in]SAFEARRAY(unsigned short) original_sector, [in]SAFEARRAY(double) original_speed, [in]SAFEARRAY(unsigned short) new_sector, [in]SAFEARRAY(double) new_speed)
 
HRESULT Filter_WxLandscapeWS_Import ([in]const BSTR FilterName, [in]const unsigned short sector, [in]const double speed, [in] const BSTR prj_file_name, [in]const BSTR grid_file_name)
 
HRESULT Filter_WxLandscapeWS_Export ([in]const BSTR FilterName, [in]const unsigned short sector, [in]const double speed, [in] const BSTR prj_file_name, [in]const BSTR grid_file_name)
 
HRESULT Filter_WxLandscapeWS_SetSectorMode ([in]const BSTR FilterName, [in]int mode)
 
HRESULT Filter_WxLandscapeWS_GetSectorMode ([in]const BSTR FilterName, [out, retval]int *mode)
 
HRESULT Filter_WxLandscapeWS_Remove ([in]const BSTR FilterName, [in]const unsigned short sector, [in]const double speed)
 
HRESULT Filter_WxLandscapeWS_GetCount ([in]const BSTR FilterName, [in]const unsigned short sector, [out, retval]unsigned short *count)
 
HRESULT Filter_WxLandscapeWS_GetWindSpeeds ([in]const BSTR FilterName, [in]const unsigned short sector, [out]unsigned short *count, [in, out]SAFEARRAY(double)*speed_array)
 
HRESULT Filter_WxLandscapeWS_GetFilenames ([in]const BSTR FilterName, [in]const unsigned short sector, [out]SAFEARRAY(BSTR)*filenames)
 
HRESULT Filter_WxLandscapeWS_GetSectorCount ([in]const BSTR FilterName, [out, retval]unsigned short *count)
 
HRESULT Filter_WxLandscapeWS_GetSectorAngles ([in]const BSTR FilterName, [in]const unsigned short sector, [out]double *min_angle, [out]double *max_angle)
 
HRESULT Filter_WxLandscapeWS_ModifySectors ([in]const BSTR FilterName, [in]SAFEARRAY(unsigned short) original_sector, [in]SAFEARRAY(double) original_speed, [in]SAFEARRAY(unsigned short) new_sector, [in]SAFEARRAY(double) new_speed)
 
HRESULT Filter_TotalFuelLoad_Create ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_TotalFuelLoad_Export ([in]const BSTR FilterName, [in]const BSTR projFileName, [in]const BSTR FileName)
 
HRESULT Filter_TotalFuelLoad_Set ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [in]double load)
 
HRESULT Filter_TotalFuelLoad_Get ([in]const BSTR FilterName, [in]unsigned short X, [in]unsigned short Y, [out, retval]double *load)
 

Detailed Description

Interface PromeApp.

The Prometheus COM combines all of the low-level COMs to provide a high-level procedural interface that is easier for programmers to learn, understand and use. The COM is intended to be used by agencies interested in developing their own Fire Growth Model with a different user interface, or integrating the Prometheus Fire Growth Model into other applications. Additionally, the Microsoft Interop technology now allows modern .Net applications to use the high-level COM interface.

Member Function Documentation

IPromeApp::CreateGrid ( [in] unsigned short  xsize,
[in] unsigned short  ysize,
[in] double  latitude,
[in] double  longitude,
[in] double  xllcorner,
[in] double  yllcorner,
[in] double  resolution,
[in] unsigned char  fuel_index 
)

Creates a uniform xsize by ysize grid with xllcorner and yllcorner as the lower-left coordinate in world coordinate system. Currently all grids use the same projection and LUT information, and most of PrometheusCOM does not support the concept of multiple grids. Also, this function does not verify that the provided name for the new grid is unique (if multiple grids are to be continued to be supported).

Parameters
xsizeX dimension of the grid.
ysizeY dimension of the grid.
latitudeThe latitude the grid is based at.
longitudeThe longitude the grid is based at.
xllcornerX-coordinate of the lower-left corner of the grid.
yllcornerY-coordinate of the lower-left corner of the grid.
resolutionResolution of the grid (measured as number of metres per grid unit).
fuel_indexDefault fuel for the grid – it corresponds to a fuel index value used in the lookup table (if users are using the standard lookup table, the fuel_index should be the standard value for the corresponding fuel).
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_NOINTERFACEInternal error. Please report this to the PrometheusCOM development team.
ERROR_GRID_INITIALIZEDAttempting to set the same fuel map object twice.
ERROR_GRID_UNINITIALIZEDThe grid object is not initialized
E_INVALIDARGThe latitude/longitude used to set the world location are invalid, or if the arguments used to create the grid (e.g. xllcorner) are invalid.
ERROR_FUELS_FUEL_UNKNOWNThe fuel referenced by fuel_index is unknown.
ERROR_SCENARIO_SIMULATION_RUNNINGValue cannot be changed as it is being used by a currently running scenario.
TRUEOperation succeeded.
IPromeApp::CreateNewFuelFrom ( [in] const BSTR  OldFuelName,
[in] const BSTR  NewFuelName,
[out] int *  fuel_index 
)

Creates a new fuel type from an old fueltype. The COM first tries to locate a match via the FBP fuel name (from the LUT file), then the agency name, then will finally try to find a first "close match" to copy from. The new fuel name is assigned as the new fuels FBP name. The new fuel is assigned the same import and export indices. This function requires modification, because it does not verify that the provided name for the new fuel is unique.

Parameters
OldFuelNameName of the fuel to copy from.
NewFuelNameUnique FBP name of the newly created fuel.
fuel_indexThe index of the new fuel if the function is successful, otherwise the value will be set to 0.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_NOINTERFACEInternal error. Please report this to the PrometheusCOM development team.
ERROR_FUELS_FILEINDEX_ALREADY_ASSIGNEDThe fuel to add has assigned a non-unique file identifier that is not -1.
SUCCESS_FUELS_FUEL_ALREADY_ADDEDThe fuel to be added is already in the FuelMap; a particular fuel can occur in a FuelMap more than once.
ERROR_FUELS_FUEL_UNKNOWNThere is no fuel with that name.
ERROR_FUELS_FUEL_KNOWNThe name for the new fuel is not unique.
ERROR_SEVERITY_ERRORFailure to actually create the new fuel, even though other tests say it should be able to be created.
IPromeApp::CreateNewFuelFromIndex ( [in] int  source_input_index,
[in] const BSTR  NewFuelName,
[out] int *  NewFuelIndex 
)

This function is similar to the CreateNewFuelFrom function. The difference is this function requires an index to specify the source fuel to create new fuel from. If successfully executed, the fuel_index will contain the index for the new fuel, otherwise, fuel_index should be 0.

Parameters
source_input_indexIndex of the source fuel.
NewFuelNameUnique FBP name of the newly created fuel.
NewFuelIndexThe index of the new fuel if the function is successful, otherwise the value will be set to 0.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_FUELS_FUEL_UNKNOWNThe fuel referenced by fuel_index is unknown.
ERROR_FUELS_FUEL_KNOWNThe name for the new fuel is not unique.
ERROR_SEVERITY_ERRORFailure to actually create the new fuel, even though other tests say it should be able to be created.
IPromeApp::DeleteFuel ( [in] const BSTR  FuelName)

This function will delete a given fuel type from the set of fuels.

Parameters
FuelNameName of fuel type to delete
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_FUELS_FUEL_USEDCannot delete a fuel which is in use (by a grid or patch)
ERROR_FUELS_FUEL_UNKNOWNThe fuel referenced by fuel_index is unknown.
IPromeApp::ExportElevationSlopeAspect ( [in] const BSTR  projFileName,
[in] const BSTR  elevationFile,
[in] const BSTR  slopeFile,
[in] const BSTR  aspectFile 
)

Exports the project elevation, slope, or aspect file and the corresponding projection file.

Parameters
projFileNameString identifying the name and path of the projection file.
elevationFileString identifying the name and path of elevation grid file.
slopeFileString identifying the name and path of the slope grid file.
aspectFileString identifying the name and path of the aspect grid file.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_ACCESS_DENIEDAccess denied.
ERROR_INVALID_HANDLEThe handle has been invalidated, or closed.
ERROR_FILE_EXISTSThe file exists.
ERROR_INVALID_PARAMETERThe parameter is incorrect.
ERROR_TOO_MANY_OPEN_FILESSystem error; current application has too many files open.
ERROR_FILE_NOT_FOUNDThe specified file could not be found.
ERROR_HANDLE_DISK_FULLThe disk is full.
E_POINTERAddress provided is invalid.
E_INVALIDARGInvalid parameters.
ERROR_GRID_UNINITIALIZEDThe grid is not initialized properly.
IPromeApp::ExportFuelGrid ( [in] const BSTR  projFileName,
[in] const BSTR  filename 
)

Exports the project's default (original) fuel grid along with the corresponding projection file.

Parameters
filenameCharacter string identifying the name and path of the export file.
projFileNameString identifying the name and path of the projection file.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_ACCESS_DENIEDAccess denied.
ERROR_INVALID_HANDLEThe handle has been invalidated, or closed.
ERROR_FILE_EXISTSThe file exists.
ERROR_INVALID_PARAMETERThe parameter is incorrect.
ERROR_TOO_MANY_OPEN_FILESSystem error; current application has too many files open.
ERROR_FILE_NOT_FOUNDThe specified file could not be found.
ERROR_HANDLE_DISK_FULLThe disk is full.
E_POINTERAddress provided is invalid.
E_INVALIDARGInvalid parameters.
IPromeApp::ExportFuelsLookup ( [in] const BSTR  fileName)

Exports the fuel lookup table (LUT) being used in the COM model. This file is an ASCII text file and is compatible with Prometheus.

Parameters
fileNameCharacter string identifying the name and path of the export file.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::ExportScenarioFireFront ( [in] const BSTR  ScenarioName,
[in] const BSTR  FileName,
[in] const BSTR  StartTime,
[in] const BSTR  EndTime,
[in] int  only_active,
[in] int  only_exterior,
[in] int  combine_all,
[in] const BSTR  perimeter_units,
[in] const BSTR  area_units 
)

Exports the fire front of the specified scenario. The scenario must contain at least one step's simulation data, otherwise this function will fail.

Parameters
ScenarioNameUnique identifier for a scenario.
FileNameCharacter string identifying the name and path of the export file.
StartTimeStart time for which to export at. Only displayable time steps will be output. Time should be of format "YYYY-MM-DDTHH:MM:SS"
EndTimeEnd time for which to export at. Only displayable time steps will be output. Time should be of format "YYYY-MM-DDTHH:MM:SS"
only_activeOption to export only active parts of the fire front.
only_exteriorOption to export only exterior parts of the fire front.
combine_allOption to export all parts of the fire front.
perimeter_unitsUnits for which to report the perimeter length of the fire(s)
area_unitsUnits for which to report the area of the fire(s)
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error; or for an undetermined error in exporting
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioName does not resolve to a known scenario.
E_NOTIMPLMethod has not been implemented yet.
E_POINTERAddress provided is invalid.
ERROR_FIRE_INVALID_TIMEThe time specified is invalid.
E_INVALIDARGInvalid parameters.
ERROR_NO_DATAThere is no data.
E_FAILA general failure occurred.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
IPromeApp::Filter_CBH_Create ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

This method creates a new CBH (crown base height) grid which can be attached to any scenario. Only one CBH grid per scenario is currently allowed. This grid is an optional FBP input during simulations.

Parameters
FilterNameUnique identifier for the filter.
projFileNameString identifying the name and path to the projection file.
FileNameName of the file.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_CBH_Export ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

Exports a CBH grid identified by name to the filename directed.

Parameters
FileNameThe path and filename to export to.
projFileNameString identifying the name and path for the projection file.
FilterNameUniquely identifies the filter.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_CBH_Get ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[out,retval] double *  cbh 
)

Retrieves CBH given the grid's name, and the location within the grid.

Parameters
FilterNameUnique identifier for the filter.
Xx coordinate, grid units
Yy coordinate, grid units
cbhCBH
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
IPromeApp::Filter_CBH_Set ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[in] double  cbh 
)

Given the name, coordinates, sets the CBH.

Parameters
FilterNameUnique identifier of the filter.
Xx coordinate, grid units
Yy coordinate, grid units
cbhCBH (m).
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
IPromeApp::Filter_CureGrass_Create ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

This method creates a new CBH (crown base height) grid which can be attached to any scenario. Only one CBH grid per scenario is currently allowed. This grid is an optional FBP input during simulations.

Parameters
FilterNameUnique identifier for the filter.
projFileNameString identifying the name and path to the projection file.
FileNameName of the file.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_CureGrass_Export ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

Exports a grass curing percentage grid identified by name to the filename directed.

Parameters
FileNameThe path and filename to export to.
projFileNameString identifying the name and path for the projection file.
FilterNameUniquely identifies the filter.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_CureGrass_Get ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[out,retval] int *  percent 
)

Retrieves the grass curing percentage, given the grid's name, and the location within the grid.

Parameters
FilterNameUnique identifier for the filter.
Xx coordinate, grid units
Yy coordinate, grid units
percentGrass curing percentage
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
IPromeApp::Filter_CureGrass_Set ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[in] int  percent 
)

Given the name, coordinates, sets the grass curing percentage.

Parameters
FilterNameUnique identifier of the filter.
Xx coordinate, grid units
Yy coordinate, grid units
percentGrass curing percentage.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
IPromeApp::Filter_Delete ( [in] const BSTR  FilterName)

Deletes a filter identified by its name.

Parameters
FilterNameUnique identifier for the filter.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter by this name exists.
IPromeApp::Filter_Fuel_GetRelationship ( [in] const BSTR  FilterName,
[out] unsigned short *  source_fuel_index,
[out] unsigned short *  dest_fuel_index 
)

Retrieves the file import index of the source and destination fuels of a filter patch referenced by PatchName.

Parameters
FilterNameUnique identifier for the filter.
source_fuel_indexSet to the file import index of the source fuel on successful return. In addition to fuel index values (0 - 254), valid values are:
  • -1 indicates failure to identify the fuel.
  • 255 indicates all fuels
  • 256 indicates all combustible fuels
  • 257 indicates NODATA
dest_fuel_indexSet to the import index of the destination fuel on successful return. If dest_fuel_index is -1 indicates failure to identify the fuel patch.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
E_NOINTERFACENo interface.
IPromeApp::Filter_Fuel_SetRelationship ( [in] const BSTR  FilterName,
[in] unsigned short  source_fuel_index,
[in] unsigned short  dest_fuel_index 
)

Sets the source fuel name and destination fuel name for a patch filter.

Parameters
FilterNameUnique identifier of the filter.
source_fuel_indexSource fuel index. In addition to fuel index values (0 - 254), valid values are:
  • 255 indicates all fuels
  • 256 indicates all combustible fuels
  • 257 indicates NODATA
dest_fuel_indexDestination fuel index, or -1 to replace no fuels in the area.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_FUELS_FUEL_UNKNOWNNo such fuel exists.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter with this name.
IPromeApp::Filter_FuelGrid_Create ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

This method creates a new fuel grid filter.

Parameters
FilterNameUnique identifier for the filter.
projFileNameString identifying the name and path to the projection file.
FileNameName of the file.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_FuelGrid_Export ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

Exports a fuel grid filter identified by name to the filename directed.

Parameters
FileNameThe path and filename to export to.
projFileNameString identifying the name and path for the projection file.
FilterNameUniquely identifies the filter.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_FuelLandscape_Create ( [in] const BSTR  FilterName)

This method creates a new fuel landscape grid filter.

Parameters
FilterNameUnique identifier for the filter.
Return values
S_OKSuccessful.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SEVERITYWARNING Failed initialization or a non-specific I/O error.
IPromeApp::Filter_FuelPoly_Area ( [in] const BSTR  PatchName,
[out,retval] double *  area 
)

Calculates the area of the specified fuel patch and passes it into area.

Parameters
PatchNameUnique identifier for the filter.
areaIs set to the area upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_FuelPoly_Clear ( [in] const BSTR  FilterName)

Removes all polygons associated with this fuel patch.

Parameters
FilterNameUnique identifier for the filter.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter by this name exists.
IPromeApp::Filter_FuelPoly_Count ( [in] const BSTR  FilterName,
[out,retval] int *  count 
)

Retrieve the number of fuel polygons within a project.

Parameters
FilterNameUnique identifier for the filter.
countIs set to the count number upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_FuelPoly_Create ( [in] const BSTR  FilterName)

This method creates a new fuel polygon grid filter.

Parameters
FilterNameUnique identifier for the filter. Returns:
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_FuelPoly_Export ( [in] const BSTR  FilterName,
[in] const BSTR  fileName 
)

Exports a fuel patch identified by name to the filename directed.

Parameters
FileNameThe path and filename to export to.
projFileNameString identifying the name and path for the projection file.
FilterNameUniquely identifies the filter.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNThere is no filter with that name.
IPromeApp::Filter_FuelPoly_Get ( [in] const BSTR  FilterName,
[in] int  index,
[out] int *  ignition_size,
[out] SAFEARRAY(double)*  xy_pairs 
)

Returns the polygon data defining the polygon fuel patch.

Parameters
FilterNameUnique identifier for the filter.
indexIs set to the count number upon return.
ignition_sizeThe size of the ignition.
xy_pairs2D Array of coordinates
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_FuelPoly_Import ( [in] const BSTR  FilterName,
[in] const BSTR  fileName 
)

This function attempts to import a fuel polygon patch from a file.

Parameters
FilterNameUnique identifier for the fuel polygon patch.
fileNameThe file name and path of the file where the vector data is. The projection (and other) file(s) will be determined from the filename.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRID_FILTER_UNKNOWNThere is no grid filter with that name.
E_POINTERAddress provided is invalid.
ERROR_GRID_UNINITIALIZEDThe grid is not initialized properly.
S_FALSEfalse.
E_INVALIDARGInvalid parameters.
ERROR_FILE_NOT_FOUNDThe specified file could not be found.
ERROR_TOO_MANY_OPEN_FILESSystem error; current application has too many files open.
ERROR_ACCESS_DENIEDAccess denied.
ERROR_INVALID_HANDLEThe handle has been invalidated, or closed.
ERROR_FILE_EXISTSThe file exists.
ERROR_HANDLE_DISK_FULLThe disk is full.
E_FAILA general failure occurred.
IPromeApp::Filter_FuelPoly_MaxSize ( [in] const BSTR  FilterName,
[out,retval] int *  count 
)

Return the maximum size of a polygon given the name.

Parameters
FilterNameUnique identifier for the filter.
countIs set to the count number upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_FuelPoly_Set ( [in] const BSTR  FilterName,
[in] SAFEARRAY(double)  xy_pairs,
[out] int *  index 
)

Set the name, coordinates and index of a fuel polygon filter.

Parameters
FilterNameUnique identifier of the filter.
xy_pairs2D Array of coordinates
indexIs set to the filter's index upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_INVALIDARGInvalid parameters.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter with this name.
IPromeApp::Filter_FuelPoly_Size ( [in] const BSTR  FilterName,
[in] int  index,
[out,retval] int *  count 
)

Return the size of a polygon given the name and index of it.

Parameters
FilterNameUnique identifier for the filter.
countIs set to the count number upon return.
indexIndex of the fuel polygon filter.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_GetIndex ( [in] const BSTR  FilterName,
[out, retval] int *  index 
)

Retrieves the index of a filter given the name.

Parameters
indexSet to the index upon return.
FilterNameUnique identifier for the filter.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
IPromeApp::Filter_GetName ( [in] int  index,
[out, retval] BSTR *  FilterName 
)

Retrieves the name of a filter given its index.

Parameters
indexIndex of a filter.
FilterNameIs set to the filter name upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
IPromeApp::Filter_GetType ( [in] int  index,
[out, retval] BSTR *  FilterName 
)

Retrieves the name of a filter given the index.

Parameters
indexIndex of a filter.
FilterNameName of the filter's type (returned).
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
IPromeApp::Filter_Greenup_Create ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

This method creates and loads a new green-up grid which can be attached to any scenario. Only one green-up grid per scenario is currently allowed. This grid is an optional FBP input during simulations.

Parameters
FilterNameUnique identifier for the filter.
projFileNameString identifying the name and path to the projection file.
FileNameName of the file.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_Greenup_Export ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

Exports a green-up grid identified by name to the filename directed.

Parameters
FileNameThe path and filename to export to.
projFileNameString identifying the name and path for the projection file.
FilterNameUniquely identifies the filter.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_Greenup_Get ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[out,retval] int *  green_up_on 
)

Retrieves a green up state given the grid's name and the location within the grid.

Parameters
FilterNameUnique identifier for the filter.
XAn x coordinate
YA y coordinate
green_up_onWhether green-up is applied or not.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
IPromeApp::Filter_Greenup_Set ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[in] int  greenup_on 
)

Given the name, coordinates, sets whether or not green-up is on.

Parameters
FilterNameUnique identifier of the filter.
Xx coordinate, grid units
Yy coordinate, grid units
greenup_onWhether the green-up grid applies.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
IPromeApp::Filter_Number ( [out, retval] int *  count)

Retrieves the number of filters in a project.

Parameters
countSets this to the number of filters upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_PC_Create ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

This method creates a new CBH (crown base height) grid which can be attached to any scenario. Only one CBH grid per scenario is currently allowed. This grid is an optional FBP input during simulations.

Parameters
FilterNameUnique identifier for the filter.
projFileNameString identifying the name and path to the projection file.
FileNameName of the file.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_PC_Export ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

Exports a percentage conifer grid identified by name to the filename directed.

Parameters
FileNameThe path and filename to export to.
projFileNameString identifying the name and path for the projection file.
FilterNameUniquely identifies the filter.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_PC_Get ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[out,retval] int *  percent 
)

Retrieves PC given the grid's name, and the location within the grid.

Parameters
FilterNameUnique identifier for the filter.
Xx coordinate, grid units
Yy coordinate, grid units
percentPercentage Conifer
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
IPromeApp::Filter_PC_Set ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[in] int  percent 
)

Given the name, coordinates, sets the percentage conifer.

Parameters
FilterNameUnique identifier of the filter.
Xx coordinate, grid units
Yy coordinate, grid units
percentPercentage conifer.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
IPromeApp::Filter_PDF_Create ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

This method creates a new CBH (crown base height) grid which can be attached to any scenario. Only one CBH grid per scenario is currently allowed. This grid is an optional FBP input during simulations.

Parameters
FilterNameUnique identifier for the filter.
projFileNameString identifying the name and path to the projection file.
FileNameName of the file.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_PDF_Export ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

Exports a percentage dead fir grid identified by name to the filename directed.

Parameters
FileNameThe path and filename to export to.
projFileNameString identifying the name and path for the projection file.
FilterNameUniquely identifies the filter.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_PDF_Get ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[out,retval] int *  percent 
)

Retrieves CBH given the grid's name, and the location within the grid.

Parameters
FilterNameUnique identifier for the filter.
Xx coordinate, grid units
Yy coordinate, grid units
percentPercentage Dead Fir
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
IPromeApp::Filter_PDF_Set ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[in] int  percent 
)

Given the name, coordinates, sets the percentage dead fir.

Parameters
FilterNameUnique identifier of the filter.
Xx coordinate, grid units
Yy coordinate, grid units
percentPercentage dead fir.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
IPromeApp::Filter_PutName ( [in] int  index,
[in] const BSTR  FilterName 
)

Set the name of the filter at the index specified.

Parameters
indexIndex of the filter.
FilterNameUnique identifier for the filter.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_KNOWNThere already exists a filter with this name.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
IPromeApp::Filter_TotalFuelLoad_Create ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

This method creates a new total fuel load grid which can be attached to any scenario. Only one total fuel load grid per scenario is currently allowed. This grid is an optional input during simulations.

Parameters
FilterNameUnique identifier for the filter.
projFileNameString identifying the name and path to the projection file.
FileNameName of the file.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_TotalFuelLoad_Export ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

Exports a total fuel load grid identified by name to the filename directed.

Parameters
FileNameThe path and filename to export to.
projFileNameString identifying the name and path for the projection file.
FilterNameUniquely identifies the filter.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_TotalFuelLoad_Get ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[out,retval] double *  height 
)

Retrieves total fuel load given the grid's name, and the location within the grid.

Parameters
FilterNameUnique identifier for the filter.
Xx coordinate, grid units
Yy coordinate, grid units
heightTree height
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
IPromeApp::Filter_TotalFuelLoad_Set ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[in] double  load 
)

Given the name, coordinates, sets the total fuel load.

Parameters
FilterNameUnique identifier of the filter.
Xx coordinate, grid units
Yy coordinate, grid units
heightTree height (m).
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
IPromeApp::Filter_TreeHeight_Create ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

This method creates a new tree height grid which can be attached to any scenario. Only one tree height grid per scenario is currently allowed. This grid is an optional input during simulations, and affects breaching logic.

Parameters
FilterNameUnique identifier for the filter.
projFileNameString identifying the name and path to the projection file.
FileNameName of the file.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_TreeHeight_Export ( [in] const BSTR  FilterName,
[in] const BSTR  projFileName,
[in] const BSTR  FileName 
)

Exports a tree height grid identified by name to the filename directed.

Parameters
FileNameThe path and filename to export to.
projFileNameString identifying the name and path for the projection file.
FilterNameUniquely identifies the filter.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_TreeHeight_Get ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[out,retval] double *  height 
)

Retrieves tree height given the grid's name, and the location within the grid.

Parameters
FilterNameUnique identifier for the filter.
Xx coordinate, grid units
Yy coordinate, grid units
heightTree height
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
IPromeApp::Filter_TreeHeight_Set ( [in] const BSTR  FilterName,
[in] unsigned short  X,
[in] unsigned short  Y,
[in] double  height 
)

Given the name, coordinates, sets the tree height.

Parameters
FilterNameUnique identifier of the filter.
Xx coordinate, grid units
Yy coordinate, grid units
heightTree height (m).
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNThere is no grid filter at this index.
IPromeApp::Filter_Wx_GetTime ( [in] const BSTR  FilterName,
[out] BSTR *  StartTime,
[out] BSTR *  EndTime 
)

Retrieve the start and end time for a specified weather polygon patch.

Parameters
FilterNameUnique identifier for the filter.
StartTimeIs set to the start time upon return.
EndTimeIs set to the end time upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_Wx_SetTime ( [in] const BSTR  FilterName,
[in] const BSTR  StartTime,
[in] const BSTR  EndTime 
)

Set the start and end times of the weather patch identified by filter name.

Parameters
FilterNameUnique identifier of the filter.
StartTimeThe starting time. Time should be of format "YYYY-MM-DDTHH:MM:SS"
EndTimeThe ending time. Time should be of format "YYYY-MM-DDTHH:MM:SS"
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_INVALIDARGThe start or end time format is incorrect.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_FAILA general failure occurred.
NO_INTERFACENo interface.
IPromeApp::Filter_WxLandscape_GetTimeSpan ( [in] const BSTR  FilterName,
[out] BSTR *  StartTimeOfDay,
[out] BSTR *  EndTimeOfDay 
)

Retrieves the diurnal application time span of the landscape (wind speed or direction) weather filter identified by the filter name.

Parameters
FilterNameUniquely identifies the filter.
StartTimeOfDayThe starting time of day.
EndTimeOfDayThe ending time of day.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscape_SetTimeSpan ( [in] const BSTR  FilterName,
[in] const BSTR  StartTimeOfDay,
[in] const BSTR  EndTimeOfDay 
)

Sets the diurnal application time span of the landscape (wind speed or direction) weather filter identified by the filter name.

Parameters
FilterNameUniquely identifies the filter.
StartTimeOfDayThe starting time of day. Time should be of format "HH:MM:SS"
EndTimeOfDayThe ending time of day. Time should be of format "HH:MM:SS"
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.The start or end time of day format is incorrect.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWD_Create ( [in] const BSTR  FilterName)

This method creates a new directional weather grid from a file.

Parameters
FilterNameUnique identifier for the filter.
Return values
S_OKSuccessful.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_WxLandscapeWD_Export ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[in] const double  speed,
[in] const BSTR  prj_file_name,
[in] const BSTR  grid_file_name 
)

Exports a Wind Direction Grid from a specific sector, for a specific speed, in the wind direction filter identified by the filter name. Specification of the output projection file name is optional.

Parameters
FilterNameUniquely identifies the filter.
sectorSector value. If sector is (unsigned short) -1, then the file is loaded into the default sector.
speedValue for wind speed.
prj_file_nameProjecton file name.
grid_file_nameGrid file name.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWD_GetCount ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[out, retval] unsigned short *  count 
)

This function gets the total number of grid files loaded into the identified sector in a wind direction landscape weather filter identified by the filter name.

Parameters
FilterNameUniquely identifies the filter.
sectorSector of the specified landscape weather filter.
countNumber of sectors.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWD_GetFilenames ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[out] SAFEARRAY(BSTR)*  filenames 
)

This function returns an array of filenames for specified wind direction sector, for the identified filter.

Parameters
FilterNameUniquely identifies the filter
sectorSector of the specified landscape weather filter.
filenamesFile names of files with data associated to a sector
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWD_GetSectorAngles ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[out] double *  min_angle,
[out] double *  max_angle 
)

This function gets the minimum and maximum angles of a specific sector in a landscape weather filter identified by the filter name.

Parameters
FilterNameUniquely identifies the filter
sectorSector of the specified landscape weather filter.
min_angleMinimum angle of a sector.
max_angleMaximum angle of a sector.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWD_GetSectorCount ( [in] const BSTR  FilterName,
[out, retval] unsigned short *  count 
)

This function gets the number of sectors in a wind direction landscape weather filter identified by the filter name.

Parameters
FilterNameUniquely identifies the filter
countNumber of sectors
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWD_GetSectorMode ( [in] const BSTR  FilterName,
[out, retval] int *  mode 
)

This function retrieves the sector mode of the identified landscape weather filter.

Parameters
FilterNameUniquely identifies the filter.
modeSector mode value of the landscape weather filter. If 0, then this filter defaults to only interpretting the loaded default sector grid file. If 1, then this filter will interpret up to 8 sector grid files in each direction.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWD_GetWindSpeeds ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[out] unsigned short *  count,
[in,out] SAFEARRAY(double)*  speed_array 
)

This function returns the wind-speed information for all grids loaded into the specified sector of a wind direction landscape weather filter identified by the filter name.

Parameters
FilterNameUniquely identifies the filter
sectorSector of the specified landscape weather filter.
countNumber of entries put into the array
speed_array1-D array used to hold the speed values. Must be initialized and large enough to hold all entries (see Filter_WxLandscapeWD_GetCount).
See Also
Filter_WxLandscapeWD_GetCount
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWD_Import ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[in] const double  speed,
[in] const BSTR  prj_file_name,
[in] const BSTR  grid_file_name 
)

Imports a Wind Direction Grid to a specific sector and assigned applicable speed ranges, for the wind direction filter identified by the filter name. If the import projection file is unspecified, then it is assumed to match the projection for the associated main projection file for the project.

Parameters
FilterNameUniquely identifies the filter.
sectorSector of the specified landscape weather filter.
speedWind speed for which this grid was generated.
prj_file_nameProjection file name.
grid_file_nameGrid file name.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWD_Remove ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[in] const double  speed 
)

This function removes a sector from a wind-direction landscape weather filter identified by a filter name.

Parameters
FilterNameUniquely identifies the filter.
sectorSector of the specified landscape weather filter.
speedValue for wind speed.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWD_SetSectorMode ( [in] const BSTR  FilterName,
[in] int  mode 
)

This function sets sector mode of the landscape weather filter identified by filter name.

Parameters
FilterNameUniquely identifies the filter.
modeSector mode value of the landscape weather filter. If 0, then this filter defaults to only interpretting the loaded default sector grid file. If 1, then this filter will interpret up to 8 sector grid files in each direction.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWS_Create ( [in] const BSTR  FilterName)

This method creates a new weather speed grid from a file.

Parameters
FilterNameUnique identifier for the filter.
Return values
S_OKSuccessful.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_WxLandscapeWS_Export ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[in] const double  speed,
[in] const BSTR  prj_file_name,
[in] const BSTR  grid_file_name 
)

Exports a Wind Speed Grid from a specific sector, for a specific speed, in the wind speed filter identified by the filter name. Specification of the output projection file name is optional.

Parameters
FilterNameUniquely identifies the filter.
sectorSector value. If sector is (unsigned short) -1, then the file is loaded into the default sector.
speedValue for wind speed.
prj_file_nameProjecton file name.
grid_file_nameGrid file name.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWS_GetCount ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[out, retval] unsigned short *  count 
)

This function gets the total number of grid files loaded into the identified sector in a wind-speed landscape weather filter identified by the filter name.

Parameters
FilterNameUniquely identifies the filter.
sectorSector of the specified landscape weather filter.
countNumber of sectors.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWS_GetFilenames ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[out] SAFEARRAY(BSTR)*  filenames 
)

This function returns an array of filenames for specified wind speed sector, for the identified filter.

Parameters
FilterNameUniquely identifies the filter
sectorSector of the specified landscape weather filter.
filenamesFile names of files with data associated to a sector
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWS_GetSectorAngles ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[out] double *  min_angle,
[out] double *  max_angle 
)

This function gets the minimum and maximum angles of a specific sector in a landscape weather filter identified by the filter name.

Parameters
FilterNameUniquely identifies the filter
sectorSector of the specified landscape weather filter.
min_angleMinimum angle of a sector.
max_angleMaximum angle of a sector.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWS_GetSectorCount ( [in] const BSTR  FilterName,
[out, retval] unsigned short *  count 
)

This function gets the number of sectors in a wind-speed landscape weather filter identified by the filter name.

Parameters
FilterNameUniquely identifies the filter
countNumber of sectors
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWS_GetSectorMode ( [in] const BSTR  FilterName,
[out, retval] int *  mode 
)

This function retrieves the sector mode of the identified landscape weather filter.

Parameters
FilterNameUniquely identifies the filter.
modeSector mode value of the landscape weather filter. If 0, then this filter defaults to only interpretting the loaded default sector grid file. If 1, then this filter will interpret up to 8 sector grid files in each direction.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWS_GetWindSpeeds ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[out] unsigned short *  count,
[in,out] SAFEARRAY(double)*  speed_array 
)

This function returns the wind-speed information for all grids loaded into the specified sector of a wind-speed landscape weather filter identified by the filter name.

Parameters
FilterNameUniquely identifies the filter
sectorSector of the specified landscape weather filter.
countNumber of entries put into the array
speed_array1-D array used to hold the speed values. Must be initialized and large enough to hold all entries (see Filter_WxLandscapeWS_GetCount).
See Also
Filter_WxLandscapeWS_GetCount
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWS_Import ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[in] const double  speed,
[in] const BSTR  prj_file_name,
[in] const BSTR  grid_file_name 
)

Imports Wind Speed Grid to a specific sector and assigned applicable speed ranges, for the wind speed filter identified by the filter name. If the import projection file is unspecified, then it is assumed to match the projection for the associated main projection file for the project.

Parameters
FilterNameUniquely identifies the filter.
sectorSector of the specified landscape weather filter.
speedWind speed for which this grid was generated.
prj_file_nameProjection file name.
grid_file_nameGrid file name.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error. Wind speed values are limited to 250kph.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWS_Remove ( [in] const BSTR  FilterName,
[in] const unsigned short  sector,
[in] const double  speed 
)

This function removes a sector from a wind-speed landscape weather filter identified by a filter name.

Parameters
FilterNameUniquely identifies the filter.
sectorSector of the specified landscape weather filter.
speedValue for wind speed.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxLandscapeWS_SetSectorMode ( [in] const BSTR  FilterName,
[in] int  mode 
)

This function sets sector mode of the landscape weather filter identified by filter name.

Parameters
FilterNameUniquely identifies the filter.
modeSector mode value of the landscape weather filter. If 0, then this filter defaults to only interpretting the loaded default sector grid file. If 1, then this filter will interpret up to 8 sector grid files in each direction.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGAt least one of the arguments provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::Filter_WxPoly_Area ( [in] const BSTR  FilterName,
[out,retval] double *  area 
)

Calculates the area of the specified patch and passes the value to area.

Parameters
FilterNameUnique identifier for the filter.
areaIs set to the area upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_WxPoly_Clear ( [in] const BSTR  FilterName)

Removes all polygons associated with this weather patch.

Parameters
FilterNameUnique identifier for the filter.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter by this name exists.
IPromeApp::Filter_WxPoly_Count ( [in] const BSTR  FilterName,
[out,retval] int *  count 
)

Retrieve the number of weather polygons in a project.

Parameters
FilterNameUnique identifier for the filter.
countIs set to the number of weather polygon patches upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_WxPoly_Create ( [in] const BSTR  FilterName)

This method creates a new polygon weather patch.

Parameters
FilterNameUnique identifier for the filter.
Return values
S_OKSuccessful.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_GRIDFILTER_KNOWNThere is already a grid filter with this name.
IPromeApp::Filter_WxPoly_Export ( [in] const BSTR  FilterName,
[in] const BSTR  fileName 
)

Exports a weather patch identified by name to the filename directed.

Parameters
FileNameThe path and filename to export to.
projFileNameString identifying the name and path for the projection file.
FilterNameUniquely identifies the filter.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNThere is no filter with that name.
IPromeApp::Filter_WxPoly_Get ( [in] const BSTR  FilterName,
[in] int  index,
[out] int *  ignition_size,
[in, out] SAFEARRAY(double)*  xy_pairs 
)

Given a weather polygons name and index returns its size and coordinates.

Parameters
FilterNameUnique identifier for the filter.
indexUnique index for the filter.
ignition_sizeSize of the polygon.
xy_pairs2D Array of coordinates
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_WxPoly_GetRule ( [in] const BSTR  FilterName,
[in] int  raw_input,
[out] unsigned short *  operation,
[out] double *  value 
)

Retrieve the rules for the weather patch specified. The rules are whether or not speed and direction are being set to certain values.

Parameters
FilterNameUnique identifier for the filter.
raw_inputDetermines which raw weather input to modify:
  • 0: wind direction
  • 1: wind speed
  • 2: temperature
  • 3: relative humidity
  • 4: precipitation
operationType of operation to apply to the raw weather input. Not all operations are applicable to all inputs. Valid values are:
  • 0: simple assignment / replacement
  • 1: additive
  • 2: subtraction
  • 3: multiplicative
  • 4: division
valueThe value/operand of the operation.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_WxPoly_Import ( [in] const BSTR  FilterName,
[in] const BSTR  fileName 
)

This function attempts to import a weather polygon patch from a file.

Parameters
FilterNameUnique identifier for the weather polygon patch.
fileNameThe file name and path of the file where the vector data is. The projection (and other) file(s) will be determined from the filename.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRID_FILTER_UNKNOWNThere is no grid filter with that name.
E_POINTERAddress provided is invalid.
ERROR_GRID_UNINITIALIZEDThe grid is not initialized properly.
S_FALSEfalse.
E_INVALIDARGInvalid parameters.
ERROR_FILE_NOT_FOUNDThe specified file could not be found.
ERROR_TOO_MANY_OPEN_FILESSystem error; current application has too many files open.
ERROR_ACCESS_DENIEDAccess denied.
ERROR_INVALID_HANDLEThe handle has been invalidated, or closed.
ERROR_FILE_EXISTSThe file exists.
ERROR_HANDLE_DISK_FULLThe disk is full.
E_FAILA general failure occurred.
IPromeApp::Filter_WxPoly_MaxSize ( [in] const BSTR  FilterName,
[out,retval] int *  count 
)

Returns the maximum number of vertices of any polygon in this weather patch.

Parameters
FilterNameUnique identifier for the filter.
countThe weather polygon patch count.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::Filter_WxPoly_Set ( [in] const BSTR  FilterName,
[in] SAFEARRAY(double)  xy_pairs,
[out] int *  index 
)

Set the name, coordinates and index of a polygon weather filter.

Parameters
FilterNameUnique identifier of the filter.
xy_pairs2D Array of coordinates
indexIs set to the index of the filter upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
E_INVALIDARGInvalid argument.
IPromeApp::Filter_WxPoly_SetRule ( [in] const BSTR  FilterName,
[in] int  raw_input,
[in] unsigned short  operation,
[in] double  value 
)

Sets a weather polygon patch such that it will perform wind direction and/or wind speed changes and also sets the value for each.

Parameters
FilterNameUnique identifier of the filter.
raw_inputDetermines which raw weather input to modify:
  • 0: wind direction
  • 1: wind speed
  • 2: temperature
  • 3: relative humidity
  • 4: precipitation
operationType of operation to apply to the raw weather input. Not all operations are applicable to all inputs. Valid values are:
  • 0: simple assignment / replacement
  • 1: additive
  • 2: subtraction
  • 3: multiplicative
  • 4: division
valueThe value/operand of the operation.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRIDFILTER_UNKNOWNNo weather patch with this name exists.
IPromeApp::Filter_WxPoly_Size ( [in] const BSTR  FilterName,
[in] int  index,
[out,retval] int *  count 
)

Returns the number of vertices of the polygon at 'index'.

Parameters
FilterNameUnique identifier for the filter.
countThe weather polygon patch count.
indexIndex of the weather polygon.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
E_OUTOFMEMORYThere is not enough memory to complete this operation.
ERROR_GRIDFILTER_UNKNOWNNo grid filter with this name exists.
IPromeApp::GetArea ( [in] const BSTR  ScenarioName,
[out,retval] double *  area 
)

Retrieves the area (in square metres) covered by fire of scenario which is named as ScenarioName. This area includes all fires.

Parameters
ScenarioNameUnique identifier for a scenario.
areaSet to the area on successful return (m2).
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error; or if there is a problem with any of the fires attached to this scenario (e.g., the pointer to any fire in the list being NULL)
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioName does not resolve to a known scenario.
ERROR_NO_DATA
ERROR_SEVERITY_WARNINGNothing has been initialized yet.
ERROR_FIRE_INVALID_TIMEIf the time is invalid.
ERROR_FIRE_SCENARIO_UNKNOWNThis fire object is not attached to the scenario specified by the scenario parameter.
SUCCESS_FIRE_NOT_STARTEDFire not yet started (stats is set to 0).
ERROR_FIRE_STAT_UNKNOWNIf stat does not resolve to a known statistic.
E_INVALIDARGInvalid parameters.
ERROR_POINT_NOT_IN_FIREThe point is not in the fire area.
E_FAILUnspecified failure.
IPromeApp::GetAreaChange ( [in] const BSTR  ScenarioName,
[out, retval] double *  areaChange 
)

Retrieves the change of area (in square metres) covered by fire of scenario referenced by ScenarioName. This change of area includes all fires.

Parameters
ScenarioNameUnique identifier for a scenario.
areaChangeSet to the change of area on successful return (m2).
Return values
S_OKSuccessful
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error; or if there is a problem with any of the fires attached to this scenario (e.g., the pointer to any fire in the list being NULL)
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioName does not resolve to a known scenario.
E_FAILA general failure occurred.
ERROR_NO_DATA
ERROR_SEVERITY_WARNINGNothing has been initialized yet.
ERROR_FIRE_INVALID_TIMEIf the time is invalid.
ERROR_FIRE_SCENARIO_UNKNOWNThis fire object is not attached to the scenario specified by the scenario parameter.
SUCCESS_FIRE_NOT_STARTEDFire not yet started (stats is set to 0).
ERROR_FIRE_STAT_UNKNOWNIf stat does not resolve to a known statistic.
E_INVALIDARGInvalid parameters.
ERROR_POINT_NOT_IN_FIREThe point is not in the fire area.
IPromeApp::GetBooleanAttribute ( [in] unsigned short  attribute_key,
[out, retval] VARIANT_BOOL *  value 
)

Return the Boolean value of the attribute specified in the function call.

Parameters
attribute_keyValid keys are CWFGM_GRID_ATTRIBUTE_DAYLIGHT_SAVINGS, CWFGM_GRID_ATTRIBUTE_DEM_PRESENT
valueSet to the value of the key upon return.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_INVALIDARGInvalid arguments.
IPromeApp::GetBurnedBox ( [in] const BSTR  ScenarioName,
[out] int *  left,
[out] int *  right,
[out] int *  bottom,
[out] int *  top 
)

Retrieves the rectangular area encompassing all burned areas of all fires at a specific time during a specific the simulation. If no fires have started burning yet, then return values are all set to -1.

Parameters
ScenarioNameUnique identifier for a scenario.
leftSet to the left bound of the rectangle on successful return (grid coordinate units).
rightSet to the right bound of the rectangle on successful return (grid coordinate units).
bottomSet to the bottom bound of the rectangle on successful return (grid coordinate units).
topSet to the top bound of the rectangle on successful return (grid coordinate units).
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioName does not resolve to a known scenario.
ERROR_SCENARIO_BAD_STATEIf the function is run while a scenario is running.
SUCCESS_FIRE_NOT_STARTEDEither no fires or the request predates the start time of the simulation.
IPromeApp::GetDoubleAttribute ( [in] unsigned short  attribute_key,
[out, retval] double *  value 
)

Return the double value of the attribute specified in the function call.

Parameters
attribute_keyValid keys are CWFGM_GRID_ATTRIBUTE_DEFAULT_ELEVATION, CWFGM_GRID_ATTRIBUTE_MEDIAN_ELEVATION, CWFGM_GRID_ATTRIBUTE_PLOTRESOLUTION
valueSet to the value of the key upon return.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_INVALIDARGInvalid parameters.
IPromeApp::GetFuelDoubleAttribute ( [in] int  fuel_index,
[in] unsigned short  attribute_key,
[out, retval] double *  value 
)

Return the double value of the fuel attribute specified in the function call.

Parameters
fuel_index
attribute_keyValid keys are:
  • FUELCOM_ATTRIBUTE_A
  • FUELCOM_ATTRIBUTE_B
  • FUELCOM_ATTRIBUTE_C
  • FUELCOM_ATTRIBUTE_Q
  • FUELCOM_ATTRIBUTE_MAXBE
  • FUELCOM_ATTRIBUTE_BUI0
  • FUELCOM_ATTRIBUTE_CBH
  • FUELCOM_ATTRIBUTE_CFL
  • FUELCOM_ATTRIBUTE_PC
  • FUELCOM_ATTRIBUTE_PDF
  • FUELCOM_ATTRIBUTE_CURINGDEGREE
  • FUELCOM_ATTRIBUTE_M3M4_C2_A
  • FUELCOM_ATTRIBUTE_M3M4_C2_B
  • FUELCOM_ATTRIBUTE_M3M4_C2_C
  • FUELCOM_ATTRIBUTE_M4_D1_A
  • FUELCOM_ATTRIBUTE_M4_D1_B
  • FUELCOM_ATTRIBUTE_M4_D1_C
  • FUELCOM_ATTRIBUTE_EQ35_THRESHOLD
  • FUELCOM_ATTRIBUTE_EQ35A_MULT1
  • FUELCOM_ATTRIBUTE_EQ35A_MULT2
  • FUELCOM_ATTRIBUTE_EQ35B_ADDER
  • FUELCOM_ATTRIBUTE_EQ35B_MULT1
valueSet to the value of the key upon return.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_INVALIDARGInvalid parameters.
ERROR_FUELS_FUEL_UNKNOWNThere is no fuel with this index.
ERROR_SCENARIO_SIMULATION_RUNNINGAction cannot be performed while running the scenario.
ERROR_GRID_UNINITIALIZEDGrid object not initialized.
ERROR_GRID_LOCATION_OUT_OF_RANGEPoint specified is out of grid range.
ERROR_GRID_NO_DATANo data at point specified.
E_UNEXPECTEDAn unexpected error occurred.
IPromeApp::GetFuelIndexByName ( [in] const BSTR  FuelName,
[out] unsigned char *  lut_index 
)

Returns the fuel import index based on the fuel based on FuelName in the "FBP fuel type" column in the lookup table. If more than one import index is associated with the given fuel, then the first import index is returned.

Parameters
FuelNameUnique identifier for a fuel.
lut_indexSet to the internal LUT fuel index on successful return.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_FUELS_FUEL_UNKNOWNFuelName does not resolve to a known fuel.
IPromeApp::GetFuelNameByIndex ( [in] int  input_fuel_index,
[out] BSTR *  FuelName 
)

This function returns the name of a fuel based on its index (fuel_index). Please note that the caller has to free the memory returned via "FuelName" after use.

Parameters
input_fuel_indexUnique identifier for a fuel.
FuelNameSet to the fuel name on successful return.
Return values
S_OKSuccessful
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_FUELS_FUEL_UNKNOWN'fuel_index' does not resolve to a known fuel.
IPromeApp::GetGridDimension ( [out] unsigned short *  xDim,
[out] unsigned short *  yDim 
)

Returns the X and Y dimensions of the grid referenced by gridName. Currently all grids use the same projection and LUT information, and most of PrometheusCOM does not support the concept of multiple grids.

Parameters
xDimSet to the x dimension on successful return (grid coordinate units).
yDimSet to the y dimension on successful return (grid coordinate units).
Return values
S_OKSuccessful
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::GetGridLLCLocation ( [out] double *  lat,
[out] double *  lon 
)

Returns the location on the planet for the grid. Currently all grids use the same projection and LUT information, and most of PrometheusCOM does not support the concept of multiple grids.

Parameters
latSet to the latitude on successful return (degrees).
lonSet to the longitude on successful return (degrees).
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::GetGridValue ( [in] unsigned short  X,
[in] unsigned short  Y,
[out] int *  fuel_index 
)

Retrieves the fuel import index from the grid at the coordinate specified by X/Y.

Parameters
Xx coordinate, grid units
Yy coordinate, grid units
fuel_indexSet to the fuel index on successful return – this value will correspond to one on the fuel lookup table. If fuel_index is -1, then there is no data at the specified coordinate.
Return values
S_OKSuccessful
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRID_UNINITIALIZEDThe grid object associated with GridName is not properly initialized.
ERROR_GRID_LOCATION_OUT_OF_RANGEThe x/y coordinates passed in are out of range.
ERROR_FUELS_FUEL_UNKNOWNThere is no valid fuel index associated with the x/y coordinate.
IPromeApp::GetIndexVertex ( [in] const BSTR  ScenarioName,
[in] long  index,
[in,out] double *  X,
[in,out] double *  Y 
)

Given a scenario identifier and an index, retrieves the coordinates of a specific point/vertex. X and Y will be set to these coordinates on successful return. This function returns the coordinates in the grid cell units. If users need the distance to the LLC corner, they can multiply X and Y by the resolution (using the GetResolution fuction) to get the distance. The distance is measured in meters. Note that (-1, -1) is a special vertex used for separating vertices produced by different fire ignitions or time steps in the simulation. Note that this function replaces several old functions (GetFirstVertice, GetNextVertice, GetLastVertice, GetPreviousVertice, GetFirstVerticeActive, GetNextVerticeActive, GetPreviousVerticeActive, GetLastVerticeActive and GetIndexVerticeActive). The current implementation of this function (and structures supporting it) significantly increases the memory overhead and operating inefficiencies associated with any PrometheusCOM application and therefore requires modification.

Parameters
ScenarioNameUnique identifier for a scenario.
indexIndex of the point to retrieve.
XX coordinate on successful return (grid coordinate units).
YY coordinate on successful return (grid coordinate units).
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioID does not resolve to a known scenario
IPromeApp::GetIntegerAttribute ( [in] unsigned short  attribute_key,
[out, retval] int *  value 
)

Return the integer value of the attribute specified in the function call.

Parameters
attribute_keyValid keys are:
  • CWFGM_GRID_ATTRIBUTE_TIMEZONE Units are in seconds, relative to GMT. For example, MST (Mountain Standard Time) would be -6 * 60 * 60 seconds.
  • PROMETHEUSCOM_VERSION Value is the version string packed as an unsigned 4-byte hexadecimal value, where each byte represents part of the version string.
valueSet to the value of the key upon return.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_INVALIDARGInvalid parameters.
IPromeApp::GetLLCOffset ( [out] double *  xllcorner,
[out] double *  yllcorner 
)

Gets the offsets of the lower lefthand corner of any grid (since multiple grids share the same projection). These values are retrieved from the original projection file used when importing the grid layers.

Parameters
xllcornerSet to the x-offset on successful return.
yllcornerSet to the y-offset on successful return.
Return values
S_OKSuccessful
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRID_UNINITIALIZEDThe Grid object is not properly initialized.
S_FALSEIf asking for offset values where the appropriate array has not been initialized.
E_FAILA general failure occurred.
E_INVALIDARGThe attribute/option index was invalid/unknown for this object.
ERROR_GRID_LOCATION_OUT_OF_RANGEThe location is outside the grid.
ERROR_GRID_NO_DATAThe point is in a no data area.
E_UNEXPECTEDInternal error. Please contact the software development team.
IPromeApp::GetNumOfNewVertices ( [in] const BSTR  ScenarioName,
[out,retval] long *  ResultNum 
)

Retrieves the number of the latest vertices produced by the last step. This value includes the marker vertices separating outputs from different ignitions. Note: this replaces the depreciated GetNumOfNewVerticesActive function.

Parameters
ScenarioNameUnique identifier for a scenario.
ResultNumSet to the number of vertices on successful return.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioID does not resolve to a known scenario.
E_FAILA general failure occurred.
IPromeApp::GetNumOfVertices ( [in] const BSTR  ScenarioName,
[out, retval] long *  Num 
)

Retrieves the number of the vertices produced by the simulation for all simulation display steps for all fires. This includes active and inactive vertices, plus marker points to separate the fire fronts (from different ignitions or times). Note: this replaces the depreciated GetNumOfVerticesActive function.

Parameters
ScenarioNameUnique identifier for a scenario.
NumSet to the number of vertices on successful return.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioID does not resolve to a known scenario.
E_FAILA general failure occurred.
IPromeApp::GetStringAttribute ( [in] unsigned short  attribute_key,
[out, retval] BSTR *  value 
)

Return the textual string value of the attribute specified in the function call.

Parameters
attribute_keyValid keys are:
  • PROMETHEUSCOM_VERSION Value is the version string in textual form.
  • PROMETHEUSCOM_RELEASEDATE Value indicating release date.
valueSet to the value of the key upon return.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_INVALIDARGInvalid parameters.
IPromeApp::GetXYParameters ( [in] const BSTR  ScenarioName,
[in] double  X,
[in] double  Y,
[in] unsigned short  interp_method,
[out] double *  ros,
[out] double *  fi,
[out] double *  raz,
[out] double *  sfc,
[out] double *  cfb,
[out] double *  cfc,
[out] double *  tfc 
)

Retrieves specific statistics for the location at (X, Y) a specific simulation. The current time of the simulation is used for calculating these values. Passing NULL to any of the statistics parameters that are not needed by the client program will suppress unnecessary computations, and will thus result in a performance gain.

Parameters
ScenarioNameUnique identifier for a scenario.
Xx coordinate, grid units
Yy coordinate, grid units
interp_methodHow to calculate/determine the value of the statistic requested
  • SCENARIO_XYSTAT_TECHNIQUE_CLOSEST_VERTEX Picks the closest vertex from 1 of 2 specific fire perimeters: the one which first contained the point of interest, and the perimeter immediately prior to that.
  • SCENARIO_XYSTAT_TECHNIQUE_IDW Calculates the statistic using IDW, using all local, active vertices.
  • SCENARIO_XYSTAT_TECHNIQUE_AREA_WEIGHTING Calculates the statistic using weighting based on union between voronoi regions and the grid cell of interest.
  • SCENARIO_XYSTAT_TECHNIQUE_VORONOI_OVERLAP Calculates the statistic using weighting based on the union of the point's inserted voronoi region and the voronoi regions of each vertex without the point.
  • SCENARIO_XYSTAT_TECHNIQUE_CALCULATE Calculates the statistic in the same manner as the simulation would.
rosreturned FBP rate of spread statistic
fireturned FBP fire intensity statistic
razreturned FBP RAZ (direction) statistic
sfcreturned FBP surface fuel consumption statistic
cfbreturned crown fraction burned statistic
cfcreturned crown fuel consumption statistic
tfcreturned total fuel consumption statistic
Return values
S_OKSuccessful
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioName does not resolve to a known scenario.
ERROR_POINT_NOT_IN_FIREThe x/y parameter passed in is not in a valid region (has not yet been burned).
ERROR_NO_DATA
ERROR_SEVERITY_WARNINGNothing has been initialized yet.
ERROR_FIRE_INVALID_TIMEIf the time is invalid.
ERROR_FIRE_SCENARIO_UNKNOWNThis fire object is not attached to the scenario specified by the scenario parameter.
SUCCESS_FIRE_NOT_STARTEDFire not yet started (stats is set to 0).
ERROR_FIRE_STAT_UNKNOWNIf stat does not resolve to a known statistic.
ERROR_SCENARIO_BAD_STATEIf the function is run without a running scenario.
ERROR_GRID_UINITIALIZEDThe grid is not initialized properly.
ERROR_SCENARIO_NO_FIRESThere are no ignitions in the scenario.
ERROR_SCENARIO_BAD_TIMESThe scenario has invalid times.
ERROR_GRID_WEATHER_INVALID_DATESThe scenario has an invalid weather grid dates.
ERROR_GRID_WEATHER_NOT_IMPLEMENTEDInternal error. Please contact the software development team.
ERROR_WEATHER_STREAM_NOT_ASSIGNEDThe scenario does not have a weather stream assigned.
ERROR_GRID_PRIMARY_STREAM_UNSPECIFIEDThe scenario does not have a primary weather stream assigned.
ERROR_GRID_WEATHERSTATIONS_TOO_CLOSEThe weather stations used are too close.
ERROR_GRID_WEATHERSTREAM_TIME_OVERLAPSThe weather streams used overlap and are from the same station.
ERROR_SCENARIO_OPTION_INVALIDInternal error. Please contact the software development team.
IPromeApp::Ignition_Clear ( [in] const BSTR  IgnitionName)

Clears an ignition with multiple points.

Parameters
IgnitionNameUnique identifier for the ignition point.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
IPromeApp::Ignition_Count ( [in] const BSTR  IgnitionName,
[out,retval] int *  count 
)

Returns the number of ignitions within a project.

Parameters
IgnitionNameUnique identifier for the ignition point.
countSet to the number of ignitions within a project.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Ignition_Create ( [in] const BSTR  IgnitionName)

Creates a new, empty ignition object, given a name. Note that the name should be unique among existing fire ignitions.

Parameters
IgnitionNameUnique identifier for the new ignition point.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_ALREADY_ADDEDAn ignition with this name has already exists.
IPromeApp::Ignition_Delete ( [in] const BSTR  IgnitionName)

Deletes the ignition denoted by IgntionName and removes it from all related scenarios.

Parameters
IgnitionNameUnique identifier for an ignition.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error; or if there is a problem with the scenario indexing.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThe ignition of that name does not exist.
IPromeApp::Ignition_Export ( [in] const BSTR  IgnitionName,
[in] const BSTR  fileName 
)

Exports an ignition object identified by its name to the specified filename.

Parameters
IgnitionNameUniquely identifies the ignition.
fileNameThe path and filename to export to.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no ignition with this name.
E_POINTERAddress provided is invalid.
E_INVALIDARGInvalid parameters.
IPromeApp::Ignition_Get ( [in] const BSTR  IgnitionName,
[in] int  index,
[out] unsigned short *  ignition_type,
[out] int *  ignition_size,
[out] SAFEARRAY(double)*  xy_pairs 
)

Gives information regarding the ignition such as the type, size and location.

Parameters
IgnitionNameUnique identifier for the ignition point.
indexIndex of the ignition.
ignition_typeThe ignition type. Valid values are:
  • CWFGM_FIRE_IGNITION_POINT
  • CWFGM_FIRE_IGNITION_LINE
  • CWFGM_FIRE_IGNITION_POLYGON_OUT
  • CWFGM_FIRE_IGNITION_POLYGON_IN
ignition_sizeThe ignition size.
xy_pairs2D Array of coordinates
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Ignition_GetIndex ( [in] const BSTR  IgnitionName,
[out, retval] int *  index 
)

Given an ignition name, gives the ignition's index.

Parameters
IgnitionNameUniquely identifies the ignition.
indexSet to the index of the ignition upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Ignition_GetName ( [in] int  index,
[out, retval] BSTR *  IgnitionName 
)

Given an ignition index, gives the ignition's name.

Parameters
indexIndex of the ignition.
IgnitionNameSet to the name of the ignition upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Ignition_GetTime ( [in] const BSTR  IgnitionName,
[out,retval] BSTR *  StartTime 
)

Given an ignition name returns the start time.

Parameters
IgnitionNameUnique identifier for the ignition point.
StartTimeSet to the start time of the ignition point upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Ignition_Import ( [in] const BSTR  IgnitionName,
[in] const BSTR  filename 
)

Import an ignition from the given file path and filename. A variety of file formats are now supported. Please refer to the Prometheus User Manual and Prometheus I/O Standard Document for this file format specification.

Parameters
IgnitionNameUnique identifier for the new ignition.
filenameThe file name and path to a file containing the ignition data. The projection (and other) file(s) will be determined from the filename.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThe ignition does not exist.
E_POINTERAddress provided is invalid.
ERROR_FILE_NOT_FOUNDThe specified file cannot be found.
ERROR_TOO_MANY_OPEN_FILESSystem error; current application has too many files open.
ERROR_ACCESS_DENIEDAccess denied.
ERROR_INVALID_HANDLEThe handle has been invalidated, or closed.
ERROR_FILE_EXISTSThe file exists.
ERROR_HANDLE_DISK_FULLThe disk is full.
E_FAILA general failure occurred.
IPromeApp::Ignition_MaxSize ( [in] const BSTR  IgnitionName,
[out,retval] int *  count 
)

Gives the number of points that make up the sub-ignition with the largest amount of points within a single ignition file.

Parameters
IgnitionNameUnique identifier for the ignition point.
countSet to the ignition number upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Ignition_Number ( [out, retval] int *  count)

Gives the number of ignitions in an FGM project.

Parameters
countSet to the number of ignitions in the project.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
IPromeApp::Ignition_PutName ( [in] int  index,
[in] const BSTR  IgnitionName 
)

Set the name for an ignition based on its index.

Parameters
IgnitionNameUnique identifier for the ignition point.
indexThe index of the ignition.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no scenario with this name.
ERROR_SCENARIO_FIRE_KNOWNThere is already an existing ignition with this name.
IPromeApp::Ignition_PutTime ( [in] const BSTR  IgnitionName,
[in] const BSTR  StartTime 
)

Gives an ignition a start time, given an ignition name.

Parameters
IgnitionNameUnique identifier for the ignition point.
StartTimeThe start time of the ignition point. Time should be of format "YYYY-MM-DDTHH:MM:SS"
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
E_INVALIDARGThe time entered is in a format that cannot be parsed.
ERROR_SCENARIO_SIMULATION_RUNNINGA scenario is running and needs to be stopped before this action takes place.
IPromeApp::Ignition_Set ( [in] const BSTR  IgnitionName,
[in] int  index,
[in] unsigned short  ignition_type,
[in] SAFEARRAY(double)  xy_pairs 
)

Sets the x and y coordinates for all types of ignitions.

Parameters
IgnitionNameUnique identifier for the ignition point.
indexThe ignition index identifier.
ignition_typeWhether the ignition is of the type point, line, or polygon. Valid values are:
  • CWFGM_FIRE_IGNITION_POINT
  • CWFGM_FIRE_IGNITION_LINE
  • CWFGM_FIRE_IGNITION_POLYGON_OUT
  • CWFGM_FIRE_IGNITION_POLYGON_IN
xy_pairs2D Array of coordinates
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_SIMULATION_RUNNINGA scenario is running and needs to be stopped before this action takes place.
ERROR_FIRE_IGNTION_TYPE_UNKNOWNThe fire ignition type is unknown.
E_POINTERAddress provided is invalid.
FALSEfalse
IPromeApp::Ignition_Size ( [in] const BSTR  IgnitionName,
[in] int  index,
[out,retval] int *  count 
)

Gives the number of points that make up each sub-ignition within a single ignition file.

Parameters
IgnitionNameUnique identifier for the ignition point.
indexIndex of the ignition.
countSet to the number of ignitions upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Ignition_Type ( [in] const BSTR  IgnitionName,
[in] int  index,
[out,retval] unsigned short *  type 
)

Given an ignition name, gives the type.

Parameters
IgnitionNameUnique identifier for the ignition point.
indexIndex of ignition.
typeSet to the type of ignition upon return. Valid values are:
  • CWFGM_FIRE_IGNITION_POINT
  • CWFGM_FIRE_IGNITION_LINE
  • CWFGM_FIRE_IGNITION_POLYGON_OUT
  • CWFGM_FIRE_IGNITION_POLYGON_IN
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no fire with this name.
E_POINTERAddress provided is invalid.
IPromeApp::ImportElevation ( [in] const BSTR  projFileName,
[in] const BSTR  elevationFile 
)

Import the elevation, slope, and aspect data. Before calling this function, you should call the ImportFuelGrid() function first. None of the parameters should contain an empty string; all elevation data must be provided. Currently, all grids use the same projection and LUT information. Most of PrometheusCOM does not support the concept of multiple grids.

Parameters
elevationFileCharacter string identifying the name and path to the grid elevation file name.
IPromeApp::ImportFuelGrid ( [in] const BSTR  projFileName,
[in] const BSTR  fileName 
)

Imports a fuel grid and its associated projection file. Currently, all grids use the same projection and LUT information, and most of PrometheusCOM now supports the concept of multiple grids. However, at this time, this function does not require a name for this default initial grid.

Parameters
projFileNameString identifying the name and path to the projection file.
fileNameCharacter string identifying the name and path to the grid file.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRID_UNINITIALIZEDThe grid is not initialized properly.asc
ERROR_FILE_NOT_FOUNDThe file cannot be found in the filesystem.
ERROR_ACCESS_DENIEDThe file cannot be opened.
ERROR_READ_FAULT
ERROR_SEVERITY_WARNINGThe file format is unrecognized, or if there is an error in the file format.
ERROR_GRID_LOCATION_OUT_OF_RANGEIf the import files do not appear to match data that has already been imported.
ERROR_FUELS_FUEL_UNKNOWNThe grid file contains a fuel index that is not defined in the fuel look-up table.
E_POINTERAddress provided is invalid.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_SIMLUATION_RUNNINGValue cannot be changed while running a simulation.
E_FAILA general failure occurred.
ERROR_TOO_MANY_OPEN_FILESSystem error; current application has too many files open.
SUCCESS_GRID_DATA_UPDATEDThe grid data was successfully updated.
ERROR_INVALID_HANDLEThe handle has been invalidated, or closed.
ERROR_FILE_EXISTSThe file exists.
ERROR_INVALID_PARAMETERThe parameter is incorrect.
ERROR_HANDLE_DISK_FULLThe disk is full.
ERROR_SUCCESSSuccess.
IPromeApp::ImportFuelsLookup ( [in] const BSTR  fileName)

Input the Fuels Lookup table. This function is optional but should be called before ImportFuelGrid(). If no lookup table is specified, then the default Prometheus table is used. Please refer to the Prometheus User Manual and Prometheus I/O Standard Document for this file format specification.

Parameters
fileNameCharacter string identifying the name and path to the fuels lookup file.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_FILE_FORMAT_INVALIDIf the format of the file does not comform to expected specifications.
ERROR_GRID_INITIALIZEDThe assignment of the same fuel map is tried more than once.
ERROR_FILE_NOT_FOUND
ERROR_SEVERITY_WARNINGThe specified file cannot be found.
E_FAILA general failure occurred.
IPromeApp::Initialize ( )

Initialize the PrometheusCOM DLL for one application use. Various initial parameters and structures are prepared for usage. This function must be called before any other functions. The rules imposed by the COM architecture allow you to instantiate and initialize many PrometheusCOM objects simultaneously. However, the current design is limited to at most one PrometheusCOM object per application. This is a known design limitation. Previously, this method required parameters to specify (e.g.) latitude, longitude. Now, this data is retrieved from the provided projection files during an import operation. This function no longer takes any parameters. The longitude and latitude will be imported with the ASCII file and the time zone is set with a different function. Use the SetIntegerAttribute function and the CWFGM_GRID_ATTRIBUTE_TIMEZONE key.

Return values
S_OKSuccessful.
ERROR_INVALID_ACCESS
ERROR_SEVERITY_WARNINGInternal error to be reported to COM development team.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
TRUEOperation succeeded.
REGDB_E_CLASSNOTREGInternal error to be reported to COM development team.
CLASS_E_NOAGGREGATIONInternal error to be reported to COM development team.
E_NOINTERFACEInternal error to be reported to COM development team.
ERROR_SCENARIO_SIMULATION_RUNNINGValue cannot be changed as it is being used in a currently running scenario.
E_INVALIDARGInvalid parameters.
E_FAILA general failure occurred.
IPromeApp::IsXYBurned ( [in] const BSTR  ScenarioName,
[in] double  X,
[in] double  Y,
[out, retval] int *  burned 
)

Retrieves whether the location at (X, Y) was burned in a specific simulation.

Parameters
ScenarioNameUnique identifier for a scenario.
XX-coordinate of interest.
YY-coordinate of interest.
burnedOn successful return, this will be set to 1 if burned and 0 if not burned.
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioName does not resolve to a known scenario.
ERROR_SCENARIO_BAD_STATEIf the function is run while a scenario is running.
ERROR_NODATA
ERROR_SEVERITY_WARNINGNothing initialized yet.
SUCCESS_FIRE_NOT_STARTEDEither no fires or the request predates the start time of the simulation.
IPromeApp::Scenario_AddIgnition ( [in] const BSTR  ScenarioName,
[in] const BSTR  FireID 
)

Adds the specified ignition to the specified scenario.

Parameters
ScenarioNameID of the scenario to be modified.
FireIDID of the ignition to be added.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no ignition with this name.
E_FAILA general failure occurred.
IPromeApp::Scenario_AddVector ( [in] const BSTR  ScenarioName,
[in] const BSTR  VectorName 
)

Adds the specified vector to the specified scenario.

Parameters
ScenarioNameID of the scenario to be modified.
VectorNameUnique identifier for a Vector.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_FAILA general failure occurred.
ERROR_SCENARIO_VECTORENGINE_UNKNOWNThere is no vector with this name.
IPromeApp::Scenario_AddWxStream ( [in] const BSTR  ScenarioName,
[in] const BSTR  StationName,
[in] const BSTR  StreamName 
)

Adds the specified weather stream to the specified scenario.

Parameters
ScenarioNameID of the scenario to be modified.
StationNameID of the weather station to be used.
StreamNameID of the weather stream to be added.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_FAILA general failure occurred.
ERROR_SCENARIO_WEATHER_STATION_UNKNOWNThere is no weather station with this name.
ERROR_SCENARIO_WEATHER_STREAM_UNKNOWNThere is no weather stream with this name.
IPromeApp::Scenario_Copy ( [in] const BSTR  fromScenarioName,
[in] const BSTR  newScenarioName 
)

This method copies an already existing scenario.

Parameters
fromScenarioNameUnique identifier of the scenario to be copied.
newScenarioNameUnique identifier of the new scenario created from the old one.
Return values
S_OKSuccessful.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_SCENARIO_UNKOWNNo scenario exists with that name.
ERROR_SCENARIO_KNOWNIf a scenario with that name already exists.
IPromeApp::Scenario_Create ( [in] const BSTR  ScenarioName)

Creates a new, empty scenario object. A scenario is an object which associates together all spatial and temporal data required for a simulation. This scenario is assigned the default FBP and scenario options. These can be modified by calling Scenario_SetBooleanAttribute, Scenario_SetIntegerAttribute and passing the correct parameters. This function requires further modification for verification of input parameters, such as uniqueness of the ignition name.

Parameters
ScenarioNameUnique identifier for the new scenario.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_GRID_UNINITIALIZEDThe grid object is not initialized.
IPromeApp::Scenario_Delete ( [in] const BSTR  ScenarioName)

Deletes the scenario.

Parameters
ScenarioNameUnique identifier for the scenario.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
IPromeApp::Scenario_FilterAtIndex ( [in] const BSTR  ScenarioName,
[in] int  index,
[out,retval] BSTR *  FilterID 
)

Gets filter in the scenario by index.

Parameters
ScenarioNameUnique identifier for the scenario.
indexIndex of wanted filter.
FilterIDSet to the name of the filter upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_WEATHERGRID_UNKNOWNThere is not weather grid with this name.
IPromeApp::Scenario_GetBooleanAttribute ( [in] const BSTR  ScenarioName,
[in] unsigned short  attribute_key,
[out, retval] VARIANT_BOOL *  value 
)

Get the scenario attribute determined by the attribute key as a boolean value.

Parameters
ScenarioNameName of the scenario to be modified
attribute_keyValid attribute keys are:
  • CWFGM_SCENARIO_OPTION_ACCEL Boolean. If TRUE, then acceleration is applied to various output statistics in the FBP standard. This value should only applicable to point ignitions. If FALSE, then the fire is assumed to be always at equilibrium.
  • CWFGM_SCENARIO_OPTION_BUI Boolean. If TRUE, then the BUI build-up effect is applied to various statistics in the FBP standard.
  • CWFGM_SCENARIO_OPTION_TOPOGRAPHY Boolean. If TRUE, then the slope component to calculating the WSV output statistic in the FBP standard is set to 0.0. If TRUE, then the wind speed is used as provided. This setting also affects the slope component in Dr. Richards' 3D equations.
  • CWFGM_SCENARIO_OPTION_GREENUP Boolean. Specific FBP fuel types use different equations during green-up. This flag determines whether to use green-up equations or not.
  • CWFGM_SCENARIO_OPTION_FMC_TERRAIN Boolean. If TRUE, then elevation is used to calculate FMC. Note that specific rules exist when default elevations have to be used.
  • CWFGM_SCENARIO_OPTION_WIND Boolean. If FALSE, then the wind component to calculating the WSV statistic in the FBP standard is set to 0.0. If TRUE, then the wind speed is used as provided.
  • CWFGM_SCENARIO_OPTION_EXTINGUISHMENT Boolean. Currently unused.
  • CWFGM_SCENARIO_OPTION_USE_2DGROWTH Boolean. TRUE if using Dr. Richards' 2D equations. FALSE if using Dr. Richards' 3D equations.
  • CWFGM_SCENARIO_OPTION_BOUNDARY_STOP Boolean. TRUE if the simulation stops when any simulated fire reaches the grid boundary. FALSE if the simulation should continue (in which case, any perimeter of the fire is stopped and clipped at the grid boundary).
  • CWFGM_SCENARIO_OPTION_SPOTTING Boolean. Currently unused.
  • CWFGM_SCENARIO_OPTION_BREACHING Boolean. Determines whether breaching of vector and gridded fire breaks is allowed.
  • CWFGM_SCENARIO_OPTION_SINGLETHREADING Boolean. TRUE if multithreading within a simulation is disabled. FALSE if multithreading is enabled.
  • CWFGM_SCENARIO_OPTION_NONFUELS_AS_VECTOR_BREAKS Boolean. When TRUE, square polygons are built around each non-fuel grid cell. This option affects performance, and how breaching, etc. operations perform around non-fuel grid cells.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_TEMPORAL Boolean. When TRUE, temporal weather interpolation is turned on, for all of the WX and hourly/instantantaneous FWI calculations.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL Boolean. When TRUE, spatial weather interpolation is turned on. This option applies to both WX and FWI values, and will work whether there is 1 or more weather stations assigned to the scenario. If FALSE, then there should only be one weather stream.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_PRECIP Boolean. Conditional on CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL. When TRUE, precipitation is spatially interpolated using IDW. When FALSE, precipitation from the primary weather stream is used.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_WIND Boolean. Conditional on CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL. When TRUE, wind is spatially interpolated (WS is defined using IDW, WD is chosen from the closest station); when FALSE, wind from the primary weather stream is used.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_TEMP_RH Boolean. Conditional on CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL. When TRUE, temperature, dew point temperature, and RH are calculated spatially from adiabatic lapse rates; when FALSE, values from the primary weather stream are used.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_CALCFWI Boolean. If FALSE, then the current FWI values are returned (possibly interpolated). If TRUE, then the current FWI values are calculated from the prior FWI values and the current weather values (likely spatially interpolated).
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_HISTORY Boolean. Conditional on CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL and CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_CALCFWI. If TRUE, then historical FWI values are calculated to try to attain equilibrium on FWI values.
  • CWFGM_SCENARIO_OPTION_ACCURATE_FMC_LOCATION Boolean. When TRUE, the precise location of a simulated fire vertex is used when calculating FMC. When FALSE, the grid's lower left corner is used in calculating FMC.
  • CWFGM_SCENARIO_OPTION_CACHE_GRID_POINTS Boolean. When TRUE, caches will be calculated to determine the closest points (for statistics purposes) to the center of each grid cell.
valueSet to the value of the key upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_OPTION_INVALIDThis attribute key does not exist.
E_FAILA general failure occurred.
IPromeApp::Scenario_GetBurnCondition ( [in] const BSTR  ScenarioName,
[in] int  Day,
[out] VARIANT_BOOL *  Effective,
[out] int *  StartHour,
[out] int *  EndHour,
[out] double *  WSThreshold,
[out] double *  RHThreshold,
[out] double *  FWIThreshold 
)

Get the scenario burn condition for this specific day.

Parameters
ScenarioNameName of the scenario to look in.
DayThe Day in which we are interested.
EffectiveWhether the conditions are applied.
StartHourSet to the start hour upon return.
EndHourSet to the end hour upon return.
WSThresholdSet to the minimum wind speed which will sustain burning.
RHThresholdSet to the maximum relative humidity which will sustain burning.
FWIThresholdSet to the minimum FWI value which will sustain burning.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Scenario_GetDefaultBurnCondition ( [in] const BSTR  ScenarioName,
[out] VARIANT_BOOL *  Effective,
[out] int *  StartHour,
[out] int *  EndHour,
[out] double *  WSThreshold,
[out] double *  RHThreshold,
[out] double *  FWIThreshold 
)

Get the default scenario burn condition.

Parameters
ScenarioNameName of the scenario to look in.
EffectiveWhether the conditions are applied.
StartHourSet to the start hour upon return.
EndHourSet to the end hour upon return.
WSThresholdSet to the minimum wind speed which will sustain burning.
RHThresholdSet to the maximum relative humidity which will sustain burning.
FWIThresholdSet to the minimum FWI value which will sustain burning.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Scenario_GetDoubleAttribute ( [in] const BSTR  ScenarioName,
[in] unsigned short  attribute_key,
[out, retval] double *  value 
)

Get the scenario attribute determined by the attribute key as a double value.

Parameters
ScenarioNameName of the scenario to be modified
attribute_keyValid attribute keys are:
  • CWFGM_SCENARIO_OPTION_PERIMETER_RESOLUTION Maximum distance between any two vertices on a fire perimeter.
  • CWFGM_SCENARIO_OPTION_SPATIAL_THRESHOLD Maximum distance (in grid units) that a vertex is allows to travel while advancing a fire perimeter.
  • CWFGM_SCENARIO_OPTION_SMOOTHING_WEIGHT Smoothing factor which allows a vertex's neighbours' rates of spread to impact its calculated distance travelled.
  • CWFGM_SCENARIO_OPTION_SPECIFIED_FMC User-override FMC value for the simulation. If >= 0, then the value is used, if < 0 then, this value is not used.
  • CWFGM_SCENARIO_OPTION_DEFAULT_ELEVATION User specified elevation to use when there is no grid elevation available for at a requested grid location.
  • CWFGM_SCENARIO_OPTION_IGNITION_SIZE Diameter (in grid units) of the starting circle of an ignition point. Also used to determine the width of an ignition line.
  • CWFGM_WEATHER_OPTION_ADIABATIC_IDW_EXPONENT_TEMP Used when CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL is set. IDW power for interpolating temperature and dew point values.
  • CWFGM_WEATHER_OPTION_IDW_EXPONENT_WS Used when CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_WIND is set. IDW power for interpolating WS values.
  • CWFGM_WEATHER_OPTION_IDW_EXPONENT_PRECIP Used when CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_PRECIP is set. IDW power for interpolating precip values.
  • CWFGM_WEATHER_OPTION_IDW_EXPONENT_FWI Used when CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL is set. IDW power for interpolating FWI values.
valueSet to the value of the key upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_OPTION_INVALIDThis attribute key does not exist.
E_FAILA general failure occurred.
IPromeApp::Scenario_GetFilterCount ( [in] const BSTR  ScenarioName,
[out, retval] int *  count 
)

Gets the number of filters in the scenario.

Parameters
ScenarioNameUnique identifier for the scenario.
countSet to the number of filters upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
IPromeApp::Scenario_GetGridValue ( [in] const BSTR  ScenarioName,
[in] unsigned short  X,
[in] unsigned short  Y,
[out] int *  fuel_index 
)

Gets the fuel grid value at coordinates x, y in a specified scenario.

Parameters
ScenarioNameUnique identifier of a scenario.
XX coordinate
YY coordinate
fuel_indexIndex for a CWFGM fuel.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_GRID_UNINITIALIZEDThe grid is not initialized properly.
ERROR_GRID_LOCATION_OUT_OF_RANGEThe location is outside the grid.
ERROR_FUELS_FUEL_UNKNOWNThere is no fuel with that name.
IPromeApp::Scenario_GetIgnitionCount ( [in] const BSTR  ScenarioName,
[out, retval] int *  count 
)

Get number of ignitions in a certain scenario.

Parameters
ScenarioNameName of the scenario to look in.
countSet to the number of ignitions upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Scenario_GetIndex ( [in] const BSTR  ScenarioName,
[out, retval] int *  index 
)

Gets the index of a scenario identified by name.

Parameters
ScenarioNameUnique identifier of a scenario.
indexSet to the index of the scenario upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Scenario_GetIntegerAttribute ( [in] const BSTR  ScenarioName,
[in] unsigned short  attribute_key,
[out, retval] int *  value 
)

Get the scenario attribute determined by the attribute key as an integer value.

Parameters
ScenarioNameName of the scenario to be modified
attribute_keyValid attribute keys are:
  • PROMETHEUSCOM_SCENARIO_PRIMARYSTREAM_INDEX Index of the wx stream that is the primary stream.
  • CWFGM_SCENARIO_OPTION_STARTING_POINTS Number of verticies used for a point ignition. Valid values are 6 to 64 inclusive.
  • CWFGM_SCENARIO_OPTION_MULTITHREADING If multithreading is enabled, then this option determines how many threads to allow.
  • CWFGM_SCENARIO_OPTION_TEMPORAL_THRESHOLD 64-bit signed integer. Units are in seconds. Maximum time allowed between any two adjacent simulation time steps.
  • CWFGM_SCENARIO_OPTION_TEMPORAL_THRESHOLD_ACCEL 64-bit signed integer. Units are in seconds. Maximum time allowed between two adjacent simulation time steps when any ignition is in its acceleration phase (when ROSt is less than 90% of ROSeq).
  • CWFGM_SCENARIO_OPTION_DISPLAY_INTERVAL 64-bit signed integer. Units are in seconds. Time interval for output fire perimeters, or 0 if every time step is to be outputted.
valueSet to the value of the key upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_OPTION_INVALIDThis attribute key does not exist.
E_FAILA general failure occurred.
IPromeApp::Scenario_GetName ( [in] int  index,
[out, retval] BSTR *  ScenarioName 
)

Gets the name of the scenario identified by index.

Parameters
indexIndex of a scenario.
ScenarioNameUnique identifier for the scenario.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Scenario_GetTime ( [in] const BSTR  ScenarioName,
[out] BSTR *  StartTime,
[out] BSTR *  EndTime 
)

Get the scenario start and end times.

Parameters
ScenarioNameID of the scenario.
StartTimeSet to the start time upon return.
EndTimeSet to the end time upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERInvalid address.
IPromeApp::Scenario_GetVectorCount ( [in] const BSTR  ScenarioName,
[out, retval] int *  count 
)

Gets the number of vectors in the specified scenario.

Parameters
ScenarioNameUnique identifier for the scenario.
countSet to the number of vectors upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Scenario_GetWxStreamCount ( [in] const BSTR  ScenarioName,
[out, retval] int *  count 
)

Gets the number of weather streams in the specified scenario.

Parameters
ScenarioNameUnique identifier for the scenario.
countSet to the number of weather streams upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
IPromeApp::Scenario_IgnitionAtIndex ( [in] const BSTR  ScenarioName,
[in] int  index,
[out,retval] BSTR *  FireID 
)

Get the ignition specified by the index.

Parameters
ScenarioNameUnique identifier for the scenario.
indexIndex number of ignition.
FireIDUnique identifier for the ignition.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no ignition with this name.
IPromeApp::Scenario_IndexOfFilter ( [in] const BSTR  ScenarioName,
[in] const BSTR  FilterID,
[out, retval] int *  index 
)

Gets index of the filter in the scenario.

Parameters
ScenarioNameUnique identifier for the scenario.
FilterIDUnique identifier for the filter.
indexSet to the index of the filter upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_WEATHERGRID_UNKNOWNThere is not weather grid with this name.
IPromeApp::Scenario_IndexOfIgnition ( [in] const BSTR  ScenarioName,
[in] const BSTR  FireID,
[out, retval] int *  index 
)

Get the index of the specified ignition.

Parameters
ScenarioNameUnique identifier for the scenario.
FireIDUnique identifier for the ignition.
indexSet to the index of the ignition upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_FIRE_UNKNOWNThere is no ignition with this name.
IPromeApp::Scenario_IndexOfVector ( [in] const BSTR  ScenarioName,
[in] const BSTR  VectorName,
[out, retval] int *  index 
)

Gets the index in the specified scenario by index.

Parameters
ScenarioNameUnique identifier for the scenario.
VectorNameUnique identifier for the vector.
indexSet to the index of the vector upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_VECTORENGIVE_UNKNOWNThere is no vector with this name.
IPromeApp::Scenario_IndexOfWxStream ( [in] const BSTR  ScenarioName,
[in] const BSTR  StationName,
[in] const BSTR  StreamName,
[out, retval] int *  index 
)

Gets the index in the specified scenario by weather stream and station.

Parameters
ScenarioNameUnique identifier for the scenario.
StationNameUnique identifier for the weather station.
StreamNameUnique identifier for the weather stream.
indexSet to the index of the weather stream.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream with this name.
ERROR_WEATHER_STATION_UNKNOWNThere is no weather station with this name.
IPromeApp::Scenario_InsertFilter ( [in] const BSTR  ScenarioName,
[in] const BSTR  FilterID,
[in] int  index 
)

Adds the specified filter to the specified scenario.

Parameters
ScenarioNameID of the scenario to be modified.
FilterIDID of the filter to be added.
indexIndex of where the filter is to be added.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
ERROR_SCENARIO_WEATHERGRID_UNKNOWNThere is no weather grid with this name.
E_FAILA general failure occurred.
IPromeApp::Scenario_Number ( [out, retval] int *  count)
Parameters
countSet to the number of scenarios upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
IPromeApp::Scenario_PutName ( [in] int  index,
[in] const BSTR  ScenarioName 
)

Sets the scenario name for the given scenario.

Parameters
ScenarioNameName of the scenario.
indexIndex of the scenario.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
IPromeApp::Scenario_RemoveFilter ( [in] const BSTR  ScenarioName,
[in] const BSTR  FilterID 
)

Removes the specified filter to the specified scenario.

Parameters
ScenarioNameID of the scenario to be modified.
FilterIDID of the filter to be added.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
ERROR_SCENARIO_WEATHERGRID_UNKNOWNThere is no weather grid with this name.
IPromeApp::Scenario_RemoveIgnition ( [in] const BSTR  ScenarioName,
[in] const BSTR  FireID 
)

Removes the specified ignition from the specified scenario.

Parameters
ScenarioNameID of the scenario to be modified.
FireIDUnique identifier for a Fire.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error; or if there is a problem with the scenario indexing.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_FIRE_UNKNOWNThe ignition of that name does not exist.
ERROR_SCENARIO_UNKNOWNThe scenario of that name does not exist.
IPromeApp::Scenario_RemoveVector ( [in] const BSTR  ScenarioName,
[in] const BSTR  VectorName 
)

Removes the specified fuel break vector from the specified scenario.

Parameters
ScenarioNameID of the scenario to be modified.
VectorNameUnique identifier for a Vector.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error; or if there is a problem with the scenario indexing.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_VECTORENGINE_UNKNOWNThe ignition of that name does not exist.
ERROR_SCENARIO_UNKNOWNThe scenario of that name does not exist.
E_FAILA general failure occurred.
IPromeApp::Scenario_RemoveWxStream ( [in] const BSTR  ScenarioName,
[in] const BSTR  StationName,
[in] const BSTR  StreamName 
)

Removes the specified weather stream to the specified scenario.

Parameters
ScenarioNameID of the scenario to be modified.
StationNameID of the weather station to be used.
StreamNameID of the weather stream to be added.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_FAILA general failure occurred.
ERROR_SCENARIO_WEATHER_STATION_UNKNOWNThere is no weather station with this name.
ERROR_SCENARIO_WEATHER_STREAM_UNKNOWNThere is no weather stream with this name.
E_UNEXPECTED
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_SIMULATION_RUNNINGWeather stream cannot be removed while the scenario is running.
IPromeApp::Scenario_SetBooleanAttribute ( [in] const BSTR  ScenarioName,
[in] unsigned short  attribute_key,
[in] VARIANT_BOOL  value 
)

Set the scenario attribute determined by the attribute key to a Boolean value.

Parameters
ScenarioNameName of the scenario to be modified
attribute_keyValid attribute keys are:
  • CWFGM_SCENARIO_OPTION_ACCEL Boolean. If TRUE, then acceleration is applied to various output statistics in the FBP standard. This value should only applicable to point ignitions. If FALSE, then the fire is assumed to be always at equilibrium.
  • CWFGM_SCENARIO_OPTION_BUI Boolean. If TRUE, then the BUI build-up effect is applied to various statistics in the FBP standard.
  • CWFGM_SCENARIO_OPTION_TOPOGRAPHY Boolean. If TRUE, then the slope component to calculating the WSV output statistic in the FBP standard is set to 0.0. If TRUE, then the wind speed is used as provided. This setting also affects the slope component in Dr. Richards' 3D equations.
  • CWFGM_SCENARIO_OPTION_GREENUP Boolean. Specific FBP fuel types use different equations during green-up. This flag determines whether to use green-up equations or not.
  • CWFGM_SCENARIO_OPTION_FMC_TERRAIN Boolean. If TRUE, then elevation is used to calculate FMC. Note that specific rules exist when default elevations have to be used.
  • CWFGM_SCENARIO_OPTION_WIND Boolean. If FALSE, then the wind component to calculating the WSV statistic in the FBP standard is set to 0.0. If TRUE, then the wind speed is used as provided.
  • CWFGM_SCENARIO_OPTION_EXTINGUISHMENT Boolean. Currently unused.
  • CWFGM_SCENARIO_OPTION_USE_2DGROWTH Boolean. TRUE if using Dr. Richards' 2D equations. FALSE if using Dr. Richards' 3D equations.
  • CWFGM_SCENARIO_OPTION_BOUNDARY_STOP Boolean. TRUE if the simulation stops when any simulated fire reaches the grid boundary. FALSE if the simulation should continue (in which case, any perimeter of the fire is stopped and clipped at the grid boundary).
  • CWFGM_SCENARIO_OPTION_SPOTTING Boolean. Currently unused.
  • CWFGM_SCENARIO_OPTION_BREACHING Boolean. Determines whether breaching of vector and gridded fire breaks is allowed.
  • CWFGM_SCENARIO_OPTION_SINGLETHREADING Boolean. TRUE if multithreading within a simulation is disabled. FALSE if multithreading is enabled.
  • CWFGM_SCENARIO_OPTION_NONFUELS_AS_VECTOR_BREAKS Boolean. When TRUE, square polygons are built around each non-fuel grid cell. This option affects performance, and how breaching, etc. operations perform around non-fuel grid cells.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_TEMPORAL Boolean. When TRUE, temporal weather interpolation is turned on, for all of the WX and hourly/instantantaneous FWI calculations.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL Boolean. When TRUE, spatial weather interpolation is turned on. This option applies to both WX and FWI values, and will work whether there is 1 or more weather stations assigned to the scenario. If FALSE, then there should only be one weather stream.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_PRECIP Boolean. Conditional on CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL. When TRUE, precipitation is spatially interpolated using IDW. When FALSE, precipitation from the primary weather stream is used.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_WIND Boolean. Conditional on CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL. When TRUE, wind is spatially interpolated (WS is defined using IDW, WD is chosen from the closest station); when FALSE, wind from the primary weather stream is used.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_TEMP_RH Boolean. Conditional on CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL. When TRUE, temperature, dew point temperature, and RH are calculated spatially from adiabatic lapse rates; when FALSE, values from the primary weather stream are used.
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_CALCFWI Boolean. If FALSE, then the current FWI values are returned (possibly interpolated). If TRUE, then the current FWI values are calculated from the prior FWI values and the current weather values (likely spatially interpolated).
  • CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_HISTORY Boolean. Conditional on CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL and CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_CALCFWI. If TRUE, then historical FWI values are calculated to try to attain equilibrium on FWI values.
  • CWFGM_SCENARIO_OPTION_ACCURATE_FMC_LOCATION Boolean. When TRUE, the precise location of a simulated fire vertex is used when calculating FMC. When FALSE, the grid's lower left corner is used in calculating FMC.
  • CWFGM_SCENARIO_OPTION_CACHE_GRID_POINTS Boolean. When TRUE, caches will be calculated to determine the closest points (for statistics purposes) to the center of each grid cell.
valueThe value to which the attribute key will be set.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_BAD_TIMESThe scenario has invalid times.
ERROR_SCENARIO_BAD_TIMESTEPSThe scenario has an invalid time step.
TRUEOperation succeeded.
FALSEfalse.
E_FAILA general failure occurred.
IPromeApp::Scenario_SetBurnCondition ( [in] const BSTR  ScenarioName,
[in] int  Day,
[in] VARIANT_BOOL  Effective,
[in] int  StartHour,
[in] int  EndHour,
[in] double  WSThreshold,
[in] double  RHThreshold,
[in] double  FWIThreshold 
)

Sets the burn conditions for the scenario.

Parameters
ScenarioNameName of the scenario to be modified
DayThe integer representing the day.
EffectiveWhether the burn condition is applied.
StartHourThe start hour.
EndHourThe end hour.
WSThresholdMinimum wind speed which will sustain burning.
RHThresholdMaximum relative humidity which will sustain burning.
FWIThresholdMinimum FWI value which will sustain burning.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
IPromeApp::Scenario_SetDefaultBurnCondition ( [in] const BSTR  ScenarioName,
[in] VARIANT_BOOL  Effective,
[in] int  StartHour,
[in] int  EndHour,
[in] double  WSThreshold,
[in] double  RHThreshold,
[in] double  FWIThreshold 
)

Sets the default burn conditions for the scenario.

Parameters
ScenarioNameName of the scenario to be modified
EffectiveWhether the burn condition is applied.
StartHourThe start hour.
EndHourThe end hour.
WSThresholdMinimum wind speed which will sustain burning.
RHThresholdMaximum relative humidity which will sustain burning.
FWIThresholdMinimum FWI value which will sustain burning.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
IPromeApp::Scenario_SetDoubleAttribute ( [in] const BSTR  ScenarioName,
[in] unsigned short  attribute_key,
[in] double  value 
)

Set the scenario attribute determined by the attribute key to a double value. Valid temperature, FWI IDW values are (0.0-10.0]. Valid wind speed, Precipitation IDW values are [0.0-10.0]. If 0.0 is provided, then voronoi regions are employed.

Parameters
ScenarioNameName of the scenario to be modified
attribute_keyValid attribute keys are:
  • CWFGM_SCENARIO_OPTION_PERIMETER_RESOLUTION Maximum distance between any two vertices on a fire perimeter.
  • CWFGM_SCENARIO_OPTION_SPATIAL_THRESHOLD Maximum distance (in grid units) that a vertex is allows to travel while advancing a fire perimeter.
  • CWFGM_SCENARIO_OPTION_SMOOTHING_WEIGHT Smoothing factor which allows a vertex's neighbours' rates of spread to impact its calculated distance travelled.
  • CWFGM_SCENARIO_OPTION_SPECIFIED_FMC User-override FMC value for the simulation. If >= 0, then the value is used, if < 0 then, this value is not used.
  • CWFGM_SCENARIO_OPTION_DEFAULT_ELEVATION User specified elevation to use when there is no grid elevation available for at a requested grid location.
  • CWFGM_SCENARIO_OPTION_IGNITION_SIZE Diameter (in grid units) of the starting circle of an ignition point. Also used to determine the width of an ignition line.
  • CWFGM_WEATHER_OPTION_ADIABATIC_IDW_EXPONENT_TEMP Used when CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL is set. IDW power for interpolating temperature and dew point values.
  • CWFGM_WEATHER_OPTION_IDW_EXPONENT_WS Used when CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_WIND is set. IDW power for interpolating WS values.
  • CWFGM_WEATHER_OPTION_IDW_EXPONENT_PRECIP Used when CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_PRECIP is set. IDW power for interpolating precip values.
  • CWFGM_WEATHER_OPTION_IDW_EXPONENT_FWI Used when CWFGM_SCENARIO_OPTION_WEATHER_INTERPOLATE_SPATIAL is set. IDW power for interpolating FWI values.
valueThe value to which the attribute key will be set.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_BAD_TIMESThe scenario has invalid times.
ERROR_SCENARIO_BAD_TIMESTEPSThe scenario has invalid time steps.
TRUEOperation succeeded.
FALSEfalse.
E_FAILA general failure occurred.
IPromeApp::Scenario_SetIntegerAttribute ( [in] const BSTR  ScenarioName,
[in] unsigned short  attribute_key,
[in] int  value 
)

Set the scenario attribute determined by the attribute key to an integer value.

Parameters
ScenarioNameName of the scenario to be modified
attribute_keyValid attribute keys are:
  • PROMETHEUSCOM_SCENARIO_PRIMARYSTREAM_INDEX Index of the wx stream that should be the primary stream.
  • CWFGM_SCENARIO_OPTION_STARTING_POINTS Number of verticies used for a point ignition. Valid values are 6 to 64 inclusive.
  • CWFGM_SCENARIO_OPTION_MULTITHREADING If multithreading is enabled, then this option determines how many threads to allow.
  • CWFGM_SCENARIO_OPTION_TEMPORAL_THRESHOLD 64-bit signed integer. Units are in seconds. Maximum time allowed between any two adjacent simulation time steps.
  • CWFGM_SCENARIO_OPTION_TEMPORAL_THRESHOLD_ACCEL 64-bit signed integer. Units are in seconds. Maximum time allowed between two adjacent simulation time steps when any ignition is in its acceleration phase (when ROSt is less than 90% of ROSeq).
  • CWFGM_SCENARIO_OPTION_DISPLAY_INTERVAL 64-bit signed integer. Units are in seconds. Time interval for output fire perimeters, or 0 if every time step is to be outputted.
valueThe value to which the attribute key will be set.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_BAD_TIMESThe scenario has invalid times.
ERROR_SCENARIO_BAD_TIMESTEPSThe scenario has an invalid time step.
E_FAILA general failure occurred.
IPromeApp::Scenario_SetTime ( [in] const BSTR  ScenarioName,
[in] const BSTR  StartTime,
[in] const BSTR  EndTime 
)

Set the scenario start and end times.

Parameters
ScenarioNameID of the scenario to be modified
StartTimeThe start time of the scenario. Time should be of format "YYYY-MM-DDTHH:MM:SS"
EndTimeThe end time of the scenario. Time should be of format "YYYY-MM-DDTHH:MM:SS"
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_BAD_TIMESThe scenario has invalid times.
ERROR_SCENARIO_BAD_TIMESTEPSThe scenario has an invalid time step.
E_FAILA general failure occurred.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
IPromeApp::Scenario_VectorAtIndex ( [in] const BSTR  ScenarioName,
[in] int  index,
[out,retval] BSTR *  VectorName 
)

Gets the vector in the specified scenario by index.

Parameters
ScenarioNameUnique identifier for the scenario.
indexIndex of vector in the scenario.
VectorNameUniquie identifier for the vector.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_VECTORENGIVE_UNKNOWNThere is no vector with this name.
IPromeApp::Scenario_WxStreamAtIndex ( [in] const BSTR  ScenarioName,
[in] int  index,
[out] BSTR *  Station,
[out] BSTR *  Stream 
)

Gets the weather stream and station in the specified scenario by index.

Parameters
ScenarioNameUnique identifier for the scenario.
indexIndex of the weather stream within the scenario.
StationUnique identifier for the station.
StreamUnique identifier for the stream.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream with this name.
IPromeApp::SetBooleanAttribute ( [in] unsigned short  attribute_key,
[in] VARIANT_BOOL  value 
)

Set the Boolean value for the specified attribute.

Parameters
attribute_keyValid key is CWFGM_GRID_ATTRIBUTE_DAYLIGHT_SAVINGS
valueThe Boolean value to be used.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_INVALIDARGThe elevation parameter has an invalid value.
IPromeApp::SetDoubleAttribute ( [in] unsigned short  attribute_key,
[in] double  value 
)

Set the double value for the specified attribute.

Parameters
attribute_keyValid key is CWFGM_GRID_ATTRIBUTE_DEFAULT_ELEVATION
valueThe double value to be used.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_BAD_TIMESThe scenario has invalid times.
ERROR_SCENARIO_BAD_TIMESTEPSThe scenario has an invalid time step.
ERROR_SCENARIO_OPTION_INVALIDUnrecognized key code.
IPromeApp::SetFuelDoubleAttribute ( [in] int  fuel_index,
[in] unsigned short  attribute_key,
[in] double  value 
)

Set the double value for the specified fuel attribute.

Parameters
fuel_indexThe index number of the fuel to set the attribute for.
attribute_keyValid keys are:
  • FUELCOM_ATTRIBUTE_A
  • FUELCOM_ATTRIBUTE_B
  • FUELCOM_ATTRIBUTE_C
  • FUELCOM_ATTRIBUTE_Q
  • FUELCOM_ATTRIBUTE_MAXBE
  • FUELCOM_ATTRIBUTE_BUI0
  • FUELCOM_ATTRIBUTE_CBH
  • FUELCOM_ATTRIBUTE_CFL
  • FUELCOM_ATTRIBUTE_PC
  • FUELCOM_ATTRIBUTE_PDF
  • FUELCOM_ATTRIBUTE_CURINGDEGREE
  • FUELCOM_ATTRIBUTE_M3M4_C2_A
  • FUELCOM_ATTRIBUTE_M3M4_C2_B
  • FUELCOM_ATTRIBUTE_M3M4_C2_C
  • FUELCOM_ATTRIBUTE_M4_D1_A
  • FUELCOM_ATTRIBUTE_M4_D1_B
  • FUELCOM_ATTRIBUTE_M4_D1_C
  • FUELCOM_ATTRIBUTE_EQ35_THRESHOLD
  • FUELCOM_ATTRIBUTE_EQ35A_MULT1
  • FUELCOM_ATTRIBUTE_EQ35A_MULT2
  • FUELCOM_ATTRIBUTE_EQ35B_ADDER
  • FUELCOM_ATTRIBUTE_EQ35B_MULT1
valueThe double value to be used.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_BAD_TIMESThe scenario has invalid times.
ERROR_SCENARIO_BAD_TIMESTEPSThe scenario has an invalid time step.
ERROR_SCENARIO_OPTION_INVALIDUnrecognized key code.
E_NOINTERFACENo interface.
E_POINTERAddress provided is invalid.
ERROR_FUELS_FUEL_UNKOWNThere is no fuel with this index.
IPromeApp::SetIntegerAttribute ( [in] unsigned short  attribute_key,
[in] int  value 
)

Set the integer value for the specified attribute.

Parameters
attribute_keyValid key is CWFGM_GRID_ATTRIBUTE_TIMEZONE. Units are in seconds, relative to GMT. For example, MST (Mountain Standard Time) would be -6 * 60 * 60 seconds. Valid values are from -12 hours to +12 hours.
valueThe integer value to be used.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_BAD_TIMESThe scenario has invalid times.
ERROR_SCENARIO_BAD_TIMESTEPSThe scenario has an invalid time step.
ERROR_SCENARIO_OPTION_INVALIDUnrecognized key code.
IPromeApp::SetStringAttribute ( [in] unsigned short  attribute_key,
[in] BSTR  value 
)

Set the integer value for the specified attribute. Currently unused and kept as a placeholder for future development.

Parameters
attribute_key
valueThe string value to be used.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
E_INVALIDARGInvalid parameters.
ERROR_SCENARIO_BAD_TIMESThe scenario has invalid times.
ERROR_SCENARIO_BAD_TIMESTEPSThe scenario has an invalid time step.
ERROR_SCENARIO_OPTION_INVALIDUnrecognized key code.
IPromeApp::Simulate ( [in] const BSTR  ScenarioName)

Simulates the a scenario completely, from start (reset) to finish. This replaces the depreciated SimulateActive function.

Parameters
ScenarioNameUnique identifier for a scenario.
Return values
SUCCESS_SCENARIO_SIMULATION_COMPLETESuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_FIRE_SCENARIO_UNKNOWN ScenarioID does not correspond to a known scenario.
ERROR_SCENARIO_NO_FIRESThe scenario contains no fires.
ERROR_SCENARIO_BAD_TIMESStart or end time is invalid, or if the internal or output calculation intervals are invalid.
ERROR_SCENARIO_BAD_TIMESTEPSThe scenario's time steps are invalid.
ERROR_SCENARIO_INVALID_BURNCONDITIONSInvalid burn condition settings (burning periods between days overlap)
ERROR_GRID_WEATHER_NOT_IMPLEMENTEDNo weather data is currently associated with this scenario.
ERROR_GRID_UNINITIALIZEDSome grid information is incomplete, or unspecified, for example if that object doesn't have an initialized latitude, longitude, or time zone.
ERROR_SCENARIO_UNKNOWNScenarioID is unknown or invalid.
S_OKScenario ready to execute, but has not begun.
ERROR_SCENARIO_BAD_STATEIf this function is run while the scenario is running.
ERROR_GRID_WEATHER_INVALID_DATESThe weather grid has invalid dates.
S_FALSEfalse.
E_INVALIDARGInvalid parameters.
E_FAILA general failure occurred.
ERROR_WEATHER_STREAM_NOT_ASSIGNEDThe scenario has no weather stream assigned to it.
E_POINTERAddress provided is invalid.
SUCCESS_STATE_OBJECT_UNLOCKEDInternal error. Please report to the software development team.
SUCCESS_STATE_OBJECT_LOCKED_WRITEInternal error. Please report to the software development team.
SUCCESS_STATE_OBJECT_LOCKED_SCENARIOInternal error. Please report to the software development team.
SUCCESS_STATE_OBJECT_lOCKED_READInternal error. Please report to the software development team.
IPromeApp::SimulateEightSteps ( [in] const BSTR  ScenarioName,
[out] long *  StepResult 
)

Simulates the fire growth eight steps forward. According to the value of StepResult, a decision can be made about whether the simulate operation should be stopped. It is equivalent to calling SimulateStep() eight times. This replaces the depreciated SimulateEightStepsActive function. This functionality is similar to that provided by the function SimulateStep().

Parameters
ScenarioNameUnique identifier for a scenario. StepResult; 0: operation completed successfully -1: operation failed
StepResult;0: operation completed successfully -1: operation failed
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error; or if no weather streams are attached to this scenario.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioID does not correspond to a known scenario.
ERROR_SCENARIO_BAD_STATEScenario is not running.
SUCCESS_SCENARIO_SIMULATION_COMPLETEThis step completes simulation, i.e. the "current time" has reached the end time.
ERROR_GRID_UNINITIALIZEDNo ICWFGM_GridEngine object has been specified, or that object doesn't have an initialized latitude, longitude, or time zone.
IPromeApp::SimulateRestart ( [in] const BSTR  ScenarioName)

Restarts the simulation. This operation must take place before any calls to SimulateStep(). This replaces the depreciated SimulateRestartActive function.

Parameters
ScenarioNameUnique identifier for a scenario.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioID does not correspond to a known scenario.
ERROR_SCENARIO_NO_FIRESThe scenario contains no fires.
ERROR_SCENARIO_BAD_TIMESStart or end time is invalid, or if the internal or output calculation intervals are invalid.
ERROR_SCENARIO_BAD_TIMESTEPSThe time steps are invalid.
ERROR_SCENARIO_INVALID_BURNCONDITIONSInvalid burn condition settings (burning periods between days overlap)
ERROR_GRID_WEATHER_NOT_IMPLEMENTEDNo weather data is currently associated with this scenario.
ERROR_GRID_UNINITIALIZEDSome grid information is incomplete, or unspecified, for example if that object doesn't have an initialized latitude, longitude, or time zone.
ERROR_SCENARIO_BAD_STATEIf this function is run while the scenario is running.
ERROR_GRID_WEATHER_INVALID_DATESThe weather grid has invalid dates.
S_FALSEfalse.
E_INVALIDARGInvalid parameters.
E_FAILA general failure occurred.
ERROR_WEATHER_STREAM_NOT_ASSIGNEDThe scenario has no weather stream assigned to it.
E_POINTERAddress provided is invalid.
SUCCESS_STATE_OBJECT_UNLOCKEDInternal error. Please report to the software development team.
SUCCESS_STAE_OBJECT_LOCKED_WRITEInternal error. Please report to the software development team.
SUCCESS_STATE_OBJECT_LOCKED_SCENARIOInternal error. Please report to the software development team.
SUCCESS_STATE_OBJECT_LOCKED_READInternal error. Please report to the software development team.
ERROR_GRID_PRIMARY_STREAM_UNSPECIFIEDThe scenario has no primary stream assigned to it.
ERROR_GRID_WEATHERSTATIONS_TOO_CLOSEThe weather stations in the scenario are too close together.
ERROR_GRID_WEATHERSTREAM_TIME_OVERLAPSAt least two streams from the station have overlapping times.
ERROR_GRID_LOCATION_OUT_OF_RANGEThe location is off the grid.
IPromeApp::SimulateStep ( [in] const BSTR  ScenarioName)

Simulates the fire growth in steps. This replaces the depreciated SimulateStepActive function.

Parameters
ScenarioNameUnique identifier for a scenario.
Return values
SUCCESS_SCENARIO_SIMULATION_COMPLETESuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioID does not correspond to a known scenario.
ERROR_SCENARIO_NO_FIRESThe scenario contains no fires.
ERROR_SCENARIO_BAD_TIMESStart or end time is invalid, or if the internal or output calculation intervals are invalid.
ERROR_SCENARIO_BAD_TIMESTEPSThe time steps are invalid.
ERROR_GRID_WEATHER_NOT_IMPLEMENTEDNo weather data is currently associated with this scenario.
ERROR_GRID_UNINITIALIZEDSome grid information is incomplete, or unspecified, for example if that object doesn't have an initialized latitude, longitude, or time zone.
ERROR_SCENARIO_BAD_STATEScenario is not running.
SUCCESS_SCENARIO_SIMULATION_COMPLETEThe scenario has successfully simulated.
IPromeApp::SimulateStop ( [in] const BSTR  ScenarioName)

Stops the simulation that is running.

Parameters
ScenarioNameUnique identifier for a scenario.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioID does not correspond to a known scenario.
ERROR_SCENARIO_BAD_STATEIf the simulation wasn't in a reset, running, or completed state.
IPromeApp::SimulateThreeSteps ( [in] const BSTR  ScenarioName,
[out] long *  StepResult 
)

Simulates the fire growth three steps forward. According to the value of StepResult, a decision can be made about whether the simulate operation should be stopped. It is equivalent to calling SimulateStep() three times. This replaces the depreciated SimulateThreeStepsActive function. This functionality is similar to that provided by the function SimulateStep().

Parameters
ScenarioNameUnique identifier for a scenario.
StepResult;0: operation completed successfully -1: operation failed
Return values
S_OKSuccessful.
E_POINTERAddress provided is invalid.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error; or if no weather streams are attached to this scenario.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNScenarioID does not correspond to a known scenario.
ERROR_SCENARIO_BAD_STATEScenario is not running.
SUCCESS_SCENARIO_SIMULATION_COMPLETEThis step completes simulation, i.e. the "current time" has reached the end time.
ERROR_GRID_UNINITIALIZEDNo ICWFGM_GridEngine object has been specified, or that object doesn't have an initialized latitude, longitude, or time zone.
E_OUTOFMEMORYInsufficient memory.
IPromeApp::UnInitialize ( )

Performs necessary clean-up when simulations are finished. De-allocates all related objects, etc. This function ends the current COM session. No further COM functions can be called unless this function is re-initialized. This method should be used with care. Its functionality is redundant to simply deleting the PrometheusCOM object.

Return values
S_OKSuccessful.
IPromeApp::Vector_Create ( [in] const BSTR  VectorName,
[in] SAFEARRAY(double)  xy_pairs,
int  is_polygon 
)

This method creates a new vector fuel break identified by name and formed by the strings of x and y values.

Parameters
VectorNameUnique identifier for the vector fuelbreak.
xy_pairs2D Array of coordinates
is_polygondetermines how to interpret the ordered set of points: 0 is polyline, 1 is polygon
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_SCENARIO_VECTORENGINE_KNOWNA vector object with this name already exists.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_INVALIDARGInvalid parameters.
IPromeApp::Vector_Delete ( [in] const BSTR  VectorName)

Deletes a vector identified by its name.

Parameters
VectorNameUnique identifier for the vector.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_VECTORENGIVE_UNKNOWNNo object with the provided name.
IPromeApp::Vector_Export ( [in] const BSTR  VectorName,
[in] const BSTR  fileName 
)

Exports a vector object identified by name to the filename directed.

Parameters
fileNameThe path and filename to export to.
VectorNameUniquely identifies the vector.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_VECTORENGINE_UNKNOWN
E_FAILA general failure occurred.
E_POINTERAddress provided is invalid.
S_FALSEfalse.
E_INVALIDARGInvalid parameters.
ERROR_NO_DATAThere is no data.
IPromeApp::Vector_GetIndex ( [in] const BSTR  VectorName,
[out, retval] int *  index 
)

Retrieves the index of a vector given its name.

Parameters
indexSet to the index of the vector upon return.
VectorNameUnique identifier for the vector.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_VECTORENGINE_UNKNOWNUnknown object.
E_OUTOFMEMORYInsufficient memory.
IPromeApp::Vector_GetName ( [in] int  index,
[out, retval] BSTR *  VectorName 
)

Retrieves the name of a vector given its index.

Parameters
indexIndex of a vector.
VectorNameIs set to the vector name upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_VECTORENGINE_UNKNOWN
IPromeApp::Vector_GetWidth ( [in] const BSTR  VectorName,
[out, retval] double *  width 
)

Retrieves the width of a vector polyline, for the vector identified by index.

Parameters
VectorNameUnique identifier for the vector.
widthWidth, in grid units, of the polyline.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_SCENARIO_VECTORENGIVE_UNKNOWNNo object with the provided name.
IPromeApp::Vector_Import ( [in] const BSTR  VectorName,
[in] const BSTR  fileName 
)

This function attempts to import a fuel break vector from a file.

Parameters
VectorNameUnique identifier for the vector.
fileNameThe file name and path of the file where the vector data is. The projection (and other) file(s) will be determined from the filename.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_VECTORENGINE_KNOWNThe vector data object does not exist.
E_POINTERAddress provided is invalid.
ERROR_GRID_UNINITIALIZEDThe grid is not initialized properly.
E_FAILA general failure occurred.
S_FALSEfalse.
E_INVALIDARGInvalid parameters.
IPromeApp::Vector_Number ( [out, retval] int *  count)

Retrieves the number of vectors in a project.

Parameters
countSets this to the number of vectors upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
IPromeApp::Vector_PutName ( [in] int  index,
[in] const BSTR  VectorName 
)

Set the name of the vector at the index specified.

Parameters
indexIndex of the vector.
VectorNameUnique identifier for the vector.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_VECTORENGINE_UNKNOWNUnrecognized key code.
IPromeApp::Vector_PutWidth ( [in] const BSTR  VectorName,
[in] double  width 
)

Sets the width of a vector polyline, for the vector identified by index.

Parameters
VectorNameUnique identifier for the vector.
widthWidth, in grid units, of the polyline.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_SCENARIO_VECTORENGIVE_UNKNOWNNo object with the provided name.
IPromeApp::WxStation_Create ( [in] const BSTR  StationName)

This method attempts to create a new weather station object with the id given it.

Parameters
StationNameUnique identifier for the new weather station.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_WEATHER_STATION_ALREADY_PRESENTThere is already a weather station with this identifier.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
IPromeApp::WxStation_Delete ( [in] const BSTR  StationName)

Deletes a weather station.

Parameters
StationNameUnique identifier for the station.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_SCENARIO_UNKNOWNThere is no scenario with this name.
ERROR_SCENARIO_BAD_STATEThe scenario is in a bad state.
ERROR_WEATHER_STATION_UNKNOWNNo weather station with this name can be found.
ERROR_SCENARIO_SIMULATION_RUNNINGAction cannot be performed while scenario is running.
SUCCESS_SCENARIO_SIMULATION_COMPLETEAction connate be performed while scenario is in complete state.
IPromeApp::WxStation_GetIndex ( [in] const BSTR  StationName,
[out, retval] int *  index 
)

Retrieves the index of a weather station given a name.

Parameters
StationNameUnique identifier for the station.
indexIndex of weather station.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
IPromeApp::WxStation_GetLocation ( const BSTR  StationName,
[out] double *  Latitude,
[out] double *  Longitude,
[out] double *  Elevation 
)

Gets the latitude, longitude and elevation of a weather station specified by weather station id.

Parameters
StationNameUnique identifier for a weather station.
LatitudeSets this to latitude on return.
LongitudeSets this to longitude on return.
ElevationSets this to elevation on return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNNo weather station exists with this id.
IPromeApp::WxStation_GetName ( [in] int  index,
[out, retval] BSTR *  StationName 
)

Retrieves the station name of a weather station given an index.

Parameters
StationNameUnique identifier for the station.
indexIndex of weather station.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station at this index.
IPromeApp::WxStation_Number ( [out, retval] int *  NumOfStations)

Gets the number of weather stations.

Parameters
NumOfStationsSets this to the number of weather stations on return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_POINTERAddress provided is invalid.
IPromeApp::WxStation_PutName ( [in] int  index,
[in] const BSTR  StationName 
)

Sets the weather station at an index to the name passed to it.

Parameters
indexIndex of aweather station.
StationNameUnique identifier of a weather station.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNThere is no weather station at this index.

Set the name of a weather station.

Parameters
indexUnique identifier of the weather station.
StationNameName of the station.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNNo weather station with this name exists.
IPromeApp::WxStation_SetLocation ( const BSTR  StationName,
[in] double  Latitude,
[in] double  Longitude,
[in] double  Elevation 
)

Set the coordinates and elevation of a weather station.

Parameters
StationNameUnique identifier of the weather station.
LatitudeLatitude coordinate.
LongitudeLongitdue coordinate.
ElevationElevation.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNNo weather station with this name exists.
ERROR_GRID_LOCATION_OUT_OF_RANGEA location of 0.0, 0.0 degrees was provided for latitude, longitude.
IPromeApp::WxStream_AddWeatherDaily ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] double  min_temp,
[in] double  max_temp,
[in] double  min_ws,
[in] double  max_ws,
[in] double  rh,
[in] double  precip,
[in] double  wd 
)

Adds daily weather to the weather stream specified by station name and stream name.

Parameters
StationNameUnique identifier for the station.
StreamNameUnique identifier for the stream.
min_tempMinimum temperature.
max_tempMaximum temperature.
min_wsMinimum windspeed.
max_wsMaximum windspeed.
rhRelative humidity.
precipPrecipitation.
wdWind direction.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNNo weather station with this name can be found.
ERROR_WEATHER_STREAM_UNKNOWNNo weather stream with this name can be found.
E_UNEXPECTEDInternal error. Please report to the software development team.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_SIMULATION_RUNNINGCannot add weather while simulation is running.
IPromeApp::WxStream_ClearAllWeatherData ( [in] const BSTR  StationName,
[in] const BSTR  StreamName 
)

Deletes all hourly and daily weather data in the file. Does not reset start time, starting codes, etc.

Parameters
StationNameUnique identifier for a weather station.
StreamNameUnique identifier for a weather stream.
Return values
S_OKSuccessful.
IPromeApp::WxStream_Create ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] const BSTR  StartTime 
)

This method attempts to create a new weather stream object with the given name, station and start time.

Parameters
StationNameUnique identifier for the weather station.
StreamNameUnique identifier for a weather stream.
StartTimeStart time for the weather stream. Time should be of format "YYYY-MM-DD"
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
ERROR_WEATHER_STATION_ALREADY_PRESENTThere is already a weather station with this identifier.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNThe weather station specified can not be found.
E_FAILA general failure occurred.
E_INVALIDARGInvalid parameters.
IPromeApp::WxStream_Delete ( [in] const BSTR  StationName,
[in] const BSTR  StreamName 
)

Deletes a weather stream.

Parameters
StationNameUnique identifier for the station.
StreamNameUnique identifier for the stream.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNNo weather station with this name can be found.
ERROR_WEATHER_STREAM_UNKNOWNNo weather stream with this name can be found.
E_UNEXPECTEDInternal error. Please report to the software development team.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_SIMULATION_RUNNINGThe weather stream cannot be delete while a scenario is running.
IPromeApp::WxStream_EditWeatherDaily ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] const BSTR  Day,
[in] double  MinTemp,
[in] double  MaxTemp,
[in] double  MinWS,
[in] double  MaxWS,
[in] double  MinRH,
[in] double  Preci,
[in] double  WD 
)

Edits a specific weather stream's daily observation values for a specific day. This day must already exist in the weather stream, or be adjacent to an existing day. Judy Beck's diurnal curve equations are used to calculate hourly data from these daily observations.

Parameters
StationNameUnique identifier for a weather station.
StreamNameUnique identifier for a weather stream.
DayIdentifies the day to modify (or add) in the weather stream.
MinTempMinimum observed temperature (degrees in Celsius) for the day.
MaxTempMaximum observed temperature (degrees in Celsius) for the day.
MinWSMinimum observed wind speed (km/hr) for the day.
MaxWSMaximum observed wind speed (km/hr) for the day.
MinRHMinimum observed relative humidity (%) for the day.
PreciTotal observed precipitation (mm) for the day.
WDMean observed wind direction (degrees clockwise from north) for the day.
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error; or if the operation of making daily observations failed (e.g. because the requested day is not present or adjacent to existing data).
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNStationName does not correspond to a known weather station.
ERROR_WEATHER_STREAM_UNKNOWNStreamName does not correspond to a known weather stream.
ERROR_SCENARIO_SIMULATION_RUNNINGIf trying to set a new start time when the fire is attached to a running simulation.
E_POINTERAddress provided is invalid.
IPromeApp::WxStream_EditWeatherHourly ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] const BSTR  Day,
[in] long  Hour,
[in] double  Temp,
[in] double  RH,
[in] double  WS,
[in] double  Preci,
[in] double  WD 
)

Edits a specific weather stream's hourly readings for a specific hour of a specific day. This day must already exist in the weather stream, or be adjacent to an existing day.

Parameters
StationNameuniquely identifies a weather station
StreamNameuniquely identifies a weather stream
DayIdentifies the day to modify (or add) in the weather stream.
HourHour (0 to 23).
TempTemperature for the hour (degrees in Celsius).
RHRelative humidity for the hour (%).
WSWind speed for the hour (km/hr).
PreciPrecipitation for the hour (mm).
WDWind direction for the hour (degrees clockwise from north).
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error; or if the operation of making hourly readings failed (e.g. because the requested day is not present or adjacent to existing data).
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNStationName does not correspond to a known weather station.
ERROR_WEATHER_STREAM_UNKNOWNStreamName does not correspond to a known weather stream.
ERROR_SCENARIO_BAD_TIMESDay is not in a valid date format.
E_POINTERAddress provided is invalid.
ERROR_SCENARIO_SIMULATION_RUNNINGIf trying to set a new start time when the fire is attached to a running simulation.
IPromeApp::WxStream_Export ( [in] const BSTR  fileName,
[in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] int  flags 
)

Exports a weather stream identified by station and stream name with a possible header to the filename directed.

Parameters
StationNameUniquely identifies the weather station.
fileNameThe path and filename to export to.
StreamNameUniquely identifies the weather stream.
flags0x1 (low-order) bit: Whether or not to include header information. 0x2 bit: Whether or not to include FWI information. 0x4 bit: Whether or not to export as an hourly weather file (daily is 0)
Return values
S_OKSuccessful
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNThere is no weather station with this name.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream with this name.
ERROR_ACCESS_DENIEDAccess denied.
ERROR_INVALID_HANDLEThe handle has been invalidated, or closed.
ERROR_FILE_EXISTSThe file exists.
ERROR_INVALID_PARAMETERThe parameter is incorrect.
ERROR_TOO_MANY_OPEN_FILESSystem error; current application has too many files open.
ERROR_FILE_NOT_FOUNDThe specified file could not be found.
ERROR_HANDLE_DISK_FULLThe disk is full.
IPromeApp::WxStream_GetBooleanAttribute ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] unsigned short  attribute_key,
[out, retval] VARIANT_BOOL *  value 
)

Retrieves the value of a certain attribute of a station, or stream.

Parameters
StationNameUnique identifier for the station.
attribute_keyValid attributes are:
  • CWFGM_WEATHER_OPTION_FFMC_VANWAGNER Use the Van Wagner approach to calculating HFFMC values.
  • CWFGM_WEATHER_OPTION_FFMC_HYBRID Do not use, only for experimental purposes.
  • CWFGM_WEATHER_OPTION_FFMC_LAWSON Use the Lawson approach to calculating HFFMC values
  • CWFGM_WEATHER_OPTION_FWI_USE_SPECIFIED Use any/all FWI values provided in the input file
  • CWFGM_WEATHER_OPTION_ORIGIN_FILE Indicates whether the weather stream data origininated from an imported file.
StreamNameUnique identifier for the stream.
valueSet to the correct value upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream at this index.
E_FAILA general failure occurred.
IPromeApp::WxStream_GetDoubleAttribute ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] unsigned short  attribute_key,
[out, retval] double *  value 
)

Retrieves the value of a certain attribute of a station, or stream.

Parameters
StationNameUnique identifier for the station.
attribute_keyValid attributes are:
  • CWFGM_WEATHER_OPTION_TEMP_ALPHA The 'alpha' value for Beck et. al. diurnal equations for temperature.
  • CWFGM_WEATHER_OPTION_TEMP_BETA The 'beta' value for Beck et. al. diurnal equations for temperature.
  • CWFGM_WEATHER_OPTION_TEMP_GAMMA The 'gamma' value for Beck et. al. diurnal equations for temperature.
  • CWFGM_WEATHER_OPTION_WIND_ALPHA The 'alpha' value for Beck et. al. diurnal equations for wind.
  • CWFGM_WEATHER_OPTION_WIND_BETA The 'beta' value for Beck et. al. diurnal equations for wind.
  • CWFGM_WEATHER_OPTION_WIND_GAMMA The 'gamma' value for Beck et. al. diurnal equations for wind.
  • CWFGM_WEATHER_OPTION_INITIAL_FFMC Initial FFMC value for daily FWI calculations.
  • CWFGM_WEATHER_OPTION_INITIAL_HFFMC Initial hourly FFMC value for hourly FWI calculations.
  • CWFGM_WEATHER_OPTION_INITIAL_DC Initial DC value for daily FWI calculations.
  • CWFGM_WEATHER_OPTION_INITIAL_DMC Initial DMC value for daily FWI calculations.
  • CWFGM_WEATHER_OPTION_INITIAL_BUI Optional initial BUI value. If not provided, then BUI is calculated from the initial DC, DMC values. Use -99.0 to clear the specified value.
  • CWFGM_WEATHER_OPTION_INITIAL_RAIN 64-bit floating point. Initial rain for the prior 11/12 hours. Only needed for Van Wagner HFFMC calculations.
StreamNameUnique identifier for the stream.
valueSet to the correct value upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream at this index.
E_FAILA general failure occurred.
IPromeApp::WxStream_GetIndex ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[out, retval] int *  index 
)

Retrieves the index of a weather stream for a certain station and stream name.

Parameters
StationNameUnique identifier for the station.
indexIndex of weather station.
StreamNameUnique identifier for the stream.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream at this index.
IPromeApp::WxStream_GetIntegerAttribute ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] unsigned short  attribute_key,
[out, retval] int *  value 
)

Retrieves the value of a certain attribute of a station, or stream.

Parameters
StationNameUnique identifier for the station.
attribute_keyValid attributes are:
  • CWFGM_WEATHER_OPTION_INITIAL_HFFMCTIME 64-bit signed integer. Units are in seconds. Hour at which the initial HFFMC value is observed. HFFMC values will be calculated forward and back in time from this value.
StreamNameUnique identifier for the stream.
valueSet to the correct value upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream at this index.
E_FAILA general failure occurred.
IPromeApp::WxStream_GetName ( [in] const BSTR  StationName,
[in] int  index,
[out, retval] BSTR *  StreamName 
)

Retrieves the name of a weather stream for a certain station and index.

Parameters
StationNameUnique identifier for the station.
indexIndex of weather station.
StreamNameUnique identifier for the stream.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream at this index.
IPromeApp::WxStream_GetStartTime ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[out,retval] BSTR *  StartTime 
)

Retrieves the start time of a stream.

Parameters
StationNameUnique identifier for the station.
StartTimeSet to the start time upon return.
StreamNameUnique identifier for the stream.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream at this index.
IPromeApp::WxStream_Import ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] const BSTR  FileName 
)

Attempts to import a weather stream for the specified weather station from the specified file.

Parameters
FileNameThe file name and path of the file where the weather stream data is.
StationNameUnique identifier for a weather station.
StreamNameUnique identifier for a weather stream.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNThere is no weather station with this id.
ERROR_WEATHER_STREAM_ALREADY_ADDEDThere is already a weather stream with this id.
IPromeApp::WxStream_Number ( [in] const BSTR  StationName,
[in, out] int *  NumOfStreams 
)

Retrieves the number of weathers streams for a certain station.

Parameters
StationNameUnique identifier for the station.
NumOfStreamsSet to the number of streams upon return.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
IPromeApp::WxStream_PutName ( [in] const BSTR  StationName,
[in] int  index,
[in] const BSTR  StreamName 
)

Set the name of a weather stream.

Parameters
indexUnique identifier of the weather stream.
StationNameName of the station.
StreamNameName of the stream
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
ERROR_WEATHER_STATION_UNKNOWNNo weather station with this name exists.
E_POINTERInvalid address.
ERROR_WEATHER_STREAM_UNKNOWNNo weather station exists with this index.
IPromeApp::WxStream_SetBooleanAttribute ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] unsigned short  attribute_key,
[in] VARIANT_BOOL  value 
)

Set station and stream attributes.

Parameters
StationNameUnique identifier for the station.
attribute_keyUsed to identify the attribute to be changed. Valid values are:
  • CWFGM_WEATHER_OPTION_FFMC_VANWAGNER Use the Van Wagner approach to calculating HFFMC values
  • CWFGM_WEATHER_OPTION_FFMC_HYBRID Do not use, only for experimental purposes.
  • CWFGM_WEATHER_OPTION_FFMC_LAWSON Use the Lawson approach to calculating HFFMC values
  • CWFGM_WEATHER_OPTION_FWI_USE_SPECIFIED Use any/all FWI values provided in the input file
StreamNameUnique identifier for the stream.
valueValue to set the attribute to.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream at this index.
ERROR_SCENARIO_SIMULATION_RUNNINGCan't change a weather stream while simulating.
FALSEfalse.
E_FAILA general failure occurred.
E_INVALIDARGInvalid parameters.
ERROR_WEATHER_OPTION_INVALIDUnrecognized key code.
IPromeApp::WxStream_SetDoubleAttribute ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] unsigned short  attribute_key,
[in] double  value 
)

Set station and stream double attributes.

Parameters
StationNameUnique identifier for the station.
attribute_keyUsed to identify the attribute to be changed.
StreamNameUnique identifier for the stream.
valueValue to set the attribute to.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream at this index.
ERROR_SCENARIO_SIMULATION_RUNNINGCan't change a weather stream while simulating.
FALSEfalse.
E_FAILA general failure occurred.
E_INVALIDARGInvalid parameters.
ERROR_WEATHER_OPTION_INVALIDUnrecognized key code.
IPromeApp::WxStream_SetIntegerAttribute ( [in] const BSTR  StationName,
[in] const BSTR  StreamName,
[in] unsigned short  attribute_key,
[in] int  value 
)

Set station and stream integer attributes.

Parameters
StationNameUnique identifier for the station.
attribute_keyValid attribute keys are:
  • CWFGM_WEATHER_OPTION_INITIAL_HFFMCTIME 64-bit signed integer. Units are in seconds. Hour at which the initial HFFMC value is observed. HFFMC values will be calculated forward and back in time from this value.
StreamNameUnique identifier for the stream.
valueValue to set the attribute to.
Return values
S_OKSuccessful.
ERROR_SEVERITY_WARNINGFailed initialization or a non-specific I/O error.
E_OUTOFMEMORYThere is not enough memory to complete the operation.
E_POINTERAddress provided is invalid.
ERROR_WEATHER_STATION_UKNOWNThere is no weather station with this name.
ERROR_WEATHER_STREAM_UNKNOWNThere is no weather stream at this index.
ERROR_SCENARIO_SIMULATION_RUNNINGCan't change a weather stream while simulating.
FALSEfalse.
E_FAILA general failure occurred.
E_INVALIDARGInvalid parameters.
ERROR_WEATHER_OPTION_INVALIDUnrecognized key code.