IS:line trackGroups

Scheme description / Schemenbeschreibung /

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

• Parent: <trackGroups>

• Children: <additionalName> (introduced with version 2.1), <any>, <states>, <lineDescr>, <trackRef>

Semantics / Bedeutung /

A <line> groups all tracks belonging to a line. The line typically has its own mileage and allows for the regular operation of trains.
Das <line>-Element gruppiert Gleise zu Strecken.

Inherited attributes from other data types / Abgeleitete Attribute von anderen Datentypen /

• 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.

Specific Attributes of line / Spezielle Attribute von line /

• type: This is a attribute indicating the importance of the <line>. The usage of this value follows usually local habits of the countries and might be defined by railway related laws or rules too. Unfortunately no biunique definitions are given for these terms in Europe and Worldwide.

Mit diesem Attribut kann die Bedeutung und ggf. geltende technische Regeln der Strecke beschrieben werden. Die Bedeutung dieses Wortes folgt üblicherweise lokalen Gewohnheitens der Länder und ist teilweise in den Gesetzen oder Bahnregularien beschrieben. Leider gibt es keine eindeutige Definition dieses Begriffes in Europa oder gar weltweit. Possible values are:

• mainLine: A main line is an important section of a railway network, which connects cities or hubs and does serve high(er) speed passenger, larger cargo or suburban trains. Normally these lines are equipped with signals, Train protection systems and allow higher speeds and axle loads (e.g. in Germany a maximum speed for passenger trains of 250 km/h and for cargo trains of 120 km/h is allowed by the law EBO § 40, see left side definitions). The German term for this type of lines is Hauptbahn, the Czech term is celostátní dráhy.
  Als main line werden bedeutendere Bahnstrecken bezeichnet, der in Deutschland, Österreich und der Schweiz übliche Begriff hierfür ist Hauptbahn.
• branchLine: A branch line is a railway line which branches off a more important through route, usually a main line. These lines have mainly local traffic only, lower speeds and lower equipment criterias (e.g. in Germany non supervised level crossings are allowed by the law EBO § 11, see right side definitions). The German term for this type of lines is Nebenbahn, the Czech term is regionální dráhy.
  Als branch line werden nachrangige Bahnstrecken, welche meist von Hauptbahnen aus die Fläche erschließen, bezeichnet. Der in Deutschland, Österreich und der Schweiz übliche Begriff hierfür ist Nebenbahn.
• secondaryLine (deprecated with version 2.3): The usage of this value is not clear in the railML community, it is recommended to avoid this value.
• 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.
  Sofern Strecken nicht als Hauptbahn oder Nebenbahn zu kategorisieren sind, können hier weitere Attribute wie Anschlussbahn, Schmalspurbahn (jedoch Spurweite über <gauge> zu definieren!) oder Strassenbahn angegeben werden.

• infrastructureManagerRef: (introduced with version 2.2) This attribute provides the reference to an infrastructure manager entry given in <infrastructureManager>.

Dieses Attribut dient der Referenzierung des Infrastruktur-Manager-Eintrags.

• lineCategory: (introduced with version 2.3) This attribute specified the line category according to the definitions given in EN 15528.

Dieses Attribut wird verwendet zur Kategorisierung der Strecke entsprechend den Vorgaben aus der DIN EN 15528. Possible values are:

• A
• B1
• B2
• C2
• C3
• C4
• D2
• D3
• D4
• D4xL
• E4
• E5

Constraints / 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
• 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
• infrastructureManagerRef: xs:IDREF
• lineCategory: 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

Best practice / Empfohlene Anwendung /

Austrian East Railway / Österreichische Ostbahn /

The following railML infrastructure example describes the Austrian East Railway — Wikipedia (external link) — from Vienna Main Station to the Hungarian border station of Hegyeshalom. The line is a main line and can be operated by all trains with a maximum axle load of 22.5 tons and a maximum metre load of 8,0 tons per meter. These constraints are summarized in the line category D4. The common used line number of the infrastructure manager ÖBB Infrastruktur — Wikipedia (external link) is given with “11801”.

