2. about mouse rtc user guide
Contents
1. oves 9 L gt MOUSERTC VS REAL LIFE a a 11 2 terry ree acm ee eee 13 DE E 13 PAGES TE TE EET eine 13 NAE TT EE 14 15 ALME OU a RT RNC 16 2a LOGICAL CONDITION S 17 220 CONTROL FUNCTIONS UEM I DLE 18 25 UDIN EOS BEES AECNREORRORRR 19 2 5 1 Calibration of the PID constants aee eire en RE Era Era eoo 20 2 0 CONTROLLED DEVICES os nace aAA 23 4 MOUSERICCOMPUTATIONS 26 SM MEE 26 4 USER WRITTEN CONT ROOLi ccccccccccccscccccccccccccccccccccccccccccccccccccccccccccccccccccccccccoccocccees 28 Marre Emm 28 RETEREN 32 APPENDIX THE PID 34 DHI Software DHI Software MOUSE RTC2. MOUSE RTC User Guide WATER amp ENVIRONMENT se MOUSE RTC USER GUIDE DHI Water amp Environment Agern Alle 11 DK 2970 H rsholm Denmark Tel 45 4516 9200 Fax 45 4516 9292 E mail dhi amp dhi dk Web www dhi dk and www dhisoftware com DHI Software CONTENTS PART I INTRODUCTION TO MOUSE RTC 1 ABOUT MOUSE RTEMODULE isnende aaa aia 1 1 1 KEY FEATURES AND APPLICATION DOMAIN ccccececcececcecccecccsceccsceccsceceececescececsctsescesescesescusescs 1 1 2 SOFTWARE IMPLEMENTATION ssceccecceccsceccecceccscescesceccecesceccectecescescescectecescescesescescscescecescescseacs 1 2 ABOUT MOUSE RTC USER 3 3 MOUSERTCUSER SUPPORT E a 5 31 PRODUCT SUPPORT 5 3 2 DHI TRAINING 5 32 3 COMMENTS AND SUGGESTIONS D UR PCM M 6 PEEL C0 ccc 9 1 1 RTC IN URBAN DRAINAGE AND SEWER SYSTEMS ccscescececcececcecccececcececcsceceececscscesescesescesescusescs 9 1 2 ARCHITECTURE OF SYSTEMS ever eS besos sees De es
3. GSM etc to transfer data between sensors controllers and the global controller In connection with the global controller function an RTC system is usually equipped with the data management and storage facilities databases and the user interface This is usually termed as SCADA Supervisory Control And Data Acquisition system Both local and global RTC based on sensor measurements is termed as reactive RTC The global control can be extended also to include forecast data in addition to real time data which is then called predictive RTC The most comprehensive way to obtain forecast data is to include a model in the control system Predictive control brings DHI Software Se BACKGROUND 1 3 additional benefits in relatively inert systems i e where the response time of an operational variable is long compared to the change of relevant disturbance external input or control action MOUSE RTC vs Real Life MOUSE RTC simulates reactive local and global RTC systems in urban drainage and sewer networks The software implementation is inherently a conceptualisation of real life of which the user must be fully aware Some conceptualisations applied in MOUSE RTC are listed below The program does not distinguish explicitly between local and global RTC Per default all elements of a modelled RTC system are assumed available for global control Sensors are specified as operational devices with definition of sensor type and positio
4. Measuredl SetPoint2 Measured2 SetPoint3 Measured3 StartLevel StopLevel GatePosition WeirPosition Double begin LevelA GetSensorValue Level_A Level02 GetSensorValue Level 02 112 GetSensorValue Level 12 122 GetSensorValue Level 22 Pump 2 3 SetPointl 0 6 LevelA 67 SetPumpPIDSetpoint Pump 2 3 SetPoint1 Measuredl 102 SetPumpPIDMeasurement Pump 2 3 Measured1 Weir 12 3 SetPoint2 0 6 LevelA 67 SetWeirPIDSetpoint Weir 12 3 SetPoint2 Measured2 Level12 SetWeirPIDMeasurement Weir 12 3 Measured2 Orifice 22 3 SetPoint3 0 6 LevelA 67 SetGatePIDSetpoint Orifice 22 3 SetPoint3 Measured3 Level22 SetGatePIDMeasurement Orifice 22 3 Measured3 Pump 2a 3 StartLevel LevelA 0 2 StopLevel LevelA SetPumpStartLevel Pump 2a 3 StartLevel SetPumpStopLevel Pump 2a 3 StopLevel Weir 12a 3 WeirPosition LevelA SetWeirPosition Weir 12a 3 WeirPosition Orifice 22a 3 GatePosition LevelA SetGatePosition Orifice 22a 3 GatePosition end exports TimeStep begin end documentation of the different procedures and functions can be found in the MOUSEDLL pas file DHI does not provide support in the Delphi Programming language We are howevet open to suggestions on improving and adding functionality to this 30 DHI Software USER WRITTEN CONTROL DHI Software 31 se MOUSE RTC USER GUIDE 5 RE
5. weir crest level WCL setting m Gates level of the bottom lip of the gate called WCL setting Pumps pump discharge 0 NOTE when using weir as PID regulator weir crest level WCL will not be used On the other hand the START and STOP levels for pumps will be used to start a PID controlled pump The following types of controlled variables set points are available m H water level in a node DHI Software 19 MOUSE RTC USER GUIDE 20 m Q flowin a pipe S7 NOTE Hot start does not work with set points PID parameter sets Fast Query PID 10 Help PID ID Standard Pump up up Insert Prapartianality factor 1 0 Alphal weight time n 1 0 Integration Time Ti 300 0 sec Alpha weight time n 1 1 0 Derivation Time Td 0 5 sec Alphad weight time n 2 1 0 SetName Proportional Integration Derivation Standard Pump up up 1 0 Standard Pump up dow 1 0 Standard Weir up up 1 0 Standard wer up dowr 1 0 Fig 2 6 Dialog for input of PID parameters PID ID Each set of PID parameter sets is identified with a unique ID which can be used to access the information from other dialogs Proportionality Factor Integration Time and Derivation Time These are the 3 main parameters for the PID control refer to Appendix A PID Algorithm for a detailed description Alpha 1 Alpha 2 and Alpha 3 Weighting factors
6. Capacity E Pump 2a 3 39 90 Pump Capacity Show gt Select List gt Fig 2 3 Dialog for input of pump data No Control RTC This field allows for the definition of an RTC controllable pump If a pump is specified as an RTC device several additional parameters must be specified for the description of its operational properties Min time Pump OFF The minimum time the pump has to be OFF before it can start again Min time Pump ON The minimum time the pump has to be ON before it can stop DHI Software 15 se MOUSE RTC USER GUIDE 2 2 Max Start Level The maximum START level for the pump If exceeded the pump is unconditionally switched ON Min Stop Level The minimum STOP level for the pump If a lower level occurs the pump is unconditionally switched OFF Acceleration time The time used to accelerate the pump from a standstill to the maximum capacity derived from the capacity curve This acceleration can never be exceeded in any part of the simulation Deceleration time The time used to stop the pump from running with the maximum capacity This deceleration can never be exceeded in any part of the simulation Acceleration Curve for PID control only For PID controls the acceleration of the pump can be specified as dependent on the actual flow The acceleration curve is specified in tabular data and referred to by the ID of the data set Sensors A sensor is a physical device positioned som
7. relation between the control variable and the regulator setting which controls the system response indirectly This is much simpler than PID control but in turn the control results are in many cases inherently inexact and only a rough flow control can be achieved This type of control is most suitable for regulators of the ON OFF or OPEN CLOSE type while the application to continuously controllable regulators should be carefully considered If the operational strategy is based on conditions local to the regulated device for example the ON OFF control of a pump based on the water level in a wet well it is called local control A PLC receives signals measurements from local sensors and sends the control decisions actuation signals to the regulators The usual situation for a sewer system is to have a number of local controllers associated with pumps Although in strict terms this is an RTC system it is usually not understood as such If the operational logic is based on global conditions it is then called global control In such a situation a global controller is required A global controller is a computer program that makes the overall system state analysis in real time and provides additional input to the local controllers which overrides or supplements the local logic with e g actuator signals ot by modified set point values Additional component needed is then a data transmission system UHF radio leased or dialled telephone lines
8. the selection of an appropriate control function A control function establishes a relation between a control variable and a controlled variable A controlled variable can be a regulator setting e g gate position pump START STOP level or some of the flow variables e g water level flow In the latter case the control decisions are derived by evaluating comparing the current value of the controlled flow variable and the pre defined set point value The control algorithm is based on the numerical solution of the continuous control problem equation and is usually termed as PID Proportional Integral Differential control The actuation signal for the regulator is generated by a PID controller which usually appears as part of the operational strategy programmed in a Programmable Logical Controller PLC Selection of a controlled variable is however subject to limits set by the variable s controllability Therefore a controlled variable is usually selected among the flow variables flow water level preferably in the vicinity of the regulator As a controlled variable becomes more distant from the regulator it becomes more difficult to control due to time lags diffusion and uncontrollable interference Control of relatively distant controlled variables is difficult and often cannot give satisfactory results When a regulator setting is used as a controlled variable the control algorithm is reduced to an explicit functional
9. upgrade scheme also involving significant civil upgrading works to increase the transport treatment or assimilative capacity of the urban wastewater system In such circumstances the role of R TC is to optimise the operation of both the new and the existing facilities thereby maximising the benefit in performance terms Where the overall objective is to achieve compliance with specified performance targets RTC serves to minimise the scale and extent of the necessary works Architecture of RTC Systems An RTC system includes monitors sensors which generate measurement values characterising states of the system To be useful for RTC the measurements must be available with the relatively insignificant time lag delay The sensors must be accurate and reliable The active control is performed by regulators controllable movable devices weirs gates and valves and pumps Regulators may take various forms and sizes and the regulation may be continuous within the functional range step wise or discontinuous e g ON OFF OPEN CLOSED The regulators may be powered mechanically hydraulically or pneumatically Controllers on the basis of a pre programmed operational strategy determine the regulator movements the control actions The operational strategy may consist of two parts the DHI Software 9 10 se MOUSE RTC USER GUIDE control function s and if more control functions are specified the control logic rules responsible for
10. FERENCES DHI 2000 MOUSE Short Introduction and Tutorial Version 2000 DHI H rsholm Denmark 2 DHI 2000 MOUSE User Guide Version 2000 DHI H rsholm Denmark 32 DHI Software REFERENCES DHI Software 33 lt lt gt lt MOUSE USER GUIDE APPENDIX THE PID ALGORITHM 34 DHI Software APPENDIX THE PID ALGORITHM DHI Software 35 APPENDIX THE PID ALGORITHM se At each simulation time step the set point is evaluated against the actual value of the control variable flow or water level depending on the set point type The actual WCL Qpuny is determined from the following equation 1 z u K e edt T 1 D dt where 7 the output signal WCL ot Q e the error to be minimised K the proportionality factor the derivation time T the integration time For numerical solution a discrete form of this equation is required By use of the Laplace transformation one obtains I us Kr erus 2 sS where U s the Laplace transform of E s the Laplace transform of e By use of the backward Euler transformation je 3 where T is the sampling period one obtains the following discrete representation of the PID equation 4 Za m y 1 S y 1 yn 1 CELLS 15 2T 4 S aK 14 O 2 y n 2 S t u n 1 36 DHI Software SS APPENDIX THE PID ALGORITHM where u v
11. MOUSE RTC User Manual Basic information about MOUSE RTC principles and techniques and extensive reference on using MOUSE RTC for modelling RTC schemes APPENDIX A The PID Algorithm A theoretical background and numerical implementation of the continuous control equation DHI Software 3 MOUSE RTC USER GUIDE 4 DHI Software SS MOUSE RTC USER SUPPORT 3 3 1 3 2 MOUSE RTC USER SUPPORT Product Support If you have questions or problems concerning MOUSE RTC please consult the documentation Installation and Update Guide and MOUSE RTC User Guide first Secondly look in the README files that came with your installation If you have access to the Internet you may also have a look under Frequently Asked Questions or Problems amp Work arounds on the MOUSE Home Page The MOUSE Home Page is located at http www dhisoftware com mouse If you cannot find the answers to your queries please contact your local agent In countries where no local agent is present you may contact DHI directly by mail phone fax or e mail DHI Water amp Environment Agern All 11 DK 2970 H rsholm Denmark Phone 45 45 169 200 Telefax 45 45 169 292 e mail software dhi dk When you contact your local agent or DHI you should prepare the following information m The version number of MOUSE that you are using m The type of hardware you using including available memory m The exact wording of any me
12. USER GUIDE Copyright This document refers to proprietary computer software which is protected by copyright All rights are reserved Copying or other reproduction of this manual or the related programs is prohibited without prior written consent of DHI Water amp Environment DHD Warranty The warranty given by DHI is limited as specified in your Software License Agreement The following should be noted Because programs are inherently complex and may not be completely free of errors you are advised to validate your work When using the programs you acknowledge that DHI has taken every care in the design of them DHI shall not be responsible for any damages arising out of the use and application of the programs and you shall satisfy yourself that the programs provide satisfactory solutions by testing out sufficient examples DHI Water amp Environment is a private non profit research and consulting organization providing a broad spectrum of services and technology in offshore coastal port river water resources urban drainage and environmental engineering DHI Software MOUSE RTC USER GUIDE 2 DHI Software PART I INTRODUCTION TO MOUSE RTC DHI Software MOUSE RTC USER GUIDE DHI Software 1 SS ABOUT MOUSE RTC MODULE 1 1 1 1 2 ABOUT MOUSE RTC MODULE Key Features and Application Domain The MOUSE module features advanced Real Time Control simulation capabilities for urban drainag
13. alue of the control variable i e WCL ot K the factor of proportionality I the integration time Ta the derivation time T sampling period i e simulation time step Jf the set point for the regulated variable 01 0 factors for weighing each time step index n 1 and n 2 actual value of the regulated variable Indexes 7 n 7 and n 2 denote the current the previous the second previous time step respectively The weight factors Qt 03 have been added to the PID algorithm in order to give the user more ways of stabilising the algorithm in case of instability problems DHI Software 37
14. b small Set point 7 N 9 anst Too large Good Fig 2 8 Fluctuations around the set point depending on the size of the derivation time Tp DHI Software DATA INPUT 2 6 Set point Good g gt large Fig 2 9 Fluctuations around the set point depending the size of the integration time Controlled Devices In this dialog the operational control logic for controllable devices is specified The control is specified as a set of rules linking the logical indirectly conditions and the control functions The rules are evaluated sequentially following the rules list sequence Evaluation of a logical condition belonging to a rule as TRUE leads to the selection of the specified control function On the contrary if a logical conditions is FALSE the evaluation proceeds to the next rule on the list Controlled Devices E Fast Query Device ID Control Device Type Pump Device ID Pump 2 3 El Insert Control Type Setpoint PID PID ID Standard Pump up down THEN Blocking PumpControlPID No DeviceType ContolType DevicelD Pump Setpoint PID Pump 2 3 Standard Pump up down 2 Weir Setpoint PID Weir 12 3 Standard Weir up up MI 3 Gate in orifice Setpoint PID Orifice 22 3 Standard Gate up down Show gt 4 P Direct Setti P 2a 3 s ix eang ne z Se
15. ctly or by a PID control If a direct control is used the function specifies information of START and STOP levels for pumps or of the wanted position for gates or weirs If a PID control is applied the function specifies a set point flow or level anywhere in the system Setpoint Sensor For functions of PID type it must be specified where in the system the set point is located For this purpose a Sensor ID must be specified Input Type and Input Sensor The type and identification of the parameter which should be evaluated Depending on the type it might be necessary with two sensor IDs e g if the flow 15 regulated as a function of the difference between two level sensor values If the Constant type is selected a constant value is specified instead of the sensor s and the functional relation Input and Output Values The functional relation between the actual input value sensor reading or a combination of two sensors and the set point value or setting The tabulated values are linearly interpolated PID parameter sets MOUSE RTC includes the possibilities for PID control of weirs gates and pumps Independently on the choice of the controlled variable the PID algorithm adjusts the settings of the regulator or outputs in case of pumps according to the current error between the specified set point and the actual value of the controlled variable The following settings outputs can be used as means of flow control m Weits
16. dDwn fi 000 m s MinLevel 38 00 m rifice 22 3 22 Node 3 Rectangular 38 00 rifice 22a 3 Node 224 Node 3 Rectangular 38 00 Show gt Select List gt Fig 2 2 Dialog for input of Orifice gate data No Control RTC This field allows for the definition of a controllable underflow gate If a rectangular orifice is specified as an RTC device several additional parameters must be specified for the description of the gate The gate covers the upper part of the orifice opening with a horizontal lower edge blade Max Speed Up The maximum velocity for movement of the gate in upward direction Max Speed Down The maximum velocity for movement of the gate in downward direction 14 DHI Software DATA INPUT Max Level The maximum elevation of the movable gate Min Level The minimum elevation of the movable gate 2 1 3 Pumps ELTE isi xl Fast Query _ EE MCI ECC Pump ID Location Pump to Help Pump ID Pump 2 3 Offset 0 00 m Insert Location Node 02 Start 40 10 m Pump to Node 3 Stop 39 90 m Capacity Curve Pump Capacity A Pump type Screw E Min Time Pump Off 0 min Min Time Pump On 0 min Start Level 50 00 m Min Stop Level 38 00 m Acc Time 50 sec Dec Time 50 sec Acceleration Curve only used for PID control Pump acceleration Es No PumplD StartLevel Stoplevel Cure Pump 2 3 39 90 Pump
17. e and sewer systems It permits description of various controllable devices and makes the definition of complex operational logic for interdependent regulators fully transparent and time efficient The following controllable devices can be specified m Rectangular overflow weit Rectangular underflow gate m Pump The devices may be specified as settings or PID controlled with control function selection based on a global system analysis Each regulator or pump operates under the control logic encapsulated into a set of simple logical rules and control functions The system allows a schematised definition of any form and size of decision tree featuring logical operators AND OR NOT and NOR in any associate combination The process of selecting an appropriate control function under the current operational situations relies on the evaluation of system state conditions including measurable and derived hydraulic and WQ variables e g water level flow pollutant concentration level difference devices statuses e g gate blade position pump ON OFF and the current control function The control functions range from the simplest constants for the operational variables e g constant weir crest setting constant flow set point to dynamic controlled variables set in a continuous functional relation with any of the measurable variables in the system e g CSO discharge set point as a function of flow concentration or a pump START STOP le
18. ewhere in the system which provides information of the actual value of a monitored variable A sensor can only monitor one variable if more variables are measured at the same locality a corresponding number of sensors has to be described Sensor FEE Fast Query Nooo Sensor ID Type Ose Help Sensor ID Leve Insert Level Location Type Node Location Node Bl SensorID Location Type Location Level Level Node Made Level 02 Level Node Node 02 Level 12 Level Made Made 12 Level 22 Level Node Node 22 Time Since Start Time Since Sim System Show gt Select List gt 16 DHI Software Se DATA INPUT 2 3 Fig 2 4 Dialog for input of sensor data Sensor ID Each sensor needs a unique ID which can be used to access the sensor information from other dialogs Type The type of the sensor defines which variable the sensor measures Location Type and Location Depending on the sensor type there could be one or more location types Accordingly the actual location can be specified be selecting from the comprehensive list Component For the Concentration sensor type a measured WQ component must be specified Logical Conditions A logical condition stands as a frame which demarcates the boundaries of a certain operational situation in the controlled system This frame consists of up to four independent logical tests on the va
19. for time level n n 1 and n 2 2 5 1 Calibration of the PID constants Tuning of the PID constants Ti Td and Kd is not a straightforward task Understanding of the theoretical background and the numerical solution of the control equation would be beneficial in this process refer to Appendix A PID Algorithm The following may be used as an elementary guideline DHI Software DATA INPUT Typical values of the PID constants and weighting factors T CE 300 sec Pumps and gates setpoint downstream setpoint upstream Weirs setpoint downstream setpoint upstream Gates and weirs Pumps 0 8 sec 1 0 1 0 1 0 1 0 1 0 0 7 1 0 1 0 SS NOTE The sign on the K factor is very important if it is wrong it will cause the control function not to work at all since the device will typically move to one of the extreme positions and stay there till the end of the simulation Figures 2 7 through 2 9 show examples of how the actual variable flow or water level can fluctuate around the set point as consequence of various choices of the PID constants Each figure has three different graphs depending on whether the constant is too high too low or adequate DHI Software 21 22 MOUSE RTC USER GUIDE K ji 9p large PD 6 9 Too small Fig 2 7 Fluctuations around the set point depending on the size of the proportionality factor K I
20. illed for the test to be evaluated as TRUE In cases with the tested continuous variables it consists of an algebraic operator lt or gt and a limit value In cases of logical evaluation e g pump ON OFF the test is defined simply by setting the desired device state as TRUE or FALSE Control Functions A control function is a functional relation between input from one or two sensors and the set point or the setting for the controlled device Control Functions Function ID Fast BUT Close PumpControlPID Function ID Help ooo FunetoniD 1 Device type Pump Inset PumpContolF ID Function type PID control of level w eirControlPID GateControlPID Setpoint Sensor Level 02 ES L PumpControlDirect Input type Sensor Value weirControlDirect eda Level m GateControlDirect EJ Input Value Setpoint Value Fig 2 5 Dialog for input of control functions Function ID Each control function needs a unique ID which can be used to access the functions from other dialogs 18 DHI Software Se DATA INPUT 2 9 For each of the functions the following should be specified Device Type and Function Type These two fields hold the information about the applicability of the function device type and which type of control it describes The devices which can be controlled are pumps weirs and gates and each of these types can be controlled dire
21. lect List gt Fig 2 10 Dialog for input of Controlled devices DHI Software 23 24 se MOUSE RTC USER GUIDE Device Type and Device ID Device Type and ID identifies the device which should be controlled The actual description of the device should be made in relevant menu for pumps weits or orifices Control Type and PID ID The control type can be either direct setting PID control of set point or no control If PID control is used set of PID parameters should be selected by the PID ID Control rules Any number of rules can be specified to control the device The statements are evaluated sequentially starting from the top This means that appropriate sequence of rules is essential for the achievement of the desired control logic If no logical condition is specified the rule is unconditionally evaluated as TRUE This implies that the last rule in the sequence must not include any logical conditions in order to ensure a selection of a default control function if all specified conditions are found FALSE When specifying the rules a few constraints should be notified All control functions used to control a specific device must be of the same function type corresponding to the specified Device Type and Control For PID control all control functions must refer to the same set point sensor change of the set point sensor during simulation 15 not allowed For time dependent control Input sen
22. n in the MOUSE network Sensors with multiple functionality must be specified individually When devices weirs gates and pumps are specified as controllable in the MOUSE interface a number of additional physical parameters about the behaviour of the structure is required to describe e g the allowed change rates for the state of the structure The actual controllers are not specified explicitly as physical devices but their function i e operational logic as a combination of operational conditions and control functions is associated with the respective devices MOUSE RTC uses sampling and actuation control loop frequency identical to the simulation time step Sensor readings are simulated as perfectly accurate and with 100 availability Low level logic of the pump START STOP operation is built into the program and is controlled by the START and STOP levels The PID control algorithm is built into the program and is controlled by the PID constants and by factors for weighting the terms of the numerical solution of the control equation DHI Software 11 MOUSE RTC USER GUIDE 12 DHI Software DATA INPUT 2 DATA INPUT 2 1 Devices Basic data for controllable devices Weirs Gates and Pumps are specified in the standard data dialogs for the actual devices with the selected as the operational mode 2 1 1 Weirs Weis FE Fast Query Wer ID Loca
23. re appreciate any suggestion in that respect hoping that future edition will contribute to the improved overall quality of MOUSE Please submit your contribution via e mail fax or letter 6 DHI Software MOUSE RTC USER SUPPORT PART Il MOUSE RTC USER GUIDE DHI Software MOUSE RTC USER GUIDE DHI Software 1 1 1 2 BACKGROUND lt A BACKGROUND RTC in Urban Drainage and Sewer Systems Real time control RTC is an active control and operation of flow regulators based on real time information about the system state R TC is feasible where it proves that flexible redistribution of water in space and time contributes to the fulfilment of the specified operational objectives based on economically and technically sound solutions Accordingly application of RTC to urban drainage and sewer systems may be relevant m where the system has substantial transport storage or treatment capacity which is not effectively used under passive system operation m where typical rainfall patterns over the catchment area exhibit high degrees of spatial variability resulting in some parts of the system becoming overloaded whilst others are under utilised m where the urban wastewater system includes treatment processes whose performance is amenable to active short term control m where the assimilative capacity of the receiving waters is variable over time Usually RTC is implemented as an integral part of a rehabilitation
24. rious operational variables where the relation of the actual value or state of the variable provided by a sensor is tested against the specified threshold limit value or state The individual tests are evaluated as TRUE or FALSE with the outcome depending on the actual variable value or state the threshold and the specified operator A logical condition is evaluated as TRUE only if all of its constitutive tests are evaluated as TRUE If only one of the tests is FALSE the logical condition is rejected Logical Conditions oe x Fast Query Condition ID ose Help Condition ID High level at Insert Type ID Operand Limit Sensor Value m Lever Eg gt m 42 00 Im kNone gt lt None gt E Condition ID E High level at Fig 2 5 Dialog for input of logical conditions DHI Software 17 se MOUSE RTC USER GUIDE 2 4 Condition ID Each Logical Condition needs a unique ID which can be used to access the logical condition information from from other dialogs For each of the tests included in a logical condition the following should be specified Type and ID The type and identification of the variable which should be evaluated Depending on the type it might be necessary with two IDs e g for the evaluation of difference between two sensor values Operator and Limit This part of a test defines the condition which must be fulf
25. sor of type Time since start of simulation only ONE rule can be specified The menu allows more functions to be inserted but only the first one will be used during the simulation When starting a simulation the system checks if these conditions are fulfilled and in the case of any violation the simulation will not start DHI Software DATA INPUT DHI Software 25 MOUSE RTC USER GUIDE 3 MOUSE HTC COMPUTATIONS 3 1 General A MOUSE computation is started from the usual Pipe Flow Computation dialog and will be performed if the checkbox Real Time Controls is marked Pipe Flow Computation PES fond foo Foro Figure 3 1 Pipe Flow computation dialog with Real Time Control 26 DHI Software MOUSE RTC COMPUTATIONS DHI Software 27 se MOUSE RTC USER GUIDE 4 USER WRITTEN CONTROL 4 1 General MOUSE 2002 and newer versions support User Written Control UWC for advanced RTC control of the system This gives the user the possibility of controlling almost all aspects of MOUSE each time step and thereby implementing advanced control strategies in the system UWC is only recommended for the advanced computer user since it involves programming experience The currently supported language is Delphi the procedures and functions can however be called from any programming language including Visual Basic and others that support generating DLLs The user can execute code at 3 different
26. ssages that appeared on the screen m A description of what happened and what you were doing when the problem occurred m description of how you tried to solve the problem DHI Training Courses DHI software is often used to solve complex and complicated problems which requires a good perception of modelling techniques and the capabilities of the software Therefore DHI provides training courses in the use of our products A list of standard courses is offered to our clients ranging from introduction courses to courses for more advanced users The courses are advertised via DHI Software News and via DHI home page on the Internet http www dhi dk DHI can adapt training courses to very specific subjects and personal wishes DHI can also assist you in your effort to build models applying the MOUSE software If you have any questions regarding DHI training courses do not hesitate to contact us DHI Software 5 lt lt gt lt MOUSE USER GUIDE 3 3 Comments and Suggestions Success in perception of the information presented in this document together with the user s general knowledge of urban sewer systems R TC technology and experience in numerical modelling is essential for getting a maximum benefit from MOUSE RTC This implies that the quality of the documentation in terms of presentation style completeness and scientific competence constitutes an important aspect of the software product quality DHI will therefo
27. steps in the code The Initialization step is for executing code opening preparing or reading files needed in the simulation The Time step is the step in which the control strategies are run The End step is the step in which files opened in the Initialization step can be closed The 3 steps are defined under the mouse604 exe Simulation Options dialog where a filename and a procedure name are specified for each step under UWC The compiled DLL with the UWC must be located in the same folder as the mouse_hd dll file There are currently over 140 different procedures and functions exported from MOUSE ranging from setting PID constants runtime to retrieving the flow in a specific grid point in a link Using the methods require the user to include the MOUSEDLL pas file into the DLL Delphi project An example of the use of this is listed below library Test uses SysUtils Classes MOUSEDLL lt Important SR res var OutFile TextFile procedure InitStep begin AssignFile OutFile C MMOUSEOutput txt Rewrite OutFile end procedure TimeStep var NodeLevelString String MOUSETimestring String begin NodeLevelString Floattostr GetNodeLevel Node 11 MOUSETimeString FormatDateTime YYYY MM DD hh mm ss MOUSETime Writeln OutFile NodeLevelString MOUSETimeString end procedure EndStep 28 DHI Software USER WRITTEN CONTROL begin CloseFile OutFile end exports InitStep TimeS
28. tep EndStep end Options _ a x Sien Mode Sim Active UC Initialization DLL CAMOUSE 2001 est dl zi UWE Initialization Procedure InitStep UWE Timestep OLL CAMOUSE 2001 sBins T est m UWL Timestep Procedure TimeStep UWE Endstep DLL CAMOUSE2001 sBins T est dll xd UC Endstep Procedure EndStep 5 DIMS Output Active Connection String DIHS ASF File DIIS Data Pretts The example above simply writes water level in a node and corresponding time to a file but the possibilities are endless The next example is the RT CExample provided in the installation where the actual control is handled from UWC The RTC control in the UND file is not changed for this which means the UWC RTC overrides the RTC in the UND This provides a way of overriding standard RTC in e g emergency situations in the network Alternatively the UWC RTC can be used alone In this case the Control Functions and Logical Conditions are not needed for the Controlled Devices since the actual control is handled externally In addition to this the control type number for the 3 PID controlled devices is changed to 5 This change is done using a text editor library RTCExample DHI Software 29 Se uses SysUtils Classes MOUSEDLL SR res procedure TimeStep MOUSE RTC USER GUIDE var LevelA Level02 Level12 Level22 SetPointl
29. tion Flow Help Weir ID fweir 1 23 Insert Location ode 12 Bl Flow To Node 3 Es Method wei Farmula E Coefficient fi 00 Sharp crested Crest Level 40 00 m Degrees o Crest Width 11 00 m Speed Up 1 000 m s Max Speed Dwn 1 000 m s Max Level 50 00 m Min Level 38 00 m Node 12 Node 3 40 00 V eir Formula ENS Mode 12 amp Node 3 40 00 Weir Formula Show Figure 2 1 Dialog for input of Weir data No Control RTC This field allows for the selection of the weir type i e if the weir is controllable or not If the weir is specified as an RTC weir a number of additional parameters must be specified Max Speed Up The maximum velocity for movement of the weir in upward direction DHI Software 13 MOUSE RTC USER GUIDE Max Speed Down The maximum velocity for movement of the weir in downward direction Max Level The maximum elevation of the movable weit crest Min Level The minimum elevation of the movable weir crest E Note The fixed weir crest level is NOT used for RTC weir 2 1 2 Orifices Orifices Gates lel Fast Query Cl From To Type Help Orifice ID Dice 223 Type Rectangular Insert From Node 2200 O To af Width i00 Height e00 Invert Level 38 00 m MaxSpeedUp fi 000 m s MaxLevel 50 00 MaxSpee
30. vels as functions of water level at strategic location in the system Software Implementation MOUSE is an add on module to MOUSE HD Pipe Flow Model The MOUSE RTC capabilities can be accessed only after the MOUSE license has been extended to include MOUSE R IC For details about the DHI copy protection system and the license update procedure please refer to the MOUSE Installation and Update Guide MOUSE utilizes the standard MOUSE Windows interface with on line HELP facility which has been extended to accommodate actions related to MOUSE This implies that the MOUSE on line HELP system and documentation related to the standard versions of MOUSE are essential as support for working with this model ref 1 and 2 DHI Software 1 MOUSE RTC USER GUIDE 2 DHI Software SS ABOUT MOUSE RTC USER GUIDE 2 ABOUT MOUSE RTC USER GUIDE This manual provides information related to the principles and techniques for modelling Real Time Control RTC schemes in urban drainage and sewer systems The document contains a comprehensive reference on the MOUSE s RTC capabilities allowing users to design model and simulate various RTC schemes within their MOUSE system Usage of MOUSE and its other add on modules is described in respective user manuals amp tutorials This manual is divided into three units m Part I Introduction General information about MOUSE RTC and about this document Part II
Download Pdf Manuals
Related Search