Header and material file for pipe spool document
On the Pipe Spools tab of Plant Modeller, designers can generate pipe spool documents that present pipe spools as seen in the 3D model or as seen on the assembly table, and there can also be multi-pipe penetration (MPP) spools that consist of several separate pipes (possibly belonging to different Systems) welded to one steel plate.
Assembly event sequences
A spool assembly consists of a main pipe run and optional branch pipe runs. An outlet part at the start of a branch is considered to be an assembly event along the main run if the outlet has no other parts connected to it.
For each pipe run, assembly information lists an ordered set of assembly event sequences. Each sequence normally represents a fitting or a change of direction. Branch anchors along the main run have their own sequences that merely mark where each branch run begins. Straight pipe pieces between fittings are not reported as being sequence events—their length is included into the sequence between the fittings.
The transformation that needs to be applied to make the pipe geometry to be as seen on the assembly table is determined from a few rules:
- The longest straight pipe piece along the main run is to be at the left of the table, parallel to the X-axis of the table.
- The straight pipe is rotated to have as few parts pointing downward as possible.
- Parts are as much as possible on the X-Y plane of the assembly table.
In the spool, the assembly sequences are given consecutive ordinal numbers, and the first sequence of the main run is number 1.
Header files for pipe spool drawings
The header file (h-file) of a document provides general information about the object that the document represents, such as the drawing's title and number, and the object's total mass and center of gravity. This ASCII file contains data records in the form of tag–value pairs. Each tag and its value string are separated by one or more space characters or tabs, and the value string is terminated by a semicolon that indicates the end of the record.
sys Water;
Typically, this information is used by displaying it in the title block of the drawing or in the header fields of printed lists. The tags can be used in data requests to refer to the associated value string; data requests can be defined in drawing sheets, label definitions, and ICGDs, to output the desired values to the required location in the required format. The tag names can be freely chosen, as long as they do not conflict with reserved tag names.
Header tags
- Apr – Approved by.
- CGX – X coordinate of the center of gravity.
- CGY – Y coordinate of the center of gravity.
- CGZ – Z coordinate of the center of gravity.
- Dap – Approval date.
- Ded – Design date.
- Des – Designed by.
- Dno – Drawing number.
- Dra – Drawn by.
- Drd – Drawing date.
- Dsc – Description.
- Ds1 – Description row 1.
- Ds2 – Description row 2.
- Sur – Surface. The surface area of the piperun as an approximate value based on the geometry of the components. Unit: m2.
- TMA – Total mass of the objects in the document set.
- TSH – Total number of drawing sheets, present when there is more than one page.
- Vol – Volume. Internal volume of the piperun as an approximate value based on the geometry of the components. Unit: m3.
- .dD – Name.
- .dG – Description.
- .dU – Document name.
- .GD – Inner surface area of the piperun as an approximate value based on the geometry of the components. Unit: m2.
- .IA – Object coordinate system.
- .pN – X min of the document.
- .pO – X max of the document.
- .pP – Y min of the document.
- .pQ – Y max of the document.
- .pR – Z min of the document.
- .pS – Z max of the document.
Material files for pipe spool drawings
A material file (m–file) generated for a pipe spool drawing differs from standard m–file generation in the following ways:
- Each part in the spool has at least one record output to the m–file. This means that there is a record for each straight pipe piece, also for the ones that make one bent pipe.
- Records that will be selected to the assembly table will have some additional tags related to the assembly sequence that the part represents (see the tag descriptions below).
- Depending on the sequence type, there may be an additional record describing additional geometry information related to a given part. For example, for eccentric reducers and 180-degree bends created by merging two consecutive 90-degree bends. These records have assembly sequence information and also are marked as method records with the mth tag set to value $G. Also this record is output for eccentric branches.
- Method records for stub-ins and outlets will have sequence information.
- For each cut pipe piece, there will be an additional method record describing the properties of the cut pipe piece. These records are marked with the mth tag set to value $C.
Even though the system outputs this assembly information to m–files, it may still be necessary to apply some degree of customization to the m–file before it is processed via the ICGD to generate the final tables that appear on a drawing sheet or in Microsoft Excel files.
Below you will find information on additional tags that specify information about assembly events and sequences related to parts in a pipe spool.
In the list below, each title contains the defined name of the tag and its abbreviation in parentheses, as needed by script writers who create m–file customizations. These defines are available in the script header file %PMS_HOME%/include/pm_core_tags.h.
Tags relates to the pipe run of the sequence

