IS:switch: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[unchecked revision][checked revision]
(Updated using new templates (Vorlage:InheritOcpRef, Vorlage:InheritOcpRefConstraints))
m (railroad -> railway)
 
(29 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<!--{{show}}--><!--Uncomment temporarily for preview-->
{{ElementDocu|
{{ElementDocu|
elementName = switch
elementName = switch
|parent = {{IS:Tag|connections}}
|parent = {{IS:Tag|connections}}
 
|childs = {{IS:Tag|additionalName|switch}} {{Intro|2.1}}, {{IS:Tag|any}}, {{IS:Tag|geoCoord}}, {{states}}, {{IS:Tag|connection|switch}},
|childs = {{IS:Tag|additionalName|switch}} {{Intro|2.1}}, {{IS:Tag|connection}}, {{IS:Tag|geoCoord|switch}}
|minocc=0
 
|maxocc=∞
|inheritedAttributes =
|inheritedAttributes =
{{InheritIdName
{{InheritIdName
Line 13: Line 13:
|description =
|description =
}}
}}
{{InheritPosition
{{InheritPosition
|pos =
|pos =
Line 19: Line 18:
|absPosOffset =
|absPosOffset =
}}
}}
|ownAttributes =
|ownAttributes =
{{InheritOcpRef
{{InheritSwitchCrossing
|ocpStationRef =
|ocpStationRef =
|ocpStationRef_de =
|controllerRef =
|controllerRef =
|controllerRef_de =
|trackContinueCourse =
|trackContinueCourse_de =
|trackContinueRadius =
|trackContinueRadius_de =
|normalPosition =
|normalPosition_de =
|model =
|model_de =
|length =
|length_de =
}}
* {{Attr|type}} Possible values are:
:* {{Enum|ordinarySwitch}} An ordinary switch is a switch with a straight branch and a curved branch.
:* {{Enum|insideCurvedSwitch}} An inside curved switch has two curved branches directing in the same direction (either left or right) with one branch having a bigger radius than the other.
:* {{Enum|outsideCurvedSwitch}} An outside curved switch has two curved branches directing in different directions (left and right). The value of the radius may be similar with both branches.
:* {{Enum|threeWaySwitch}} A switch with three instead of two possible ways.
:* {{OtherEnum
|notes_en =
|notes_de =
}}
}}
* {{Attr|trackContinueCourse}}
* {{Attr|trackContinueRadius}}
* {{Attr|normalPosition}}
* {{Attr|model}}
* {{Attr|length}}
* {{Attr|type}}
|semantics =
|semantics =
A {{IS:Tag|switch}} defines a standard switch with three connections as an infrastructure element.
A {{IS:Tag|switch}} defines a standard railway switch with three connections as an infrastructure element. A railway switch, turnout or (set of) points is a mechanical installation enabling railway trains to be guided from one track to another, such as at a railway junction or where a spur or siding branches off a {{external|https://en.wikipedia.org/wiki/Railway_switch}}.
 
|notes =
|notes =
{{InheritPositionNotes}}
{{InheritPositionNotes}}
|constraints =
|constraints =
{{InheritIdNameConstraints}}
{{InheritIdNameConstraints}}
{{InheritPositionConstraints}}
{{InheritPositionConstraints}}
 
{{InheritSwitchCrossingConstraints}}
{{InheritOcpRefConstraints}}
*{{Attr|type}}: {{railMLType|tSwitchType}}; optional
 
|example =
* {{Attr|trackContinueCourse}} optional
Please also refer to [[Dev:Connection_between_tracks]] for further information on how to use switches.
 
* {{Attr|trackContinueRadius}} optional
 
* {{Attr|normalPosition}} optional
 
* {{Attr|model}} {{XsdType|string}}, optional
 
* {{Attr|length}} optional
 
* {{Attr|type}}  optional
 
|backHome = IS:elements
}}
}}

Latest revision as of 13:09, 14 September 2024


switch
 


Schema description / Schemenbeschreibung

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

Multiplicity / Anzahl

[0..∞]

Semantics / Bedeutung

A <switch> defines a standard railway switch with three connections as an infrastructure element. A railway switch, turnout or (set of) points is a mechanical installation enabling railway trains to be guided from one track to another, such as at a railway junction or where a spur or siding branches off a https://en.wikipedia.org/wiki/Railway_switch (external link).

Attributes of switch / Attribute von switch

  • 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.
  • code (introduced with version 2.1): Machine-interpretable string (e.g. an abbreviation) used for identification of the object across exchange partners, usecase specific uniqueness constraints may apply. Please see our description of the differences between id, code and human-readable identifiers.
    Maschineninterpretierbare Zeichenkette (z.B. Abkürzung), die zur Identifizierung des Objekts auch bei Austauschpartnern verwendet wird, wobei spezifische Eindeutigkeitsbeschränkungen gelten können. Bitte beachten Sie unsere Erläuterung zu den Unterschieden zwischen id, code and menschenlesbaren Kennzeichnungen.
  • name: Established, human-readable short string, giving the object a name. Not intended for machine interpretation, please see our notice on human interpretable data fields.
    Etablierte, menschenlesbare kurze Zeichenkette, die das Objekt benennt. Nicht zur maschinellen Interpretation bestimmt, siehe Hinweise zu menschenlesbaren Datenfeldern.
  • description: Human-readable, more detailed description as addition to the name. It should give additional explanations or hints to the contents of this element. Not intended for machine interpretation, please see our notice on human interpretable data fields.
    Menschenlesbare, detailliertere Beschreibung als Ergänzung zu name. Sie soll zusätzliche Erläuterungen oder Hinweise auf den Inhalt dieses Elements geben. Nicht zur maschinellen Interpretation bestimmt, siehe Hinweise zu menschenlesbaren Datenfeldern.
  • xml:lang (introduced with version 2.1): This is a unique identifier of language. It uses basically the language standard IETF BCP 47 (external link) which may be different to ISO 639-1 (external link) or ISO 639-2 (external link). For mapping hints see relation to other standards (external link).
    This defines the language used for name and description. Use <additionalName> to provide a name and/or description in other languages.
  • pos: This is the position on a track defined as distance from its start (trackBegin) regardless the "absolute mileage" in @absPos.
    Das ist die Position des Elements auf einem Track i.S. der realen Entfernung zum trackBegin. Sie ist damit unabhängig von der mit absPos modellierten Strecken-Kilometrierung.
🗒️ For an explanation of the differences between @pos and @absPos see <mileageChange>
  • absPos: This is the position on a track as absolute mileage/chainage.
    Das ist die Position des Elements im Referenzsystem der Strecken-Kilometrierung.
🗒️ For an explanation of the differences between @pos and @absPos see <mileageChange>
  • absPosOffset (deprecated with version 2.1): The semantics of this attribute aren't very clear. It seems to be redundant to the definitions with mileageChanges in "overlapping regions".
  • ocpStationRef: This refers to the id attribute of the associated <ocp> element.
    (introduced with version 2.1)
  • controllerRef: This refers to the id attribute of the associated <controller> element.
    (introduced with version 2.1)
  • trackContinueCourse Possible values are:
  • straight straight leg (no curve) of the switch
  • left left curved leg of switch
  • right right curved leg of switch
  • 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.
  • trackContinueRadius Radius of the curve with which the principal track continues beyond the switch.
  • normalPosition Possible values are:
  • straight straight leg (no curve) of the switch
  • left left curved leg of switch
  • right right curved leg of switch
  • 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.
  • model used for the manufacturer's model of the switch. The naming of switches like "EW

49-300-1:9" follows simple rules: EW - simple switch (einfache Weiche), 49 - the type of rail S49, 300 - radius of the branching track. 1:9 - the angle of the switch. For further information see: ISBN 3-519-06383-2; Jörn Pachl: Systemtechnik des Schienenverkehrs, Teubner 1999

  • length total building length of the switch from begin to end
  • remoteOperated: (introduced with version 2.5) Flag, whether the position of the switch or crossing is operated from anywhere else, i.e. from signalbox or remote operator place but not directly at the switch/crossing.
  • remoteIndicated: (introduced with version 2.5) Flag, whether the position of the switch or crossing is indicated at a remote operator place.
  • lockRef: (introduced with version 2.5) The reference to the lock used to control the position of this switch or crossing.
  • clearancePosOffset: (introduced with version 2.5) The distance between the switch location (@pos) and the position of the switch clearance point. This value is always positive.
  • type Possible values are:
  • ordinarySwitch An ordinary switch is a switch with a straight branch and a curved branch.
  • insideCurvedSwitch An inside curved switch has two curved branches directing in the same direction (either left or right) with one branch having a bigger radius than the other.
  • outsideCurvedSwitch An outside curved switch has two curved branches directing in different directions (left and right). The value of the radius may be similar with both branches.
  • threeWaySwitch A switch with three instead of two possible ways.
  • 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

  • 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 (_)
  • code: xs:string, optional
  • name: xs:string, optional
  • description: xs:string, optional
  • xml:lang: xs:language, language identification, optional
  • pos: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter); required; must be greater than or equal to zero, less than or equal to the track's length
  • absPos: tLengthM (xs:decimal, 6 fraction digits, length value measured in meter); optional
  • absPosOffset: xs:decimal, 6 fraction digits, length value measured in meter; optional
  • controllerRef xs:IDREF, optional
  • trackContinueCourse optional
  • trackContinueRadius optional
  • normalPosition optional
  • model xs:string, optional
  • length optional
  • remoteOperated: xs:boolean, optional
  • remoteIndicated: xs:boolean, optional
  • lockRef: xs:IDREF, optional
  • clearancePosOffset: xs:decimal, 6 fraction digits, length value measured in meter, optional
  • type: 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; optional

Best practice & Examples / Empfohlene Anwendung & Beispiele

Please also refer to Dev:Connection_between_tracks for further information on how to use switches.

Notes / Anmerkungen

General information on positioning

Positive pos values describe the distance from the track's begin. The track length is derived from the pos value in <trackEnd>.

The absolute mileage refered to by absPos is usually found on technical drawings of the track layout or on mileage posts next to the track.

Open issues / Offene Punkte/Pendenzen

Not yet described. / Noch nicht beschrieben.