New version Utility Functions Add-In for Ebsilon
Two new features! Improved documentation!
Introduction
I’ve expanded the UtilityFunctions.esc file I described in this post, made the files easier to find, and created a document that describes the features, installation, and usage.
Where are the files?
Go to the Utility Functions folder on my Ebsilon Tips OneDrive
What’s there?
The latest version of the EbsScript (UtilityFunctions20231221.esc), two demo models, and a new document — Utility Functions Add-In for Ebsilon.pdf — which tells you everything about the functionality, installation, and usage.
What’s New?
GetValFromProfile
This function has 2 arguments: a profile name, and a variable name (given as Object.Variable). It can be used in a Text Field, specification, or EbsScript. For example,
GetValFromProfile("Design", "Shaft.Q")
returns the Shaft Power from the Design Profile.
This can be quite useful in a Specification. For example, to set a controller to modulate something to achieve 50% of the Design shaft power, the SCV can be given by this expression:
MySignalNotConverged
This is for use only in EbsScripts. It can be used as a replacement for ksSignalNotConverged or kiSignalNotConverged.
MySignalNotConverged prints this information to the EbsKern-Output panel, e.g.
Iteration 197 Preventing convergence with ksSignalNotConverged in Macro_object line 6
Iteration 198 Preventing convergence with ksSignalNotConverged in Macro_object line 6
Iteration 199 Preventing convergence with ksSignalNotConverged in Macro_object line 6
whereas the base functions do not print any such information.
Refer to the Utility Functions Add-In for Ebsilon.pdf document for the benefits of and syntax for using this function.
Existing Functionality
All prior functionality has been preserved. See the Utility Functions Add-In for Ebsilon.pdf document for the full list with more examples and expanded information regarding syntax.