(dpar-ms-set-nozzle "<nozzle tag>" nil nil '<element name> '<face> 
<dimension 1> <dimension 2> ['<rotation> <input flange diameter> 
<input length> "<location-type>" '<frozen> '<type> <x-ordinate>
<y-ordinate> <z-ordinate> '(<orientation-vector-components>)])

where:

<nozzle tag> ::= <string>

• Uniquely identifies the nozzle, consisting of the equipment tag and nozzle name separated by a slash; e.g., "80-T-100/A".

nil

• The spaces occupied by the two nil entries are hold overs from older versions of PlantWise and are maintained for backward compatibility.

<element name> ::= <string>

• The name of the equipment element on which the nozzle is to be placed; e.g., SHELL or GENERATOR; the list of available elements is dependent on the geometry of the equipment.

<face> ::= <string>

• The name of the face (in local element coordinates) of the equipment element on which the element is to be place; for cylinders, the choices are TOP, BOTTOM, and BODY (for the curved surface); for boxes the choices are TOP, BOTTOM, FRONT, BACK, LEFT, and RIGHT; for elliptical-heads, the choice is BOTTOM.

<dimension 1> ::= <real>

• For a box element, this is the distance along the u-axis; for the body of a cylinder element, this is the distance along the cylinder's main axis; for the top or bottom of a cylinder or head, it's the radius from the center.

<dimension 2> ::= <real>

• For a box element, this is the distance along the v-axis; for a cylinder or head element, this is the angle in from the local x-axis as defined by a right-hand coordinate system (NOT the user coordinate system used in the dialog).

[OPTIONAL] <rotation> ::= <axis> <real>

• Also a hold over from previous PlantWise versions, you need not write values for this rotation entry. PlantWise will, however, write values to this attribute.

[OPTIONAL] <flange diameter> ::= <real>

• The diameter of the flange if the default table lookup value is overridden; should be in project main units; may be NIL if the default value is not to be overridden.

[OPTIONAL] <input length> ::= <real>

• The length of the nozzle if the project default length is to be overridden; may be NIL.

[OPTIONAL] <frozen> ::= FROZEN | NIL

• If the nozzle is not to be relocated by nozzle placement rules, this value is set to FROZEN.

[OPTIONAL] <type> ::= <string> | NIL

• The nozzle type; may be NIL.

[OPTIONAL] <x-ordinate> ::= <real> | NIL

• If the nozzle is being placed by local or global coordinates, the x-ordinate value MUST be provided. When placing the nozzle on element, this value is NIL.

[OPTIONAL] <y-ordinate> ::= <real> | NIL

• If the nozzle is being placed by local or global coordinates, the y-ordinate value MUST be provided. When placing the nozzle on element, this value is NIL.

[OPTIONAL] <z-ordinate> ::= <real> | NIL

• If the nozzle is being placed by local or global coordinates, the z-ordinate value MUST be provided. When placing the nozzle on element, this value is NIL.

[OPTIONAL] <location-type> ::= on-element | local-coordinates |
	global-coordinates

• Only when placing the nozzle on an element face is this attribute optional.
• For local-coordinates, ordinate values are with respect to the equipment’s placement point.
• For global-coordinates, ordinate values are with respect to the global axes.

[OPTIONAL] <orientation-vector-components> ::= <real> <real> <real>

• This set of components sets the direction the nozzle is pointing.
• - For placement on element, Z is the element face’s outward normal.
• - For placement by local coordinates, this is relative to the equipment’s orientation.
• - For placement by global coordinates, this is relative to the global axes.

(dpar-ms-set-nozzle "80-T-100/Fred" nil nil 'TANK 'BODY 198.0 180.0
'((:Z 0.0) (:Y 0.0) (:X 0.0)) 13.5 6.0 "on-element" NIL 'INLET
NIL NIL NIL '(0.0 0.0 1.0))

(dpar-ms-set-nozzle "80-T-100/Fred" nil nil 'NIL 'NIL NIL NIL
'((:Z 0.0) (:Y 0.0) (:X 90.0)) 13.5 6.0 "local-coordinates"
NIL 'INLET 0.0 -89.0 198.0 '(0.0 -1.0 0.0))

(dpar-ms-set-nozzle "80-T-100/Fred" nil nil 'NIL 'NIL NIL NIL
'((:Z 0.0) (:Y 0.0) (:X 90.0) (:X 0.0)) 13.5 6.0
"global-coordinates" NIL 'INLET 2315.0 2617.0 1458.0
'(0.0 -1.0 0.0))