AVEVA™ P&ID

Element Definitions

Save PDF

Element Definitions

Save PDF

Last UpdatedJan 30, 2025
34 minute read

Engineering

To successfully export data to the 12.0 SP4 version of PDMS or earlier, valid element definitions must be used. The valid element definitions are provided for reference purposes, detailing the available child elements and attributes.

PlantModel

This is the root node of an XML document and only exists as the root node of an XML file. Other than the first two child elements, PlantInformation and Extent, the ordering of child elements within a PlantModel element is not significant.

There shouldn’t be any need to place graphical elements into a PlantModel element as all drawing annotation such as borders and floating text should be child elements of the drawing element.

While a Position element may be provided is has no attached semantics and is often defaulted to 0,0,0.

Child Elements:

Element Name	Cardinality	Description
PlantInformation	1	The properties of a plant model This includes properties like its name, modification date, editing system etc. The PlantInformation element must be the first child element of a PlantModel element.
Extent	1	The minimum bounding rectangle that encloses the full graphical contents of the PlantModel instance. The Extent element must be the second child element of a PlantModel element
BsplineCurve	0..*	A geometric primitive
Circle	0..*	A geometric primitive
CompositeCurve	0..*	A composite geometry
Drawing	1	Metadata and graphical annotation related to the P&ID drawing being represented
Ellipse	0..*	A geometric primitive
Equipment	0..*	The representation of a piece of plant equipment.
GenericAttributes	0..*	Source system properties that relate to the XML file and plant model. These properties may be grouped into many GenericAttributes elements.
GeometricPrimitives	0..*	A collection of geometric primitives.
InstrumentLoop	0..*	A grouped set of instrument detail
Line	0..*	A geometric primitive
PipingNetworkSystem	0..*	An Engineering PipingNetworkSystem element
PipeLine	0..*	An Engineering PipeLine element
PlantArea	0..*	A place holder for Area information
Point	0..*	A geometric primitive
PolyLine	0..*	A geometric Primitive
Position	0..1	Usually defaulted to 0,0,0 if output.
Presentation	0..*	Style information for this object. In this context it has no meaning and should be omitted.
ProcessInstrument	0..*	An Engineering Instrument object
Shape	0..*	A geometric primitive
ShapeCatalogue	0..*	A catalogue of Equipment and PipingComponent symbols.
SignalLine	0..*	A connection between instruments.
Text	0..*	Label primitives
TrimmedCurve	0..*	A geometric primitive

Example:

Association

The Association element is used to relate engineering items to other resources.

One documented use of this is to relate in-line ProcessInstrument elements with InstrumentLoop elements. In this case each in-line ProcessInstrument element has an Association child element which details the relationship using the Type attribute with a value of ‘is a part of’.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Type	Y	The meaning/semantics of the relationship.
ItemID	N	The ID or PersistentID/@Identifier attribute value of the item being referenced.
Tag	N	The Tag attribute value of the item being referenced. (See Tag Referencing)
Name	N	The Name attribute value of the item being referenced.
URI	N	A URI identifying an associated resource
Context	N	If omitted then the resource is assumed to be part of the model in the same file. If you want to state the context as the current model then use the value ‘XML’.

Example:

Axis

See Geometries (Axis and Reference).

Child elements:

None

Attributes :

Attribute Name	Required	Description
X	Y
Y	Y
Z	Y

Example:

BsplineCurve

Geometric curve primitive detailing a Bspline.

Child elements:

Element Name	Cardinality	Description
Presentation	0..1	The style to use when drawing the Bspline. The drawing behaviour is undefined if the Presentation element is missing.
Extent	1	The minimum bounding geometry of this element and its descendants
ControlPoints	1
KnotMultiplicities	0..1
Knots	0..1
WeightsData	0..1
GenericAttributes	0..1	Any application specific attributes relating to the Bspline

Attributes:

Attribute Name	Required	Description
Degree	Y
CurveType	Y	One of the following : 'BsplineCurve', 'BsplineCurveWithKnots' or 'RationalBsplineCurve'.
CurveForm	N	One of the following : 'PolyLine', 'CircularArc', 'EllipticArc', 'ParabolicArc' or 'HyperbolicArc'
NumControlPoints	Y	x
NumKnots	N	x
Closed	N	'true' or 'false'
SelfIntersect	N	'true' or 'false'

Example:

CenterLine

Geometric curve primitive detailing the line geometry between the components of a PipingNetworkSegment. A CenterLine element is used to imply the presence of tubing. The interpolation between each coordinate is linear.

Child elements:

Element Name	Cardinality	Description
Presentation	0..1	The style to use when drawing the line. The drawing behaviour is undefined if the Presentation element is missing.
Extent	1	The minimum bounding geometry of the CenterLine element and its descendants
Coordinate	1..*	The coordinates defining the line primitive
GenericAttributes	0..*	Any application specific attributes relating to the tube/CenterLine

Attributes:

Attribute Name	Required	Description
NumPoints	Y	The number of child Coordinate elements.

Example:

Circle

A geometric primitive describing a circle.

Child elements:

Element Name	Cardinality	Description
Presentation	1	The style to use when drawing the circle
Extent	1	The minimum bounding geometry of the circle
Position	1	The location of the circles centre
GenericAttributes	0..*	Any application attributes relating to the circle

Attributes:

Attribute Name	Required	Description
Radius	Y	The radius of the circle to draw
Filled	N	One of ‘Solid’ or ‘Hatch’. If not present the circle is not filled.

Example:

Component

Used to group geometric and text primitives within a Drawing element. This inherits all elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

