openswmm_links.h

Go to the documentation of this file.

 
#ifndef OPENSWMM_LINKS_H
#define OPENSWMM_LINKS_H
 
#include "openswmm_engine.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum SWMM_LinkType {
    SWMM_LINK_CONDUIT = 0, 
    SWMM_LINK_PUMP    = 1, 
    SWMM_LINK_ORIFICE = 2, 
    SWMM_LINK_WEIR    = 3, 
    SWMM_LINK_OUTLET  = 4  
} SWMM_LinkType;
 
typedef enum SWMM_XSectShape {
    SWMM_XSECT_CIRCULAR        =  0, 
    SWMM_XSECT_FILLED_CIRCULAR =  1, 
    SWMM_XSECT_RECT_CLOSED     =  2, 
    SWMM_XSECT_RECT_OPEN       =  3, 
    SWMM_XSECT_TRAPEZOIDAL     =  4, 
    SWMM_XSECT_TRIANGULAR      =  5, 
    SWMM_XSECT_PARABOLIC       =  6, 
    SWMM_XSECT_POWER           =  7, 
    SWMM_XSECT_RECT_TRIANG     =  8, 
    SWMM_XSECT_RECT_ROUND      =  9, 
    SWMM_XSECT_MOD_BASKET      = 10, 
    SWMM_XSECT_HORIZ_ELLIPSE   = 11, 
    SWMM_XSECT_VERT_ELLIPSE    = 12, 
    SWMM_XSECT_ARCH            = 13, 
    SWMM_XSECT_EGGSHAPED       = 14, 
    SWMM_XSECT_HORSESHOE       = 15, 
    SWMM_XSECT_GOTHIC          = 16, 
    SWMM_XSECT_CATENARY        = 17, 
    SWMM_XSECT_SEMIELLIPTICAL  = 18, 
    SWMM_XSECT_IRREGULAR       = 19  
} SWMM_XSectShape;
 
/* =========================================================================
 * Identity
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_count(SWMM_Engine engine);
 
SWMM_ENGINE_API int swmm_link_index(SWMM_Engine engine, const char* id);
 
SWMM_ENGINE_API const char* swmm_link_id(SWMM_Engine engine, int idx);
 
/* =========================================================================
 * Creation (BUILDING state only)
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_add(SWMM_Engine engine, const char* id, int type);
 
/* =========================================================================
 * Connectivity (BUILDING or OPENED)
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_set_nodes(SWMM_Engine engine, int idx,
                                         int from_node_idx, int to_node_idx);
 
SWMM_ENGINE_API int swmm_link_get_from_node(SWMM_Engine engine, int idx, int* node_idx);
 
SWMM_ENGINE_API int swmm_link_get_to_node(SWMM_Engine engine, int idx, int* node_idx);
 
/* =========================================================================
 * Geometry setters (BUILDING or OPENED)
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_set_length(SWMM_Engine engine, int idx, double length);
 
SWMM_ENGINE_API int swmm_link_set_roughness(SWMM_Engine engine, int idx, double n);
 
SWMM_ENGINE_API int swmm_link_set_offset_up(SWMM_Engine engine, int idx, double offset);
 
SWMM_ENGINE_API int swmm_link_set_offset_dn(SWMM_Engine engine, int idx, double offset);
 
SWMM_ENGINE_API int swmm_link_set_initial_flow(SWMM_Engine engine, int idx, double flow);
 
SWMM_ENGINE_API int swmm_link_set_max_flow(SWMM_Engine engine, int idx, double flow);
 
/* =========================================================================
 * Cross-section (BUILDING or OPENED)
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_set_xsect(SWMM_Engine engine, int idx,
                                          int shape, double geom1, double geom2,
                                          double geom3, double geom4);
 
SWMM_ENGINE_API int swmm_link_get_xsect(SWMM_Engine engine, int idx,
                                          int* shape, double* geom1, double* geom2,
                                          double* geom3, double* geom4);
 
/* =========================================================================
 * Geometry getters
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_get_type(SWMM_Engine engine, int idx, int* type);
 
SWMM_ENGINE_API int swmm_link_get_length(SWMM_Engine engine, int idx, double* length);
 
SWMM_ENGINE_API int swmm_link_get_roughness(SWMM_Engine engine, int idx, double* n);
 
/* =========================================================================
 * Hydraulic state getters/setters
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_get_flow(SWMM_Engine engine, int idx, double* flow);
 
SWMM_ENGINE_API int swmm_link_set_flow(SWMM_Engine engine, int idx, double flow);
 
SWMM_ENGINE_API int swmm_link_get_depth(SWMM_Engine engine, int idx, double* depth);
 
SWMM_ENGINE_API int swmm_link_get_velocity(SWMM_Engine engine, int idx, double* velocity);
 
SWMM_ENGINE_API int swmm_link_get_capacity(SWMM_Engine engine, int idx, double* capacity);
 
SWMM_ENGINE_API int swmm_link_get_volume(SWMM_Engine engine, int idx, double* volume);
 
/* --- Runtime forcing (RUNNING state only) --- */
 
SWMM_ENGINE_API int swmm_link_set_control_setting(SWMM_Engine engine, int idx, double setting);
 
