OpenSWMM Engine  6.0.0-alpha.1
Data-oriented, plugin-extensible SWMM Engine (6.0.0-alpha.1)
Loading...
Searching...
No Matches
openswmm_pollutants.h
Go to the documentation of this file.
1
16#ifndef OPENSWMM_POLLUTANTS_H
17#define OPENSWMM_POLLUTANTS_H
18
19#include "openswmm_engine.h"
20
21#ifdef __cplusplus
22extern "C" {
23#endif
24
25/* =========================================================================
26 * Identity
27 * ========================================================================= */
28
35
42SWMM_ENGINE_API int swmm_pollutant_index(SWMM_Engine engine, const char* id);
43
50SWMM_ENGINE_API const char* swmm_pollutant_id(SWMM_Engine engine, int idx);
51
52/* =========================================================================
53 * Creation (BUILDING state only)
54 * ========================================================================= */
55
63SWMM_ENGINE_API int swmm_pollutant_add(SWMM_Engine engine, const char* id, int units);
64
65/* =========================================================================
66 * Property setters (BUILDING or OPENED)
67 * ========================================================================= */
68
76SWMM_ENGINE_API int swmm_pollutant_set_kdecay(SWMM_Engine engine, int idx, double k);
77
85SWMM_ENGINE_API int swmm_pollutant_set_rain_conc(SWMM_Engine engine, int idx, double conc);
86
94SWMM_ENGINE_API int swmm_pollutant_set_gw_conc(SWMM_Engine engine, int idx, double conc);
95
103SWMM_ENGINE_API int swmm_pollutant_set_init_conc(SWMM_Engine engine, int idx, double conc);
104
112SWMM_ENGINE_API int swmm_pollutant_get_units(SWMM_Engine engine, int idx, int* units);
113
114/* =========================================================================
115 * Property getters
116 * ========================================================================= */
117
125SWMM_ENGINE_API int swmm_pollutant_get_kdecay(SWMM_Engine engine, int idx, double* k);
126
134SWMM_ENGINE_API int swmm_pollutant_get_rain_conc(SWMM_Engine engine, int idx, double* conc);
135
143SWMM_ENGINE_API int swmm_pollutant_get_gw_conc(SWMM_Engine engine, int idx, double* conc);
144
152SWMM_ENGINE_API int swmm_pollutant_get_init_conc(SWMM_Engine engine, int idx, double* conc);
153
161SWMM_ENGINE_API int swmm_pollutant_set_rdii_conc(SWMM_Engine engine, int idx, double conc);
162
170SWMM_ENGINE_API int swmm_pollutant_get_rdii_conc(SWMM_Engine engine, int idx, double* conc);
171
179SWMM_ENGINE_API int swmm_pollutant_set_mwt(SWMM_Engine engine, int idx, double mwt);
180
188SWMM_ENGINE_API int swmm_pollutant_get_mwt(SWMM_Engine engine, int idx, double* mwt);
189
198SWMM_ENGINE_API int swmm_pollutant_set_co_pollutant(SWMM_Engine engine, int idx, int co_idx, double frac);
199
208SWMM_ENGINE_API int swmm_pollutant_get_co_pollutant(SWMM_Engine engine, int idx, int* co_idx, double* frac);
209
217SWMM_ENGINE_API int swmm_pollutant_set_snow_only(SWMM_Engine engine, int idx, int flag);
218
226SWMM_ENGINE_API int swmm_pollutant_get_snow_only(SWMM_Engine engine, int idx, int* flag);
227
228/* =========================================================================
229 * Runtime quality injection
230 * ========================================================================= */
231
240SWMM_ENGINE_API int swmm_node_set_quality(SWMM_Engine engine, int node_idx, int pollut_idx, double conc);
241
250SWMM_ENGINE_API int swmm_link_set_quality(SWMM_Engine engine, int link_idx, int pollut_idx, double conc);
251
252#ifdef __cplusplus
253} /* extern "C" */
254#endif
255
256#endif /* OPENSWMM_POLLUTANTS_H */
void * SWMM_Engine
Opaque handle to an OpenSWMM Engine instance.
Definition openswmm_callbacks.h:35
OpenSWMM Engine — primary transparent C API (master header).
#define SWMM_ENGINE_API
Definition openswmm_engine.h:87
SWMM_ENGINE_API int swmm_pollutant_count(SWMM_Engine engine)
Get the total number of pollutants in the model.
Definition openswmm_pollutants_impl.cpp:22
SWMM_ENGINE_API int swmm_pollutant_set_gw_conc(SWMM_Engine engine, int idx, double conc)
Set the pollutant concentration in groundwater.
Definition openswmm_pollutants_impl.cpp:88
SWMM_ENGINE_API int swmm_pollutant_set_kdecay(SWMM_Engine engine, int idx, double k)
Set the first-order decay coefficient for a pollutant.
Definition openswmm_pollutants_impl.cpp:72
SWMM_ENGINE_API int swmm_pollutant_set_mwt(SWMM_Engine engine, int idx, double mwt)
Set the molecular weight of a pollutant.
Definition openswmm_pollutants_impl.cpp:164
SWMM_ENGINE_API int swmm_pollutant_index(SWMM_Engine engine, const char *id)
Look up a pollutant's zero-based index by its string identifier.
Definition openswmm_pollutants_impl.cpp:27
SWMM_ENGINE_API int swmm_pollutant_set_co_pollutant(SWMM_Engine engine, int idx, int co_idx, double frac)
Set a co-pollutant relationship (concentration = fraction * co-pollutant).
Definition openswmm_pollutants_impl.cpp:180
SWMM_ENGINE_API int swmm_pollutant_get_units(SWMM_Engine engine, int idx, int *units)
Get the concentration units code for a pollutant.
Definition openswmm_pollutants_impl.cpp:104
SWMM_ENGINE_API int swmm_pollutant_add(SWMM_Engine engine, const char *id, int units)
Add a new pollutant to the model.
Definition openswmm_pollutants_impl.cpp:43
SWMM_ENGINE_API int swmm_link_set_quality(SWMM_Engine engine, int link_idx, int pollut_idx, double conc)
Set the pollutant concentration in a link (runtime override).
Definition openswmm_pollutants_impl.cpp:228
SWMM_ENGINE_API int swmm_pollutant_set_init_conc(SWMM_Engine engine, int idx, double conc)
Set the initial concentration throughout the conveyance system.
Definition openswmm_pollutants_impl.cpp:96
SWMM_ENGINE_API int swmm_pollutant_get_rdii_conc(SWMM_Engine engine, int idx, double *conc)
Get the RDII concentration.
Definition openswmm_pollutants_impl.cpp:156
SWMM_ENGINE_API int swmm_pollutant_set_rdii_conc(SWMM_Engine engine, int idx, double conc)
Set the RDII (Rainfall-Dependent Infiltration/Inflow) concentration.
Definition openswmm_pollutants_impl.cpp:148
SWMM_ENGINE_API const char * swmm_pollutant_id(SWMM_Engine engine, int idx)
Get the string identifier of a pollutant by index.
Definition openswmm_pollutants_impl.cpp:32
SWMM_ENGINE_API int swmm_pollutant_get_init_conc(SWMM_Engine engine, int idx, double *conc)
Get the initial concentration throughout the conveyance system.
Definition openswmm_pollutants_impl.cpp:140
SWMM_ENGINE_API int swmm_pollutant_get_mwt(SWMM_Engine engine, int idx, double *mwt)
Get the molecular weight of a pollutant.
Definition openswmm_pollutants_impl.cpp:172
SWMM_ENGINE_API int swmm_pollutant_get_rain_conc(SWMM_Engine engine, int idx, double *conc)
Get the pollutant concentration in rainfall.
Definition openswmm_pollutants_impl.cpp:124
SWMM_ENGINE_API int swmm_pollutant_set_snow_only(SWMM_Engine engine, int idx, int flag)
Set whether a pollutant only builds up during snowfall events.
Definition openswmm_pollutants_impl.cpp:198
SWMM_ENGINE_API int swmm_pollutant_get_gw_conc(SWMM_Engine engine, int idx, double *conc)
Get the pollutant concentration in groundwater.
Definition openswmm_pollutants_impl.cpp:132
SWMM_ENGINE_API int swmm_pollutant_get_snow_only(SWMM_Engine engine, int idx, int *flag)
Get whether a pollutant only builds up during snowfall events.
Definition openswmm_pollutants_impl.cpp:206
SWMM_ENGINE_API int swmm_pollutant_set_rain_conc(SWMM_Engine engine, int idx, double conc)
Set the pollutant concentration in rainfall.
Definition openswmm_pollutants_impl.cpp:80
SWMM_ENGINE_API int swmm_pollutant_get_kdecay(SWMM_Engine engine, int idx, double *k)
Get the first-order decay coefficient.
Definition openswmm_pollutants_impl.cpp:116
SWMM_ENGINE_API int swmm_node_set_quality(SWMM_Engine engine, int node_idx, int pollut_idx, double conc)
Set the pollutant concentration at a node (runtime override).
Definition openswmm_pollutants_impl.cpp:218
SWMM_ENGINE_API int swmm_pollutant_get_co_pollutant(SWMM_Engine engine, int idx, int *co_idx, double *frac)
Get a co-pollutant relationship.
Definition openswmm_pollutants_impl.cpp:189