See ‘PlantItem’, no additional elements are defined.

Attiribute:

See ‘PlantItem’, no additional attributes are defined.

Example:

CompositeCurve

A collection of geometric curve primitives.

Child elements:

Element Name	Cardinality	Description
Presentation	0..1	The Presentation element has no purpose in this context.
Extent	1	The minimum bounding geometry of the geometric contents of the Drawing element and its descendants.
BsplineCurve	0..*	A geometric primitive
Circle	0..*	A geometric primitive
CompositeCurve	0..*	A geometric primitive
Ellipse	0..*	A geometric primitive
Line	0..*	A geometric primitive
Polyline	0..*	A geometric primitive
Shape	0..*	A geometric primitive
TrimmedCurve	0..*	A geometric primitive
GenericAttributes	0..*	Any application specific properties relating to the Drawing.

Attributes:

None

Example:

Connection

This element is used to describe the flow connectivity between elements. The source of the flow is defined using the attributes FromID and FromNode while the flow destination is defined using ToID and ToNode. A connection element and its attributes are not mandatory but must be present to represent the topology of a network. If the FromID/ToID attributes reference a Nozzle, PipeConnector or SpecificationBreak element then the FromNode/ToNode attributes are not required.

See ConnectionPoints for details on what is being referenced.

Child elements:

None

Attributes:

Attribute Name	Required	Description
ToID	N	The ID, PersistentID/@Identifier or Tag of the referenced item that is the flow destination for the parent of the Connection element.
ToNode	N	The index of the ConnectionPoints Node element within the ConnectionPoints element of the destination element. Nb this is a 0 based index and is only required if the destination is not a Nozzle, PipeConnector or SpecificationBreak.
FromID	N	The ID, PersistentID/@Identifier or Tag of the referenced item that is the flow source for the parent of the Connection element. See Tag Referencing
FromNode	N	The index of the ConnectionPoints Node element within the ConnectionPoints element of the source element. Nb this is a 0 based index and is only required if the source is not a Nozzle, PipeConnector or SpecificationBreak.

Example:

ConnectionPoints

This element is used to describe the potential flow connections from and to the parent of this element. Each potential connection location is represented as a Node element. Nodes are ordered and positioned on the drawing. Each Node element may be referenced by at most one Connection element.

The first node (known as Node 0) represents the geometric origin of the parent of the ConnectionPoints element.

Child elements:

Element Name	Cardinality	Description
Presentation	0..1	The Presentation element has no purpose in this context.
Extent	0..1	The minimum bounding geometry of the geometric contents of the ConnectionPoints element and its descendants.
Node	1..*	The first node (Node 0) represents the geometric location of the parent element. Nodes 1..n represent the locations that other elements may connect to.
GenericAttributes	0..*	Any Application attributes related to connectivity

Attributes:

Attribute Name	Required	Description
NumPoints	Y	The number of Node elements in this ConnectionPoints element.
FlowIn	N	The index of the Node that is used for the primary flow into the parent of the ConnectionPoints element. This Defaults to 1 if not present.
FlowOut	N	The index of the Node that is used for the primary flow from the parent of the ConnectionPoints element. This defaults to 2 if not present.

Example:

ConnectionType

This is a free form string element that may be unit qualified.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Unis	N	This may contain any of the permitted units types See Units.

Example:

ControlPoints

Child elements :

Element Name	Cardinality	Description
Coordinate	1..*

Attributes:

None

Example:

ControlPointWeight

This is defined as an any but should be considered to be of type xsd:integer.

Child elements:

None

Attributes :

None

Example:

Coordinate

A Coordinate element is a Tuple of ordinates denoting a location in the drawing plane. For 2D drawings the Z ordinates should always be 0.

Child elements:

None

Attributes:

Attribute Name	Required	Description
X	Y	The X Axis ordinate as a double
Y	Y	The Y Axis ordinate as a double
Z	N	The Z Axis ordinate as a double, If not present this defaults to 0.0

Example:

CrossPageConnection

An element describing how to match PipeConnector elements to represent cross page connectivity on a P&ID.

Child elements:

None

Attributes:

Attribute Name	Required	Description
DrawingName	N	The Name attribute of the Drawing that the matching PipeConnector is on. Depending on whether the attribute for matching is unique to a drawing or the entire project this may be required.
AttributeName	Y	The attribute name on the PipeConnector to use to match the connectors together. This could be an ItemAttribute such as the Tag or ID, or a member of a GenericAttributes element.
AttributeValue	Y	The value of the attribute to match on. Wildcards are not supported.
Set	N	If referencing an attribute inside a GenericAttributes element then the Set of the attribute should be provided. If referencing a PersistentID attribute then the Context attribute value of the PersistentID should be provided here.

Example:

Description

A textual description of an item

Child elements:

None

Attributes:

None

Example:

Discipline

This is a simple element with no attributes containing one of the following values to classify an element:

Electrical

Mechanical

Process

HVAC

Telecomms

Example:

Drawing

This contains metadata about the drawing and graphical annotation for the drawing that the XML file contains.

Child elements:

Element Name	Cardinality	Description
Presentation	1	The R, G and B values of this element define the background colour for the drawing. This is in contrast to the normal use of the Presentation element that defines foreground style information.
Extent	1	The minimum bounding geometry of the geometric contents of the Drawing element and its descendants.
Component	0..*	A PlantItem used to group annotation.
BsplineCurve	0..*	A geometric primitive
Circle	0..*	A geometric primitive
CompositeCurve	0..*	A geometric primitive
Ellipse	0..*	A geometric primitive
Line	0..*	A geometric primitive
Polyline	0..*	A geometric primitive
Shape	0..*	A geometric primitive
TrimmedCurve	0..*	A geometric primitive
Text	0..*	Textual annotation on the drawing
DrawingBorder	0..*	This element may be used to store the drawing border/outline but this is at the discretion of the export tool.
GenericAttributes	0..*	Any application specific properties relating to the Drawing.

