IS:connection crossing

From railML 2 Wiki
Revision as of 15:44, 20 December 2018 by RailML Coord Documentation (talk | contribs) (Additions suggested by Torben Brand)
Jump to navigation Jump to search


connection
 


Scheme description / Schemenbeschreibung

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

  • Parent: <crossing>
  • Children: Not yet described. / Noch nicht beschrieben.

Multiplicity / Anzahl

[1..3]

Semantics / Bedeutung

The <connection> describes a branch of the <crossing>, including which other track this branch is connected to. See Dev:Connection between tracks for more details on different connections between tracks.

Attributes of connection / Attribute von connection

  • id: XML-file-wide unique, machine-interpretable identity, required for later referencing that element internally. For a detailed explanation see Dev:identities.
    XML-Datei-weit eindeutige, maschineninterpretierbare Identität, die für die spätere interne Referenzierung dieses Elements erforderlich ist. Für eine detaillierte Erklärung siehe Dev:identities.
  • ref: This refers to the id attribute of the associated <connection> element.
  • orientation: Orientation of the <crossing> branch relative to the direction of the <track> (looking towards the <trackEnd>).
  • incoming: This branch is merging into the track, tracks are converging relative to the direction.
  • outgoing: Twis branch is splitting out from the track, tracks are diverging relative to the direction.
  • rightAngled: This branch is crossing perpendicular to the track. Only meaningful for <crossing>, not for <switch>.
  • unknown: The 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.
  • course: Sideways direction of this branch relative to the continuation of the <track> in the track's direction (looking towards the <trackEnd>).
  • straight This branch continues straight. This assumes the principal track is not considered straight (<switch>@trackContinueCourse is not "straight").
  • left: This branch is merging from the left or is diverging leftward from the track.
  • right: This branch is merging from the right or is diverging rightward from the track.
  • 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.
  • radius: Radius of the curve with which the branch rails converge into or diverge from the track, measured from an imaginary center of a circle. Defined in the same way as <radiusChange>@value.
  • maxSpeed: Speed restriction for passing over the switch on this branch.
  • passable Denotes if you can pass between the track the <connection> is placed on and the track referred to by ref. See Dev:Connection_between_tracks for descriptions of the usage.
  • branchDist (deprecated with version 2.1) Since originally no separate, connecting track element was allowed, a special attribute denoted the length of the connection. See Dev:Connection_between_tracks.

Syntactic Constraints / Syntaktische Beschränkungen

  • id: xs:ID, required
    a string, starting with a letter (a..zA..Z) or an underscore (_),
    followed by a non-colonized and non-spaced string consisting of letters, digits, points (.), dashes (-) or underscores (_)
  • ref: tGenericRef (xs:IDREF); required
    Must point to the id of another <connection>
  • orientation: tConnectionOrientation (FIXME); required
  • course: tCourse (Restriction of xs:string; can be "straight"/"left"/"right" or any); optional
  • radius: tRadiusM (xs:decimal, 6 fraction digits, radius value measured in meter); optional (introduced with version 2.4)
🗒️ Until railML® 2.3: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter) (deprecated with version 2.3)
  • maxSpeed: tSpeedKmPerHour (xs:decimal, 5 digits and 1 fraction digit with minimum value 0, speed value measured in km/h); optional
  • passable: xs:boolean; default: TRUE; optional
  • branchDist: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter); optional

Best practice & Examples / Empfohlene Anwendung & Beispiele

As the movement possibilities are given for a fully functional <switch> (true), a simple <crossing> (false and false) and a double switch crossing (true and true; within railML® a crossing with @type=doubleSwitchCrossing) the passable does not need to be defined for these element types. For fully functional switches/crossings only use @passable for each of the IS:crossing connection of a crossing@type="simpleSwitchCrossing" (single slip switch) with either the value combination true and false or false and true.

When setting a switch/crossing into a reduced state in railML

When you pad(lock) a switch/switch crossing use the combination of state@disabled=true and passable=true/false under the switch/crossing element. The passable for passing over the switch/crossing on the track the switch is placed on (the principal/straight track) is implicit given through the @passable=true/false of the switch connection (the diverging track).

Notes / Anmerkungen


None.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.