Specifies run sequence number for the event. 1 is the main run, and 2–3 are branch runs.

Parts in runs that belong to a multi-pipe penetration will have this tag that specifies the ordinal number of the run within the multi-pipe penetration.

If event is the last one in the run, then this tag is present and has value 1.

If record contains additional information for the last sequence in run, then this tag has value 1. This information is available for 180-degree bends and curves.
General sequence information

Gives the sequence number of the event. Numbers for the spool start from 1.

Gives a short identification string for the assembly event, such as A, AB, BC. Indicates between which labeled points the sequence is located.

Gives the length of the sequence from the start point to the end point, measured as projected to a line leaving from the start point. So, sequence length between an eccentric reducer and the next event is measured along the line leaving the reducer.

Gives the measured length of straight pipe within the sequence. This is given only for sequences between real fittings, not given for sequences that represent location of branches along main run.
This length includes also the length of potential end-parts located at the end of the straight pipe piece in the sequence. At the point where the straight pipe piece and the end-part meet the end-part needs to have connection type DM_CT_FROMPIPE. This signals that the part is actually fabricated from the straight pipe piece.

Measures the amount of change in the X-coordinate in the sequence as seen on the assembly table. For multi-pipe penetrations it measures distance from the origin of the MPP.

Measures the amount of change in the Y-coordinate as seen on the assembly table. For multi-pipe penetrations it measures distance from the origin of the MPP.

Measures the amount of change in the Z-coordinate as seen on the assembly table. For multi-pipe penetrations it measures distance from the origin of the MPP.

Gives the named direction after the assembly event:
- X30-Y rotated 30 degrees from X axis towards
- -X30Y45U rotated 30 degrees from
The names of principal axes used in this notation are fixed: X,
Sequence information related to bends

Turn angle after bending in degrees. Measured from the assembly table as seen from

"L" left if turn angle measured from +Y, or "R" (right) if angle measured from

Shows angle as 180 – bend angle.

Measures elongation during bending.

A 90-degree bend is the first of two bends that together make a 180 bend. Only one bend is shown on the assembly table.

Value is 1 if this pipe part is the tail part in the bending process.

Value is 1 if this pipe part is the head part in the bending process.

Value is 1 if the pipe is bent with this flange.
Sequence information related to flanges

Named direction as seen on the assembly table from which flange installation angle is measured when looking at the flange from the connection direction. Initially bolt hole symmetry axis will be parallel to this direction.

Measures required rotation angle in degrees from base direction. Clockwise direction is positive.

Measures required rotation angle in degrees from standard orientation. Clockwise direction is positive. If 0, then the flange is at standard orientation regarding direction out of the gasket face.
Sequence cut information

Will contain the cut number of the pipe piece involved in the sequence.

Will contain the amount of straight pipe that needs to be taken into account for pipe cutting in the sequence.
Information of field welds and manually assigned extra lengths

Tag is present with value 1 if there is a field weld at the start of the assembly sequence.

Tag is present with value 1 if there is a field weld at the end of the assembly sequence.

Gives the amount of extra length required at the start of the assembly sequence.

Gives the amount of extra length required at the end of the assembly sequence.
Information on cuts at start or end of sequence

If assembly sequence represents a straight pipe, then this may specify additional end cut length as seen at the start of the assembly sequence. A straight pipe can have this addition if the pipe end at the start of the sequence is slanted or is a stub-in branch.