Attributes:

Attribute Name	Required	Description
Name	Y	Identity for the drawing, this must be unique in the project.
Type	Y	Fixed value of ‘PID’
Revision	N	Free form string value. See Character encoding
Title	Y	The drawing title
Size	N	This is a free text string and has no defined syntax. See Character encoding.

Example:

DrawingBorder

This element may be used to separate the drawing frame and borders from the drawing annotation.

Child elements:

Element Name	Cardinality	Description
Presentation	0..1	The Presentation element has no purpose in this context.
Extent	1	The minimum bounding geometry of the geometric contents of the Drawing element and its descendants.
BsplineCurve	0..*	A geometric primitive
Circle	0..*	A geometric primitive
CompositeCurve	0..*	A geometric primitive
Ellipse	0..*	A geometric primitive
Line	0..*	A geometric primitive
Polyline	0..*	A geometric primitive
Shape	0..*	A geometric primitive
TrimmedCurve	0..*	A geometric primitive
Text	0..*
DrawingBorder	0..*	This element may be used to store the drawing border/outline but this is at the discretion of the export tool.
GenericAttributes	0..*	Any application specific properties relating to the Drawing.

Attributes:

Attribute Name	Required	Description
Name	N	Identity for the drawing border
Size	N	This is a free text string and has no defined syntax. See Character encoding.

Example:

Ellipse

A geometric primitive used to describe an ellipse.

Child elements:

Element Name	Cardinality	Description
Presentation	1	This defines the drawing style to be used for the ellipse.
Extent	1	The minimum bounding geometry of the geometric contents of the Drawing element and its descendants.
Position	1	The centre/origin of the ellipse to draw
GenericAttributes	0..*	A geometric primitive

Attributes:

Attribute Name	Required	Description
PrimaryAxis	Y	Double describing the primary axis
SecondaryAxis	Y	double describing the secondary axis
Filled	N	A value of ‘Solid’ or ‘Hatch’. If not present the ellipse is not filled.

Example:

EndDiameter

This is the internal bore for a segment or a PipingNetworkSystem at its destination.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The bore size
Units	N	This may be any of the distance units permitted. See Units for permitted values and semantics if not present.

Example:

Equipment

An Equipment element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

Element Name	Cardinality	Description
Discipline	0..1	Functional domain of Equipment
NormalOperatingPressure	0..1
MinimumDesignPressure	0..1
MaximumDesignPressure	0..1
MinimumDesignTemperature	0..1
MaximumDesignTemperature	0..1
Equipment	0..*	Equipment considered part of this equipment
Nozzle	0..*	Potential pipe connection to this equipment

Attributes:

Attribute Name	Required	Description
ProcessArea	N	A free form string identifying, if required, the process area that this equipment resides in (See Character encoding).
Purpose	N	A free form string describing the function of this equipment in the process (see Character encoding).

Example:

Extent

A minimum bounding geometry describing the minimum and maximum coordinates of the descendants of this elements parent.

Child elements:

Element Name	Cardinality	Description
Min	1	Minimum values for all geometric descendants of the Extent elements parent.
Max	1	Maximum values for all geometric descendants of the Extent elements parent

Attributes:

None

Example:

FabricationCategory

This is a free form string element that may be unit qualified.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Units	N	This may contain any of the permitted units types See Units.

Example:

None

GenericAttributes

This element permits application specific attributes/properties to be output into an XML file. The properties themselves must adhere to the following complex type definition:

Child elements:

Element Name	Cardinality	Description
Xsd:any	@Number	The contents of a GenericAttributes element are not validated and may be any valid XML content. However the XML applications will expect the contents to conform to the schema fragment provided above.

Attributes:

Attribute Name	Required	Description
Number	Y	The number of GenericAttributes inside this set.
Set	N	A name for this grouping of attributes.

Example:

GeometricPrimitives

A collection of geometric elements.

Child elements:

Element Name	Cardinality	Description
Extent	1	The minimum bounding geometry of the geometric contents of the Drawing element and its descendants.
Surface	0..*	A geometric primitive
BsplineCurve	0..*	A geometric primitive
Circle	0..*	A geometric primitive
CompositeCurve	0..*	A geometric primitive
Ellipse	0..*	A geometric primitive
Line	0..*	A geometric primitive
Polyline	0..*	A geometric primitive
Shape	0..*	A geometric primitive
TrimmedCurve	0..*	A geometric primitive

Attributes:

Attribute Name	Required	Description
NumPrimitives	N	The number of primitives inside this set. (= number of child elements -1)

Example:

Height

This is the height of the Nozzle origin on it’s parent Equipment, measured from the origin of the Equipment.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The height value
Units	N	This may be any of the distance units permitted. See Units for permitted values and semantics if not present.

Example:

History

This is provided to contain an audit trail of the changes to an item.

Child elements:

Element Name	Cardinality	Description
Transaction	0..*	An entry in the audit trail

Attributes:

Attribute Name	Required	Description
NumTransactions	Y	The number of Transaction child elements

Example:

Identifier

This element is used to capture the structure of an identifier such as a Tag. Not usually used.

Child elements:

Element Name	Cardinality	Description
IdentifierElement	0..*	A structural component of an identifier.

Attributes:

