The :sp:element:`~Core.Diagram.MetaData` of the :sp:element:`~Core.ConceptualModel`. The :sp:element:`Notes <Core.Note>` of the :sp:element:`~Core.ConceptualModel`. The :sp:element:`Roles <Core.Role>` of the :sp:element:`~Core.ConceptualModel`. The conceptual content of an :sp:element:`~Core.EngineeringModel`, i.e., engineering information independent from its graphical representation. The roles performed by the :sp:element:`~Core.ConceptualObject`. The PersistentIdentifiers of the :sp:element:`~Core.ConceptualObject`. The :sp:element:`Notes <Core.Note>` about the :sp:element:`~Core.ConceptualObject`. The abstract base class of all classes used in a :sp:element:`~Core.ConceptualModel`. Language-dependent values of the :sp:element:`~Core.DataTypes.MultiLanguageString`. A container for one or more :sp:element:`~Core.DataTypes.SingleLanguageString`'s. :sp:element:`!~Core.DataTypes.MultiLanguageString` is used as the type of data attributes which have language-dependent string values. The value raises an alarm. The value that can be tolerated for an extended period. It has a specific meaning in safety specifications. The value is that used for design. It has a specific meaning in safety specifications. A value that is estimated and subject to uncertainty. The value that can be tolerated for a short period. It has a specific meaning in safety specifications. A value specified for operation. The value initiates a protective action. A value assigned by the manufacturer representing a specified operating condition. The value that will be set to test a system or piece of equipment. The value raises a warning. The language of the :sp:element:`~Core.DataTypes.SingleLanguageString.Value` of the :sp:element:`~Core.DataTypes.SingleLanguageString`. If not :sp:element:`~Builtin.Undefined`, the language must be given as a language tag standardized by IETF BCP 47 (Best Current Practice 47 by the Internet Engineering Task Force). IETF BCP 47 is based on ISO 639. Language tags ============= In DEXPI, only those language tags are allowed * that are listed in the normative registry file at `https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry <https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry>`__ from September 29, 2020, * that consist of exactly two letters (in particular extended tags such as *en-US* or *de-CH-1996* are not allowed), * that refer to an actual language (the *type* defined by IETF BCP 47 must be *language*), * and that are not deprecated. The table below contains all permitted language tags. +--------+------------------------------------------------------------------------------+ | Tag | Language | +========+==============================================================================+ | ``aa`` | Afar | +--------+------------------------------------------------------------------------------+ | ``ab`` | Abkhazian | +--------+------------------------------------------------------------------------------+ | ``ae`` | Avestan | +--------+------------------------------------------------------------------------------+ | ``af`` | Afrikaans | +--------+------------------------------------------------------------------------------+ | ``ak`` | Akan | +--------+------------------------------------------------------------------------------+ | ``am`` | Amharic | +--------+------------------------------------------------------------------------------+ | ``an`` | Aragonese | +--------+------------------------------------------------------------------------------+ | ``ar`` | Arabic | +--------+------------------------------------------------------------------------------+ | ``as`` | Assamese | +--------+------------------------------------------------------------------------------+ | ``av`` | Avaric | +--------+------------------------------------------------------------------------------+ | ``ay`` | Aymara | +--------+------------------------------------------------------------------------------+ | ``az`` | Azerbaijani | +--------+------------------------------------------------------------------------------+ | ``ba`` | Bashkir | +--------+------------------------------------------------------------------------------+ | ``be`` | Belarusian | +--------+------------------------------------------------------------------------------+ | ``bg`` | Bulgarian | +--------+------------------------------------------------------------------------------+ | ``bh`` | Bihari languages | +--------+------------------------------------------------------------------------------+ | ``bi`` | Bislama | +--------+------------------------------------------------------------------------------+ | ``bm`` | Bambara | +--------+------------------------------------------------------------------------------+ | ``bn`` | Bengali/Bangla | +--------+------------------------------------------------------------------------------+ | ``bo`` | Tibetan | +--------+------------------------------------------------------------------------------+ | ``br`` | Breton | +--------+------------------------------------------------------------------------------+ | ``bs`` | Bosnian | +--------+------------------------------------------------------------------------------+ | ``ca`` | Catalan/Valencian | +--------+------------------------------------------------------------------------------+ | ``ce`` | Chechen | +--------+------------------------------------------------------------------------------+ | ``ch`` | Chamorro | +--------+------------------------------------------------------------------------------+ | ``co`` | Corsican | +--------+------------------------------------------------------------------------------+ | ``cr`` | Cree | +--------+------------------------------------------------------------------------------+ | ``cs`` | Czech | +--------+------------------------------------------------------------------------------+ | ``cu`` | Church Slavic/Church Slavonic/Old Bulgarian/Old Church Slavonic/Old Slavonic | +--------+------------------------------------------------------------------------------+ | ``cv`` | Chuvash | +--------+------------------------------------------------------------------------------+ | ``cy`` | Welsh | +--------+------------------------------------------------------------------------------+ | ``da`` | Danish | +--------+------------------------------------------------------------------------------+ | ``de`` | German | +--------+------------------------------------------------------------------------------+ | ``dv`` | Dhivehi/Divehi/Maldivian | +--------+------------------------------------------------------------------------------+ | ``dz`` | Dzongkha | +--------+------------------------------------------------------------------------------+ | ``ee`` | Ewe | +--------+------------------------------------------------------------------------------+ | ``el`` | Modern Greek (1453-) | +--------+------------------------------------------------------------------------------+ | ``en`` | English | +--------+------------------------------------------------------------------------------+ | ``eo`` | Esperanto | +--------+------------------------------------------------------------------------------+ | ``es`` | Spanish/Castilian | +--------+------------------------------------------------------------------------------+ | ``et`` | Estonian | +--------+------------------------------------------------------------------------------+ | ``eu`` | Basque | +--------+------------------------------------------------------------------------------+ | ``fa`` | Persian | +--------+------------------------------------------------------------------------------+ | ``ff`` | Fulah | +--------+------------------------------------------------------------------------------+ | ``fi`` | Finnish | +--------+------------------------------------------------------------------------------+ | ``fj`` | Fijian | +--------+------------------------------------------------------------------------------+ | ``fo`` | Faroese | +--------+------------------------------------------------------------------------------+ | ``fr`` | French | +--------+------------------------------------------------------------------------------+ | ``fy`` | Western Frisian | +--------+------------------------------------------------------------------------------+ | ``ga`` | Irish | +--------+------------------------------------------------------------------------------+ | ``gd`` | Scottish Gaelic/Gaelic | +--------+------------------------------------------------------------------------------+ | ``gl`` | Galician | +--------+------------------------------------------------------------------------------+ | ``gn`` | Guarani | +--------+------------------------------------------------------------------------------+ | ``gu`` | Gujarati | +--------+------------------------------------------------------------------------------+ | ``gv`` | Manx | +--------+------------------------------------------------------------------------------+ | ``ha`` | Hausa | +--------+------------------------------------------------------------------------------+ | ``he`` | Hebrew | +--------+------------------------------------------------------------------------------+ | ``hi`` | Hindi | +--------+------------------------------------------------------------------------------+ | ``ho`` | Hiri Motu | +--------+------------------------------------------------------------------------------+ | ``hr`` | Croatian | +--------+------------------------------------------------------------------------------+ | ``ht`` | Haitian/Haitian Creole | +--------+------------------------------------------------------------------------------+ | ``hu`` | Hungarian | +--------+------------------------------------------------------------------------------+ | ``hy`` | Armenian | +--------+------------------------------------------------------------------------------+ | ``hz`` | Herero | +--------+------------------------------------------------------------------------------+ | ``ia`` | Interlingua (International Auxiliary Language Association) | +--------+------------------------------------------------------------------------------+ | ``id`` | Indonesian | +--------+------------------------------------------------------------------------------+ | ``ie`` | Interlingue/Occidental | +--------+------------------------------------------------------------------------------+ | ``ig`` | Igbo | +--------+------------------------------------------------------------------------------+ | ``ii`` | Sichuan Yi/Nuosu | +--------+------------------------------------------------------------------------------+ | ``ik`` | Inupiaq | +--------+------------------------------------------------------------------------------+ | ``io`` | Ido | +--------+------------------------------------------------------------------------------+ | ``is`` | Icelandic | +--------+------------------------------------------------------------------------------+ | ``it`` | Italian | +--------+------------------------------------------------------------------------------+ | ``iu`` | Inuktitut | +--------+------------------------------------------------------------------------------+ | ``ja`` | Japanese | +--------+------------------------------------------------------------------------------+ | ``jv`` | Javanese | +--------+------------------------------------------------------------------------------+ | ``ka`` | Georgian | +--------+------------------------------------------------------------------------------+ | ``kg`` | Kongo | +--------+------------------------------------------------------------------------------+ | ``ki`` | Kikuyu/Gikuyu | +--------+------------------------------------------------------------------------------+ | ``kj`` | Kuanyama/Kwanyama | +--------+------------------------------------------------------------------------------+ | ``kk`` | Kazakh | +--------+------------------------------------------------------------------------------+ | ``kl`` | Kalaallisut/Greenlandic | +--------+------------------------------------------------------------------------------+ | ``km`` | Khmer/Central Khmer | +--------+------------------------------------------------------------------------------+ | ``kn`` | Kannada | +--------+------------------------------------------------------------------------------+ | ``ko`` | Korean | +--------+------------------------------------------------------------------------------+ | ``kr`` | Kanuri | +--------+------------------------------------------------------------------------------+ | ``ks`` | Kashmiri | +--------+------------------------------------------------------------------------------+ | ``ku`` | Kurdish | +--------+------------------------------------------------------------------------------+ | ``kv`` | Komi | +--------+------------------------------------------------------------------------------+ | ``kw`` | Cornish | +--------+------------------------------------------------------------------------------+ | ``ky`` | Kirghiz/Kyrgyz | +--------+------------------------------------------------------------------------------+ | ``la`` | Latin | +--------+------------------------------------------------------------------------------+ | ``lb`` | Luxembourgish/Letzeburgesch | +--------+------------------------------------------------------------------------------+ | ``lg`` | Ganda/Luganda | +--------+------------------------------------------------------------------------------+ | ``li`` | Limburgan/Limburger/Limburgish | +--------+------------------------------------------------------------------------------+ | ``ln`` | Lingala | +--------+------------------------------------------------------------------------------+ | ``lo`` | Lao | +--------+------------------------------------------------------------------------------+ | ``lt`` | Lithuanian | +--------+------------------------------------------------------------------------------+ | ``lu`` | Luba-Katanga | +--------+------------------------------------------------------------------------------+ | ``lv`` | Latvian | +--------+------------------------------------------------------------------------------+ | ``mg`` | Malagasy | +--------+------------------------------------------------------------------------------+ | ``mh`` | Marshallese | +--------+------------------------------------------------------------------------------+ | ``mi`` | Maori | +--------+------------------------------------------------------------------------------+ | ``mk`` | Macedonian | +--------+------------------------------------------------------------------------------+ | ``ml`` | Malayalam | +--------+------------------------------------------------------------------------------+ | ``mn`` | Mongolian | +--------+------------------------------------------------------------------------------+ | ``mr`` | Marathi | +--------+------------------------------------------------------------------------------+ | ``ms`` | Malay (macrolanguage) | +--------+------------------------------------------------------------------------------+ | ``mt`` | Maltese | +--------+------------------------------------------------------------------------------+ | ``my`` | Burmese | +--------+------------------------------------------------------------------------------+ | ``na`` | Nauru | +--------+------------------------------------------------------------------------------+ | ``nb`` | Norwegian Bokmål | +--------+------------------------------------------------------------------------------+ | ``nd`` | North Ndebele | +--------+------------------------------------------------------------------------------+ | ``ne`` | Nepali (macrolanguage) | +--------+------------------------------------------------------------------------------+ | ``ng`` | Ndonga | +--------+------------------------------------------------------------------------------+ | ``nl`` | Dutch/Flemish | +--------+------------------------------------------------------------------------------+ | ``nn`` | Norwegian Nynorsk | +--------+------------------------------------------------------------------------------+ | ``no`` | Norwegian | +--------+------------------------------------------------------------------------------+ | ``nr`` | South Ndebele | +--------+------------------------------------------------------------------------------+ | ``nv`` | Navajo/Navaho | +--------+------------------------------------------------------------------------------+ | ``ny`` | Nyanja/Chewa/Chichewa | +--------+------------------------------------------------------------------------------+ | ``oc`` | Occitan (post 1500) | +--------+------------------------------------------------------------------------------+ | ``oj`` | Ojibwa | +--------+------------------------------------------------------------------------------+ | ``om`` | Oromo | +--------+------------------------------------------------------------------------------+ | ``or`` | Oriya (macrolanguage)/Odia (macrolanguage) | +--------+------------------------------------------------------------------------------+ | ``os`` | Ossetian/Ossetic | +--------+------------------------------------------------------------------------------+ | ``pa`` | Panjabi/Punjabi | +--------+------------------------------------------------------------------------------+ | ``pi`` | Pali | +--------+------------------------------------------------------------------------------+ | ``pl`` | Polish | +--------+------------------------------------------------------------------------------+ | ``ps`` | Pushto/Pashto | +--------+------------------------------------------------------------------------------+ | ``pt`` | Portuguese | +--------+------------------------------------------------------------------------------+ | ``qu`` | Quechua | +--------+------------------------------------------------------------------------------+ | ``rm`` | Romansh | +--------+------------------------------------------------------------------------------+ | ``rn`` | Rundi | +--------+------------------------------------------------------------------------------+ | ``ro`` | Romanian/Moldavian/Moldovan | +--------+------------------------------------------------------------------------------+ | ``ru`` | Russian | +--------+------------------------------------------------------------------------------+ | ``rw`` | Kinyarwanda | +--------+------------------------------------------------------------------------------+ | ``sa`` | Sanskrit | +--------+------------------------------------------------------------------------------+ | ``sc`` | Sardinian | +--------+------------------------------------------------------------------------------+ | ``sd`` | Sindhi | +--------+------------------------------------------------------------------------------+ | ``se`` | Northern Sami | +--------+------------------------------------------------------------------------------+ | ``sg`` | Sango | +--------+------------------------------------------------------------------------------+ | ``sh`` | Serbo-Croatian | +--------+------------------------------------------------------------------------------+ | ``si`` | Sinhala/Sinhalese | +--------+------------------------------------------------------------------------------+ | ``sk`` | Slovak | +--------+------------------------------------------------------------------------------+ | ``sl`` | Slovenian | +--------+------------------------------------------------------------------------------+ | ``sm`` | Samoan | +--------+------------------------------------------------------------------------------+ | ``sn`` | Shona | +--------+------------------------------------------------------------------------------+ | ``so`` | Somali | +--------+------------------------------------------------------------------------------+ | ``sq`` | Albanian | +--------+------------------------------------------------------------------------------+ | ``sr`` | Serbian | +--------+------------------------------------------------------------------------------+ | ``ss`` | Swati | +--------+------------------------------------------------------------------------------+ | ``st`` | Southern Sotho | +--------+------------------------------------------------------------------------------+ | ``su`` | Sundanese | +--------+------------------------------------------------------------------------------+ | ``sv`` | Swedish | +--------+------------------------------------------------------------------------------+ | ``sw`` | Swahili (macrolanguage) | +--------+------------------------------------------------------------------------------+ | ``ta`` | Tamil | +--------+------------------------------------------------------------------------------+ | ``te`` | Telugu | +--------+------------------------------------------------------------------------------+ | ``tg`` | Tajik | +--------+------------------------------------------------------------------------------+ | ``th`` | Thai | +--------+------------------------------------------------------------------------------+ | ``ti`` | Tigrinya | +--------+------------------------------------------------------------------------------+ | ``tk`` | Turkmen | +--------+------------------------------------------------------------------------------+ | ``tl`` | Tagalog | +--------+------------------------------------------------------------------------------+ | ``tn`` | Tswana | +--------+------------------------------------------------------------------------------+ | ``to`` | Tonga (Tonga Islands) | +--------+------------------------------------------------------------------------------+ | ``tr`` | Turkish | +--------+------------------------------------------------------------------------------+ | ``ts`` | Tsonga | +--------+------------------------------------------------------------------------------+ | ``tt`` | Tatar | +--------+------------------------------------------------------------------------------+ | ``tw`` | Twi | +--------+------------------------------------------------------------------------------+ | ``ty`` | Tahitian | +--------+------------------------------------------------------------------------------+ | ``ug`` | Uighur/Uyghur | +--------+------------------------------------------------------------------------------+ | ``uk`` | Ukrainian | +--------+------------------------------------------------------------------------------+ | ``ur`` | Urdu | +--------+------------------------------------------------------------------------------+ | ``uz`` | Uzbek | +--------+------------------------------------------------------------------------------+ | ``ve`` | Venda | +--------+------------------------------------------------------------------------------+ | ``vi`` | Vietnamese | +--------+------------------------------------------------------------------------------+ | ``vo`` | Volapük | +--------+------------------------------------------------------------------------------+ | ``wa`` | Walloon | +--------+------------------------------------------------------------------------------+ | ``wo`` | Wolof | +--------+------------------------------------------------------------------------------+ | ``xh`` | Xhosa | +--------+------------------------------------------------------------------------------+ | ``yi`` | Yiddish | +--------+------------------------------------------------------------------------------+ | ``yo`` | Yoruba | +--------+------------------------------------------------------------------------------+ | ``za`` | Zhuang/Chuang | +--------+------------------------------------------------------------------------------+ | ``zh`` | Chinese | +--------+------------------------------------------------------------------------------+ | ``zu`` | Zulu | +--------+------------------------------------------------------------------------------+ en The actual value of the :sp:element:`~Core.DataTypes.SingleLanguageString`. This is some sample text. A :sp:element:`!~Core.DataTypes.SingleLanguageString` contains a :sp:element:`~Core.DataTypes.SingleLanguageString.Value` and a :sp:element:`~Core.DataTypes.SingleLanguageString.Language` tag. :sp:element:`!~Core.DataTypes.SingleLanguageString` is only used within :sp:element:`~Core.DataTypes.MultiLanguageString`. Basic data types such as strings, numbers, and enumerations. SubTagName The intensity of the blue channel of the :sp:element:`~Core.Diagram.Color`. The intensity of the green channel of the :sp:element:`~Core.Diagram.Color`. The intensity of the red channel of the :sp:element:`~Core.Diagram.Color`. A color. :sp:element:`!~Core.Diagram.Color` is based on the RGB color model (e.g., see `Wikipedia <https://en.wikipedia.org/wiki/RGB_color_spaces>`__ for an overview). For each channel *red*, *green*, and *blue*, :sp:element:`!~Core.Diagram.Color` has an attribute :sp:element:`~Core.Diagram.Color.R`, :sp:element:`~Core.Diagram.Color.G`, and :sp:element:`~Core.Diagram.Color.B` that gives the intensity of the channel. Intensities are given as values of :sp:element:`~Core.DataTypes.UnsignedByte`, i.e., integers in the range [0, 255]. Simplified Literals ------------------- Within this specification, we use the hexadecimal SVG representation of a :sp:element:`~Core.Diagram.Color` (without the string delimiters) as a convenient literal to refer to that :sp:element:`~Core.Diagram.Color`. For example, :code:`#0000ff` refers to the :sp:element:`<Core.Diagram.Color>` *blue* with :code:`R=0`, :code:`G=0`, and :code:`B=255`. Mapping to SVG -------------- There are several syntactical variants to map a :sp:element:`~Core.Diagram.Color` to SVG. Here, we use the `RGB Hexadecimal Notation <https://www.w3.org/TR/css-color-4/#hex-notation>`__ with 6 digits as defined by :ref:`standard-css-color-4`. It has the form :code:`'#RRGGBB'`, where :code:`RR`, :code:`GG`, and :code:`BB` are 2-digit hexadecimal representations of the integer values of the attributes :sp:element:`~Core.Diagram.Color.R`, :sp:element:`~Core.Diagram.Color.G`, and :sp:element:`~Core.Diagram.Color.B`. Conventional hexadecimal digits are used: :code:`0`, ..., :code:`9`, :code:`a`, ..., :code:`f`. Capitalized versions of the latter are also allowed: :code:`A`, ..., :code:`F`. To ensure 2 digits for each integer, a leading zero is added if required. .. admonition:: example Consider the :sp:element:`~Core.Diagram.Color` with :code:`R=0`, :code:`G=10`, and :code:`B=255`. The hexadecimal representations of the attributes are :code:`00`, :code:`0a`, and :code:`ff`. Hence, the SVG representation of the color is :code:`'#000aff'`. http://data.posccaesar.org/rdl/RDS4316590816 CONFIDENTIAL INFORMATION confidential http://sandbox.dexpi.org/rdl/NonConfidentialInformation NON CONFIDENTIAL INFORMATION not confidential The inner points of the :sp:element:`~Core.Diagram.ConnectorLine`. The stroke of the :sp:element:`~Core.Diagram.ConnectorLine`. A :sp:element:`!~Core.Diagram.DashStyle` describes a pattern for drawing a stroke. The pattern gives the lengths of those parts of a stroke that are actually drawn and of those parts that are not drawn. Appearance ========== Each :sp:element:`!~Core.Diagram.DashStyle` is characterized by a sequence of an even number of double values. The first of these values gives the length of a visible part of a stroke, the second one the length of an invisible part. Optional further pairs of double values in the pattern are applied in the same way. The entire pattern is applied repeatedly until the end of a stroke. The lengths in a :sp:element:`!~Core.Diagram.DashStyle`'s pattern are given in terms of the :sp:element:`~Core.Diagram.Stroke`'s :sp:element:`~Core.Diagram.Stroke.Width` in mm, i.e., the dimensionless double values must be multiplied with the :sp:element:`~Core.Diagram.Stroke.Width` in order to get the actual lengths. The following table gives heuristically proven patterns for the different :sp:element:`DashStyles <Core.Diagram.DashStyle>`. .. image:: /images/img5.* Example P&ID The center position of the :sp:element:`~Core.Diagram.Ellipse`. The fill style of the :sp:element:`~Core.Diagram.Ellipse`. The length of the horizontal semi-axis of the :sp:element:`~Core.Diagram.Ellipse` in mm. The rotation of the :sp:element:`~Core.Diagram.Ellipse` around its center, measured clockwise and in degrees. The value must be in the inverval [0; 360). The stroke of the :sp:element:`~Core.Diagram.Ellipse`. The length of the vertical semi-axis of the :sp:element:`~Core.Diagram.Ellipse` in mm. An ellipse. Geometry ======== The geometry of an :sp:element:`!~Core.Diagram.Ellipse` is characterized by its :sp:element:`~Core.Diagram.Ellipse.Center`, its two axes (:sp:element:`~Core.Diagram.Ellipse.HorizontalSemiAxis` and :sp:element:`~Core.Diagram.Ellipse.VerticalSemiAxis`), and the :sp:element:`~Core.Diagram.Ellipse.Rotation` of the :sp:element:`~Core.Diagram.Ellipse.HorizontalSemiAxis` w.r.t. the x axis of the :ref:`owner <owner-of-graphical-primitive>`. The :sp:element:`~Core.Diagram.Ellipse.Rotation` is measured clockwise and in degrees. .. admonition:: example We consider an :sp:element:`!~Core.Diagram.Ellipse` with - :sp:element:`~Core.Diagram.Ellipse.Center` :code:`(10, 20)`, - :sp:element:`~Core.Diagram.Ellipse.HorizontalSemiAxis` :code:`110`, - :sp:element:`~Core.Diagram.Ellipse.VerticalSemiAxis` :code:`50`, and - :sp:element:`~Core.Diagram.Ellipse.Rotation` :code:`35`. The :sp:element:`!~Core.Diagram.Ellipse` will look like this: .. image:: /images/img15.* .. rubric:: Visual Center The :ref:`visual center <visual-center>` of an :sp:element:`!~Core.Diagram.Ellipse` is its actual :sp:element:`~Core.Diagram.Ellipse.Center`. Mapping to SVG ============== An :sp:element:`~Core.Diagram.Ellipse` corresponds to an `svg:ellipse <https://www.w3.org/TR/SVG2/shapes.html#EllipseElement>`__ with these attributes: - :code:`transform` describes both the :sp:element:`~Core.Diagram.Ellipse.Center` :math:`(c_x, c_y)` and the :sp:element:`~Core.Diagram.Ellipse.Rotation` :math:`r` of the Ellipse. :code:`transform = "translate(` + str(:math:`c_x`) + :code:`,` + str(:math:`c_y`) + :code:`) rotate(` + str(:math:`r`) + :code:`)"` - :code:`rx` and :code:`ry` are string representations of :sp:element:`~Core.Diagram.Ellipse.HorizontalSemiAxis` and :sp:element:`~Core.Diagram.Ellipse.VerticalSemiAxis`. - :code:`stroke`, :code:`stroke-dasharray`, :code:`stroke-dashoffset` and :code:`stroke-width` are set according to the SVG mapping rules for the :sp:element:`~Core.Diagram.Ellipse.Stroke` of the :sp:element:`~Core.Diagram.Ellipse` (see :sp:element:`~Core.Diagram.Stroke`). - :code:`stroke-linecap = "round"` and :code:`stroke-linejoin = "round"` reflect the :ref:`heuristic for line caps and line joins <line-caps-and-line-joins>`. - :code:`vector-effect = "non-scaling-stroke"` reflects the :ref:`heuristic for scaled symbols <scaled-symbols>`. - :code:`fill` is set according to the SVG mapping rules for the :sp:element:`~Core.Diagram.Ellipse.FillStyle` of the :sp:element:`~Core.Diagram.Ellipse` (see :sp:element:`~Core.Diagram.FillStyle`). .. admonition:: example We assume that the :sp:element:`~Core.Diagram.Stroke` of the :sp:element:`~Core.Diagram.Ellipse` above is :code:`2mm #ff0000 Solid` and that its :sp:element:`~Core.Diagram.Ellipse.FillStyle` is :sp:element:`~Core.Diagram.FillStyle.Transparent`. .. code-block:: xml {EllipseTransparentSvgCode} .. image:: /images/img16.* .. admonition:: example We consider the same :sp:element:`~Core.Diagram.Ellipse` as in the previous example, except that the :sp:element:`~Core.Diagram.Stroke` is :code:`2mm #ff0000 LongDashShortDash`. .. code-block:: xml {EllipseLongDashShortDashSvgCode} .. image:: /images/img17.* .. admonition:: example Finally, a variant with :sp:element:`~Core.Diagram.Stroke` :code:`2mm #ff0000 Solid` and :sp:element:`~Core.Diagram.Ellipse.FillStyle` :sp:element:`~Core.Diagram.FillStyle.Hatch`. .. code-block:: xml {EllipseHatchSvgCode} .. image:: /images/img18.* The center position of the :sp:element:`~Core.Diagram.EllipseArc`. The end angle of the :sp:element:`~Core.Diagram.EllipseArc`, measured clockwise and in degrees. The value must be in the inverval [0; 360). The length of the horizontal semi-axis of the :sp:element:`~Core.Diagram.EllipseArc` in mm. The rotation of the :sp:element:`~Core.Diagram.EllipseArc` around its center, measured clockwise and in degrees. The value must be in the inverval [0; 360). The start angle of the :sp:element:`~Core.Diagram.EllipseArc`, measured clockwise and in degrees. The value must be in the inverval [0; 360). The stroke of the :sp:element:`~Core.Diagram.EllipseArc`. The length of the vertical semi-axis of the :sp:element:`~Core.Diagram.EllipseArc` in mm. ' A segment of an ellipse. Geometry ======== An :sp:element:`!~Core.Diagram.EllipseArc` is a segment of an ellipse. The geometry of the underlying ellipse is described in the same way as the geometry of the actual :sp:element:`~Core.Diagram.Ellipse` class (:sp:element:`~Core.Diagram.EllipseArc.Center`, :sp:element:`~Core.Diagram.EllipseArc.HorizontalSemiAxis`, :sp:element:`~Core.Diagram.EllipseArc.VerticalSemiAxis`, :sp:element:`~Core.Diagram.EllipseArc.Rotation`). In addition, an :sp:element:`!~Core.Diagram.EllipseArc` has two attributes :sp:element:`~Core.Diagram.EllipseArc.StartAngle` and :sp:element:`~Core.Diagram.EllipseArc.EndAngle` that determine the start and end position of the arc. .. admonition:: example We consider an :sp:element:`~Core.Diagram.EllipseArc` with - :sp:element:`~Core.Diagram.EllipseArc.Center` :code:`(10, 20)`, - :sp:element:`~Core.Diagram.EllipseArc.HorizontalSemiAxis` :code:`110`, - :sp:element:`~Core.Diagram.EllipseArc.VerticalSemiAxis` :code:`50`, and - :sp:element:`~Core.Diagram.EllipseArc.Rotation` :code:`35`. These attributes describe the blue dashed ellipse in this figure (cf. the :sp:element:`~Core.Diagram.Ellipse` example which has the same attribute values). .. image:: /images/img19.* The :sp:element:`~Core.Diagram.EllipseArc` has two further geometric attributes - :sp:element:`~Core.Diagram.EllipseArc.StartAngle` :code:`288` and - :sp:element:`~Core.Diagram.EllipseArc.EndAngle` :code:`20`. These two angles do not have a simple geometric interpretation in the figure; we will get back to them in the following sections. However, these angles determine the start position and the end position of the black :sp:element:`~Core.Diagram.EllipseArc` in the figure. The actual :sp:element:`~Core.Diagram.EllipseArc` goes from the start position *in positive direction* (i.e., clockwise) to the end position. .. rubric:: Calculation of start and end position We use the following notation: - :math:`c_x` and :math:`c_y`: components of the :sp:element:`~Core.Diagram.EllipseArc.Center`, - :math:`r_x`: :sp:element:`~Core.Diagram.EllipseArc.HorizontalSemiAxis`, - :math:`r_y`: :sp:element:`~Core.Diagram.EllipseArc.VerticalSemiAxis`, - :math:`\varphi`: :sp:element:`~Core.Diagram.EllipseArc.Rotation`, - :math:`\theta_1`: :sp:element:`~Core.Diagram.EllipseArc.StartAngle`, - :math:`\theta_2`: :sp:element:`~Core.Diagram.EllipseArc.EndAngle`, - :math:`x_1` and :math:`y_1`: start position, - :math:`x_2` and :math:`y_2`: end position. .. admonition:: technical The notation is based on that used by the `SVG Arc Implementation Notes <https://www.w3.org/TR/SVG2/implnote.html#ArcImplementationNotes>`__ which may be useful for implementors. The start position is .. math:: \left(\begin{array}{c} x_1 \\ y_1 \end{array}\right) = \left(\begin{array}{cc} \cos \varphi & -\sin \varphi \\ \sin \varphi & \cos \varphi \end{array}\right) \cdotp \left(\begin{array}{c} r_x \cos \theta_1 \\ r_y \sin \theta_1 \end{array}\right) + \left(\begin{array}{c} c_x \\ c_y \end{array}\right) and the end position is .. math:: \left(\begin{array}{c} x_2 \\ y_2 \end{array}\right) = \left(\begin{array}{cc} \cos \varphi & -\sin \varphi \\ \sin \varphi & \cos \varphi \end{array}\right) \cdotp \left(\begin{array}{c} r_x \cos \theta_2 \\ r_y \sin \theta_2 \end{array}\right) + \left(\begin{array}{c} c_x \\ c_y \end{array}\right) \quad . .. admonition:: example In the example, we have .. math:: c_x &= 10 c_y &= 20 r_x &= 110 r_y &= 50 \varphi &= 35 \theta_1 &= 288 \theta_2 &= 20 With the equations above, we get these coordinates for the start and end positions (cf. the figure above): .. math:: x_1 &= 65.1197 y_1 &= 0.5439 x_2 &= 84.8639 y_2 &= 93.2967 .. rubric:: Interpretation of StartAngle and EndAngle These angles are not measured in the ellipse on which an :sp:element:`~Core.Diagram.EllipseArc` is based, but in the unit circle: ??? The figure shows the end position w.r.t. the unit circle. Its angle measured from the horizonal semi-axis is :math:`\theta_2 = 20`. The ellipse could be constructed by stretching the unit circle by :math:`r_x` in direction of the horizontal semi-axis and by :math:`r_y` in direction of the vertical semi-axis. After this transformation, the end position w.r.t. the unit circle is at the actual end position. To calculate an actual, ellipse-based angle from an angle w.r.t. the unit circle, use the formula .. math:: \theta_{actual} = \textrm{atan2}( r_y \sin \theta, r_x \cos \theta ) \,\textrm{mod}\, 360 \quad. The formulas apply to both the :sp:element:`~Core.Diagram.EllipseArc.StartAngle` :math:`\theta_1` and the :sp:element:`~Core.Diagram.EllipseArc.EndAngle` :math:`\theta_2`. Note that we give angles in degrees, i.e., the actual calculations in a program may require conversions to and from radians. .. admonition:: example In the example, we have .. math:: \theta_{actual, 1} = \textrm{atan2}( 50 \cdotp \sin 288, 110 \cdotp \cos 288) \,\textrm{mod}\, 360 = 305.56 and .. math:: \theta_{actual, 2} = \textrm{atan2}( 50 \cdotp \sin 20, 110 \cdotp \cos 20) \,\textrm{mod}\, 360 = 9.39 \quad . The inverse formula is .. math:: \theta = \textrm{atan2}( r_x \sin \theta_{actual}, r_y \cos \theta_{actual} ) \,\textrm{mod}\, 360 \quad . .. admonition:: technical The rationale for using angles w.r.t. the unit circle is that they are numerically more stable when an :sp:element:`~Core.Diagram.EllipseArc` is scaled with small values (i.e., in a :sp:element:`~Core.Diagram.ShapeUsage`) and that some calculations are simpler (cf. `SVG 2 Arc Implementation Notes <https://www.w3.org/TR/SVG2/implnote.html#ArcImplementationNotes>`__). Mapping to SVG ============== An :sp:element:`~Core.Diagram.EllipseArc` is mapped to an `svg:path <https://www.w3.org/TR/SVG2/paths.html#PathElement>`__ with these attributes: - :code:`d` is the `path data <https://www.w3.org/TR/SVG2/paths.html#PathData>`__ that describes the entire geometry of the :sp:element:`~Core.Diagram.EllipseArc`. The value is the concatenation of the following strings, all of them separated by spaces: - :code:`M` - str(:math:`x_1`) - str(:math:`y_1`) - :code:`A` - str(:math:`r_x`) - str(:math:`r_y`) - str(:math:`\varphi`) - str(:math:`f_A`) - :code:`1` - str(:math:`x_2`) - str(:math:`y_2`) :math:`f_A` is calculated as follows (cf. the definition of the :ref:`modulo operator <modulo-operator>`): .. math:: \Delta \theta &= (\theta_2 - \theta_1)\, \textrm{mod}\, 360 \quad , f_A &= 0 \quad \textrm{if} \, \Delta \theta < 180 \quad , f_A &= 1 \quad \textrm{if} \, \Delta \theta \geq 180 \quad . The other variables have been defined above. - :code:`stroke`, :code:`stroke-dasharray`, :code:`stroke-dashoffset` and :code:`stroke-width` are set according to the SVG mapping rules for the :sp:element:`~Core.Diagram.EllipseArc.Stroke` of the :sp:element:`~Core.Diagram.EllipseArc` (see :sp:element:`~Core.Diagram.Stroke`). - :code:`stroke-linecap = "round"` and :code:`stroke-linejoin = "round"` reflect the :ref:`heuristic for line caps and line joins <line-caps-and-line-joins>`. - :code:`vector-effect = "non-scaling-stroke"` reflects the :ref:`heuristic for scaled symbols <scaled-symbols>`. - :code:`fill = "none"` is required to avoid that the `svg:path <https://www.w3.org/TR/SVG2/shapes.html#PolylineElement>`__ is filled. .. admonition:: example We assume that the :sp:element:`~Core.Diagram.Stroke` of the :sp:element:`~Core.Diagram.EllipseArc` above is :code:`2mm #ff0000 solid`. With :math:`\Delta \theta = (20 - 288)\, \textrm{{mod}}\,360 = (-268)\, \textrm{{mod}}\, 360 = 92 < 180` we get :math:`f_A = 0`. .. code-block:: xml {EllipseArcSolidSvgCode} ??? .. admonition:: example We consider the same :sp:element:`~Core.Diagram.EllipseArc` as in the previous example, except that the :sp:element:`~Core.Diagram.Stroke` is :code:`2mm #ff0000 Dash`. .. code-block:: xml {EllipseArcDashSvgCode} .. image:: /images/img20.* Drawing No.: A representation of the approval date of the drawing. The format of the representation is not prescribed. http://sandbox.dexpi.org/rdl/ApprovalDateRepresentationAssignmentClass APPROVAL DATE REPRESENTATION ASSIGNMENT CLASS 2016-04-01 A description of the approval of the drawing. http://sandbox.dexpi.org/rdl/ApprovalDescriptionAssignmentClass APPROVAL DESCRIPTION ASSIGNMENT CLASS The name of the approver of the drawing. http://sandbox.dexpi.org/rdl/ApproverNameAssignmentClass APPROVER NAME ASSIGNMENT CLASS A. P. Prover The archive number of the drawing. http://sandbox.dexpi.org/rdl/ArchiveNumberAssignmentClass ARCHIVE NUMBER ASSIGNMENT CLASS XY923-463 The name of the related block. http://sandbox.dexpi.org/rdl/BlockNameAssignmentClass BLOCK NAME ASSIGNMENT CLASS a block The number of the related block. http://sandbox.dexpi.org/rdl/BlockNumberAssignmentClass BLOCK NUMBER ASSIGNMENT CLASS B987-654 The name of the checker of the drawing. http://sandbox.dexpi.org/rdl/CheckerNameAssignmentClass CHECKER NAME ASSIGNMENT CLASS C. Hecker The confidentiality classification of the diagram. http://sandbox.dexpi.org/rdl/ConfidentialitySpecialization CONFIDENTIALITY SPECIALIZATION A representation of the creation date of the drawing. The format of the representation is not prescribed. http://sandbox.dexpi.org/rdl/CreationDateRepresentationAssignmentClass CREATION DATE REPRESENTATION ASSIGNMENT CLASS 2016-04-01 The name of the creator of the drawing. http://sandbox.dexpi.org/rdl/CreatorNameAssignmentClass CREATOR NAME ASSIGNMENT CLASS A. Creator The name of the designer of the drawing. http://sandbox.dexpi.org/rdl/DesignerNameAssignmentClass DESIGNER NAME ASSIGNMENT CLASS D. E. Signer The name of the drafter of the drawing. http://sandbox.dexpi.org/rdl/DrafterNameAssignmentClass DRAFTER NAME ASSIGNMENT CLASS D. Rafter The drawing name. http://data.posccaesar.org/rdl/RDS2102503531 DRAWING NAME ASSIGNMENT CLASS DEXPI example PID The drawing number. http://sandbox.dexpi.org/rdl/DrawingNumberAssignmentClass DRAWING NUMBER ASSIGNMENT CLASS 123/A93 The subtitle of the drawing. http://sandbox.dexpi.org/rdl/DrawingSubTitleAssignmentClass DRAWING SUB TITLE ASSIGNMENT CLASS The file name of the drawing. http://sandbox.dexpi.org/rdl/FileNameAssignmentClass FILE NAME ASSIGNMENT CLASS DEXPI_example_PID.xml A representation of the last modification date of the drawing. The format of the representation is not prescribed. http://sandbox.dexpi.org/rdl/LastModificationDateRepresentationAssignmentClass LAST MODIFICATION DATE REPRESENTATION ASSIGNMENT CLASS 2016-04-02 The location name. http://sandbox.dexpi.org/rdl/LocationNameAssignmentClass LOCATION NAME ASSIGNMENT CLASS C1248 The identification code of the related process cell according to ISA-95. http://sandbox.dexpi.org/rdl/ProcessCellIdentificationCodeAssignmentClass PROCESS CELL IDENTIFICATION CODE ASSIGNMENT CLASS PC123 The name of the related process cell according to ISA-95. http://sandbox.dexpi.org/rdl/ProcessCellNameAssignmentClass PROCESS CELL NAME ASSIGNMENT CLASS a process cell The name of the related project. http://sandbox.dexpi.org/rdl/ProjectNameAssignmentClass PROJECT NAME ASSIGNMENT CLASS a project The number of the related project. http://sandbox.dexpi.org/rdl/ProjectNumberAssignmentClass PROJECT NUMBER ASSIGNMENT CLASS P3.1415 The range number of the related project. http://sandbox.dexpi.org/rdl/ProjectRangeNumberAssignmentClass PROJECT RANGE NUMBER ASSIGNMENT CLASS PR321 The drawing replaced by this drawing. http://sandbox.dexpi.org/rdl/ReplacedDrawingAssignmentClass REPLACED DRAWING ASSIGNMENT CLASS D321 The name of the department responsible for the drawing. http://sandbox.dexpi.org/rdl/ResponsibleDepartmentNameAssignmentClass RESPONSIBLE DEPARTMENT NAME ASSIGNMENT CLASS R2-D2 The revision number of the drawing. http://sandbox.dexpi.org/rdl/RevisionNumberAssignmentClass REVISION NUMBER ASSIGNMENT CLASS R2.2 The sheet format. http://sandbox.dexpi.org/rdl/SheetFormatAssignmentClass SHEET FORMAT ASSIGNMENT CLASS DIN A3 The sheet number of the drawing. http://sandbox.dexpi.org/rdl/SheetNumberAssignmentClass SHEET NUMBER ASSIGNMENT CLASS 2a The name of the related sub-project. http://sandbox.dexpi.org/rdl/SubProjectNameAssignmentClass SUB PROJECT NAME ASSIGNMENT CLASS a sub-project The number of the related sub-project. http://sandbox.dexpi.org/rdl/SubProjectNumberAssignmentClass SUB PROJECT NUMBER ASSIGNMENT CLASS P3.1415-SP2 The total number of sheets. http://sandbox.dexpi.org/rdl/TotalNumberOfSheets TOTAL NUMBER OF SHEETS The identification code of the related unit according to ISA-95. http://sandbox.dexpi.org/rdl/UnitIdentificationCodeAssignmentClass UNIT IDENTIFICATION CODE ASSIGNMENT CLASS U-923-463 The name of the related unit according to ISA-95. http://sandbox.dexpi.org/rdl/UnitIsa95NameAssignmentClass UNIT ISA95 NAME ASSIGNMENT CLASS a unit Meta data about a :sp:element:`~Core.Container`. http://sandbox.dexpi.org/rdl/MetaData META DATA The X (horizontal) coordinate of the :sp:element:`~Core.Diagram.Point` in mm. The Y (horizontal) coordinate of the :sp:element:`~Core.Diagram.Point` in mm. A point in the X-Y-plane. The points of the :sp:element:`~Core.Diagram.PolyLine`. The stroke of the :sp:element:`~Core.Diagram.PolyLine`. A curve that consists of one or more chained straight sections. Geometry ======== The first straight section of a :sp:element:`~Core.Diagram.PolyLine` starts at its first :sp:element:`~Core.Diagram.Point`, i.e., :sp:element:`Points[0] <Core.Diagram.Polygon.Points>`, and ends at its second :sp:element:`~Core.Diagram.Point`. For each further :sp:element:`~Core.Diagram.Point`, another section is drawn that starts at the preceding :sp:element:`~Core.Diagram.Point`. .. admonition:: example We consider a :sp:element:`~Core.Diagram.PolyLine` with 3 :sp:element:`~Core.Diagram.PolyLine.Points`: - :code:`(-30, 40)`, - :code:`(50, 40)`, and - :code:`(-10, -60)`. The :sp:element:`~Core.Diagram.PolyLine` will look like this: .. image:: /images/img6.* Mapping to SVG ============== A :sp:element:`~Core.Diagram.PolyLine` corresponds to an `svg:polyline <https://www.w3.org/TR/SVG2/shapes.html#PolylineElement>`__ with these attributes: - :code:`points` contains the :sp:element:`~Core.Diagram.PolyLine.Points` of the :sp:element:`~Core.Diagram.PolyLine`. Each :sp:element:`~Core.Diagram.Point` :math:`i` with position :math:`x_i` and :math:`y_i` is converted to a string as str(:math:`x_i`) + :code:`,` + str(:math:`y_i`). Finally, the :code:`points` attribute is set to a single string that contains all positions, separated by spaces. - :code:`stroke`, :code:`stroke-dasharray`, :code:`stroke-dashoffset` and :code:`stroke-width` are set according to the SVG mapping rules for the :sp:element:`~Core.Diagram.PolyLine.Stroke` of the :sp:element:`~Core.Diagram.PolyLine` (see :sp:element:`~Core.Diagram.Stroke`). - :code:`stroke-linecap = "round"` and :code:`stroke-linejoin = "round"` reflect the :ref:`heuristic for line caps and line joins <line-caps-and-line-joins>`. - :code:`vector-effect = "non-scaling-stroke"` reflects the :ref:`heuristic for scaled symbols <scaled-symbols>`. - :code:`fill = "none"` is required to avoid that the `svg:polyline <https://www.w3.org/TR/SVG2/shapes.html#PolylineElement>`__ is filled. .. admonition:: example We assume that the :sp:element:`~Core.Diagram.Stroke` of the :sp:element:`~Core.Diagram.PolyLine` above is :code:`2mm #007fff solid`. .. code-block:: xml {PolyLineSolidSvgCode} .. image:: /images/img7.* .. admonition:: example We consider the same :sp:element:`~Core.Diagram.PolyLine` as in the previous example, except that the :sp:element:`~Core.Diagram.Stroke` is :code:`2mm #007fff Dash`. .. code-block:: xml {PolyLineDashSvgCode} .. image:: /images/img8.* The fill style of the :sp:element:`~Core.Diagram.Polygon`. The points (vertices) of the :sp:element:`~Core.Diagram.Polygon`. The stroke of the :sp:element:`~Core.Diagram.Polygon`. A figure that is delimited by a closed chain of three or more straight sections. Geometry ======== The first straight section that delimits a :sp:element:`!~Core.Diagram.Polygon` starts at its first :sp:element:`~Core.Diagram.Point`, i.e., :sp:element:`Points[0] <Core.Diagram.Polygon.Points>`, and ends at its second :sp:element:`~Core.Diagram.Point`. For each further :sp:element:`~Core.Diagram.Point`, another section is added that starts at the preceding :sp:element:`~Core.Diagram.Point`. Finally, a section is added that starts at the last :sp:element:`~Core.Diagram.Point` and goes back to the first :sp:element:`~Core.Diagram.Point` such that the chain of sections is closed. .. admonition:: example We consider a :sp:element:`~Core.Diagram.Polygon` with 4 :sp:element:`~Core.Diagram.Polygon.Points`: - :code:`(-30, 40)`, - :code:`(50, 40)`, - :code:`(-10, -60)`, and - :code:`(-10, 0)`. The :sp:element:`~Core.Diagram.Polygon` will look like this: .. image:: /images/img9.* .. rubric:: Interior of a Polygon Depending on its :sp:element:`~Core.Diagram.Polygon.FillStyle`, the interior of a :sp:element:`~Core.Diagram.Polygon` may be filled. There are several possibilities to define when *"a point is inside a polygon"*. DEXPI applies a simple intuitive rule: - Choose an arbitrary point outside the :ref:`geometric bounding box <geometric bounding box>` of the :sp:element:`~Core.Diagram.Polygon`. - Each point that can be reached from there without crossing any segment is outside the :sp:element:`~Core.Diagram.Polygon`. - Each other point is inside the :sp:element:`~Core.Diagram.Polygon`. .. admonition:: example The grey area in the figure visualizes the interior of the given :sp:element:`~Core.Diagram.Polygon`. .. image:: /images/img10.* .. admonition:: technical In case of polygons, the DEXPI definition for interior points coincides with the *nonzero rule* in SVG. See `Section 13.4.2. of the SVG 2 Recommendation <https://www.w3.org/TR/SVG2/painting.html#WindingRule>`__ for a more precise definition of the *nonzero rule*. The SVG 2 Recommendation also defines an alternative rule called *evenodd rule*. If we applied this rule, the pentagonal area in the center of this :sp:element:`~Core.Diagram.Polygon` would be considered outside: .. image:: /images/img11.* .. rubric:: Visual Center Let :math:`n` be the number of :sp:element:`~Core.Diagram.Polygon.Points`, and let :math:`x_i` and :math:`y_i` be the :sp:element:`~Core.Diagram.Point.X` and :sp:element:`~Core.Diagram.Point.Y` positions of :sp:element:`Point <Core.Diagram.Polygon.Points>` :math:`i` for :math:`0 \leq i < n`. Then the horizontal position :math:`c_x` and the vertical position :math:`c_y` of the :ref:`visual center <visual-center>` of the :sp:element:`~Core.Diagram.Polygon` are .. math:: c_x &= \frac 1 2 \Big[ \min_{i=0}^{n-1} x_i + \max_{i=0}^{n-1} x_i \Big] \quad , c_y &= \frac 1 2 \Big[ \min_{i=0}^{n-1} y_i + \max_{i=0}^{n-1} y_i \Big] \quad . Intuitively, the :ref:`visual center <visual-center>` is the center of the minimum bounding box that contains all :sp:element:`~Core.Diagram.Polygon.Points`. If the :sp:element:`~Core.Diagram.Polygon` has the :sp:element:`~Core.Diagram.Polygon.FillStyle` :sp:element:`~Core.Diagram.FillStyle.Hatch`, then one of the hatch lines will cross through the visual center. .. admonition:: example For the :sp:element:`~Core.Diagram.Polygon` above, we have .. math:: c_x &= \frac 1 2 [ \min(-30, 50, -10, -10) + \max(-30, 50, -10, -10) ] &= \frac 1 2 [-30 + 50] &= 10 and .. math:: c_y &= \frac 1 2 [ \min(40, 40, -60, 0) + \max(40, 40, -60, 0) ] &= \frac 1 2 [-60 + 40] &= -10 \quad . Mapping to SVG ============== A :sp:element:`~Core.Diagram.Polygon` corresponds to an `svg:polygon <https://www.w3.org/TR/SVG2/shapes.html#PolygonElement>`__ with these attributes: - :code:`transform` contains a translation from the origin to the visual center. This is required due to the modified positions in :code:`points`. :code:`transform = "translate(` + str(:math:`c_x`) + :code:`,` + str(:math:`c_y`) + :code:`)"` - :code:`points` contains the :sp:element:`~Core.Diagram.Polygon.Points` of the :sp:element:`~Core.Diagram.Polygon` *relative to the visual center*. For each :sp:element:`~Core.Diagram.Point` :math:`i` with (absolute) position :math:`x_i` and :math:`y_i`, the position relative to the visual center is .. math:: \tilde{x}_i &= x_i - c_x \quad , \tilde{y}_i &= y_i - c_y \quad . Each of the relative positions is converted to a string as str(:math:`\tilde{x}_i`) + :code:`,` + str(:math:`\tilde{y}_i`). Finally, the :code:`points` attribute is set to a single string that contains all relative positions, separated by spaces. - :code:`stroke`, :code:`stroke-dasharray`, :code:`stroke-dashoffset` and :code:`stroke-width` are set according to the SVG mapping rules for the :sp:element:`~Core.Diagram.Polygon.Stroke` of the :sp:element:`~Core.Diagram.Polygon` (see :sp:element:`~Core.Diagram.Stroke`). - :code:`stroke-linecap = "round"` and :code:`stroke-linejoin = "round"` reflect the :ref:`heuristic for line caps and line joins <line-caps-and-line-joins>`. - :code:`vector-effect = "non-scaling-stroke"` reflects the :ref:`heuristic for scaled symbols <scaled-symbols>`. - :code:`fill` is set according to the SVG mapping rules for the :sp:element:`~Core.Diagram.Polygon.FillStyle` of the :sp:element:`~Core.Diagram.Polygon` (see :sp:element:`~Core.Diagram.FillStyle`). .. admonition:: example We assume that the :sp:element:`~Core.Diagram.Stroke` of the :sp:element:`~Core.Diagram.Polygon` above is :code:`2mm #ff00ff Solid` and that its :sp:element:`~Core.Diagram.Polygon.FillStyle` is :sp:element:`~Core.Diagram.FillStyle.Transparent`. .. code-block:: xml {PolygonTransparentSvgCode} .. image:: /images/img12.* .. admonition:: example We consider the same :sp:element:`~Core.Diagram.Polygon` as in the previous example, except that the :sp:element:`~Core.Diagram.Stroke` is :code:`2mm #ff00ff Dot`. .. code-block:: xml {PolygonDotSvgCode} .. image:: /images/img13.* .. admonition:: example Finally, a variant with :sp:element:`~Core.Diagram.Stroke` :code:`2mm #ff00ff Solid` and :sp:element:`~Core.Diagram.Polygon.FillStyle` :sp:element:`~Core.Diagram.FillStyle.Hatch`. .. code-block:: xml {PolygonHatchSvgCode} .. image:: /images/img14.* The groups of the :sp:element:`~Core.Diagram.RepresentationGroup`. The node positions of the :sp:element:`~Core.Diagram.RepresentationGroup`. The object represented by the :sp:element:`~Core.Diagram.RepresentationGroup`. A :sp:element:`!~Core.Diagram.RepresentationGroup` is a graphical representation of a :sp:element:`~Core.ConceptualObject`. The graphical elements of the :sp:element:`~Core.Diagram.RepresentationTypeGroup`. ENTRIFUGAL_PUMP_SHAPE The primitives of the :sp:element:`~Core.Diagram.Shape`. A registration number that identifies the :sp:element:`~Core.Diagram.Shape`. The following format is recommended: :code:`[standard]:[version]-[id]-[transform]` where - :code:`standard` is the name of a drawing standard, - :code:`version` is the version the drawing standard, e.g., a year, - :code:`id` is the identifier used in the standard for the :sp:element:`~Core.Diagram.Shape`, - :code:`transform` gives the transformation of the :sp:element:`~Core.Diagram.Shape` w.r.t. its depiction in the standard. :code:`transform` is one of the following values: - :code:`A`: no transformation, - :code:`B`: rotation by 90°, - :code:`C`: rotation by 180°, - :code:`D`: rotation by 270°, - :code:`E`: mirrored, - :code:`F`: mirrored, rotation by 90°, - :code:`G`: mirrored, rotation by 180°, - :code:`H`: mirrored, rotation by 270°. ISO10628:2012-2322-A The name of the :sp:element:`~Core.Diagram.ShapeCatalogue`. Shapes for example P&ID The shapes of the :sp:element:`~Core.Diagram.ShapeCatalogue`. false The shape used by the :sp:element:`~Core.Diagram.ShapeUsage`. The color of the :sp:element:`~Core.Diagram.Stroke`. The dash style of the :sp:element:`~Core.Diagram.Stroke`. The width of the :sp:element:`~Core.Diagram.Stroke` in mm. A stroke defines the visual appearance of a line. Simplified Literals =================== Within this specification, a simplified type of literal is used to refer to a :sp:element:`~Core.Diagram.Stroke`. This literal is composed of - a decimal representation of the :sp:element:`~Core.Diagram.Stroke.Width`, followed by :code:`mm`, - the simplified literal of the :sp:element:`~Core.Diagram.Stroke.Color` of the :sp:element:`~Core.Diagram.Stroke` (see :sp:element:`~Core.Diagram.Color`), - the name of the :sp:element:`~Core.Diagram.Stroke.DashStyle` of the :sp:element:`~Core.Diagram.Stroke` (see :sp:element:`~Core.Diagram.DashStyle`). The three components are separated by spaces. For example, a :sp:element:`~Core.Diagram.Stroke` with - :sp:element:`~Core.Diagram.Stroke.Width` = :code:`2`, - :sp:element:`~Core.Diagram.Stroke.Color` = :code:`#00ff00`, and - :sp:element:`~Core.Diagram.Stroke.DashStyle` = :sp:element:`~Core.Diagram.DashStyle.Dot` is represented as :code:`2mm #00ff00 Dot`. Mapping to SVG ============== A :sp:element:`~Core.Diagram.Stroke` is mapped to a set of XML attributes, which are added to the SVG element (e.g., a `svg:polygon <https://www.w3.org/TR/SVG2/shapes.html#PolygonElement>`__ or a `svg:polyline <https://www.w3.org/TR/SVG2/shapes.html#PolylineElement>`__ element) that is drawn with the :sp:element:`~Core.Diagram.Stroke`. - The :sp:element:`~Core.Diagram.Stroke.Color` of the :sp:element:`~Core.Diagram.Stroke` is mapped to the :code:`stroke` attribute. For the attribute value, see the SVG mapping for :sp:element:`~Core.Diagram.Color`. - The :sp:element:`~Core.Diagram.Stroke.DashStyle` of the :sp:element:`~Core.Diagram.Stroke` is mapped to the :code:`stroke-dasharray` and :code:`stroke-dashoffset` attributes as described in the SVG mapping for :sp:element:`~Core.Diagram.DashStyle`. Note that these attribute values depend on the :sp:element:`~Core.Diagram.Stroke.Width` of the :sp:element:`~Core.Diagram.Stroke` and on the :ref:`linecap` of the :sp:element:`~Core.Diagram.GraphicalPrimitive` that uses the :sp:element:`~Core.Diagram.Stroke`. - The :sp:element:`~Core.Diagram.Stroke.Width` of the :sp:element:`~Core.Diagram.Stroke` is mapped to the :code:`stroke-width` attribute. The attribute value is the concatenation of the string representation of the :sp:element:`~Core.Diagram.Stroke.Width` and the fixed string :code:`mm`. That is, in terms of :ref:`standard-css-values-4` we use an `absolute length <https://www.w3.org/TR/css-values-4/#absolute-lengths>`__ with the unit millimeters. .. admonition:: example For examples, see the SVG mapping sections of those subclasses of :sp:element:`~Core.Diagram.GraphicalPrimitive` that have a :sp:element:`~Core.Diagram.Stroke` attribute: - :sp:element:`~Core.Diagram.Ellipse` - :sp:element:`~Core.Diagram.EllipseArc` - :sp:element:`~Core.Diagram.Polygon` - :sp:element:`~Core.Diagram.PolyLine` Calibri The template that describes how the text is built. N1 The fragments of the :sp:element:`~Core.Diagram.TextTemplate`. Two-dimensional engineering diagrams. The :sp:element:`!~Core.Diagram` package provides concepts 1. for the graphical representation of a :sp:element:`~Core.ConceptualObject`, 2. for linking parts of this graphical representation to parts of the :sp:element:`~!Core.ConceptualObject`, and 3. for semantic annotations of the graphical representation. .. admonition:: technical This specification is not a drawing standard. It does not prescribe any drawing style or standard and it does not prescribe which information in a :sp:element:`~!Core.ConceptualObject` has to be represented in a :sp:element:`~Core.Diagram.Diagram`. .. admonition:: technical Until version 1.2, graphics has not been in the scope of the DEXPI P&ID Specification. Graphics was handled as prescribed by :ref:`standard-proteus`. Over the years, some best practices concerning graphics have evolved in the DEXPI community, and fragmentary annotations have been added to the DEXPI P&ID Specification. In DEXPI P&ID Specification 1.3, an informative Graphics package was added to cover conceptual and graphics information in a single comprehensive model. For the P&ID Specification 1.4, the Graphics package was further elaborated, and it is now a normative part of the specification. It serves to document the best practices that have emerged in the past, but no new features have been added. The Graphics package is independent from Proteus Schema in the sense that it is a pure UML package. But, like for all other packages in this specification, mappings to Proteus Schema are defined that describe how instances of the package's types are serialized. In consequence, the features of the Graphics package are constrained to what is supported by Proteus Schema. Future versions of the DEXPI P&ID Specification will skip support for Proteus Schema, such that additional features can be added to the Graphics package depending on the DEXPI community's needs. Since DEXPI 2.0, the Graphics package can be used for both P&IDs and process models. Example ------- We consider a simple :sp:element:`~Core.ConceptualModel` :sp:name:`cm` that contains a single :sp:element:`~Plant.ProcessEquipment.CentrifugalPump` with two :sp:element:`ProcessNozzles <Plant.ProcessEquipment.ProcessNozzle>` and a :sp:element:`~Plant.ProcessEquipment.Chamber`; in total, there are five :sp:element:`ConceptualObjects <Core.ConceptualObject>`: .. image:: /images/img0.* A typical graphical representation of this model may look like this: .. image:: /images/img1.* Linking Graphics and Conceptual Objects ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The graphics can be decomposed in parts each of which represents one of the :sp:element:`ConceptualObjects <Core.ConceptualObject>`. For each of these parts, we use a :sp:element:`~Core.Diagram.RepresentationGroup`: .. image:: /images/img2.* - The :sp:element:`~Core.Diagram.Diagram` :sp:name:`d` represents the entire :sp:element:`~Core.ConceptualModel`. :sp:element:`!~Core.Diagram.Diagram` is a subclass of :sp:element:`~Core.Diagram.RepresentationGroup` that is meant to be used for the entire graphics. In addition to a conventional :sp:element:`~Core.Diagram.RepresentationGroup`, a :sp:element:`~Core.Diagram.Diagram` has a size (width and height) and a background color. - :sp:name:`cp_grp` is the :sp:element:`~Core.Diagram.RepresentationGroup` for the :sp:element:`~Plant.ProcessEquipment.CentrifugalPump` :sp:name:`cp`. - :sp:name:`pn1_grp` and :sp:name:`pn2_grp` represent the two :sp:element:`ProcessNozzles <Plant.ProcessEquipment.ProcessNozzle>` :sp:name:`pn1` and :sp:name:`pn2`. Note that the composition hierarchy of the :sp:element:`!~Core.Diagram.Diagram` corresponds exactly to the composition hierarchy of the :sp:element:`~Core.ConceptualModel`. In the :sp:element:`~Core.ConceptualModel`, :sp:name:`pn1` is a component of :sp:name:`cp`, and in the :sp:element:`!~Core.Diagram.Diagram`, :sp:name:`pn1_grp` is a component of :sp:name:`cp_grp`. However, if a :sp:element:`~Core.ConceptualObject` (including all its descendants) has no graphical representation at all, no :sp:element:`~Core.Diagram.RepresentationGroup` is required: In the example above, there is no :sp:element:`~Core.Diagram.RepresentationGroup` for the :sp:element:`~Plant.ProcessEquipment.Chamber` :sp:name:`ch`. Adding Semantics ~~~~~~~~~~~~~~~~ So far, we have decomposed the overall graphics in :sp:element:`RepresentationGroups <Core.Diagram.RepresentationGroup>` that correspond to certain :sp:element:`ConceptualObjects <Core.ConceptualObject>`. On a finer level of granularity, we can identify parts with different meanings. These meanings are covered by different subclasses of the abstract class :sp:element:`~Core.Diagram.RepresentationTypeGroup`. In the example, two of these subclasses are used: :sp:element:`~Core.Diagram.Static` and :sp:element:`~Plant.Diagram.EquipmentTagNameLabel`. .. image:: /images/img3.* - Consider :sp:name:`cp_grp`, the :sp:element:`~Core.Diagram.RepresentationGroup` of the :sp:element:`~Plant.ProcessEquipment.CentrifugalPump` :sp:name:`cp`. In addition to the two groups for the :sp:element:`ProcessNozzles <Plant.ProcessEquipment.ProcessNozzle>`, :sp:name:`cp_grp` now contains two :sp:element:`RepresentationTypeGroups <Core.Diagram.RepresentationTypeGroup>`. - The :sp:element:`~Core.Diagram.Static` group contains the actual :sp:element:`~Plant.ProcessEquipment.CentrifugalPump` graphics without any annotations, labels, etc. - The :sp:element:`~Plant.Diagram.EquipmentTagNameLabel` group displays the tag name of the :sp:element:`~Plant.ProcessEquipment.CentrifugalPump`. - :sp:name:`pn1_grp` contains a :sp:element:`~Core.Diagram.Static` group for the basic symbol of the :sp:element:`~Plant.ProcessEquipment.ProcessNozzle`. - :sp:name:`pn2_grp` contains another :sp:element:`~Core.Diagram.Static` group for the second :sp:element:`~Plant.ProcessEquipment.ProcessNozzle` symbol. Whereas :sp:element:`RepresentationGroups <Core.Diagram.RepresentationGroup>` can be decomposed in further groups, :sp:element:`RepresentationTypeGroups <Core.Diagram.RepresentationTypeGroup>` cannot contain further groups. Adding Graphical Elements ~~~~~~~~~~~~~~~~~~~~~~~~~ :sp:element:`RepresentationTypeGroups <Core.Diagram.RepresentationTypeGroup>` rather contain :sp:element:`GraphicalElements <Core.Diagram.GraphicalElement>` such as geometric primitives, texts, or :sp:element:`ShapeUsages <Core.Diagram.ShapeUsage>`. .. image:: /images/img4.* - The :sp:element:`~Core.Diagram.Static` group for the :sp:element:`~Plant.ProcessEquipment.CentrifugalPump` contains a :sp:element:`~Core.Diagram.ShapeUsage`, i.e., a reference to a reusable :sp:element:`~Core.Diagram.Shape` with information about this specific usage (scaling, rotation, position). - The :sp:element:`~Plant.Diagram.EquipmentTagNameLabel` for the :sp:element:`~Plant.ProcessEquipment.CentrifugalPump` contains a :sp:element:`~Core.Diagram.Text`. - Both :sp:element:`~Core.Diagram.Static` groups for the two :sp:element:`ProcessNozzles <Plant.ProcessEquipment.ProcessNozzle>` contain a :sp:element:`~Core.Diagram.ShapeUsage`. Coordinate System ----------------- The coordinate system used is a 2D Cartesian system whose horizontal axis is oriented to the right and whose vertical axis is oriented to the bottom. In consequence, angles are measured clockwise. Lengths are dimensionless. In the examples, we assume they are in millimeters. .. admonition:: proteus In Proteus Schema, the vertical axis to the top, and angles are measured anti-clockwise. Mapping to SVG -------------- The purpose of these mappings is to define the visualization of instances of the types in this package, i.e., "how they look like". In order to keep the mappings simple, the SVG mappings for all :sp:element:`GraphicalPrimitives <Core.Diagram.GraphicalPrimitive>` are defined such that they can be easily scaled when they appear in a :sp:element:`~Core.Diagram.Shape` (in particular, they use ``vector-effect = "non-scaling-stroke"``). In consequence, further scaling, e.g., in an application, will lead to unacceptable results. .. admonition:: technical The SVG mappings in this specification must not be misunderstood as a proposal for exchanging P&ID graphics via SVG. .. _modulo-operator: Modulo Operator --------------- In some calculations for the SVG and Proteus mappings, the *modulo operator* (or *remainder of division*) is used. As the modulo operator can be defined in different ways, we give a definition of how the operator is used in this specification. We content ourselves with a definition for positive quotients. Let :math:`q > 0, a \in \mathbb R`. Then .. math:: a\,\textrm{mod}\,q = a - \left\lfloor \frac a q \right\rfloor \cdot q \quad . :math:`\lfloor.\rfloor` is the *floor function* that for :math:`x \in \mathbb R` yields the largest integer :math:`n` such that :math:`n \leq x`. For example, .. math:: 0\,\textrm{mod}\,360 &= 0 - \left\lfloor \frac {0} {360} \right\rfloor \cdot 360 = 0 - 0 \cdot 360 = 0 \quad, \\ 100\,\textrm{mod}\,360 &= 100 - \left\lfloor \frac {100} {360} \right\rfloor \cdot 360 = 100 - 0 \cdot 360 = 100 \quad, \\ 359\,\textrm{mod}\,360 &= 359 - \left\lfloor \frac {359} {360} \right\rfloor \cdot 360 = 359 - 0 \cdot 360 = 359 \quad, \\ 360\,\textrm{mod}\,360 &= 360 - \left\lfloor \frac {360} {360} \right\rfloor \cdot 360 = 360 - 1 \cdot 360 = 0 \quad, \\ (-100)\,\textrm{mod}\,360 &= -100 - \left\lfloor \frac {-100} {360} \right\rfloor \cdot 360 = -100 - (-1) \cdot 360 = 260 \quad. \\ .. admonition:: technical The definition of the modulo operator differs between programming languages. For example, the modulo operator in Python, written :code:`%`, coincides with the definition above. The modulo operator in JavaScript (ECMAScript), also written :code:`%`, behaves differently for negative dividends: :code:`-100 % 360` is evaluated to :code:`-100`. The conceptual model of the :sp:element:`!~Core.EngineeringModel`. The diagram of the :sp:element:`!~Core.EngineeringModel`. The date time at which the :sp:element:`~Core.EngineeringModel` was exported by the originating system (see :sp:element:`~Core.EngineeringModel.OriginatingSystemName`). The name of the system from which the :sp:element:`~Core.EngineeringModel` originates, e.g., the name of a P&ID tool. PID Kit Professional The name of the vendor of the system from which the :sp:element:`~Core.EngineeringModel` originates, e.g., the name of a software company. Smart and Clever Systems, Inc. The version of the the system from which the :sp:element:`~Core.EngineeringModel` originates, e.g., the version number of a tool. 1.1 The shape catalogues of the :sp:element:`!~Core.EngineeringModel`. An entire DEXPI engineering model. An identifier for the :sp:element:`~Core.Note` in a local context. A typical usage of the :sp:element:`!~Core.Note.LocalNoteIdentifier` is to visualize the relation between a :sp:element:`~Core.ConceptualObject` shown on a diagram and the actual :sp:element:`~Core.Note.NoteText` shown elsewhere on the diagram: The :sp:element:`!~Core.Note.LocalNoteIdentifier` would be drawn near the symbol of the :sp:element:`~Core.ConceptualObject`. A separate table would list the :sp:element:`!~Core.Note.LocalNoteIdentifier` and :sp:element:`~Core.Note.NoteText` attributes of all :sp:element:`Notes <Core.Note>` on the diagram. http://sandbox.dexpi.org/rdl/LocalNoteIdentifierAssignmentClass LOCAL NOTE IDENTIFIER ASSIGNMENT CLASS 42 A textual classification of the :sp:element:`~Core.Note`. http://sandbox.dexpi.org/rdl/NoteClassificationAssignmentClass NOTE CLASSIFICATION ASSIGNMENT CLASS operational requirement A registration number of the :sp:element:`~Core.Note`. http://sandbox.dexpi.org/rdl/NoteRegistrationNumberAssignmentClass NOTE REGISTRATION NUMBER ASSIGNMENT CLASS XY-42-1 The text of the :sp:element:`~Core.Note`. http://sandbox.dexpi.org/rdl/NoteTextAssignmentClass NOTE TEXT ASSIGNMENT CLASS A textual annotation about :sp:element:`ConceptualObjects <Core.ConceptualObject>`. See also :sp:element:`~Core.ConceptualObject.ReferencedNotes`. http://sandbox.dexpi.org/rdl/Note NOTE The context of the :sp:element:`~Core.PersistentIdentifier` such as a database, a project number or name, etc. mysql://myhost:1111/db The value of the :sp:element:`~Core.PersistentIdentifier`, i.e., the actual identifier string. 84187274 A persistent context-dependent identifier for a :sp:element:`~Core.ConceptualObject`. http://data.posccaesar.org/rdl/RDS1357829 CENTIMETRE SQUARED cm² CMK http://data.posccaesar.org/rdl/RDS1342934 FOOT SQUARED ft² FTK http://data.posccaesar.org/rdl/RDS1342979 INCH SQUARED in² INK http://data.posccaesar.org/rdl/RDS1358009 METRE SQUARED m² MTK http://data.posccaesar.org/rdl/RDS1358189 MILLIMETRE SQUARED mm² MMK http://data.posccaesar.org/rdl/RDS1343744 YARD SQUARED yd² YDK A unit of measurement for a physical quantity of type *area* with dimension L\ :sup:`2`. http://data.posccaesar.org/rdl/RDS1355129 KILOGRAM PER LITRE kg/l B35 http://data.posccaesar.org/rdl/RDS1354454 KILOGRAM PER METRE CUBED kg/m³ KMQ http://data.posccaesar.org/rdl/RDS1340909 POUND MASS PER FOOT CUBED lb/ft³ 87 http://data.posccaesar.org/rdl/RDS1341629 POUND MASS PER US GALLON lb/gal (US) GE A unit of measurement for a physical quantity of type *density* with dimension L\ :sup:`-3`\ M. http://data.posccaesar.org/rdl/RDS1318274 CENTIPOISE cP C7 http://data.posccaesar.org/rdl/RDS11617155 MILLIPASCAL SECOND mPa·s C24 http://data.posccaesar.org/rdl/RDS1352204 PASCAL SECOND Pa·s C65 http://data.posccaesar.org/rdl/RDS1339964 POISE P 89 A unit of measurement for a physical quantity of type *dynamic viscosity* with dimension L\ :sup:`-1`\ MT\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS1313954 AMPERE A AMP http://data.posccaesar.org/rdl/RDS4316756455 KILOAMPERE kA B22 http://data.posccaesar.org/rdl/RDS4316806954 MILLIAMPERE mA 4K A unit of measurement for a physical quantity of type *electric current* with dimension I. http://data.posccaesar.org/rdl/RDS1326464 HERTZ Hz HTZ http://data.posccaesar.org/rdl/RDS4316756612 KILOHERTZ kHz KHZ http://data.posccaesar.org/rdl/RDS4316806716 MEGAHERTZ MHz MHZ A unit of measurement for a physical quantity of type *electrical frequency* with dimension T\ :sup:`-1`. JOULE PER CUBIC METRE J/m³ KILOJOULE PER CUBIC METRE kJ/m³ A unit of measurement for a physical quantity of type *energy density* with dimension L\ :sup:`-1`\ MT\ :sup:`-2`. http://data.posccaesar.org/rdl/RDS1327544 JOULE J JOU http://data.posccaesar.org/rdl/RDS4316756626 KILOJOULE kJ KJO http://data.posccaesar.org/rdl/RDS4316756769 KILOWATT HOUR kW·h KWH http://data.posccaesar.org/rdl/RDS4316806730 MEGAJOULE MJ 3B http://data.posccaesar.org/rdl/RDS43168067178 MEGAWATT HOUR MW·h MWH A unit of measurement for a physical quantity of type *energy* with dimension L\ :sup:`2`\ MT\ :sup:`-2`. http://data.posccaesar.org/rdl/RDS1351034 KILONEWTON kN B47 http://data.posccaesar.org/rdl/RDS1337939 NEWTON N NEW A unit of measurement for a physical quantity of type *force* with dimension LMT\ :sup:`-2`. A unit of measurement for a physical quantity of type *frequency* with dimension T\ :sup:`-1`. :sp:element:`!~Core.PhysicalQuantities.FrequencyUnit` has 3 subtypes for different application areas. Btu[IT]/ºF N60 Btu[th]/ºF N61 http://data.posccaesar.org/rdl/RDS1355759 WATT PER KELVIN W/K D52 A unit of measurement for a physical quantity of type *heat capacity* with dimension L\ :sup:`2`\ MΘ\ :sup:`-1`\ T\ :sup:`-3`. http://data.posccaesar.org/rdl/RDS43167567170 KILOWATT PER METRE SQUARED KELVIN kW/(m²·K) N78 http://data.posccaesar.org/rdl/RDS1348424 WATT PER METRE SQUARED KELVIN W/(m²·K) D55 A unit of measurement for a physical quantity of type *heat transfer coefficient* with dimension MT\ :sup:`-3`\ Θ. http://data.posccaesar.org/rdl/RDS43166353195 DEGREE FAHRENHEIT SQUARE FOOT HOUR PER BRITISH THERMAL UNIT °F·h·ft²/Btu[th] J19 http://data.posccaesar.org/rdl/RDS4316756411 KELVIN SQUARE METRE PER WATT m²·K/W D19 A unit of measurement for a physical quantity of type *heat transfer resistance* with dimension M\ :sup:`-1`\ ΘT\ :sup:`3`. http://data.posccaesar.org/rdl/RDS43168636161 SQUARE CENTIMETRE PER SECOND cm²/s M81 http://data.posccaesar.org/rdl/RDS43165906236 CENTISTOKE cSt 4C http://data.posccaesar.org/rdl/RDS1355399 METRE SQUARED PER SECOND m²/s S4 http://data.posccaesar.org/rdl/RDS4316863983 STOKE St 91 A unit of measurement for a physical quantity of type *kinematic viscosity* with dimension L\ :sup:`2`\ T\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS1318004 CENTIMETRE cm CMT http://data.posccaesar.org/rdl/RDS1324664 FOOT ft FOT http://data.posccaesar.org/rdl/RDS1326959 INCH in INH http://data.posccaesar.org/rdl/RDS1330199 KILOMETRE km KMT http://data.posccaesar.org/rdl/RDS1332674 METRE m MTR http://data.posccaesar.org/rdl/RDS1351529 MICROMETRE µm 4H http://data.posccaesar.org/rdl/RDS1357739 MILLIMETRE mm MMT http://data.posccaesar.org/rdl/RDS1337669 NANOMETRE nm C45 A unit of measurement for a physical quantity of type *length* with dimension L. http://data.posccaesar.org/rdl/RDS1353734 AMPERE PER METRE A/m AE http://data.posccaesar.org/rdl/RDS4316756466 KILOAMPERE PER METRE kA/m B24 http://data.posccaesar.org/rdl/RDS1338479 OERSTED Oe 66 A unit of measurement for a physical quantity of type *magnetic field intensity* with dimension IL\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS4316755955 GAUSS Gs 76 http://data.posccaesar.org/rdl/RDS1344644 TESLA T D33 A unit of measurement for a physical quantity of type *magnetic flux density* with dimension MT\ :sup:`-2`\ I\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS1355129 KILOGRAM PER LITRE kg/l B35 http://data.posccaesar.org/rdl/RDS1354454 KILOGRAM PER METRE CUBED kg/m³ KMQ http://data.posccaesar.org/rdl/RDS1340909 POUND MASS PER FOOT CUBED lb/ft³ 87 http://data.posccaesar.org/rdl/RDS1341629 POUND MASS PER US GALLON lb/gal (US) GE A unit of measurement for a physical quantity of type *mass concentration* with dimension L\ :sup:`-3`\ M. http://data.posccaesar.org/rdl/RDS1329344 KILOGRAM PER HOUR kg/h E93 http://data.posccaesar.org/rdl/RDS1350719 KILOGRAM PER MINUTE kg/min F31 http://data.posccaesar.org/rdl/RDS1329659 KILOGRAM PER SECOND kg/s KGS http://data.posccaesar.org/rdl/RDS43168250123 POUND MASS PER HOUR lb/h 4U http://data.posccaesar.org/rdl/RDS43168250156 POUND MASS PER MINUTE lb/min K78 http://data.posccaesar.org/rdl/RDS43168250167 POUND MASS PER SECOND lb/s K81 A unit of measurement for a physical quantity of type *mass flow rate* with dimension MT\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS1329884 KILOJOULE PER KILOGRAM kJ/kg B42 http://data.posccaesar.org/rdl/RDS1332224 MEGAJOULE PER KILOGRAM MJ/kg JK A unit of measurement for a physical quantity of type *mass specific energy* with dimension L\ :sup:`2`\ T\ :sup:`-2`. http://data.posccaesar.org/rdl/RDS43164893116 BRITISH THERMAL UNIT PER POUND MASS DEGREE FAHRENHEIT Btu[IT]/(lb·°F) J43 http://data.posccaesar.org/rdl/RDS43167566130 KILOJOULE PER KILOGRAM KELVIN kJ/(kg·K) B43 A unit of measurement for a physical quantity of type *mass specific heat capacity* with dimension L\ :sup:`2`\ Θ\ :sup:`-1`\ T\ :sup:`-2`. http://data.posccaesar.org/rdl/RDS1325789 GRAM g GRM http://data.posccaesar.org/rdl/RDS1328669 KILOGRAM kg KGM http://data.posccaesar.org/rdl/RDS11617515 POUND MASS lb LBR http://data.posccaesar.org/rdl/RDS1344689 TONNE t TNE A unit of measurement for a physical quantity of type *mass* with dimension M. mmol/l M33 http://data.posccaesar.org/rdl/RDS1357964 MOLE PER LITRE mol/l C38 A unit of measurement for a physical quantity of type *mole concentration* with dimension NL\ :sup:`-3`. http://data.posccaesar.org/rdl/RDS43167566235 KILOMOLE PER SECOND kmol/s E94 http://data.posccaesar.org/rdl/RDS4316807294 MOLE-POUND MASS PER SECOND lbmol/s P45 A unit of measurement for a physical quantity of type *mole flow rate* with dimension NT\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS1354364 JOULE PER MOLE J/mol B15 http://data.posccaesar.org/rdl/RDS43167564201 KILOCALORIE PER MOLE http://data.posccaesar.org/rdl/RDS43167566144 KILOJOULE PER KILOMOLE J/mol B15 http://data.posccaesar.org/rdl/RDS43167566155 KILOJOULE PER MOLE kJ/mol B44 A unit of measurement for a physical quantity of type *mole specific energy* with dimension N\ :sup:`-1`\ L\ :sup:`2`\ MT\ :sup:`-2`. http://data.posccaesar.org/rdl/RDS1337984 NEWTON METRE N·m NU http://data.posccaesar.org/rdl/RDS1324754 FOOT POUND FORCE lbf·ft M92 A unit of measurement for a physical quantity of type *moment of force* with dimension L\ :sup:`2`\ MT\ :sup:`-2`. http://data.posccaesar.org/rdl/RDS4316851589 RECIPROCAL MINUTE min⁻¹ C94 http://data.posccaesar.org/rdl/RDS1355489 RECIPROCAL SECOND s⁻¹ C97 A unit of measurement for a physical quantity of type *number per time interval* with dimension T\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS1326959 INCH in INH http://data.posccaesar.org/rdl/RDS1351529 MICROMETRE µm 4H http://data.posccaesar.org/rdl/RDS1357739 MILLIMETRE mm MMT A unit of measurement for a physical quantity of type *particle size* with dimension L. A type parameter that gives the type of the :sp:element:`~Core.PhysicalQuantities.PhysicalQuantity.Unit`. The unit of measurement of the :sp:element:`~Core.PhysicalQuantities.PhysicalQuantity`. The numerical value of the :sp:element:`~Core.PhysicalQuantities.PhysicalQuantity`. A quantification of a scalar physical property such as a length or a force. A :sp:element:`!~Core.PhysicalQuantities.PhysicalQuantity` comprises a numerical :sp:element:`~Core.PhysicalQuantities.PhysicalQuantity.Value` and a :sp:element:`~Core.PhysicalQuantities.PhysicalQuantity.Unit`. A type parameter that gives the type of the :sp:element:`~Core.PhysicalQuantities.PhysicalQuantityVector.Unit`. The unit of measurement of the :sp:element:`~Core.PhysicalQuantities.PhysicalQuantityVector`. The numerical values of the :sp:element:`~Core.PhysicalQuantities.PhysicalQuantityVector`. A quantification of a vector of physical properties such as length or force. A :sp:element:`!~Core.PhysicalQuantities.PhysicalQuantityVector` comprises an arbitrary number of :sp:element:`~Core.PhysicalQuantities.PhysicalQuantityVector.Values` and a :sp:element:`~Core.PhysicalQuantities.PhysicalQuantityVector.Unit`. http://data.posccaesar.org/rdl/RDS1330919 KILOWATT kW http://data.posccaesar.org/rdl/RDS1332584 MEGAWATT MW http://data.posccaesar.org/rdl/RDS1348154 WATT W A unit of measurement for a physical quantity of type *power* with dimension L\ :sup:`2`\ MT\ :sup:`-3`. http://data.posccaesar.org/rdl/RDS1314539 BAR bar BAR http://data.posccaesar.org/rdl/RDS1330559 KILOPASCAL kPa KPA http://data.posccaesar.org/rdl/RDS1332404 MEGAPASCAL MPa MPA http://data.posccaesar.org/rdl/RDS11617875 MILLIBAR mbar MBR http://data.posccaesar.org/rdl/RDS1338749 PASCAL Pa PAL http://data.posccaesar.org/rdl/RDS1341809 POUND FORCE PER INCH SQUARED lbf/in² PS A unit of measurement for a physical quantity of type *pressure absolute* with dimension L\ :sup:`-1`\ MT\ :sup:`-2`. http://data.posccaesar.org/rdl/RDS1314539 BAR bar BAR http://data.posccaesar.org/rdl/RDS1330559 KILOPASCAL kPa KPA http://data.posccaesar.org/rdl/RDS1332404 MEGAPASCAL MPa MPA http://data.posccaesar.org/rdl/RDS11617875 MILLIBAR mbar MBR http://data.posccaesar.org/rdl/RDS1338749 PASCAL Pa PAL http://data.posccaesar.org/rdl/RDS1341809 POUND FORCE PER INCH SQUARED lbf/in² PS A unit of measurement for a physical quantity of type *pressure gauge* with dimension L\ :sup:`-1`\ MT\ :sup:`-2`. A unit of measurement for a physical quantity of type *pressure* with dimension L\ :sup:`-1`\ MT\ :sup:`-2`. :sp:element:`!~Core.PhysicalQuantities.PressureUnit` has 2 subtypes for different application areas. 1 http://data.posccaesar.org/rdl/RDS1337624 PARTS PER BILLION ppb 61 http://data.posccaesar.org/rdl/RDS1333484 PARTS PER MILLION ppm 59 http://data.posccaesar.org/rdl/RDS1334834 PARTS PER THOUSAND ‰ NX http://data.posccaesar.org/rdl/RDS1317959 PERCENT % P1 A unit of measurement for a physical quantity of type *ratio* with dimension 1. http://data.posccaesar.org/rdl/RDS4316851589 RECIPROCAL MINUTE min⁻¹ C94 http://data.posccaesar.org/rdl/RDS1355489 RECIPROCAL SECOND s⁻¹ C97 A unit of measurement for a physical quantity of type *rotational frequency* with dimension T\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS1323359 DYNE PER CENTIMETRE dyn/cm DX http://data.posccaesar.org/rdl/RDS1338299 NEWTON PER METRE N/m 4P http://data.posccaesar.org/rdl/RDS4316825046 POUND FORCE PER INCH lbf/in F48 A unit of measurement for a physical quantity of type *surface tension* with dimension MT\ :sup:`-2`. http://data.posccaesar.org/rdl/RDS1322684 DEGREE CELSIUS °C CEL http://data.posccaesar.org/rdl/RDS1322549 DEGREE FAHRENHEIT °F FAH http://data.posccaesar.org/rdl/RDS1327904 KELVIN K KEL A unit of measurement for a physical quantity of type *temperature* with dimension Θ. http://data.posccaesar.org/rdl/RDS431648930 BRITISH THERMAL UNIT PER HOUR FOOT DEGREE FAHRENHEIT Btu[IT]·ft/(h·ft²·°F) J40 http://data.posccaesar.org/rdl/RDS1348334 WATT PER METRE KELVIN W/(m·K) D53 A unit of measurement for a physical quantity of type *thermal conductivity* with dimension LMΘ\ :sup:`-1`\ T\ :sup:`-3`. http://data.posccaesar.org/rdl/RDS8945301 DAY d DAY http://data.posccaesar.org/rdl/RDS1326734 HOUR h HUR http://data.posccaesar.org/rdl/RDS1336364 MILLISECOND ms C26 http://data.posccaesar.org/rdl/RDS1336814 MINUTE min MIN http://data.posccaesar.org/rdl/RDS1370700781 MONTH mo MON http://data.posccaesar.org/rdl/RDS1342529 SECOND s SEC http://data.posccaesar.org/rdl/RDS4316908552 YEAR y ANN A unit of measurement for a physical quantity of type *time interval* with dimension T. http://data.posccaesar.org/rdl/RDS1324439 FOOT PER SECOND ft/s FS http://data.posccaesar.org/rdl/RDS1330289 KILOMETRE PER HOUR km/h KMH http://data.posccaesar.org/rdl/RDS1354499 METRE PER SECOND m/s MTS http://data.posccaesar.org/rdl/RDS1334204 MILE PER HOUR mile/h HM http://data.posccaesar.org/rdl/RDS1331099 KNOT kn KNT A unit of measurement for a physical quantity of type *velocity* with dimension LT\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS1359653041 KILOVOLT kV KVT http://data.posccaesar.org/rdl/RDS1359661910 MEGAVOLT MV B78 http://data.posccaesar.org/rdl/RDS1347974 VOLT V VLT A unit of measurement for a physical quantity of type *voltage* with dimension L\ :sup:`2`\ MT\ :sup:`-3`\ I\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS1320029 FOOT CUBED PER HOUR ft³/h 2K http://data.posccaesar.org/rdl/RDS1320164 FOOT CUBED PER MINUTE ft³/min 2L http://data.posccaesar.org/rdl/RDS1331369 LITRE PER SECOND l/s G51 http://data.posccaesar.org/rdl/RDS1320839 METRE CUBED PER DAY m³/d G52 http://data.posccaesar.org/rdl/RDS1321064 METRE CUBED PER HOUR m³/h MQH http://data.posccaesar.org/rdl/RDS1349909 METRE CUBED PER MINUTE m³/min G53 http://data.posccaesar.org/rdl/RDS1321379 METRE CUBED PER SECOND m³/s MQS A unit of measurement for a physical quantity of type *volume flow rate* with dimension L\ :sup:`3`\ T\ :sup:`-1`. http://data.posccaesar.org/rdl/RDS1357874 CENTIMETRE CUBED cm³ CMQ http://data.posccaesar.org/rdl/RDS1319174 DECIMETRE CUBED dm³ DMQ http://data.posccaesar.org/rdl/RDS1319669 FOOT CUBED ft³ FTQ http://data.posccaesar.org/rdl/RDS1331144 LITRE l LTR http://data.posccaesar.org/rdl/RDS1349099 METRE CUBED m³ MTQ http://data.posccaesar.org/rdl/RDS11619315 US FLUID OUNCE fl oz (US) OZA http://data.posccaesar.org/rdl/RDS11615400 US GALLON gal (US) GLL A unit of measurement for a physical quantity of type *volume* with dimension L\ :sup:`3`. http://data.posccaesar.org/rdl/RDS1060066911 pH pH Q30 A unit of measurement for a physical quantity of type *pH* with dimension 1. Data types for representing physical quantities such as the area of a surface and the frequency of a repeating event. The identifier string for the case definition. Special case Globally unique identifier to the case referred to. 1723-001 A description. The display text of the :sp:element:`~Core.QualifiedValue`, typically shown in a diagram. Lower limit ambient operating temperature. abc://exampleURI A reference to the definition of the :sp:element:`~Core.QualifiedValue`. abc://referenceURI A reference to the source of the value. abc://sourceURI A description of the :sp:element:`~Core.Role`. The name of the :sp:element:`~Core.Role`. Bottom Product The URI of the :sp:element:`~Core.Role`. http://www.exampleProcessOntology/BottomProduct The role fulfilled by a :sp:element:`Core.ConceptualObject`. General types for the representation of engineering information and associated graphical representations.