IS:connection switch

connection
 

Scheme description / Schemenbeschreibung / Description du schéma

Position of connection in the XML-Tree / Position von connection im XML-Baum / position de connection dans l’aborescence XML

• Parent: <switch>

• Children: None

Multiplicity / Anzahl / Multiplicité

[1..3]

Semantics / Bedeutung / Sémantique

A <connection> is an element to determine which branches of a track are connected at a certain position.

Attributes of connection / Attribute von connection / Attributs de 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.

In this article there is information missing with respect to the attribute semantics. Please help improving the railML® wiki by filling the gaps. Possibly, you will find further details on the discussion page. Ferri Leberl (talk) 17:17, 15 January 2017 (CET)

• orientation

In this article there is information missing with respect to the semantics of the enumeration items. Please help improving the railML® wiki by filling the gaps. Possibly, you will find further details on the discussion page. Ferri Leberl (talk) 16:28, 25 April 2018 (CEST)

• incoming
• outgoing
• rightAngled
• unknown
• 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.

• course

In this article there is information missing with respect to the semantics of the enumeration items. Please help improving the railML® wiki by filling the gaps. Possibly, you will find further details on the discussion page. Ferri Leberl (talk) 16:28, 25 April 2018 (CEST)

• straight
• left
• right
• 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.

• radius
• maxSpeed
• passable
  Denotes if you can pass between the track the switch is placed on and the track connecting to the switch.
• branchDist (deprecated with version 2.1)

Syntactic Constraints / Syntaktische Beschränkungen / Contraintes syntactiques

• 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
• orientation: tConnectionOrientation (FIXME); required
• course: tCourse (FIXME); 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 / Bonnes pratiques & exemples

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 / Notes

None.

Open issues / Offene Punkte/Pedenzen / Questions ouvertes

Not yet described. / Noch nicht beschrieben. / Pas encore décrit.