Attribute Name	Required	Description
Purpose	N	A string describing the purpose of this element.

Example:

IdentifierElement

A structural element describing part of the structure of an identifier.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Name	Y	The name of this part of the identifier
Value	N	Only required if dependantAttribute is not provided.
ItemID	N	Only required if an attribute is referenced on another item.
DependantAttribute	N	References an attribute from which this part of the identifier is derived. See Textfor a description of how this attribute is defined.

Example:

InsideDiameter

This is the internal bore for an item at its source end.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The bore size
Units	N	This may be any of the distance units permitted. See Units for permitted values and semantics if not present.

Example:

InstrumentLoop

A collection of related instruments. This element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents. Inline instruments are associated to instrument loops by using the Association element.

Child elements:

Element Name	Cardinality	Description
ProcessInstrument	0..*	An off-line instrument that is part of this set.
SignalLine	0..*
SignalConnectorSymbol	0..*
Connection	0..*

Attributes:

See ‘PlantItem’, no additional attributes are defined.

Example:

KnotMultiplicities

Child elements:

Element Name	Cardinality	Description
Multiplicity	1..*

Attributes:

None

Example:

Knot

This is defined as an any but should be considered to be of type xsd:integer.

Child elements:

None

Attributes:

None

Example:

Knots

Child elements:

Element Name	Cardinality	Description
Knot	1..*

Line

A linear geometry defined by two points.

Child elements:

Element Name	Cardinality	Description
Presentation	1	This defines the drawing style to be used for the ellipse.
Extent	1	The minimum bounding geometry of the geometric contents of the Drawing element and its descendants.
Coordinate	2	The coordinates defining the start and end of the line.
GenericAttributes	0..*	A geometric primitive

Attributes:

None

Example:

Location

A Location element matches the definition of a Coordinated, it is a Tuple of ordinates denoting a location in the drawing plane. For 2D drawings the Z ordinates should always be 0.

Child elements:

None

Attributes:

Attribute Name	Required	Description
X	Y	The X Axis ordinate as a double
Y	Y	The Y Axis ordinate as a double
Z	N	The Z Axis ordinate as a double, If not present this defaults to 0.0

Example:

Manufacturer

The manufacturer responsible for producing the item.

Child elements:

None

Attributes:

None

Example:

Material

The name of the Material used to construct the item.

Child elements:

None

Attributes:

None

Example:

MaterialDescription

A description of the material relating to an item.

Child elements:

None

Attributes:

None

Example:

Max

Maximum coordinates for an Extent element.

Child elements:

None

Attributes:

Attribute Name	Required	Description
X	Y	X axis value denoting the maximum X value for all geometric descendants of ../..
Y	Y	Y axis value denoting the maximum Y value for all geometric descendants of ../..
Z	Y	Z axis value denoting the maximum Z value for all geometric descendants of ../.. For 2D drawings this should always be 0

Attribute Name

Required

Description

X axis value denoting the maximum X value for all geometric descendants of ../..

Y axis value denoting the maximum Y value for all geometric descendants of ../..

Z axis value denoting the maximum Z value for all geometric descendants of ../..

For 2D drawings this should always be 0

Example:

MaximumDesignPressure

The maximum design pressure for an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The maximum design pressure
Units	N	This may be any of the pressure units permitted. See Units for permitted values and semantics if not present.

Example:

MaximumDesignTemperature

The maximum design temperature for an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The maximum design temperature
Units	N	This may be any of the temperature units permitted. See Units for permitted values and semantics if not present.

Example:

MaximumOperatingPressure

The maximum operating pressure for an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The maximum pressure
Units	N	This may be any of the pressure units permitted. See Units for permitted values and semantics if not present.

Example:

MaximumOperatingTemperature

The maximum operating temperature for an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The maximum temperature
Units	N	This may be any of the temperature units permitted. See Units for permitted values and semantics if not present.

Example:

Min

Child elements:

None

Attributes:

Attribute Name	Required	Description
X	Y	X axis value denoting the minimum X value for all geometric descendants of ../… This is a double
Y	Y	Y axis value denoting the minimum Y value for all geometric descendants of ../.. This is a double
Z	Y	Z axis value denoting the minimum Z value for all geometric descendants of ../.. This is a double. For 2D drawings this should always be 0.

Attribute Name

Required

Description

X axis value denoting the minimum X value for all geometric descendants of ../… This is a double

Y axis value denoting the minimum Y value for all geometric descendants of ../.. This is a double

Z axis value denoting the minimum Z value for all geometric descendants of ../.. This is a double.

For 2D drawings this should always be 0.

Example:

MinimumDesignPressure

This is the minimum design pressure for an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The minimum design pressure as a double.
Units	N	This may be any of the pressure units permitted. See Units for permitted values and semantics if not present.

Example:

MinimumDesignTemperature

This is the minimum design temperature for an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The minimum design temperature as a double.
Units	N	This may be any of the temperature units permitted. See Units for permitted values and semantics if not present.

Example:

MinimumOperatingPressure

This is the minimum operating pressure for an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The minimum pressure as a double.
Units	N	This may be any of the pressure units permitted. See Units for permitted values and semantics if not present.

Example:

MinimumOperatingTemperature

This is the minimum operating temperature for an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The minimum temperature as a double.
Units	N	This may be any of the temperature units permitted. See Units for permitted values and semantics if not present.

Example:

ModelNumber

String element detailing the model number for a component.

Child elements:

None

Attributes:

None

Example:

Multiplicity

This is defined as an any but should be considered to be of type xsd:integer.

Child elements:

None

Attributes:

None

Example:

NominalDiameter

