Schematic 3D Integrator User Guide

New	To create a new configuration (empty or default), select File, then New. There are two options for new configuration files, refer to Empty Configuration or Default Configuration for further information.
Empty Configuration	An Empty Configuration file provides some simple default settings but will contain no rules for building and comparing elements.
Default Configuration	A Default Configuration provides a copy of the out-of-the-box project configuration file containing a complete set of example rules that can be used out of the box but are available for customisation.
Open	To open an existing configuration file, select File, then Open, from the displayed Open Project Configuration File window, select the ProjectConfiguration.xml file. By default the appropriate folder is displayed, defined as the Model Management folder under the folder indicated by the project defaults environment variable, for example: for the TTP project: %ttpdflts%\ModelManagement\ProjectConfiguration.xml For general users, Integrator always uses this folder and file combination to read its configuration settings. As a Free user or a member of team CUADMIN, if required open another file in the Configuration Explorer and Integrator will use that file for any subsequent testing. Save those settings to the default file name and location in order to make them available to General users on the project. If required, use the project defaults environment variable to get quickly to the appropriate folder. For example, in the Open Project Configuration File window, for the TTP project, enter %ttpdflts%\ModelManagement in the Filename field and then press Enter.
Revert to Saved	To discard any changes made to the configuration file but keep it open, select File, then Revert to Saved.
Save	To save any changes made to the currently open configuration file, select File, then Save.
Save as	To save the current configuration to a different file, select Save As.
Close	To close the Integrator Project Configuration Explorer, select File then Close. If there are unsaved changes, a prompt is displayed save them.

Real Tolerance	This is the value that is used to compare real number attributes. Two attribute values within this tolerance are deemed to be equal. If no Real Tolerance value is specified the built-in default is 0.00001.
Distance Tolerance	This is the value that is used to compare distance attributes. Two attribute values within this tolerance are deemed to be equal. If no Distance Tolerance value is specified the built-in default is 0.01.
Distance and Bore Units	These determine which units are used for distance and bore values embedded within rules. The options are mm or inch.
Can Create Site	This determines whether a SITE may be automatically created during Build operations if no suitable SITE already exists (as specified by the project build rules). The built-in default setting is false.
Can Create Zone	This determines whether a ZONE may be automatically created during Build operations if no suitable ZONE already exists (as specified by the project build rules). The built-in default setting is false.
Compare Flanges, Couplings and Unions	By default, flanges, couplings and unions that appear only in 3D are treated as insignificant for compare. Those that appear on the P&ID will always be compared. Set the appropriate flags true to get all instances of these items in 3D compared.
Default Configurations, Colours Category and Rule Sets	These determine which settings are used if an appropriate configuration has not been defined or has not been selected.

Name	Enter a name for the new configuration.
Description	Enter an optional description of the configuration.
Compare Colours	The default set of colours
Category	The default category.
Rule Set	A rule set has to be defined or imported one from another configuration file in order to complete the selection.
Compare Options
	Ignore Accepted Differences reports each difference as if it had not been accepted.
	Reports unpositioned elements to warn when piping elements have been built but not yet positioned and orientated.
	Strictly limit compare to selected elements provides a faster report (recommended). If unchecked, Integrator may take longer to complete the report and may include additional pipelines. This can occur when matched pipes also partially match additional pipelines.
	Compare Lines/Pipes without member hierarchies to compare in Line List mode.
Whole Diagram Compare	Sets which main types will be included in the report for a Compare Diagram operation.

Accepted Difference	The element has one or more accepted differences, for example: it has been accepted as missing, or an attribute difference has been accepted, or it has had matching disabled
Connection Error	The connections on the element in 3D are not consistent with the connections on the matched schematic element, for example: a branch is connected to the wrong nozzle
Difference	The values of one or more attributes of the element or its members in 3D do not conform to the rules, or the sequence of elements in 3D does not conform to the schematic sequence
Problem with Model	An error with the element that can invalidate the comparison will be noted in the Compare Report and/or the Integrator Messages dialogue, for example: an inconsistent connection reference, or a missing GTYP value leading to a rules evaluation failure
Highlight	This is not used for compare - it is the colour used to highlight elements in the 3D view when selected in the Main Table or Compare Report
Missing	The element is not matched with an element on the other side, for example: a component on the diagram is coloured to show that there is no matching component in 3D, or an item is missing from the element that is coloured - typically a tube in 3D is coloured to show where a component is missing when compared against the matching segment on the diagram
Not Compared	The element was not compared, although it was part of the elements selected for comparison, for example: a branch that models a trunnion support. Note: This does not mean all the elements that have not been selected for comparison.
OK	Element data has compared correctly according to the rules

