From SysCAD Documentation
Navigation: Main Page -> Models -> Statistical Models
Introduction
This model is for Dynamic simulation only.
The General Statistics unit operation can be used to collect statistical information of a selected variable, for example level of a tank, valve opening position, pump speed, etc.
For flow statistics information, use the built-in statistics block in a Pipe or a Tank..
The General Statistics can be reset at Startup by selecting the Statistics tick box on the SysCAD Commands View | Dynamic Configuration - Scenario Tab.
Data Sections
The default sections and variable names are described in detail in the following tables. The default General Statistics access window consists of 2 sections. This number may increase or decrease, based on user configuration.
- The first section, which has the same name GenStats, contains general information relating to the unit
- The second section, Info, contains generic SysCAD information relating to this unit.
Class: GenStats - The first tab page in the access window will have this name.
|
Tag / Symbol
|
Input / Calc
|
Description/Calculated Variables / Options
|
|
Common First Data Section
|
General Settings
|
| On | Tick box | Enable or disable all of the independent General Stats Blocks.
|
| ShowCnv | Tick box |
|
| Number_of_ Stats | Input | The number of independent Statistics blocks required. This may be any number from 0 upwards. The user may also change this number at any time. However, the unit will always add new Statistics blocks after existing ones, and it will delete them starting from the last block. E.g. if you have 5 Statistics blocks set up and you change this to 4, Statistics block number 5 will be deleted. So if you do not want Statistics block number 1, use the priority field to change its display order then delete it by reducing the Number of Stats by 1.
|
|
|
| Check Tags | Button | SysCAD will perform a check on the validity of the tags used.
|
| Reset_All | Button | Resets all the data collected in the model.
|
|
|
| State | Output | The state of the Statistics block. If everything is correct and operating normally, the user will see ‘OK’ in this box. Otherwise the unit will flag an error message, which helps the user to locate the problem.
|
| MSG_1 to MSG_2 | Output | Any errors will be reported here. These messages are also displayed in the message window.
|
Individual Settings
|
| Each independent Statistics block has the following layout. If there is not enough space to display all blocks on the first tab page, a additional tab pages will be created.
|
| Cfg.[Statistics Block number]
|
| Desc | Input | Optional description of the statistics block.
|
| StatTag | Input | This is the variable where statistics information will be collected. Eg: P_1.T (dC) or TNK_1.Lvl (%) or VLV_1.Posn.Actual (%) or S004.Qi.QEl.Ni (t/s).
Note: If the tag is a time dependent variable, it MUST be recorded on a per second basis, e.g. t/s or m^3/s. If you use any other time step, i.e. t/h, tpa, the recorded totals will be incorrect.
|
| Reset_Stats | Button | Resets the Statistics information.
|
| Tm/Time | Calc | Time elapsed.
|
| Meas | Calc | The current measured value.
|
| Ttl/Total | Calc | The accumulative total value.
Total = previous total + (dT * measured value), where the measure value is in units specified in the StatTag.
Note: this is only meaningful for some variables.
|
| Ave/Average | Calc | The average value over total time. Average = total / time in seconds.
Note: If the average value appears to be out, please check the StatTag is in per second basis, otherwise the conversion factor should be taken into account by the user.
|
| TimeZero | Calc | The time where the unit has zero-flow.
|
| TimeInvalid | Calc | The time where the unit has a value which is not a number (NAN) (shown as '*').
|
| OnAve/ On_Average | Calc | The average value over (Total time – Zero Time).
|
| Min | Calc | The Minimum value collected over time.
|
| Max | Calc | The Maximum value collected over time.
|
| Priority | Input | If more than one Statistics block is used, the user may set the priority of the blocks. This changes the order of the blocks are displayed. If the user wants to delete an unwanted block, assign it with the lowest priority (thus the largest number) to move it to the last position. The delete it by change the number of blocks number to x-1.
|
Adding this Model to a Project
Insert into Configuration file
Sort either by DLL or Group.
|
|
DLL:
|
Control1.dll
|
→
|
Units/Links
|
→
|
Statistics: General
|
|
or
|
Group:
|
General
|
→
|
Units/Links
|
→
|
Statistics: General
|
See Project Configuration for more information on adding models to the configuration file.
Insert into Project
|
|
Insert Unit
|
→
|
Statistics
|
→
|
General
|
See Insert Unit for general information on inserting units.