This is the internal bore for an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The bore size as a double
Units	N	This may be any of the distance units permitted. See Units for permitted values and semantics if not present.

Example:

NormalDesignPressure

Design pressure of an item under normal conditions.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The pressure value as a double
Units	N	This may be any of the pressure units permitted. See Units for permitted values and semantics if not present.

Example:

NormalDesignTemperature

Design temperature of an item under normal conditions.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The temperature value as a double
Units	N	This may be any of the temperature units permitted. See Units for permitted values and semantics if not present.

Example:

NormalOperatingPressure

Operating pressure of an item under normal conditions.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The pressure value as a double
Units	N	This may be any of the pressure units permitted. See Units for permitted values and semantics if not present.

Example:

NormalOperatingTemperature

Operating temperature of an item under normal conditions

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The temperature value as a double
Units	N	This may be any of the temperature units permitted. See Units for permitted values and semantics if not present.

Example:

Nozzle

A Nozzle element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

Element Name	Cardinality	Description
NozzleType	0..1
NominalDiameter	0..1	Internal nominal bore of nozzle
Height	0..1	Height of Nozzle on the Equipment

Attributes:

See ‘PlantItem’, no additional attributes

Example:

NozzleType

This is a simple element with one attribute and no contents.

Child elements:

None

Attributes:

Attribute Name

Required

Description

Value

One of ‘Welded’, ‘Flanged’ or ‘Elbow’.

This defaults to ‘Flanged’ if the Value attribute isn’t present.

Example:

OperatorType

This is a free form string element that may be unit qualified.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Units	N	This may contain any of the permitted units types See Units.

Example:

None

OutsideDiameter

This is the external diameter of an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The external diameter measurement as a double
Units	N	This may be any of the distance units permitted. See Units for permitted values and semantics if not present.

Example:

PConnectionPoints

See Issues.

PersistentID

The PersistentID element contains a source system identifier for an object that remains consistent between exports of a drawing. A PersistentID is made up of two components the identifier and its scope.

A PersistentID should be the same for an object that appears on multiple drawings where it is practicable to do this. If this cannot be achieved the T, if present, will be used by P&ID Manager for rationalising objects.

Child elements:

None

Attributes:

Attribute Name

Required

Description

Identifier

The persistent identifier for an XML element.

The Identifier must be unique within the set of XML files that may interact directly or indirectly with this drawing for the stated context.

This a free form string type, see Character encoding.

Context

This scopes a persistent identifier.

In this way an item may have different Identifiers for different systems/contexts and each identifier may be represented.

Ideally this would be encoded as a URI. for example, http://www.aveva.com/P&ID Designer/ProjectName.

Example:

PipeConnector

An on or off page connector that represents the connectivity of a PipingNetworkSegment across a page boundary. These are contained by the PipingNetworkSegment elements and reference as the segment source or destination.

A PipeConnector element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

Element Name	Cardinality	Description
CrossPageConnection	0..1	Information describing the matching criteria for the PipeConnector that is connected to this one.

Attributes:

See ‘PlantItem’, no Additional attributes

Example:

PipeFlowArrow

This element is an annotation primitive to represent the direction of flow of a PipingNetworkSegment.

A PipeFlowArrow element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

See ‘PlantItem’, no additional elements

Attributes:

See ‘PlantItem’, no additional attributes

Example:

PipingNetworkSystem

A PipingNetworkSystem contains the information for a physical PipingNetworkSystem in the plant or a section thereof as contained within a module. The PipingNetworkSystem contains all of the PlantItems that belong to it. A PipingNetworkSystem may have multiple sources and multiple destinations.'

A PipingNetworkSystem element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

Element Name	Cardinality	Description
NominalDiameter	0..1
InsideDiameter	0..1
OutsideDiameter	0..1
StartDiameter	0..1
EndDiameter	0..1
NormalDesignPressure	0..1
MinimumDesignPressure	0..1
MaximumDesignPressure	0..1
NormalDesignTemperature	0..1
MinimumDesignTemperature	0..1
MaximumDesignTemperature	0..1
NormalOperatingPressure	0..1
MinimumOperatingPressure	0..1
MaximumOperatingPressure	0..1
TestPressure	0..1
NormalOperatingTemperature	0..1
MiniumumOperatingTemperature	0..1
MaximumOperatingTemperature	0..1
WallThickness	0..1
Connection	0..*	Not used as connectivity should be represented by each contained PipingNetworkSegment.
PipingNetworkSegment	0..*	The segments that make up the PipingNetworkSystem
SpecificationBreak	0..*	Points at which changes occur in the pipe specification. This causes a break in the segment.

Attributes:

See ‘PlantItem’, no additional attributes

Example:

PipingComponent

This represents a physical component that is common to piping systems.

A PipingComponent element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

Element Name	Cardinality	Description
PipingComponent	0..*	Contained PipingComponent.
ConnectionType	0..1
NominalDiameter	0..1
InsideDiameter	0..1
None Outside Diameter	0..1
OperatorType	0..1
WallThickness	0..1
FabricationCategory	0..1

Attributes:

Attribute Name	Required	Description
ConnectionType	N	This is a free text string and has no defined syntax. See Character encoding
Rating	N	This is a free text string and has no defined syntax. See Character encoding
Standard	N	This is a free text string and has no defined syntax. See Character encoding
ISOSymbol	N	This is a free text string and has no defined syntax. See Character encoding

Example:

PipingNetworkSegment