If assembly sequence represents a straight pipe, then this may specify additional end cut length as seen at the end of the assembly sequence. A straight pipe can have this addition if the pipe end at the end of the sequence is slanted or is a stub-in branch.

Tag for cut angle for slanted pipe end at the start of the sequence. Measures cut angle from perpendicular local Y-axis to pipe centerline (X-axis) in counter-clockwise direction.

Tag for tilt angle for slanted pipe end at the start of the sequence. Measures tilt angle in counter-clockwise direction from vertical.

Tag for cut angle for slanted pipe end at the end of the sequence. Measures cut angle from perpendicular local Y-axis to pipe centerline (X-axis) in counter- clockwise direction.

Tag for tilt angle for slanted pipe end at the end of the sequence. Measures tilt angle in counter-clockwise direction from vertical.

Tag that specifies named direction for major axis of the pipe end cut ellipse as seen on the assembly table at the start of the sequence. Normally this is parallel to the assembly table when there are no upward or downward components.

Tag that specifies the rotation angle of the cutting blade from perpendicular from pipe axis at the start of the sequence.

Tag that specifies named direction for major axis of the pipe end cut ellipse as seen on the assembly table at the end of the sequence. Normally this is parallel to the assembly table when there are no upward or downward components.

Tag that specifies the rotation angle of the cutting blade from perpendicular from pipe axis at the end of the sequence.
Information available for penetration plate or common sleeve

If spool is a multi-pipe penetration, then this tag is present for the plate, indicating how many pipes are involved.

Value of this tag specifies whether the penetration is a real plate or a common sleeve:
- 0 = plate
- 1 = common sleeve

If there is only one pipe that penetrates the plate, then this is the hole diameter for that pipe in the plate.
Information of cut pipe pieces
A material file will also contain method records describing how many separate cut pieces the spool contains. Each of these will have a cut number, length, end cut information, and so on. These records have the mth tag set to value $C.

End cut type at the start of the pipe piece, as seen in routing order, as one of the following:
- 1 = straight cut
- 2 = slanted
- 3 = concentric stub-in
- 4 = eccentric stub-in

Measures extra length added to the cut length due to an end cut (stub-in or oblique cut) at the start of the pipe.

End cut type at the end of the pipe piece, as seen in routing order, as one of the following:
- 1 = straight cut
- 2 = slanted
- 3 = concentric stub-in
- 4 = eccentric stub-in

Measures extra length added to the cut length due to an end cut (stub-in or oblique cut) at the end of the pipe.

Number of bend curves in a prefabricated pipe made from one straight piece.

If present, specifies how much extra length needs to be added before bending, and removed after bending, at the start of the pipe when bending without flange.

If present, specifies how much extra length needs to be added before bending, and removed after bending, at the start of the pipe when bending with flange.

If present, specifies how much extra length needs to be added before bending, and removed after bending, at the end of the pipe when bending without flange.

If present, specifies how much extra length needs to be added before bending, and removed after bending, at end of the pipe when bending with flange.

If present, specifies how much extra length needs to be added before bending, and removed after bending, between bends.
Also spool assembly tags to shown run information and cut information are present.
Additional information available in the header for pipe spool drawings

Named X-coordinate at the start of the spool.

Named Y-coordinate at the start of the spool.

Named Z-coordinate at the start of the spool.

Absolute values of X-coordinate at the start of the spool.

Absolute values of Y-coordinate at the start of the spool.

Absolute values of Z-coordinate at the start of the spool.

Value is named direction pointing out of the start of the spool. Principal axis names are the ones defined in the coordinate system configuration.

X-component of direction vector pointing out of the start of the spool.

Y-component of direction vector pointing out of the start of the spool.

Z-component of direction vector pointing out of the start of the spool.

Rotation angle in degrees between flanges at the ends of a bent pipe. This is seen as in front of the first flange, and positive values indicate clockwise rotation.