Das nachfolgende railML-Infrastruktur-Beispiel zeigt die Ostbahn — Wikipedia (external link) in Österreich von Wien Hauptbahnhof bis zum ungarischen Grenzbahnhof Hegyeshalom. Die Strecke ist eine Hauptbahn — Wikipedia (external link) mit der Streckenklasse D4 — Wikipedia (external link) — und wird gewöhnlich unter der betrieblichen Streckennummer 11801 des Eisenbahninfrastrukturbetreibers ÖBB Infrastruktur — Wikipedia (external link) — verwaltet.

   ...
   <trackGroups>
     <line id="a48a6491-301a-4dcf-8293-56f79979e7be"
           code="11801"
           name="Ostbahn"
           description="ehemals Wien-Raaber Bahn vom gschleiften Wiener Südbahnhof nach Hegyeshalom"
           xml:lang="de-AT"
           type="mainLine"
           infrastructureManagerRef="33e19910-794d-4afc-88f3-b5f27a3f6a6a"
           lineCategory="D4">
       <additionalName name="Austrian East Railway"
                       description="former Vienna-Raab railway from abandoned Vienna South Station to Hegyeshalom"
                       xml:lang="en"/>
       <trackRef ref="tr01"/>
     </line>
   </trackGroups>
   ...

Please note, that the line element only provides a reference to the infrastructure manager. Do not try to put information about the infrastructure manager into any attribute of the line element. The detailed information about ÖBB Infrastruktur shall be given in the metadata of the railML file. This looks like this:

Es ist zu beachten, dass das line-Element lediglich eine Referenz auf ein Eisenbahninfrastrukturunternehmen enthält, nicht aber dessen Namen oder vergleichbare Informationen. Bitte versuchen Sie nicht, diese Informationen in den Attributen der Strecke zu „verstecken“. Die Details über die ÖBB Infrastruktur finden sich in den Metadaten der railML-Datei. Das schaut wie folgt aus:

<railML ...>
  <metadata>
    <organizationalUnits>
      <infrastructureManager id="33e19910-794d-4afc-88f3-b5f27a3f6a6a"
                             code="ÖBB"
                             name="Österreichische Bundesbahn Infrastruktur"
                             xml:lang="de-AT">
        <additionalName name="Austrian Federal Railways" 
                        xml:lang="en"/>
      </infrastructureManager>
    </organizationalUnits>
  </metadata>
  ...
</railML>

For the attribute code in element <infrastructureManager> please use the matching value from the codelist file InfrastructureManagers.xml. In this example, the code ÖBB is given.

Für den Wert des Attributs code im Element <infrastructureManager> wählen Sie bitte den entsprechenden Eintrag aus der von railML.org bereitgestellten Codelist InfrastructureManagers.xml. Im Beispiel heißt der Code ÖBB.

In some cases, the infrastructure manager may use additional own national values as reference to other systems. For the given example this may include

• Pre-calculated tables for running times of different train types, engines and loads (Fahrzeitentafel),
• Routebook of Speed Restrictions and Other Specifics (La-Heft) for engine drivers and
• Mileage system for track maintenance works (Kilometrierungssystem).

As these references are specific for one use case or IT system these numbers and identifiers shall not be used as the central code for a line. These additional management numbers for the line can be named in a corresponding <any> element.

In einigen Fällen verwendet der Infrastrukturbetreiber zusätzlich eigene nationale Werte als Referenz zu anderen Systemen. Im vorliegenden Beispiel kann dies u.a. umfassen:

• Vordefinierte Fahrzeit-Tabellen unterschiedlicher Zugskategorien, Fahrzeuge und Lasten (Fahrzeitentafel),
• Übersicht über Langsamfahrstellen und Besonderheiten — Wikipedia (external link) — (La-Heft) und
• Kilometrierungssystem für Gleisarbeiten im AVS (Kilometrierungssystem)

Da diese Referenzen anwendungsbezogen oder Computerprogramm-spezifisch sind, sollten diese nicht als das streckenbestimmende <code>-Attribut verwendet werden. Diese zusätzlichen Verwaltungsnummern der Strecke können im dazugehörigen <any>-Element angegeben werden.

<any OeBB-Infra.Fahrzeitentafel.01="R179000ABC"
     OeBB-Infra.Fahrzeitentafel.02="R180000AB"
     OeBB-Infra.Fahrzeitentafel.03="R181000ABCD"
     OeBB-Infra.Fahrzeitentafel.04="S079000ABCD"
     OeBB-Infra.Fahrzeitentafel.05="S080000AB"
     OeBB-Infra.Fahrzeitentafel.06="S081000ABC"
     OeBB-Infra.LaStrecke="118">
     OeBB-Infra.Kilometrierungssystem="18" />

Additional information / Zusätzliche Informationen /

Notes / Anmerkungen /

line is a logical group of tracks and not the physical railway track itself.

Example / Beispiel /

Not yet described. / Noch nicht beschrieben. /

Open issues / Offene Punkte/Pedenzen /

Not yet described. / Noch nicht beschrieben. /