A PipingNetworkSegment is a subsection of a PipingNetworkSystem where the engineering parameters are common. A PipingNetworkSegment will start at a Nozzle, SpecificationBreak or the downstream end of a Reducer or Tee and end at a Nozzle, SpecificationBreak, Reducer, Tee or an open pipe. For a P&ID it can also start or end with a PipeConnector. It will contain one or more CenterLine, PipingComponent, Equipment and ProcessInstrument elements. For a P&ID it is the CenterLines that join the successive components together and these should be considered in the same way as the other symbols and all must occur in the order head to tail.

A PipingNetworkSegment element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

PipeConnectors representing on and off page connectivity are contained by the PipingNetworkSegment. See for details of PipingNetworkSegment connectivity.

Child Elements:

Element Name	Cardinality	Description
NominalDiameter	0..1
InsideDiameter	0..1
None Outside Diameter	0..1
StartDiameter	0..1
EndDiameter	0..1
NormalDesignPressure	0..1
MinimumDesignPressure	0..1
MaximumDesignPressure	0..1
NormalDesignTemperature	0..1
MinimumDesignTemperature	0..1
MaximumDesignTemperature	0..1
NormalOperatingPressure	0..1
MinimumOperatingPressure	0..1
MaximumOperatingPressure	0..1
TestPressure	0..1
NormalOperatingTemperature	0..1
MinimumOperating Temperature	0..1
MaximumOperatingTemperature	0..1
WallThickness	0..1
Connection	0..*	This states the head and tail connectivity of this segment.
PipingNetworkSegment	0..*	The segments that make up the PipingNetworkSystem
SpecificationBreak	0..*	Points at which changes occur in the pipe specification. This causes a break in the segment.
CenterLine	0..*
Equipment	0..*
PipingComponent	0..*
ProcessInstrument	0..*
PipeConnector	0..*
PipeFlowArrow	0..*

Attributes:

See ‘PlantItem’, no additional attributes

Example:

PlantArea

In the P&ID content of an XML file this is just an object that may be used to represent the name and attributes of named part(area) of a plant. A plant Area is not permitted to contain model elements but may be referenced to associated segments, Equipment etc with a named PlantArea.

A PlantArea element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

See ‘PlantItem’, no additional elements

Attributes:

Attribute Name	Required	Description
Name	N	A string representing the name of the area. See Character encoding.

Example:

PlantInformation

This element collects the metadata for a PlantModel. The Date and Time attributes should be the Date and Time of the XML file creation.

Child elements:

Element Name	Cardinality	Description
UnitsOfMeasure	1	Defines the default units of measure for the file.

Attributes:

Attribute Name	Required	Description
SchemaVersion	Y	Fixed value of ‘3.1.2’
OriginatingSystem	Y	Free form string. See Character encoding
ModelName	N	Free form string. See Character encoding
Date	Y	XML date of the format YYYY-MM-DD
ProjectName	N	Free form string. See Character encoding
ProjectCode	N	Free form string. See Character encoding
ProjectDescription	N	Free form string. See Character encoding
CompanyName	N	Free form string. See Character encoding
Time	Y	XML time type, assumed UTC unless zone qualified
Is3D	Y	Fixed value of ‘no’
Units	Y	The distance units of measure for the geometry in the file.
Discipline	Y	Fixed value of ‘PID’

Example:

PlantItem

This element is a base abstract type of many elements within an XML file, it defines the common elements and attributes for these items.

Child elements:

Element Name	Cardinality	Description
Presentation	0..1
Extent	1
PersistentID	0..*
Position	1
Scale	0..1
Surface	0..*
Circle	0..*
CompositeCurve	0..*
Ellipse	0..*
Line	0..*
Polyline	0..*
Shape	0..*
TrimmedCurve	0..*
BsplineCurve	0..*
GeometricPrimitives	0..*
ConnectionPoints	0..1
PConnectionPoints	0..1
Text	0..*
Identifier	0..*
Description	0..1
Weight	0..1
Material	0..1
MaterialDescription	0..1
ModelNumber	0..1
Supplier	0..1
Manufacturer	0..1
GenericAttributes	0..*
Association	0..*
History	0..1

Attributes:

Attribute Name	Required	Description
ID	Y	The sequential ID if the item in the file. Of the form ‘XMP_nnn’ where n is the sequential number as an integer. E.g. XMP_22. See ID
Tag	N	See Tag
Specification	N	See Specification
StockNumber	N	See StockNumber
ComponentClass	N	See ComponentClass
ComponentName	N	See ComponentName
ComponentType	N	See ComponentType
Revision	N	See Revision
Status	N	See Status

Example:

N/A since the type is abstract

Point

A geometric primitive representing a one dimensional geometry.

Child elements:

Element Name	Cardinality	Description
Presentation	1	The style used to draw the point.
Location	1	The point coordinate
GenericAttributes	0..*	Any application attributes for this point

Attributes:

Attribute Name

Required

Description

IsVisible

Valid values: ‘true’, ‘false’, ‘1’ or ‘0’.

Set to ‘false’ or ‘0’ if this point should not be drawn.

Example:

PolyLine

Geometric curve primitive detailing a polyline. The interpolation between each coordinate is linear.

Child elements:

Element Name	Cardinality	Description
Presentation	0..1	The style to use when drawing the line. The drawing behaviour is undefined if the Presentation element is missing.
Extent	1	The minimum bounding geometry of the element and its descendants
Coordinate	1..*	The coordinates defining the line primitive

Attributes:

Attribute Name	Required	Description
NumPoints	Y	The number of child Coordinate elements.

Example:

Position

This defines the place where an items origin is on a P&ID drawing. This is in effect the location of the items symbol. The Axis and Reference attributes are used to define the coordinate orientation in 3D space. The drawing is considered to be on the plane of Z=0.

