openswmm_engine.h

Go to the documentation of this file.

 
#ifndef OPENSWMM_ENGINE_H
#define OPENSWMM_ENGINE_H
 
#include "openswmm_callbacks.h"
 
/* =========================================================================
 * Export macro
 * ========================================================================= */
 
#ifdef OPENSWMM_ENGINE_STATIC
#  define SWMM_ENGINE_API
#else
#  ifdef _WIN32
#    ifdef openswmm_engine_EXPORTS
#      define SWMM_ENGINE_API __declspec(dllexport)
#    else
#      define SWMM_ENGINE_API __declspec(dllimport)
#    endif
#  else
#    define SWMM_ENGINE_API __attribute__((visibility("default")))
#  endif
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* =========================================================================
 * Error codes
 * ========================================================================= */
 
typedef enum SWMM_ErrorCode {
    SWMM_OK              =  0,
    SWMM_ERR_NOMEM       =  1,
    SWMM_ERR_INPFILE     =  2,
    SWMM_ERR_RPTFILE     =  3,
    SWMM_ERR_OUTFILE     =  4,
    SWMM_ERR_PARSE       =  5,
    SWMM_ERR_LIFECYCLE   =  6,
    SWMM_ERR_BADHANDLE   =  7,
    SWMM_ERR_BADINDEX    =  8,
    SWMM_ERR_BADPARAM    =  9,
    SWMM_ERR_PLUGIN      = 10,
    SWMM_ERR_IO          = 11,
    SWMM_ERR_HOTSTART    = 12,
    SWMM_ERR_CRS         = 13,
    SWMM_ERR_NUMERICAL   = 14,
    SWMM_ERR_INTERNAL    = 99
} SWMM_ErrorCode;
 
typedef enum SWMM_WarnCode {
    SWMM_WARN_NONE              = 0,
    SWMM_WARN_HOTSTART_MISSING  = 1,
    SWMM_WARN_UNKNOWN_SECTION   = 2,
    SWMM_WARN_UNKNOWN_OPTION    = 3,
    SWMM_WARN_DEPRECATED_KW     = 4,
    SWMM_WARN_PLUGIN_INIT       = 5,
    SWMM_WARN_NUMERICAL         = 6,
    SWMM_WARN_STABILITY_LIMIT   = 7
} SWMM_WarnCode;
 
/* =========================================================================
 * Engine lifecycle state
 * ========================================================================= */
 
typedef enum SWMM_EngineState {
    SWMM_STATE_NONE        = 0,
    SWMM_STATE_CREATED     = 1,
    SWMM_STATE_OPENED      = 2,
    SWMM_STATE_INITIALIZED = 3,
    SWMM_STATE_STARTED     = 4,
    SWMM_STATE_RUNNING     = 5,
    SWMM_STATE_ENDED       = 6,
    SWMM_STATE_CLOSED      = 7,
    SWMM_STATE_BUILDING    = 8  
} SWMM_EngineState;
 
/* =========================================================================
 * Object type identifiers
 * ========================================================================= */
 
typedef enum SWMM_ObjectType {
    SWMM_OBJ_GAGE      = 0,
    SWMM_OBJ_SUBCATCH  = 1,
    SWMM_OBJ_NODE      = 2,
    SWMM_OBJ_LINK      = 3,
    SWMM_OBJ_POLLUT    = 4,
    SWMM_OBJ_LANDUSE   = 5,
    SWMM_OBJ_TIMESER   = 6,
    SWMM_OBJ_TABLE     = 7,
    SWMM_OBJ_RDII      = 8,
    SWMM_OBJ_UNITHYD   = 9,
    SWMM_OBJ_SNOWMELT  = 10,
    SWMM_OBJ_SHAPE     = 11,
    SWMM_OBJ_LID       = 12
} SWMM_ObjectType;
 
/* =========================================================================
 * Engine lifecycle functions
 * ========================================================================= */
 
SWMM_ENGINE_API SWMM_Engine swmm_engine_create(void);
 
SWMM_ENGINE_API int swmm_engine_open(SWMM_Engine engine,
                                      const char* inp, const char* rpt, const char* out);
 
SWMM_ENGINE_API int swmm_engine_initialize(SWMM_Engine engine);
 
SWMM_ENGINE_API int swmm_engine_start(SWMM_Engine engine, int save_results);
 
SWMM_ENGINE_API int swmm_engine_step(SWMM_Engine engine, double* elapsed_time);
 
SWMM_ENGINE_API int swmm_engine_end(SWMM_Engine engine);
 
SWMM_ENGINE_API int swmm_engine_report(SWMM_Engine engine);
 
SWMM_ENGINE_API int swmm_engine_close(SWMM_Engine engine);
 
SWMM_ENGINE_API void swmm_engine_destroy(SWMM_Engine engine);
 
SWMM_ENGINE_API int swmm_engine_get_state(SWMM_Engine engine, int* state);
 
/* =========================================================================
 * Callback registration
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_set_progress_callback  (SWMM_Engine engine,
                                                   SWMM_ProgressCallback  callback, void* user_data);
SWMM_ENGINE_API int swmm_set_warning_callback   (SWMM_Engine engine,
                                                   SWMM_WarningCallback   callback, void* user_data);
SWMM_ENGINE_API int swmm_set_step_begin_callback(SWMM_Engine engine,
                                                   SWMM_StepBeginCallback callback, void* user_data);
SWMM_ENGINE_API int swmm_set_step_end_callback  (SWMM_Engine engine,
                                                   SWMM_StepEndCallback   callback, void* user_data);
 
/* =========================================================================
 * Error reporting
 * ========================================================================= */
 
SWMM_ENGINE_API int         swmm_get_last_error    (SWMM_Engine engine);
SWMM_ENGINE_API const char* swmm_get_last_error_msg(SWMM_Engine engine);
SWMM_ENGINE_API const char* swmm_error_message     (int code);
 
/* =========================================================================
 * Simulation timing
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_get_start_time  (SWMM_Engine engine, double* start);
SWMM_ENGINE_API int swmm_get_end_time    (SWMM_Engine engine, double* end);
SWMM_ENGINE_API int swmm_get_current_time(SWMM_Engine engine, double* current);
SWMM_ENGINE_API int swmm_get_routing_step(SWMM_Engine engine, double* dt);
 
#ifdef __cplusplus
} /* extern "C" */
#endif
 
/* =========================================================================
 * Master include — pull in all domain headers
 *
 * Each domain header includes openswmm_engine.h itself (for SWMM_ENGINE_API
 * and the handle typedef), so include guards prevent recursion.
 * ========================================================================= */
 
#include "openswmm_model.h"
#include "openswmm_nodes.h"
#include "openswmm_links.h"
#include "openswmm_subcatchments.h"
#include "openswmm_gages.h"
#include "openswmm_massbalance.h"
#include "openswmm_hotstart.h"
#include "openswmm_spatial.h"
#include "openswmm_pollutants.h"
#include "openswmm_tables.h"
#include "openswmm_inflows.h"
#include "openswmm_controls.h"
#include "openswmm_infrastructure.h"
#include "openswmm_quality.h"
#include "openswmm_statistics.h"
#include "openswmm_output.h"
#include "openswmm_forcing.h"
 
#endif /* OPENSWMM_ENGINE_H */