IS:length

Introduction

🗒️ This article uses the unit label meter. As the reference for this Wiki is British English, the correct label is metre. Wherever the label meter occurs, it is meant equivalently to metre.

Documentation

Syntax

Autoexport from the XML-Schema for element IS:length of railML® version 3.3      UML-visualization of IS
Documentation	length of the line (section)
Subschema	infrastructure
Parents*	line, overCrossing, platformEdge, track, underCrossing
Children	None
Attributes: type: type of length (operational, physical, administrative...) (obligatory; xs:string; patterns: other:w{2,}; consider Dev:UsingAny too.) Possible values: operational: operational or administrative length value physical: physical length value, validForDirection: indicate the direction for which the length information applies (optional; xs:string) Possible values: both reverse normal, value: the distance value given in meters (obligatory; xs:decimal)
*Notice: Elements may have different parent elements. As a consequence they may be used in different contexts. Please, consider this as well as a user of this Wiki as when developing this documentation further. Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element.

Autoexport from the XML-Schema for element IS:length of railML® version 3.2      UML-visualization of IS
Documentation	length of the line (section)
Subschema	infrastructure
Parents*	line, overCrossing, platform, platformEdge, track, underCrossing
Children	None
Attributes: type: type of length (operational, physical, administrative...) (obligatory; xs:string; patterns: other:w{2,}; consider Dev:UsingAny too.) Possible values: operational: operational or administrative length value physical: physical length value, validForDirection: indicate the direction for which the length information applies (optional; xs:string) Possible values: both reverse normal, value: the distance value given in meters (obligatory; xs:decimal)
*Notice: Elements may have different parent elements. As a consequence they may be used in different contexts. Please, consider this as well as a user of this Wiki as when developing this documentation further. Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element.

Autoexport from the XML-Schema for element IS:length of railML® version 3.1      UML-visualization of IS
Documentation	length of the line (section)
Subschema	infrastructure
Parents*	line, overCrossing, platform, track, underCrossing
Children	None
Attributes: value: the distance value given in meters (obligatory; xs:decimal), type: type of length (operational, physical, administrative...) (obligatory; xs:string; patterns: other:w{2,}; consider Dev:UsingAny too.) Possible values: physical: physical length value operational: operational or administrative length value, validForDirection: indicate the direction for which the length information applies (optional; xs:string) Possible values: both reverse normal
*Notice: Elements may have different parent elements. As a consequence they may be used in different contexts. Please, consider this as well as a user of this Wiki as when developing this documentation further. Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element.

Changes 3.1→3.2

There exists an overview of all changes between railML^® 3.1 and railML^® 3.2 on page Dev:Changes/3.2.

The parents have been changed.

The attributes have been changed.

Changes 3.2→3.3

There exists an overview of all changes between railML^® 3.2 and railML^® 3.3 on page Dev:Changes/3.3.

The parents have been changed.

Best Practice / Examples

Track's usable length

The usable length of station tracks is the part of a track where a train can stop without blocking a neighbouring/parallel station track.

• 

  Overview

• 

  Physical length

• 

  Operational length, normal direction

• 

  Operational length, reverse direction

<?xml version="1.0" encoding="UTF-8"?>
<railML xmlns="https://www.railml.org/schemas/3.2" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:gml="http://www.opengis.net/gml/3.2/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://www.railml.org/schemas/3.2 https://www.railml.org/schemas/3.2/railml3.xsd" version="3.2">
  <common id="co1">
    <positioning>
      <linearPositioningSystems>
        <linearPositioningSystem id="lps1" startMeasure="0" endMeasure="10000" linearReferencingMethod="absolute" units="meters">
          <isValid/>
        </linearPositioningSystem>
      </linearPositioningSystems>
    </positioning>
  </common>
  <infrastructure id="is01">
    <topology>
      <netElements>
        <netElement id="ne1">
          <associatedPositioningSystem id="asp1" positioningSystemRef="lps1">
            <intrinsicCoordinate id="intC0" intrinsicCoord="0">
              <linearCoordinate measure="4264" positioningSystemRef="lps1"/>
            </intrinsicCoordinate>
            <intrinsicCoordinate id="intC1" intrinsicCoord="1">
              <linearCoordinate measure="5198" positioningSystemRef="lps1"/>
            </intrinsicCoordinate>
          </associatedPositioningSystem>
        </netElement>
      </netElements>
      <networks>
        <network id="net1">
          <level id="lv1" descriptionLevel="Micro">
            <networkResource ref="ne1"/>
          </level>
        </network>
      </networks>
    </topology>
    <functionalInfrastructure>
      <signalsIS>
        <signalIS id="sig1">
          <name name="69P2" language="en"/>
          <spotLocation id="spL2" netElementRef="ne1">
            <linearCoordinate measure="4383" positioningSystemRef="lps1"/>
          </spotLocation>
        </signalIS>
        <signalIS id="sig2">
          <name name="69N2" language="en"/>
          <spotLocation id="spL3" netElementRef="ne1">
            <linearCoordinate measure="5000" positioningSystemRef="lps1"/>
          </spotLocation>
        </signalIS>
      </signalsIS>
      <switchesIS>
        <switchIS id="sw1">
          <spotLocation id="spL1" netElementRef="ne1" intrinsicCoord="0.0"/>
        </switchIS>
        <switchIS id="sw2">
          <spotLocation id="spL4" netElementRef="ne1" intrinsicCoord="1.0"/>
        </switchIS>
      </switchesIS>
      <tracks>
        <track id="t1" type="mainTrack">
          <linearLocation id="l1">
            <associatedNetElement netElementRef="ne1" intrinsicCoordBegin="0.0" intrinsicCoordEnd="1.0" keepsOrientation="true"/>
          </linearLocation>
          <length type="physical" validForDirection="both" value="934"/>
          <length type="operational" validForDirection="normal" value="678"/>
          <length type="operational" validForDirection="reverse" value="617"/>
        </track>
      </tracks>
      <trainDetectionElements>
        <trainDetectionElement id="tde1" type="insulatedRailJoint">
          <spotLocation id="spL5" netElementRef="ne1">
            <linearCoordinate measure="4322" positioningSystemRef="lps1"/>
          </spotLocation>
        </trainDetectionElement>
        <trainDetectionElement id="tde2" type="insulatedRailJoint">
          <spotLocation id="spL6" netElementRef="ne1">
            <linearCoordinate measure="5000" positioningSystemRef="lps1"/>
          </spotLocation>
        </trainDetectionElement>
      </trainDetectionElements>
    </functionalInfrastructure>
  </infrastructure>
</railML>