Child elements:

Attributes:

None

Example:

Presentation

The element defines a styles used to draw geometric and textual content. While all attributes are defined as optional in the schema the R, G, B, LineWeight and LineType attributes are expected for all geometric primitives, otherwise the behaviour is undefined.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Layer	N	Name of the layer in which the graphical elements resides. This has no functional semantics associated with it.
Color	N	A lookup in a color index. This isn’t to be used for P&ID Manager P&ID files.
LineType	N	One of the numbers or names from the following (Object Model document v2.2):- 0 Solid 1 Dotted 2 Dashed 3 Long Dash 4 Long Dash + Short Dash, CenterLine 5 Short Dash 6 Long Dash + Short Dash + Short Dash 7 Dash + Short Dash
LineWeight	N	<real> or <real><units> or <real><space><units> Where:- <real> is an real value. <space> is a space character () <units> is a distance units from Units If the value isn’t qualified with units then the behaviour is undefined.
R	N	0 to 1 (double) 1 = maximum intensity of Red component.
G	N	0 to 1 (double) 1 = maximum intensity of Green component.
B	N	0 to 1 (double) 1 = maximum intensity of blue component.

Example:

ProcessInstrument

This represents a physical instrument that is common to piping systems.

A ProcessInstrument element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

Element Name	Cardinality	Description
PlantItem	0..*	Contained PipingComponent.
NominalDiameter	0..1
InsideDiameter	0..1
None Outside Diameter	0..1
OperatorType	0..1
WallThickness	0..1

Attributes:

See ‘PlantItem’, no additional attributes

Example:

Rating

This is a unit qualified string value to describe the rating of an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	Maximum safe load
Units	N	This may be any of the units permitted since the type of measurement isn’t specified. See Units for permitted values, the semantics if Units are not present are unclear.

Example:

Reference

See Geometries (Axis and Reference).

Child elements:

None

Attributes:

Attribute Name	Required	Description
X	Y	Double
Y	Y	Double
Z	Y	Double

Example:

Remark

A string comment element

Child elements:

None

Attributes:

None

Example:

Scale

The scale element is used when symbols are drawn from a shape catalogue. The Scale element enables symbols to be rescaled when positioned in a drawing.

Child elements:

None

Attributes:

Attribute Name	Required	Description
X	Y	X scale factor
Y	Y	Y scale factor
Z	N	Z scale factor

Example:

Shape

The Shape element defines a closed curve. The interpolation between each coordinate is linear.

Child elements:

Element Name	Cardinality	Description
Presentation	0..1	The style to use when drawing the line. The drawing behaviour is undefined if the Presentation element is missing.
Extent	1	The minimum bounding geometry of the element and its descendants
Coordinate	4..*	The coordinates defining the primitive. The first coordinate should match the last to complete a closed form.
GenericAttributes	0..*	Any application specific attributes

Attributes:

Attribute Name	Required	Description
NumPoints	Y	The number of child Coordinate elements.
Filled	N	One of ‘Solid’ or ‘Hatch’ used to specify a fill technique

Example:

ShapeCatalogue

A Shape Catalogue defines a symbol library for a file. The elements for which the symbols can be defined are currently limited to Equipment and PipingComponent elements only.

See ComponentName for how to reference and name a symbol in the catalogue.

See Scale for how to scale symbols when drawn.

Child elements:

Element Name	Cardinality	Description
Equipment	0..*	Equipment symbols
PipingComponent	0..*	PipingComponent symbols
Nozzle	0..*	Nozzle symbols
ProcessInstrument	0..*	ProcessInstrument symbols
Component	0..*	Component symbols
PipeConnector	0..*	PipeConnector symbols
SignalConnectorSymbol	0..*	SignalConnector symbols

Attributes:

Attribute Name	Required	Description
Name	Y	The name of the symbol catalogue, this is a string attribute.
Version	N	The version of the symbol set.
Units	N	The distance units that the symbols are defined in. This affects the size of the symbol with respect to the units defined by the PlantInformation/UnitsOfMeasure/@Distance attribute. i.e if Units is different to the PlantInformation default then the symbol is scaled. See the distance section of Units for valid values.
Date	N	The date the symbol library was created/modified.

Example:

For further details of shape catalogues refer to Shape Catalogues for the ISO15926 Interface.

SignalConnectorSymbol

An on or off page connector that represents the connectivity of a SignalLine across a page boundary.

A SignalConnectorSymbol element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

Element Name	Cardinality	Description
CrossPageConnection	0..1	Information describing the matching criteria for the SignalConnector that is connected to this one.

Attributes:

See ‘PlantItem’, no additional attributes

Example:

SignalLine

A connection between two instruments carrying instrumentation signals.

A SignalLine element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

Child elements:

Element Name	Cardinality	Description
CenterLine	0..*	The graphical representation of the connectivity.
ProcessInstrument	0..*	Instruments contained in this signal line.
Connection	0..1	The connectivity details of this SignalLine
SignalConnectorSymbol	0..*	An off/on page connector for signal lines.

Attributes:

See ‘PlantItem’, no additional attributes

Example:

SpecificationBreak

This represents the point at which there is a change in specification of the piping. See Issues.

A SpecificationBreak element inherits elements and attributes from the base type ‘PlantItem’. See ‘PlantItem’ for the definitions of the inherited contents.

A SpecificationBreak may only be contained by a PipingNetworkSystem element.

Child elements :

(See ‘PlantItem’) No Additional elements

Attributes :

(See ‘PlantItem’) No Additional attributes

Example:

