Tear

From SysCAD Documentation
Jump to navigation Jump to search

Navigation: Models ➔ Other General Models ➔ Tear

Related Links: Solver Settings - GlobalTear, Convergence Methods, Tolerance Testing


General Description

The Tear is an internal SysCAD "model" automatically created by the solver. For example a break in a stream in a recycle which would be one of the criteria for convergence of a full flowsheet model. The Tear created provides a display the Tear Block information. Here the user can gain access to the Tear block to set/view Tear related information.

Data Sections

The default sections and variable names are described in the following table.

  1. Tear (Steady State solve mode) - The first section contains general information relating to the tear block
  2. Tear (Dynamic solve mode) - The first section contains general information relating to the tear block
  3. Settings - The second section allows user to specify method and tolerances values for the tear block.
  4. Convergence - The third section allows user to specify the tolerances values for individual variables in the tear block.
  5. Configuration -The fourth section allows user to specify the convergence method for individual variables in the tear block.
  6. Qi - This and subsequent tab pages, e.g. Qi.. and Sp, shows the properties of the inlet material.
  7. Qo - This and subsequent tab pages, e.g. Qo.. and Sp, shows the properties of the outlet material.
  8. TearAccumIn - This and subsequent tab pages, e.g. TearAccumIn.. and Sp, shows the properties of the Tear Accumulation in.
  9. TearAccumOut - This and subsequent tab pages, e.g. TearAccumOut.. and Sp, shows the properties of the Tear Accumulation out.

Tear Tab - Steady State

Tag (Long/Short) Input / Calc Description
Tag Display This name of the Tear Block
Tear Block
Tear.Summary Display Tears. This is the Access Window that will display the Tear block summary data. Click on the magnifying glass symbol to the right of the field to access it.
Tear.GlobalSettings Display GlobalTear. This is the Access Window that will display the Tear block Global settings. Click on the magnifying glass symbol to the right of the field to access it.
Tear.AssocTag Display The associated Flange Tag name for a Pipe Recycle.
Tear.ConvergeType / Tear.CvgType Display Convergence Type for the Tear - Pipe recycle or FlashTrain. Available from Build 139.
Tear.Active Display Returns the state of the Tear block. 1 = Active; 0 = Inactive.
Tear.Source1.Active / Tear.Src1.Active Display Shows the Source of the Tear Stream, and whether it is active. 1 = Active; 0 = Inactive.
Tear.Source1.Tag / Tear.Src1.Tag Display Shows the Source of the Tear Stream.
Tear.Destination1.Active /Tear.Dst1.Active Display Shows the Destination of the Tear Stream, and whether it is active. 1 = Active; 0 = Inactive.
Tear.Destination1.Tag / Tear.Dst1.Tag Display Shows the Destination of the Tear Stream
Tear...
Variables
Converged.Portion Display Displays if all variables in the tear block has converged. This is calculated as number of converged variables / total number of variables in the tear block.
Variables.Converged / Vars.Converged Display Displays the number of variables in the tear block that have converged. If the tear is converged, this will be equal to the Variables.InUse.
Variables.InUse / Vars.InUse Display Displays the number of variables in the tear block that need to be converged for the tear block to be converged. This is will be less than or equal to Variables.Count.
Variables.Count / Vars.Count Display Displays the total number of variables in the tear block which may need to be converged for the tear block to be converged.
Variables.ToConverge / Vars.ToConverge Display Displays the number of variables in the tear block yet to converge. This will be the difference between Variables.InUse and Variables.Converged. If the tear is converged then this will be equal to zero.
WorstTag Display The name variable in the tear block that carries the worst error.
WorstValue Display The value of the variable in the tear block that carries the worst error. The units are SI units for the WorstTag shown (eg K for temperature, kg/s for species mass flow).
WorstDiff Display The delta change value of the variable in the tear block that carries the worst error. The units are SI units for the WorstTag shown.
WorstError Display The error percentage of the variable in the tear block that carries the worst error. Refer to Tolerance Testing
Convergence
State Display Displays the state of the Tear block. Possible states are: InActive, NotConverged, Converged, NoFlow.
Converged Display Displays the state of the Tear Block in terms of convergence. Result will be 1=Yes or 0=No.
NoFlow Display Displays the state of the Tear Block in terms of flow. Result will be 1=Yes or 0=No.
Current.Good.Iters Display The number of consecutive iterations the solver has performed with the tear block converged.
Total.Iterations Display The total number of iterations the solver has performed with the tear block in use.

Tear Tab - Dynamic

Tag (Long/Short) Input / Calc Description
Tag Display This name of the Tear Block
Tear Block
Tear.Summary Display Tears. This is the Access Window that will display the Tear block summary data. Click on the magnifying glass symbol to the right of the field to access it.
Tear.GlobalSettings Display GlobalTear. This is the Access Window that will display the Tear block Global settings. Click on the magnifying glass symbol to the right of the field to access it.
Tear.AssocTag Display The associated Flange Tag name.
Tear.Active Display Returns the state of the Tear block. 1 = Active; 0 = Inactive.
Tear.Source1.Active / Tear.Src1.Active Display Shows the Source of the Tear Stream, and whether it is active. 1 = Active; 0 = Inactive.
Tear.Source1.Tag / Tear.Src1.Tag Display Shows the Source of the Tear Stream.
Tear.Destination1.Active /Tear.Dst1.Active Display Shows the Destination of the Tear Stream, and whether it is active. 1 = Active; 0 = Inactive.
Tear.Destination1.Tag / Tear.Dst1.Tag Display Shows the Destination of the Tear Stream
Tear...
Variables (Current Step)
Converged.Portion Display Displays if all variables in the tear block has converged. This is calculated as number of converged variables / total number of variables in the tear block.
Variables.Converged / Vars.Converged Display Displays the number of variables in the tear block that have converged. If the tear is converged, this will be equal to the Variables.InUse.
Variables.InUse / Vars.InUse Display Displays the number of variables in the tear block that need to be converged for the tear block to be converged. This is will be less than or equal to Variables.Count.
Variables.Count / Vars.Count Display Displays the total number of variables in the tear block which may need to be converged for the tear block to be converged.
Variables.ToConverge / Vars.ToConverge Display Displays the number of variables in the tear block yet to converge. This will be the difference between Variables.InUse and Variables.Converged. If the tear is converged then this will be equal to zero.
WorstTag Display The name variable in the tear block that carries the worst error.
WorstValue Display The value of the variable in the tear block that carries the worst error. The units are SI units for the WorstTag shown (eg K for temperature, kg/s for species mass flow).
WorstDiff Display The delta change value of the variable in the tear block that carries the worst error. The units are SI units for the WorstTag shown.
WorstError Display The error percentage of the variable in the tear block that carries the worst error. Refer to Tolerance Testing
LargestMeasRatio Display
Convergence (Current Step)
State Display Displays the state of the Tear block. Possible states are: InActive, NotConverged, Converged, NoFlow.
Converged Display Displays the state of the Tear Block in terms of convergence. Result will be 1=Yes or 0=No.
NoFlow Display Displays the state of the Tear Block in terms of flow. Result will be 1=Yes or 0=No.
Current.Good.Iters Display The number of consecutive iterations the solver has performed with the tear block converged.
HasActiveFlow Display Displays the state of the Tear Block in terms of "has non-zero flow into flange". Result will be 1=Yes or 0=No.
HasAccumMass Display Displays the state of the Tear Block in terms of "has accumulated mass that needs to be recovered". Result will be 1=Yes or 0=No.
Step.Iterations Display Displays the number of iterations for current step.
Step.Iterations.Busy Display Displays the number of iterations not converged in current step.
Step.Iterations.Reqd Display Displays the number of iterations required to reach convergence in current step.
Step.Iterations.Good Display Displays the number of iterations tear is converged in current step.
Convergence (Overall)
Steps Display Total number of steps
Steps.Good Display Total number of good steps
Steps.Good.Current Display Current run of good steps
Steps.Good.Maximum Display Maximum run of good steps since start
Steps.Bad Display Total number of bad steps
Steps.Bad.Current Display Current run of bad steps
Steps.Bad.Maximum Display Maximum run of bad steps since start
Iterations Display Total number of iterations
Iterations.Reqd Display Total number of iterations required to reach convergence
Difficult Steps
Worst.Step Display Step number of the worst (most iterations) step executed
Worst.Step.Iters Display Number of required iterations during Worst.Step
First.Bad.Step Display Step number of first bad step
Last.Bad.Step Display Step number of last bad step
Balance
Accum.Mass / Accum.Mt Display Displays the accumulated mass in the tear block.
Accum.Energy / Accum.Hf Display Displays the accumulated energy in the tear block.
Accum.Mass.Balance Display Displays the state of accumulated mass in the tear block. Result will be 1=Yes or 0=No.
Accum.Energy.Balance Display Displays the state of accumulated energy in the tear block. Result will be 1=Yes or 0=No.
Recovery settings used in THIS Tear
Recovery.Method Off Would not apply correction for the accumulated mass or energy.
Standard Applies correction for the accumulated mass or energy.
Recovery.Rate (%) Display Correction as a Fraction of accumulated error per Step
Recovery.MaxRelCorrFlow (%) Display Maximum Correction Relative to Flow
Recovery.MaxTempDiff (C) Display Maximum Relative Correction per Step

Settings Tab

Tag Input / Calc Description
Tear Block
Tear.Summary Display Tears. This is the Access Window that will display the Tear block summary data. Click on the magnifying glass symbol to the right of the field to access it.
Tear.GlobalSettings Display GlobalTear. This is the Access Window that will display the Tear block Global settings. Click on the magnifying glass symbol to the right of the field to access it.
Tear.Active Display Returns the state of the Tear block. 1 = Active; 0 = Inactive.
Tear.SourceTag / SrcTag Display The tag of the source unit.
Tear.DestinationTag / DstTag Display The tag of the destination unit.
 
Priority The priority of the Tear block.
First
Normal
Last
ReqdType NoTear Turn off user defined manual tear
ManualTear User forces this to be a tear.
Break
NOTE: If this tear is a System tear, ie. auto-generated by SysCAD, this option will have no effect.
Type NoTear Not currently a tear.
SystemTear SysCAD has made this a tear.
ManualTear User has made this a tear.
Break User has made this a break.
Tear values used in THIS Tear -- OR -- Tear values used in THIS Tear unless overridden in individual variables
Tear...
Convergence Tolerance (Refer to Tolerance Testing for more information.)
Tol.SigDigits Input / Display Sets the Global Tear Relative Tolerance, Tol.SigDigits = -log(Tol.Rel).
For Example, if this value is 5, then the Tol.Rel = 10^(-5) = 1.00e-5. This value is linked to Tol.Rel. User only needs to set one of these two values.
Tol.Rel Input / Display Sets the Global Tear Relative Tolerance, Tol.Rel = 10^(-Tol.SigDigits).
For Example, if this value is 3.16e-5, then the Tol.SigDigits = -log(3.16e-5) = 4.5. This value is linked to Tol.SigDigits. User only needs to set one of these two values.
Tol.Abs Input Sets the Global Tear Absolute Tolerance.
Tol.Strategy For any variable in a Tear there are 3 possible values for a tolerance that can be used:
  1. The individual value for the variable (may be NAN)
  2. The value for the Tear Block (may be NAN)
  3. The global value

When deciding which value to use for either the Rel or Abs tolerance for any variable the values above are used as follows (ie depending on Strategy selected):

Maximum All 3 are checked and the maximum value is used.
Minimum All 3 are checked and the minimum value is used.
Priority The are searched in the order above and the first valid value is used.
Tolerance Management
Tol.UsingDefaults Display If using the default Global Tear tolerance settings, the box will be ticked. If the user defined Convergence Tolerance differs from the global tear values, it will be unticked.
Tol.ResetToDefaults Reset Tear Tolerance Resets the Tear Tolerance to use the Global Tear Values.
Tol.Vars.Override Tickbox If this is selected, two extra columns (Tol.Rel and Tol.Abs) will appear on the Convergence Tab. This allows the user to set different tolerance values to different compounds in the tear stream.
Tol.Vars.UsingDefaults Display If this box is ticked, it indicates all the compounds on the "Convergence Tab" are using the same values as specified in the settings tab.
Tol.Vars.SetAll Button This button is visible when "Tol.Vars.Override" is selected. It can be used to reset all the tear variables (convergence tab) and replace them with values specified in the Convergence Tolerance group (Settings tab). This will overwrite any individual values entered on the Convergence Tab.
Tear Settings (Refer to Convergence Methods for detailed information on these fields.)
Method Direct Please see Direct Substitution Method
Adaptive Please see Adaptive Direct Substitution Method
Hold List Box Place a hold on the Tear block (keep output values the same). Options are: Yes, No.
ShowOutofUse Tickbox
Damping
Damp.AsGroup List Box Only visible if Method=Adaptive. (1) No; (2) Yes
Damp.UnStick List Box Only visible if Method=Adaptive. (1) No; (2) Yes. For more information, see Convergence Methods - Unsticking the solution
Damp.Minimum Input The minimum damping factor for the tear block if it is damped as a group. Normally the factor will be determined and changed by SysCAD, users do not need to set this number.
Damp.Growth Input Only relevant for Method=Direct or Adaptive.
Damp.Decay Input Only relevant for Method=Direct or Adaptive.
Zero Approach See Convergence Methods - Zero Approach
ZeroApp.Apply List Box Only visible if Method=Adaptive. (1) No; (2) Yes. If this is set to Yes (default), then as the tear block approaches zero flow, the adaptive method can be switched off to use the direct method.
ZeroApp.Limit Input Only visible if Method=Adaptive. If the largest ZeroApp.Measure for a Tear is < 1.0 and WorstError < ZeroApp.Limit then the tear is advanced using direct substitution instead of adaptive.
ZeroApp.Measure Display Only visible if Method=Adaptive. The maximum value of ZeroApp.Measure for all variables in the tear block.
ZeroApp.Measure for each variable (only applicable to species mass flows) = Measval (kg/s) / AbsTol.
Setting Management
Settings.UsingDefaults Display If using the default Global Tear tolerance settings, the box will be ticked. If the user defined Convergence Tolerance differs from the global tear values, it will be unticked.
Settings.ResetToDefaults Reset Tear Tolerance Resets the Tear Tolerance to use the Global Tear Values.
Settings.Vars.Override Tickbox If this is selected, three extra columns (Hold, Method, minDamping) will appear on the Configuration Tab. This allows the user to set different methods to different compounds in the tear stream.
Settings.Vars.UsingDefaults Display If this box is ticked, it indicates all the compounds on the "Configuration Tab" are using the same method as specified in the settings tab.
Settings.Vars.SetAll Button This button is visible when "Settings.Vars.Override" is selected. It can be used to reset all the tear variables (Configuration tab) and replace them with values specified in the Tear Setting group (Settings tab). This will overwrite any individual values entered on the Configuration Tab.
Tear Initilisation (Only for Manual Tears)

