Dynamic Configuration
From SysCAD Documentation
Navigation: User Guide -> Menu Commands -> View Commands -> Dynamic Configuration
Related Links: Dynamic Setup
This page is valid for SysCAD 9.2. Refer to Dynamic Configuration for SysCAD 9.1.
Contents |
Introduction
This command will only be available in a Dynamic project.
This page can be accessed via the View Command or by right clicking on the Graphics Window background.
This Opens the $DYN Access Window. The Dyn tab page lists the configuration options as per the Dynamic Setup command.
Some extra fields not covered by the Dynamic Setup dialogs are listed here. Note: this list is not complete.
FS_Dyn Tab Page
| Executive | ||
| Time.Fmt | FeedBack | |
| Time | FeedBack | |
| StepSize | Input | |
| StepCount | FeedBack | Displays the number of steps the simulation has taken. |
| RealTimeOn | Tickbox | |
| RealTimeMultiplier | Input | |
| TimeRec... | ||
| mSecs | FeedBack | Displays the current time - "Milliseconds" segment |
| Secs | FeedBack | Displays the current time - "Seconds" segment |
| Mins | FeedBack | Displays the current time - "Minutes" segment |
| Hours | FeedBack | Displays the current time - "Hours" segment |
| Days | FeedBack | Displays the current time - "Days" segment |
| DateRec... | ||
| Day | FeedBack | Displays the current simulation date - "Day" Segment. For example, if the current date is 28-05-2007, it will display 28 here. |
| Month | FeedBack | Displays the current simulation date - "Month" Segment. For example, if the current date is 28-05-2007, it will display 5 here. |
| Year | FeedBack | Displays the current simulation date - "Year" Segment. For example, if the current date is 28-05-2007, it will display 2007 here. |
| DayOfWeek(1=Sunday) | FeedBack | Displays the current date as in Day of the week. For example, if the current date is 28-05-2007, which is a Monday, it will display 2 here. |
| DayOfWeekDesc | FeedBack | Displays the current date as in Day of the week. For example, if the current date is 28-05-2007, it will display Monday here. |
| DayOfYear | FeedBack | Displays the current simulation's date as number of days in the year. |
| MonthDesc | FeedBack | Displays the current date in terms of month. For example, if the current date is 28-05-2007, it will display May here. |
| DaysInMonth | FeedBack | Displays the number of days in the current month. For example, if the current date is 28-05-2007, it will display 31 here. |
| DaysInYear | FeedBack | Displays the number of days in the current Year. For example, if the current date is 28-05-2007, 365. |
| NextDateRec... (The following variables are very useful to use in the Archiver Report for Trigger tests. Also useful in PGM files to overcome the one iteration behind problem.) | ||
| Day | FeedBack | Displays the simulation date for the next iteration - "Day" Segment. For example, if the date for the next iteration is 29-05-2007, it will display 29 here. |
| Month | FeedBack | Displays the simulation date for the next iteration - "Month" Segment. For example, if the date for the next iteration is 29-05-2007, it will display 5 here. |
| Year | FeedBack | Displays the simulation date for the next iteration - "Year" Segment. For example, if the date for the next iteration is 29-05-2007, it will display 2007 here. |
| DayOfWeek(1=Sunday) | FeedBack | Displays the simulation date for the next iteration as in Day of the week. For example, if the date for the next iteration is 29-05-2007, which is a Tuesday, it will display 3 here. |
Scenario Tab Page
| Specification | ||
| Type | List | Manual - User manually press the Stop button to end the dynamic simulation run. |
| Duration - User specifies a duration and SysCAD will stop the simulation when the duration period is reached. | ||
| StopTime- User specifies a Stop time and SysCAD will stop the simulation when the time counter has been reached. | ||
| Steps - User specifies the required number of steps and and SysCAD will stop the simulation when the step count is reached. | ||
| SteadyState | ||
| DurationRqd.Fmt | Input/FeedBack | Visible with Type set to Duration. User can set the duration in a time format: Day:Hour:Minute:Seconds. For example: duration of 2 days and 1 hour can be set as: 2:01:00:00. Note that if this field is changed, after pressing the OK button the DurationRqd field is adjusted accordingly. |
| DurationRqd | Input/FeedBack | Visible with Type set to Duration. User can set the duration in terms of a time engineering unit. For example: duration of 2 days and 1 hour can be set as: 2.04 d OR 49 h. Note that if this field is changed, after pressing the OK button the DurationRqd.Fmt field is adjusted accordingly. |
| StopTimeRqd.Fmt | Input/FeedBack | Visible with Type set to StopTime. User can set the stop time in a time format: Day:Hour:Minute:Seconds. This works in conjunction with the Start Time, which can be found under Scenario.Start. For Example, if StopTimeRqd.Fmt is set at 0:00:20:00, and StartAt.Fmt is set at 0:00:10:00 with SetTime Ticked, the simulation will only run for 10 minutes and it will stop. Note that if this field is changed, after pressing the OK button the StopTimeRqd field is adjusted accordingly. |
| StopTimeRqd | Input/FeedBack | Visible with Type set to StopTime. User can set the stop time in terms of a time engineering unit. This works in conjunction with the Start Time, which can be found under Scenario.Start. For Example, if StopTimeRqd is set at 1200s, and StartAt is set at 600s with SetTime Ticked, the simulation will only run for 600s and it will stop. Note that if this field is changed, after pressing the OK button the StopTimeRqd.Fmt field is adjusted accordingly. |
| StepCountRqd | Input | Visible with Type set to Steps. |
| ScnState | FeedBack | Displays the state of the scenario run. |
| StopTime.Fmt | FeedBack | Displays the StopTime in a time format. |
| StopTime | FeedBack | Displays the StopTime. |
| ScnTime.Fmt | FeedBack | Displays the current simulation time in a time format. |
| ScnTime | FeedBack | Displays the current scenario time. |
| ScnTimeEnd.Fmt | FeedBack | Displays the Scenario Ending time in a time format. |
| ScnTimeEnd | FeedBack | Displays the Scenario Ending time |
| Solver Start Behaviour | ||
| IfManualScn | List | This field is only visible if Type is set to Manual. |
| Continue - If the simulation is manually stopped before scenario is completed, it will display the Busy status. Selecting Continue here will allow the simulation to continue with the scenario when Start Run command is executed again. | ||
| Restart - If the simulation is manually stopped before scenario is completed, it will display the Busy status. Selecting Restart here will allow the scenario run to begin afresh when Start Run command is executed again. | ||
| IfScnBusy | List | This field is visible if Type is set to Duration, StopTime, Steps or SteadyState. |
| Continue - If the simulation is manually stopped before scenario is completed, it will display the Busy status. Selecting Continue here will allow the simulation to continue with the scenario when Start Run command is executed again. | ||
| Restart - If the simulation is manually stopped before scenario is completed, it will display the Busy status. Selecting Restart here will allow the scenario run to begin afresh when Start Run command is executed again. | ||
| IfScnComplete | List | This field is visible if Type is set to Duration, StopTime, Steps or SteadyState. |
| Ignore - If the simulation scenario has been completed, SysCAD will ignore the run command. | ||
| Restart - SysCAD will restart the scenario. | ||
| Elapsed Time & Progress | ||
| Progress | FeedBack | Displays the simulation progress as a percentage of completion. |
| Elapsed.Time | FeedBack | Displays the current elapsed time. |
| Elapsed.EstToGo | FeedBack | Displays the estimated time till completion of the scenario. |
| Elapsed.EstTotal | FeedBack | Displays the estimated total time required to complete the scenario run. |
| Elapsed.Steps | FeedBack | Displays the current elapsed simulation steps taken. |
| Scenario.Start... | ||
| SetTime | Tickbox | Selecting this option will set the Start time specified in the following fields. |
| StartAt.Fmt | Input/Feedback | Allows the user to set a starting time in the format of Day:hour:Minute:seconds. This field will be used to determine the scenario run time if the StopTime Type has been selected. Note that if this field is changed, after pressing the OK button the StartAt field is adjusted accordingly. |
| StartAt | Input/Feedback | Allows the user to set a starting time. This field will be used to determine the scenario run time if the StopTime Type has been selected. Note that if this field is changed, after pressing the OK button the StartAt.Fmt field is adjusted accordingly. |
| RestartHistorian | TickBox | Selecting this will Restart the Historian when scenario is started. |
| SetHistorianTagList | TickBox | Selecting this will Set the Historian Tag List if used when scenario is started. |
| RestartArchive | TickBox | Selecting this will Restart the Archiver if used when scenario is started. |
| Startup Reset Actions (These may also be set from Project - Dynamic Setup - Start Options or Action Commands in the Plant Model Access window) | ||
| Process | TickBox | This will empty all pipes and flow values when the run begins. |
| Control | TickBox | This will reset all controllers back to 'Base' state, i.e. the same state as when the controller is first inserted into the project. This is mainly relevant for PID controllers. |
| Statistics | TickBox | Selecting this will Reset the Statistical blocks when scenario is started. |
| Events Profiles | TickBox | This will reset all Event and Profiles back to start time. |
| Empty | TickBox | This Empties all containers with surge, e.g. Tanks. |
| Preset | TickBox | This resets all tanks that have the 'Preset.On' button ticked and have Preset data. |
| Scenario.End... | ||
| Action | List | Stop - SysCAD will be stopped when scenario is completed. |
| Idle - SysCAD will be placed in idle position when scenario is completed. | ||
Cmds Tab Page
| Scenario | ||
| Reset Scenario | Button | This button resets the Scenario Run. The user can also set this command in a PGM, Event file or from Excel. |
| SetTime | Button | |
| RestartHistorian | Button | This button resets the Historian data. The user can also set this command in a PGM, Event file or from Excel. |
| The following commands can be executed at any time during a run. If the user wants to automatically set any of these actions at the start of every run, then see Scenario Tab Page and Project - Dynamic Setup - Start Options. | ||
| Complete | Button | This button will reset all units in the Model, i.e it will empty all surge units, all pipes, reset controllers, etc. The user can also set this command in a PGM, Event file or from Excel. |
| Process | Button | This button will empty all pipes and flow values. The user can also set this command in a PGM, Event file or from Excel. |
| Control | Button | This button will reset all controllers back to 'Base' state, i.e. the same state as when the controller is first inserted into the project. This is mainly relevant for PID controllers. The user can also set this command in a PGM, Event file or from Excel. |
| Statistics | Button | This button will reset all statistics values back to zero. The user can also set this command in a PGM, Event file or from Excel. |
| Events Profiles | Button | This button will reset all Event and Profiles back to start time. The user can also set this command in a PGM, Event file or from Excel. |
| Empty | Button | This button Empties all containers with surge, e.g. Tanks. The user can also set this command in a PGM, Event file or from Excel. |
| Preset | Button | This button resets all tanks that have the 'Preset.On' button ticked and have pre-set data. The user can also set this command in a PGM, Event file or from Excel. |
| Time | Button | This button resets the model timer to the start time. The user can also set this command in a PGM, Event file or from Excel. |
Integration Tab Page
| Method | FeedBack | Displays the simulation method used. |
| TimeIncCtrl | FeedBack | Displays the step size control, fixed or variable. |
| IterationsPerStep | Input | Number of iterations per step |
| TimeInc | ||
| TimeIncMax | ||
| TimeIncMin | ||
| DerivEstInc | ||
| SettleTime | ||
| CtrlEval | ||
| Mag_Eps_Abs | ||
| Mag_Eps_Rel | ||
| Int_Safety | ||
| GrowLimit | ||
| Grow | ||
| OKShrinkLimit | ||
| OKShrink | ||
| BADShrink | ||
| Steps | FeedBack | Displays the total number of simulation steps |
| GoodIters | FeedBack | Displays the number of good iterations |
| BadIters | FeedBack | Displays the number of bad iterations |
| Iters4Step | FeedBack | Displays the number of iteration per step |
| WorstMagInt0 | FeedBack | Displays the worst error |
| WorstMagInt1 ... 9 | FeedBack | Displays the next 8 worst errors |
Network Tab Page
| Link Convergence | ||
| Lnk_Eps_Abs | ||
| Lnk_Eps_Rel | ||
| Network Convergence | ||
| Net_DeRating | ||
| Net_MaxResRatio | ||
| NetCnvCount | ||
| Net_ResRunAvgStart | ||
| Net_ResRunAvgCount | ||
| UDFCnvCount | ||
| FastConverge | ||
| Flow Calculations | ||
| NetFlow.Vapour | ||
| NetFlow.Liquid | ||
| Velocity Limits. NOTE that the velocity limits have been moved to Plant Model - Settings in SysCAD9.2 Build 132. | ||
| ShowVelLimitAs | List | Options are: 1) Off; 2) Note; 3) Warning; 4) Error |
| VelLimitSL | Input | Allows user to set an upper limit for slurry velocity. Messages may be displayed based on the ShowVelLimitAs method selected. See the above field. |
| VelLimitV | Input | Allows user to set an upper limit for vapour velocity. Messages may be displayed based on the ShowVelLimitAs method selected. See the above field. |
| Mass Flow Differences | ||
| ShowQmDiffAs | ||
| QmMatchAbs | ||
| QmMatchRel | ||
| Options | ||
| Momentum | ||
| KFactMult | ||
Tears Tab Page
| Tolerance Defaults | ||
| Tear.EPS_Rel | Input | User specified relative tolerance for tear streams. |
| Tear.EPS_Abs | Input | User specified absolute tolerance for tear streams. |
| Convergence Defaults | ||
| Tear.MaxIters | ||
| Tear.Method | List Box | 1) DirectSubs; 2) AdaptSubs 3) Wegstein |
| Tear.MinDamping | Input | The minimum damping factor for the tear stream. |
| Tear.DampingGrowth | Input | |
| Tear.DampingDecay | Input | |
| Tear.DampAsGroup | List Box | This is only visible with the AdaptSubs method |
| Tear.WegsteinDelay | This is only visible with the Wegstein method | |
| Tear.WegsteinBound | This is only visible with the Wegstein method | |
| Tear.WegsteinClamp | This is only visible with the Wegstein method | |
| Tear Control | ||
| Tear.Revert | Tickbox | |
| Tear.ShowMsgs | Tickbox | |
| Tear.Recovery.Method | List box | 1) FlowFraction; 2) AccumFraction |
| Tear.Recovery.Rate | Input | |
| Tear.Recovery.MaxFlow | Input | |
SS Monitor Tab Page
| Tag/Symbol | Input/Calc | Description |
|---|---|---|
| SteadyState Tests | ||
| Monitor | ||
| SS.StopCount | Input | The number of continuous iterations that the network must be steady before SysCAD will stop. |
| SS.MaxIters | Input | The solver will stop after MaxIters – regardless. |
| SS.SteadyCnt | Output | The number of consecutive iterations that the ‘Steady State’ criteria have been satisfied. |
| SS.Iteration | Output | The number of iterations todate. |
| Temperature ---------------------------- | ||
| SS.Temp.Test | List | None - do not do any temperature tests |
| Flows - Apply the temperature test to all flows. | ||
| Content - Apply the temperature test to all contents. | ||
| Flows/Content - Apply the temperature test to all flows and contents. | ||
| SS.Temp.Abs | Input | Absolute tolerance on temperature change |
| SS.Temp.Rel | Input | Relative tolerance on temperature change |
| SS.Temp.Steady | Output | The number of consecutive iterations that the ‘Steady State’ temperature criteria have been satisfied. |
| Pressure ---------------------------- | ||
| SS.Press.Test | List | None - do not do any pressure tests |
| Flows - Apply the pressure test to all flows. | ||
| Content - Apply the pressure test to all contents. | ||
| Flows/Content - Apply the pressure test to all flows and contents. | ||
| SS.Press.Abs | Input | Absolute tolerance on pressure change |
| SS.Press.Rel | Input | Relative tolerance on pressure change |
| SS.Press.Steady | Output | The number of consecutive iterations that the ‘Steady State’ pressure criteria have been satisfied. |
| Mass (Content) ---------------------------- | ||
| SS.Mass.Test | List | None - do not do any mass tests |
| TotalMass - Apply the mass test to the total mass. | ||
| Species - Apply the mass test to individual species. | ||
| IndSpecie - Apply the mass test to a specific individual specie. The user selects the specie in the field following this one. | ||
| TotalMass/Species - Apply the mass test to the total mass and individual species. | ||
| TotalMass/IndSpecie - Apply the mass test to the total mass and to a specific individual specie. The user selects the specie in the field following this one. | ||
| SS.Temp.TestSpecie | List | This is only visible if the user has chosen IndSpecie or TotalMass/IndSpecie for SS.Mass.Test. The user selects the individual specie to be tested from a drop down list of all species in the project. |
| SS.Mass.Abs | Input | Absolute tolerance on mass change |
| SS.Mass.Rel | Input | Relative tolerance on mass change |
| SS.Mass.Steady | Output | The number of consecutive iterations that the ‘Steady State’ mass criteria have been satisfied. |
| Mass Flow ---------------------------- | ||
| SS.QMass.Test | List | None - do not do any mass flow tests |
| TotalQMass - Apply the mass flow test to the total mass flow. | ||
| Species - Apply the mass flow test to individual specie flows. | ||
| IndSpecie - Apply the mass flow test to a specific individual specie flow. The user selects the specie in the field following this one. | ||
| TotalQMass/Species - Apply the mass flow test to the total mass flow and individual specie flows. | ||
| TotalQMass/IndSpecie - Apply the mass flow test to the total mass flow and to a specific individual specie flow. The user selects the specie in the field following this one. | ||
| SS.Temp.TestSpecie | List | This is only visible if the user has chosen IndSpecie or TotalQMass/IndSpecie for SS.QMass.Test. The user selects the individual specie to be tested from a drop down list of all species in the project. |
| SS.QMass.Abs | Input | Absolute tolerance on mass flow change |
| SS.QMass.Rel | Input | Relative tolerance on mass flow change |
| SS.QMass.Steady | Output | The number of consecutive iterations that the ‘Steady State’ mass flow criteria have been satisfied. |
Options
| Tag/Symbol | Input/Calc | Description |
|---|---|---|
| HistorianTagList... | ||
| Folder | Feedback | The path of the Historian Tag List |
| File | Input | User can specify all the Historian Tags on a List (Text file) and load it into SysCAD here. |
| Edit | Button | User can edit the Historian Tags List |
| Browse | Button | User can browse for the Historian Tag List |
| Set_... | Button | Adds the tags to the SysCAD Historian. |
NOTE: The first line in the Historian Tag list is ignored, user can place heading or comments there. The tags to be loaded starts from Line 2 of the file.
Example Historian Tag List file (Numbers shown are line numbers):
- Example Historian Tag List
- MULTI_STORE.TotalMass (t)
- MULTI_STORE.Summary.[0].Mass (t)
- MULTI_STORE.Summary.[1].Mass (t)
- MULTI_STORE.Summary.[2].Mass (t)
- P100.Qm (t/h)
- P101.Qm (t/h)
- P102.Qm (t/h)