StartDiameter

This is the internal bore for a segment or a PipingNetworkSystem at its source.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The bore size
Units	N	This may be any of the distance units permitted. See Units for permitted values and semantics if not present.

Example:

String

A string value used to annotate a drawing. Each element represents a single line of text.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The string value
Units	N	Any units associated with the string value, not sure how to use this.

Example:

Supplier

This is the name of the supplier for an item.

Child elements:

None

Attributes:

None

Example:

Surface

See Issues.

TestPressure

The pressure that should be used to test an item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	Y	The pressure
Units	N	This may be any of the pressure units permitted. See Units for permitted values and semantics if not present.

Example:

Text

This defines the textual annotation for a drawing. The text may be provided in an attribute, referenced using attributes on this item, referenced on attributes of another item or provided as a set of String elements.

Child elements:

Element Name	Cardinality	Description
Presentation	1	The style to use to draw the text.
Extent	1	The minimum bounding rectangle around the text.
Position	1	The position of the text
String	0..*	Used when the text contains a line break.
GenericAttributes	0..*	Any application specific attributes, this could include attributes that contain the text content to write.

Attributes:

Attribute Name	Required	Description
NumLines	N	The number of text lines being represented. If not present then a value of 1 is assumed.
String	N	If present this is the text to be drawn. If the text contains a line break then it should be split into the String child elements instead of being in the attribute or the line break character replaced with an appropriate character reference.
Font	Y	The font family name to use.
Justification		The location of Position within the Text to be written. Where the text is on multiple lines then Justification denotes the location of Position for the first line of text. One of the following: LeftTop LeftCenter LeftBottom CenterTop CenterCenter CenterBottom RightTop RightCenter RightBottom Defaults to LeftBottom if not provided.
Width	Y	The full width of the Text string once rendered
Height	Y	The full height of the Text string once rendered
TextAngle		This is the angle that the base line of the text string makes with the positive X axis measured anticlockwise in degrees.
SlantAngle		This is the angle, in degrees, of slant of the text characters measured clockwise from the positive Y axis. E.g. for the character I it is the angle that the vertical stroke makes with the positive Y axis.
ItemID		If provided then the text string is to be constructed from the attributes of another element The ID may be provided as the ID of the element, the PersistentID/@Identifier or the Tag of the element. See Tag Referencing.
Set		If the text is to be obtained from a child of a GenericAttributes element then the set name for the GenericAttributes element may be provided to avoid ambiguity.
DependantAttribute		The template for the textual contents if obtaining the text from referenced attributes. The value of the DependantAttribute can contain a single attribute or a list of Attributes and explicit text. IF a single attribute is referenced it may appear just as the attribute name. Where multiple attributes or explicit text is used the attribute names are contained in square brackets. E.g "[Tagprefix]-[Tagnumber][Tagsuffix]". The search order will be the Attributes of the PlantItem, ItemAttributes then GenericAttributes of the Text followed by the GenericAttributes of the parent or the object explicitly identified by the ItemID. The first occurrence of the named Attribute will be used, there is no mechanism for handling multiple attributes of the same name.

Example:

Transaction

A record of a change to an item.

Child elements:

Element Name	Cardinality	Description
Remark	0..*	A comment describing the change.
GenericAttributes	0..*	Any application specific attributes

Attributes:

Attribute Name	Required	Description
Type	N	One of the following; to approve to check to copy to create to modify to request to release
Date	N	A date type (YYYY-MM-DD)
Time	N	A time type (HH:MM:SS)
CompanyName	N	A free form string (see Character encoding)
Person	N	A free form string (see Character encoding)

Example:

TrimmedCurve

An arc based on a circle or ellipse definition.

Child elements:

Element Name	Cardinality	Description
Circle	0..1	Only present if Ellipse isn’t present. The base Circle used to define the arc.
Ellipse	0..1	Only present if Circle isn’t present. The base ellipse used to define the arc.
GenericAttributes	0..*	Any application specific attributes

Attributes:

Attribute Name

Required

Description

StartAngle

The rotation around the circle/ellipse to start the arc from. 0 = up.

The direction of the rotation is governed by the Z axis specifier on the geometry.

Angle specified in degrees (0-360).

EndAngle

The rotation around the circle/ellipse to end the arc at 0 = up.

The direction of the rotation is governed by the Z axis specifier on the geometry.

Angle specified in degrees (0-360).

Example:

UnitsOfMeasure

This element specifies the default units of measure for the file for each type of measured value.

Child Elements:

None

Attributes:

Attribute Name	Required	Description
Distance	N	See Units for permitted distance values. Default value is ‘Millimetre’.
Angle	N	See Units for permitted angle values. Default value is ‘Degree’.
Temperature	N	See Units for permitted temperature values. Default value is ‘DegreeCelsius’.
Pressure	N	See Units for permitted pressure values. Default value is ‘Bar’.
Weight	N	See Units for permitted weight values. Default value is ‘Kilogram’.

Example:

WallThickness

The thickness of the element construction.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	N	The thickness value. Nb this is a string type and so could be represented in many ways.
Units	N	The units of measure (See Units for permitted values). If not present then this defaults to the units specified by PlantInformation/UnitsOfMeasure.

Example:

Weight

The weight of the item.

Child elements:

None

Attributes:

Attribute Name	Required	Description
Value	N	The weight value.
Units	N	The units of measure (See Units for permitted values). If not present then this defaults to the units specified by PlantInformation/UnitsOfMeasure.

Example:

WeightsData

Child elements:

Element Name	Cardinality	Description
ControlPointWeight	0..*

Attributes:

None

Example: