IS:macroscopicNode: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[checked revision][checked revision]
(railML→{{rml}})
 
(2 intermediate revisions by 2 users not shown)
Line 17: Line 17:
:* {{Enum|out}} only out of the node (track <-- node)
:* {{Enum|out}} only out of the node (track <-- node)
:* {{Enum|both}} into and out of node (track <--> node)
:* {{Enum|both}} into and out of node (track <--> node)
:* {{Enum|unknown}} {{missing information|user=[[User:Ferri Leberl|Ferri Leberl]] ([[User talk:Ferri Leberl|talk]]) 15:36, 25 April 2018 (CEST)|topic=the semantics of the enumeration items}}
:* {{Enum|unknown}} is restricted to a certain direction, but this direction is not known.
:* {{OtherEnum
:* {{OtherEnum
|notes_en =
|notes_en =
Line 27: Line 27:


|notes =
|notes =
Many simulation programs, especially in the simulation domain for complete networks, have no knowledge about the physical {{IS:Doc|track}} layout of a station. They model a station as a "zero-dimensional vertex" in a "graph" with {{TT:Doc|train}}s being able to switch to every "edge" (here: {{IS:Doc|track}}) that is connected to that "vertex". The {{IS:Tag|macroscopicNode}} provides means to represent this simplified infrastructure model in RailML.
Many simulation programs, especially in the simulation domain for complete networks, have no knowledge about the physical {{IS:Doc|track}} layout of a station. They model a station as a "zero-dimensional vertex" in a "graph" with {{TT:Doc|train}}s being able to switch to every "edge" (here: {{IS:Doc|track}}) that is connected to that "vertex". The {{IS:Tag|macroscopicNode}} provides means to represent this simplified infrastructure model in {{rml}}.


Simulation programs that depend on precise "microscopic" modelling of stations (including {{IS:Doc|switch}}es, lengths, {{IS:Doc|signal}}s, ...) are likely to be troubled by {{IS:Tag|macroscopicNode}}. Possible solutions can be:
Simulation programs that depend on precise "microscopic" modelling of stations (including {{IS:Doc|switch}}es, lengths, {{IS:Doc|signal}}s, ...) are likely to be troubled by {{IS:Tag|macroscopicNode}}. Possible solutions can be:
Line 44: Line 44:


The associated {{IS:Doc|ocp}} shall have suitable operational attributes set (e. g. as a station). {{AddAnn|| }}
The associated {{IS:Doc|ocp}} shall have suitable operational attributes set (e. g. as a station). {{AddAnn|| }}
|example=
Consider the {{rml|2.3}} example of [https://www.railml.org/en/user/exampledata.html?file=files/download/exampledata/090318_Bahnkonzept_ExampleDataGPSinfradat_NorthUpperRhineNetworkRailML23.zip Middle Rhine Railway by GPSinfradat].
[[File:mip1.png|347x305px]]
<nowiki />
{{IS:trackEnd/tab}}
<nowiki />
This code example defines [https://wiki2.railml.org/wiki/IS:trackBegin track begin] that is a [https://wiki2.railml.org/wiki/IS:macroscopicNode macroscopic node].
<syntaxhighlight lang=xml>
<trackBegin id="tB35113" pos="0" absPos="-110">
  <macroscopicNode ocpRef="ocpFBGK"/>
</trackBegin>
</syntaxhighlight>
Consider the {{rml|2.2}} example of [https://www.railml.org/en/user/exampledata.html?file=files/download/exampledata/130416_iRFP_ExampleDataFBS_EastSaxonyRailML.zip East Saxony railway network by FBS].
[[File:mip3.pdf|623x210px]]
This code example defines [https://wiki2.railml.org/wiki/IS:trackBegin track begin] that is a [https://wiki2.railml.org/wiki/IS:macroscopicNode macroscopic node].
<syntaxhighlight lang=xml>
<trackBegin id='trn_DN_80.6212_1' pos='0' absPos='102100'>
  <macroscopicNode ocpRef='ocp_DN'/>
</trackBegin>
</syntaxhighlight>
}}
}}

Latest revision as of 19:38, 22 January 2024


macroscopicNode
 


Scheme description / Schemenbeschreibung

Position of macroscopicNode in the XML-Tree / Position von macroscopicNode im XML-Baum

Multiplicity / Anzahl

[1..1]

Semantics / Bedeutung

A <macroscopicNode> represents a logical connection of (multiple) tracks without respect to the physical layout of their connections.

Attributes of macroscopicNode / Attribute von macroscopicNode

  • ocpRef: This refers to the id attribute of the associated <ocp> element.
  • flowDirection: This specifies how trains can pass the node. Possible values are:
  • in only into the node (track --> node)
  • out only out of the node (track <-- node)
  • both into and out of node (track <--> node)
  • unknown is restricted to a certain direction, but this direction is not known.
  • other:anything: Any value that does not fit any value from the previous enumeration list, fulfilling the constraint: at minimum two characters, whitespace is not allowed. Please, apply Dev:usingAny accordingly.

Syntactic Constraints / Syntaktische Beschränkungen

  • ocpRef: tGenericRef (xs:IDREF); required
  • flowDirection: tFlowDirection (union of (restriction of xs:string, tOtherEnumerationValue); tOtherEnumerationValue is an arbitrary string starting with 'other:' followed by at minimum two characters, white space not allowed for extending railML® enumeration lists); default: both; optional

All tracks connected to this macroscopicNode shall refer to the same ocp.

The associated ocp shall have suitable operational attributes set (e. g. as a station).

Best practice & Examples / Empfohlene Anwendung & Beispiele

Consider the railML® 2.3 example of Middle Rhine Railway by GPSinfradat.

Mip1.png

TrackID LineID BeginElementType EndElementType OCP Start OCP End
26301 2630 oE mN KKO FBGK
35102 3510 oE mN FMZ FBGK
35113 3511 mN oE FBGK SBKNG

This code example defines track begin that is a macroscopic node.

<trackBegin id="tB35113" pos="0" absPos="-110">
  <macroscopicNode ocpRef="ocpFBGK"/>
</trackBegin>

Consider the railML® 2.2 example of East Saxony railway network by FBS.

File:Mip3.pdf

This code example defines track begin that is a macroscopic node.

<trackBegin id='trn_DN_80.6212_1' pos='0' absPos='102100'>
  <macroscopicNode ocpRef='ocp_DN'/>
</trackBegin>

Notes / Anmerkungen

Many simulation programs, especially in the simulation domain for complete networks, have no knowledge about the physical track layout of a station. They model a station as a "zero-dimensional vertex" in a "graph" with trains being able to switch to every "edge" (here: track) that is connected to that "vertex". The <macroscopicNode> provides means to represent this simplified infrastructure model in railML®.

Simulation programs that depend on precise "microscopic" modelling of stations (including switches, lengths, signals, ...) are likely to be troubled by <macroscopicNode>. Possible solutions can be:

  • convert the <macroscopicNode> internally into openEnds and thus allowing trains to enter and leave the simulation in that point. "Warping" trains from one track of the node to another via "virtual open ends" is a semantically identical behaviour compared with a macroscopic node.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.