You can translate material data described using any of the following Neutral data file formats into a SmartPlant Isometrics-supported format.
Alias Data Format
Although the intention is to allow the simplest possible translation, it is necessary for the Neutral file interface to observe certain rules. These rules reflect the way that the material system works. First, I-Convert needs to know the configuration of each component. There are 14 standard configuration codes.
For more information, see the Material Editor Help.
The Schema file allows the use of this configuration code. In order to assign the correct configuration, the software uses the Isogen SKEY as the key in a lookup table. Therefore, the SKEY must be supplied for each component in the Neutral file. To be clear, it is not necessary for the Neutral data file to contain the configuration code.
Second, it is a key assumption that the ItemCode plus (a maximum of) three bores uniquely defines a component. If it does not, the software modifies the supplied ItemCode to make it unique.
Alias data is the minimum necessary to define the 3D geometry of components; therefore, it is highly unlikely that any source system will not contain the data required by the software. The format of the Neutral data file is flexible so that it is acceptable to put out all available data, since the schema defines the mapping.
Minimum data requirements for creating SmartPlant Isometrics specifications
Code for the component. A string that defines the component, such as PA5BX. It can contain any characters except a space.
The ISOGEN symbol key
Text containing a description of the material, such as PIPE, CS API 5L SML, GRD B, X-STG. The name of the field is not important as it is defined in the schema file.
Text string used to classify the type of material in the terms of the originating system. The ComponentType is used in the schema to define the location of dimension data. The name used for the field is defined in the schema file
A series of fields or data items, such as size_1 4, size_2 2, which define the bore (nominal size) properties of the material.
A series of fields or data items which define the dimensions of the material. Examples include the following:
Flanged components - If you supply bolt item code and quantity fields, the software uses them to create a bolting table in the specification.
Data File Format
The data file must be in valid XML format. The XML file contains a series of material elements, as shown in the following example. Each element has a set of attributes. The names and format of the attributes are mapped to the required fields in the schema.
DESC= “PIPE, CS API 5L SML, GRD B, X-STG”
OD = “101.2”
DESC=”FLANGE, 150# WELD NECK”
Schema File Format
The Schema file is also written in XML. For each CPT_TYPE element, the Schema file defines the mapping between the Neutral file data and the Alias data. In some cases, because one component type can have more than one configuration, the CPT_TYPE field is insufficient. For example, a valve can be an inline type with a single length and bore as well as an angle valve, which has an angle configuration, two leg lengths and two bores. In this case, the Schema file must have entries for both.
The Schema file is usually be created by Alias, working with the supplier of the Neutral file data.
The following is an example of a basic Schema file.
<!—The ALL element defines general mapping that applies to all component types – in particular it maps the field names used in the neutral file to the required fields used in the Alias data set ->
<!—A Map Element maps a component type data to Alias fields ->
BOREA= “NSIZE_1” > </MAP>
<!—A Configuration may optionally be specified ->
<!—Angle valves ->
BOREB=”NSIZE_2” > </MAP>
<!—Can also define calculated fields ->
DIMA=”CALC Length + 0.5 * NSIZE_1”
Other specification tables
The process described in this document only defines the physical material data. Additional information is required to fully define an appropriate specification. This additional data is stored in a series of tables, each of which is a text file.
If the necessary information is supplied with flanged components, I-Convert can create the Bolt table. For more information, see the Optional Data section.
To fully define the specification, you must create the remaining specification tables, the Spec file (.spn), the Default Choice table (.cho), the Connectivity table (.con), and the Implied Material table (.iml), in the correct format. You can use Smart Isometrics Material Editor to do this.