SWMM_ENGINE_API int swmm_link_get_control_setting(SWMM_Engine engine, int idx, double* setting);
 
SWMM_ENGINE_API int swmm_link_set_target_setting(SWMM_Engine engine, int idx, double setting);
 
SWMM_ENGINE_API int swmm_link_get_target_setting(SWMM_Engine engine, int idx, double* setting);
 
SWMM_ENGINE_API int swmm_link_set_closed(SWMM_Engine engine, int idx, int closed);
 
SWMM_ENGINE_API int swmm_link_get_closed(SWMM_Engine engine, int idx, int* closed);
 
/* =========================================================================
 * Pump Link API
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_set_pump_curve(SWMM_Engine engine, int idx, int curve_idx);
 
SWMM_ENGINE_API int swmm_link_get_pump_curve(SWMM_Engine engine, int idx, int* curve_idx);
 
SWMM_ENGINE_API int swmm_link_set_pump_init_state(SWMM_Engine engine, int idx, int on);
 
SWMM_ENGINE_API int swmm_link_get_pump_init_state(SWMM_Engine engine, int idx, int* on);
 
/* =========================================================================
 * Weir Link API
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_set_crest_height(SWMM_Engine engine, int idx, double h);
 
SWMM_ENGINE_API int swmm_link_get_crest_height(SWMM_Engine engine, int idx, double* h);
 
SWMM_ENGINE_API int swmm_link_set_discharge_coeff(SWMM_Engine engine, int idx, double cd);
 
SWMM_ENGINE_API int swmm_link_get_discharge_coeff(SWMM_Engine engine, int idx, double* cd);
 
SWMM_ENGINE_API int swmm_link_set_end_contractions(SWMM_Engine engine, int idx, double n);
 
SWMM_ENGINE_API int swmm_link_get_end_contractions(SWMM_Engine engine, int idx, double* n);
 
/* =========================================================================
 * Conduit Loss Coefficients
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_set_loss_coeff(SWMM_Engine engine, int idx, double inlet, double outlet, double avg);
 
SWMM_ENGINE_API int swmm_link_get_loss_coeff(SWMM_Engine engine, int idx, double* inlet, double* outlet, double* avg);
 
SWMM_ENGINE_API int swmm_link_set_flap_gate(SWMM_Engine engine, int idx, int has_gate);
 
SWMM_ENGINE_API int swmm_link_get_flap_gate(SWMM_Engine engine, int idx, int* has_gate);
 
SWMM_ENGINE_API int swmm_link_set_seep_rate(SWMM_Engine engine, int idx, double rate);
 
SWMM_ENGINE_API int swmm_link_get_seep_rate(SWMM_Engine engine, int idx, double* rate);
 
SWMM_ENGINE_API int swmm_link_set_culvert_code(SWMM_Engine engine, int idx, int code);
 
SWMM_ENGINE_API int swmm_link_get_culvert_code(SWMM_Engine engine, int idx, int* code);
 
SWMM_ENGINE_API int swmm_link_set_barrels(SWMM_Engine engine, int idx, int n);
 
SWMM_ENGINE_API int swmm_link_get_barrels(SWMM_Engine engine, int idx, int* n);
 
SWMM_ENGINE_API int swmm_link_get_slope(SWMM_Engine engine, int idx, double* slope);
 
SWMM_ENGINE_API int swmm_link_get_offset_up(SWMM_Engine engine, int idx, double* offset);
 
SWMM_ENGINE_API int swmm_link_get_offset_dn(SWMM_Engine engine, int idx, double* offset);
 
/* =========================================================================
 * Link Statistics
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_get_stat_max_flow(SWMM_Engine engine, int idx, double* val);
 
SWMM_ENGINE_API int swmm_link_get_stat_max_velocity(SWMM_Engine engine, int idx, double* val);
 
SWMM_ENGINE_API int swmm_link_get_stat_max_filling(SWMM_Engine engine, int idx, double* val);
 
SWMM_ENGINE_API int swmm_link_get_stat_vol_flow(SWMM_Engine engine, int idx, double* val);
 
SWMM_ENGINE_API int swmm_link_get_stat_surcharge_time(SWMM_Engine engine, int idx, double* val);
 
/* =========================================================================
 * Water quality
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_get_quality(SWMM_Engine engine, int link_idx,
                                           int pollutant_idx, double* conc);
 
/* =========================================================================
 * Bulk access
 * ========================================================================= */
 
SWMM_ENGINE_API int swmm_link_get_flows_bulk(SWMM_Engine engine, double* buf, int count);
 
SWMM_ENGINE_API int swmm_link_get_depths_bulk(SWMM_Engine engine, double* buf, int count);
 
SWMM_ENGINE_API int swmm_link_set_flows_bulk(SWMM_Engine engine, const double* buf, int count);
 
SWMM_ENGINE_API int swmm_link_get_quality_bulk(SWMM_Engine engine, int pollutant_idx,
                                                 double* buf, int count);
 
#ifdef __cplusplus
} /* extern "C" */
#endif
 
#endif /* OPENSWMM_LINKS_H */