Not Matched	The reporting of unmatched main type elements such as pipelines and equipment.
Key Attributes	Matches by key attributes according to the rules.
Spec Attributes	Applies to specification attributes PSPE, SPRE and CATR.

Create rules	Used to create new 3D elements during Build, and to check the existence and type of a matching object during Compare.
Assign rules	Used to assign a value to an attribute during Build, and to check the setting of an attribute on the 3D object during Compare. An Assign rule should always be preceded by a Create rule in the same block.

double Sine (double angle)	// angle in degrees
double Cosine (double angle)	// angle in degrees
double Tangent (double angle)	// angle in degrees
double Acosine (double value)	// result in degrees
double Atangent (double value)	// result in degrees
double Sqrt (double value)	// square root
double Log10 (double value)	// base 10 logarithm
double Logarithm (double value)	// natural logarithm
double Alog10 (double value)	// base 10 antilogarithm
double Alogarithm (double value)	// natural antilogarithm
double Absolute (double value)	// absolute value
integer Fix (double value)	// rounded towards zero
integer Ceiling (double value)	// rounded up
integer Round (double value)	// nearest integer
double Atant (double x, double y)	// atan of x/y (degrees)
double Minimum (double a, double b, …)	// minimum value
double Maximum (double a, double b, …)	// maximum value
integer Length (string text)	// number of characters
integer Occurs (string text, string sub)	// number of occurrences of sub in text
integer Instring (string text, string sub)	// Position of first occurrence of sub in text
string Asstring (object value)	// convert numeric or Boolean value to a string
double Asreal (object value)	// convert string value to a double
boolean Asboolean (object value)	// convert string or number value to a Boolean
string Substring (string text, integer start [, integer length])	// substring from the start position of given length (or to end of text)
string Left (string text, integer length)	// left part of text
string Right (string text, integer length)	// right part of text
string Before (string text, string sub)	// left part of text before given substring
string After (string text, string sub)	// right part of text after given substring
string Uppercase (string text)	// convert to upper case
string Lowercase (string text)	// convert to lower case
string Replace (string text, string seek, string sub)	// replace all occurrences in text of substring seek with substring sub
string Trim (string text)	// remove leading and trailing white space from text
string Format (string pattern, object arg1, …)	// substitute the values of the arguments into the pattern string
	- details of this are given below
string Lookup (string dictName, string key)	// return the value associated with the key in the given Dictionary
	(see Dictionaries section)
boolean Like (string pattern, string text)	// test if the text conforms to the wildcard pattern. Wild characters are:
	* - matches any number of characters
	? - matches any single character
boolean Between (object test, object lower, object upper)	// determine if the test object lies between the given lower and upper values.
	Arguments may be all numerical or all alphanumeric.
boolean Inlist (object test, object value1, …)	// determine if the test equals one of the given list of values.
	Arguments may be all numerical or all alphanumeric.
Integer Listposition	// the list order position of the current target element.
	in the members list of its owner.

Name	Name attribute is optional
Variants Count	Previously described above.
Attribute Name	The name of the attribute to be set on the target.
Attribute Value	An expression to generate the value for the target attribute, and can contain references to source. For build rules it should not contain references to target as this will be undefined at build time.

target	The target object in 3D, this is the usual setting
owner	The owing ZONE in 3D, described below in the example for NAME
root	The owning SITE in 3D, described below in the example for NAME

set	Sets the value of the attribute
ignore	Does not set the value of the attribute

match	The value of the attribute must match the value generated by the rule
matchorexceed	The value of the attribute must be equal to or greater than the value generated by the rule
matchornotexceed	The value of the attribute must be equal to or less than the value generated by the rule
matchaskeyattribute	The value of the attribute will be used to find matching elements in 3D; where key attributes are defined in the rules for a particular type, all their values on a particular object must match the values generated by the rules, in order for the 3D object to be identified as a match for the source schematic object
ignore	The value of the attribute will not be compared

critical error	The mismatch will be reported as a critical error, indicated by a red blob icon in the compare report
error	The mismatch will be reported as an error, indicated by a red dot icon in the compare report
warning	The mismatch will be reported as a warning, indicated by a yellow triangle icon in the compare report
information	The mismatch will be reported as information, indicated by a blue "i" icon in the compare report