openswmm_output.h

Go to the documentation of this file.

 
#ifndef OPENSWMM_OUTPUT_H
#define OPENSWMM_OUTPUT_H
 
#include "openswmm_engine_export.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* =========================================================================
 * Opaque handle
 * ========================================================================= */
 
typedef void* SWMM_Output;
 
/* =========================================================================
 * Result variable enumerations
 * ========================================================================= */
 
typedef enum SWMM_OutSubcatchVar {
    SWMM_OUT_SUBCATCH_RAINFALL      = 0, 
    SWMM_OUT_SUBCATCH_SNOW_DEPTH    = 1, 
    SWMM_OUT_SUBCATCH_EVAP          = 2, 
    SWMM_OUT_SUBCATCH_INFIL         = 3, 
    SWMM_OUT_SUBCATCH_RUNOFF        = 4, 
    SWMM_OUT_SUBCATCH_GW_FLOW       = 5, 
    SWMM_OUT_SUBCATCH_GW_ELEV       = 6, 
    SWMM_OUT_SUBCATCH_SOIL_MOIST    = 7, 
    SWMM_OUT_SUBCATCH_POLLUT_BASE   = 8  
} SWMM_OutSubcatchVar;
 
typedef enum SWMM_OutNodeVar {
    SWMM_OUT_NODE_DEPTH          = 0, 
    SWMM_OUT_NODE_HEAD           = 1, 
    SWMM_OUT_NODE_VOLUME         = 2, 
    SWMM_OUT_NODE_LATERAL_INFLOW = 3, 
    SWMM_OUT_NODE_TOTAL_INFLOW   = 4, 
    SWMM_OUT_NODE_OVERFLOW       = 5, 
    SWMM_OUT_NODE_POLLUT_BASE    = 6  
} SWMM_OutNodeVar;
 
typedef enum SWMM_OutLinkVar {
    SWMM_OUT_LINK_FLOW           = 0, 
    SWMM_OUT_LINK_DEPTH          = 1, 
    SWMM_OUT_LINK_VELOCITY       = 2, 
    SWMM_OUT_LINK_VOLUME         = 3, 
    SWMM_OUT_LINK_CAPACITY       = 4, 
    SWMM_OUT_LINK_POLLUT_BASE    = 5  
} SWMM_OutLinkVar;
 
typedef enum SWMM_OutSystemVar {
    SWMM_OUT_SYS_TEMPERATURE    =  0, 
    SWMM_OUT_SYS_RAINFALL       =  1, 
    SWMM_OUT_SYS_SNOW_DEPTH     =  2, 
    SWMM_OUT_SYS_EVAP           =  3, 
    SWMM_OUT_SYS_INFIL          =  4, 
    SWMM_OUT_SYS_RUNOFF         =  5, 
    SWMM_OUT_SYS_DW_INFLOW      =  6, 
    SWMM_OUT_SYS_GW_INFLOW      =  7, 
    SWMM_OUT_SYS_LAT_INFLOW     =  8, 
    SWMM_OUT_SYS_FLOODING       =  9, 
    SWMM_OUT_SYS_OUTFLOW        = 10, 
    SWMM_OUT_SYS_STORAGE        = 11, 
    SWMM_OUT_SYS_EVAP_TOTAL     = 12, 
    SWMM_OUT_SYS_PET            = 13  
} SWMM_OutSystemVar;
 
/* =========================================================================
 * Lifecycle
 * ========================================================================= */
 
SWMM_ENGINE_API SWMM_Output swmm_output_open(const char* path);
 
SWMM_ENGINE_API void swmm_output_close(SWMM_Output handle);
 
/* =========================================================================
 * Metadata queries
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_output_get_version(SWMM_Output handle);
 
SWMM_ENGINE_API int swmm_output_get_flow_units(SWMM_Output handle);
 
SWMM_ENGINE_API int swmm_output_get_subcatch_count(SWMM_Output handle);
 
SWMM_ENGINE_API int swmm_output_get_node_count(SWMM_Output handle);
 
SWMM_ENGINE_API int swmm_output_get_link_count(SWMM_Output handle);
 
SWMM_ENGINE_API int swmm_output_get_pollut_count(SWMM_Output handle);
 
SWMM_ENGINE_API int swmm_output_get_period_count(SWMM_Output handle);
 
SWMM_ENGINE_API int swmm_output_get_start_date(SWMM_Output handle,
                                                 double* start_date);
 
SWMM_ENGINE_API int swmm_output_get_report_step(SWMM_Output handle);
 
/* =========================================================================
 * Object ID retrieval
 * ========================================================================= */
 
SWMM_ENGINE_API const char* swmm_output_get_subcatch_id(SWMM_Output handle,
                                                          int index);
 
SWMM_ENGINE_API const char* swmm_output_get_node_id(SWMM_Output handle,
                                                      int index);
 
SWMM_ENGINE_API const char* swmm_output_get_link_id(SWMM_Output handle,
                                                      int index);
 
/* =========================================================================
 * Per-period result retrieval (all objects, one variable, one period)
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_output_get_subcatch_result(SWMM_Output handle,
                                                      int period,
                                                      int var,
                                                      float* values);
 
SWMM_ENGINE_API int swmm_output_get_node_result(SWMM_Output handle,
                                                  int period,
                                                  int var,
                                                  float* values);
 
SWMM_ENGINE_API int swmm_output_get_link_result(SWMM_Output handle,
                                                  int period,
                                                  int var,
                                                  float* values);
 
SWMM_ENGINE_API int swmm_output_get_system_result(SWMM_Output handle,
                                                    int period,
                                                    int var,
                                                    float* value);
 
/* =========================================================================
 * Time series retrieval (one object, one variable, period range)
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_output_get_subcatch_series(SWMM_Output handle,
                                                      int subcatch_idx,
                                                      int var,
                                                      int start_period,
                                                      int end_period,
                                                      float* values);
 
SWMM_ENGINE_API int swmm_output_get_node_series(SWMM_Output handle,
                                                  int node_idx,
                                                  int var,
                                                  int start_period,
                                                  int end_period,
                                                  float* values);
 
SWMM_ENGINE_API int swmm_output_get_link_series(SWMM_Output handle,
                                                  int link_idx,
                                                  int var,
                                                  int start_period,
                                                  int end_period,
                                                  float* values);
 
SWMM_ENGINE_API int swmm_output_get_system_series(SWMM_Output handle,
                                                    int var,
                                                    int start_period,
                                                    int end_period,
                                                    float* values);
 
/* =========================================================================
 * Per-object result retrieval (all variables for one object at one period)
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_output_get_subcatch_attribute(SWMM_Output handle,
                                                        int subcatch_idx,
                                                        int period,
                                                        float* values,
                                                        int* count);
 
SWMM_ENGINE_API int swmm_output_get_node_attribute(SWMM_Output handle,
                                                     int node_idx,
                                                     int period,
                                                     float* values,
                                                     int* count);
 
SWMM_ENGINE_API int swmm_output_get_link_attribute(SWMM_Output handle,
                                                     int link_idx,
                                                     int period,
                                                     float* values,
                                                     int* count);
 
/* =========================================================================
 * Simulation time retrieval
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_output_get_period_time(SWMM_Output handle,
                                                  int period,
                                                  double* time);
 
/* =========================================================================
 * Error reporting
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_output_get_error_code(SWMM_Output handle);
 
#ifdef __cplusplus
}
#endif
 
#endif /* OPENSWMM_OUTPUT_H */