Usable if variable "ReqdType" is set to "ManualTear". The initial values are specified on the Configuration Tab.

ManTear.Init.How Clear The initalial values will be cleared after the manual tear initialisation step, based on ManTear.Init.When.
Hold.Initial Hold the initial values for the required number of iterations, based on values specified in ManTear.Init.Count
Rampfrom.Initial The initial values will be ramped up for the required number of iterations, based on values specified in ManTear.Init.Count
ManTear.Init.When Oninitialise manual tear initialisation will occur on project initialisation step.
Onstart manual tear initialisation will occur on project start.
OnDemand manual tear initialisation will occur on demand - manually pressing the "ManTear.Init.Start" (Start Initilisation) button .
ManTear.Init.Count Input Holds the initial values for the required amount of iterations, used when "ManTear.Init.How" is set to "Hold.Initial" or "Rampfrom.Initial".
ManTear.Init.Iters Display The remaining number of initialisation iterations to be completed.
ManTear.Init.State Display If this is ticked, it indicates the Tear is being initialised.
ManTear.Init.Start Button manually initialise the tear block.

Convergence Tab

Variable Display This column lists all the Tear variables, this includes Temperature, Pressure and mass flows of all the species.
Notes:
  • If the project has been solved for at least one iteration, all species with no flow will be "hidden" , making the table shorter for viewing purposes.
  • If the project contain size distribution data, then extra tabs will be shown showing the solids with size data.
Input Display The value in the tear block
Error Display Error calculated using formula described in Tolerance_Testing. If this value is <1.0 then the variable is converged.
Good Display Displays if the variable is converged
Used Display
Invl Display
Count Display Consecutive iteration count for which the variable has been converged
Damping Display The damping applied.
Tol.Rel Input Only visible if "Tol.Vars.Override" is ticked on Settings Tab. The Relative Tolerance required for the individual species.
Tol.Abs Input Only visible if "Tol.Vars.Override" is ticked on Settings Tab. The Absolute Tolerance required for the individual species.
 
Variables Tolerance Management
Tol.Vars.Override Tickbox If this is selected, two extra columns (Tol.Rel and Tol.Abs) will appear. This allows the user to set different tolerance values to different compounds in the tear stream.
Tol.Vars.UsingDefaults Display If this box is ticked, it indicates all the compounds on the "Convergence Tab" are using the same values as specified in the settings tab.
Tol.Vars.SetAll Button This button is visible when "Tol.Vars.Override" is selected. It can be used to reset all the tear variables (convergence tab) and replace them with values specified in the Convergence Tolerance group (Settings tab). This will overwrite any individual values entered on the Convergence Tab.

Configuration Tab

Variable Display Variable name
Input Display The input value.
NextOutput Display Only visible in Dynamic projects. The next output value.
Output Display The output value.
InitValue Input Only visible if this is a Manual Tear. Allows user specified initialisation value.
Hold Input Only visible if the "Settings.Vars.Override" is ticked. Hold option for variable. Options are Yes or No.
Method Input Only visible if the "Settings.Vars.Override" is ticked. Method used for convergence. Options are: Direct, Adaptive.
MinDamping Input Only visible if the "Settings.Vars.Override" is ticked. Minimum Damping for the Tear loop.
 
Variables Settings Management
Settings.Vars.Override Tickbox If this is selected, three extra columns (Hold, Method and MinDamping) will appear. This allows the user to set different tolerance settings to different compounds in the tear stream.
Settings.Vars.UsingDefaults Display If this box is ticked, it indicates all the compounds are using the same settings as specified in the settings tab.
Tol.Vars.SetAll Button This button is visible when "Tol.Vars.Override" is selected. It can be used to reset all the tear variables (convergence tab) and replace them with values specified in the Convergence Tolerance group (Settings tab). This will overwrite any individual values entered on the Convergence Tab.