Introduction
To consider water quality simulation such as water age, constituent simulation (like chlorine) or water trace, in WaterSight it is required that the uploaded WaterGEMS model is already pre-configured with the water quality parameters and also the SCADA calculation type needs to be set to "Age, Constituent & Trace"- see article Preparing WaterGEMS model for real time simulation in WaterSight.
Below are explained the main steps to configure a constituent simulation such as chlorine.
Workflow
- 1. Open the model in WaterCAD/WaterGEMS.
- 2. Go to Analysis >> Alternatives >> Constituent >> Click on Base Constituent

- 3. Adjust the chlorine concentration assumed at the entrance points/boundary conditions. Click on the Reservoir tab and other source tabs and adjust the concentration initial values (for reservoirs, tanks, wet wells or other boundary elements).
- In order to assume a constant value /fixed rate at the entrance points, for the pattern column select Fixed and then define the concentration initial
- If you want to assume a pattern for the chlorine concentration at the entrance points, insert the concentration base and update the pattern on the pattern column.

-
- The pattern should be created under the Constituent folder and the multipliers should be defined by the user (multiplier values will be multiplied by the concentration base value defined previously to have the final value calculated).

- 4. To update the chlorine properties, go to tab “Current System Data” and select on the button (…) near the Chlorine text.

- 5. The user can adjust the diffusivity value as well as the bulk reaction rate and Wall Reaction rate (these are the decay rates). In the absence of other values, default values below can be assumed:

- 6. More information about water quality simulations can be found here:
- 7. Note: WaterCAD and WaterGEMS do not have an automatic water quality calibration tool to calibrate coefficients such as the wall decay rate, based on measured constituent residuals for example for chlorine. Consider using the observed data feature to graph observed concentration along with calculated concentration, then manually adjust parameters as needed until the results match. The base hydraulic results should be calibrated first.
- 8. Save All changes before uploading the new model into WaterSight and make sure that the solver options are correctly defined. Go to Analysis >> Options >> Base Calculation Options. Click twice.

- 9. In the Calculation Option properties grid make sure that:
a. Calculation type is SCADA Connect Simulator
b. SCADA Calculation is “Age, Constituent & Trace”
c. Simulation Mode is Historical

- 10. Once done, make sure that the model successfully computes in WaterGEMS with no errors. If there are errors the user will need to fix those before uploading the model.
- 11. Save the Hydraulic Model.
- 12. Go to WaterSight to the Admin page. Select Numerical Models. Click in the first row. In the right side panel click on Upload Model button.

- 13. Define the EPSG Code for the Hydraulic Model. Choose the WaterGEMS model (the SQlite file or a zip file containing the SQLite file) and click upload.

- 14. A progress bar will be displayed at the bottom of the page with the progress of the uploading. It may take few minutes. During that time the user can go out to other pages.
- 15. If there is an error during the upload, please look at the message that gets displayed in the notification bell (located on the top right) or at the bottom of the numerical model administration page. The message may contain some hints about the error.

- 16. After the model was uploaded, make sure to refresh WaterSight page. Then go to the real time simulation module and check if all is working fine.
See Also
How to set up water quality simulation (such as chlorine) in WaterGEMS
Constituent analysis parameters
Preparing WaterGEMS model for real time simulation in WaterSight.
OpenFlows WaterSight TechNotes and FAQ's
WaterSight Learning Resources Guide