“Directive” is a software programming concept that is employed in the HUBPL to ensure that each widget “looks and feels” the same to a user. This also enables the software program to be less error-prone and operate more efficiently by writing the code in one place and leveraging in many places, vs. replicating code in many places. Where the same inputs, commands, or visualizations are used by multiple widgets, a directive is called by the program to bring consistent format, spelling, terminology, functionality, etc. into the widget.
The case header directive is used in all widgets. that have the ability to save the inputs, and results, of analyses in the HUBPL (excludes Map, Database Import, Ad-Hoc Analysis, etc.).
The case header directive governs the portion of the widget where a user can:
The case header directive can be expanded, or collapsed, per the user’s preference. In previous versions of Pipeline Toolbox, the free-text inputs in this section were the primary method for keeping track of the reason for the analysis, as well as for being able to find the case again.
A case can be easily associated to an entity and categorized for easy recall in the Navigator-Hierarchy Panel in the HUBPL version of
Additionally, input values for calculations can be auto-populated from an asset database through the association between case and entity, which can be made via the Map or the Navigator. Entities that are supported include:
Some widgets have multiple tabs, vs. everything happening in one tab as depicted above. When this happens, the case header directive is displayed in the first tab only. Example below:
The pipe description directive is used in all widgets that perform analyses on pipes. The pipe description directive was developed to drive consistency across the platform and help the user understand the definition of each input, as well as how data can be mapped from an asset database to auto-populate inputs when a particular pipe is selected for analysis. When an entity is selected from the Map or the Navigator, calculation inputs are prepopulated with values from the asset database and are then color-coded to convey whether or not the inputs agree with the relevant asset database values. The pipe attributes screen contains the variables available for use in calculations.
While many calculations need common input requirements (outside diameter, wall thickness, etc.), other inputs are specific to a particular analysis (elevation for hydraulics, etc.), and the content of the directive in each widget varies to suit the needs of the specific use case. Some key dependencies are explored below, while additional information of other inputs can be found on the Definitions page
The operating parameters directive is used in all widgets that perform analyses where conditions inside the pipe are relevant. The operating parameters directive was developed to drive consistency across the platform and help the user understand the definition of each input, as well as how data can be mapped from an asset database to auto-populate inputs when a particular entity is selected for analysis.
While many calculations need common input requirements, other inputs are specific to a particular analysis. The content of the directive in each widget varies to suit the needs of the specific use case. Some examples are included in the screenshot below for your reference. As with most other directives, color coding of inputs is utilized to convey whether or not the inputs agree with the relevant asset database values.
The pipe class directive is used in all widgets that perform analyses where joint type and behavior of the steel as a function of its environment, aside from SMYS, matters. This includes parameters like thermal expansion, elasticity, Poisson’s Ratio, and others. The pipe class directive was developed to drive consistency across the platform and help the user understand the definition of each input, as well as how data can be mapped from an asset database to auto-populate inputs when a particular entity is selected for analysis.
While many calculations need common input requirements, other inputs are specific to a particular analysis. The content of the directive in each widget varies to suit the needs of the specific use case. Some examples are included in the screenshot below for your reference.
Unlike other directives, color coding of inputs is not utilized to convey whether or not the inputs agree with the relevant asset database values.
The fluid description directive is used in all widgets that perform analyses where type of fluid inside the pipe and the fluid’s properties are relevant. The fluid description directive was developed to drive consistency across the platform and help the user understand the definition of each input, as well as how data can be mapped from an asset database to auto-populate inputs when a particular entity is selected for analysis.
The fluid description directive allows the user to:
While many calculations need common input requirements, other inputs are specific to a particular analysis. The content of the directive in each widget varies to suit the needs of the specific use case. Some examples are included in the screenshot below for your reference. As with most other directives, color coding of inputs is utilized to convey whether or not the inputs agree with the relevant asset database values. While variables like specific gravity, viscosity, specific heat, etc. will be color-coded to convey agreement with asset database values, the fluid name only auto-populates and color-codes if a fluid from the FLUID PowerTool is selected.
None at this time.