IS:speedSection: Difference between revisions

From railML 3 Wiki
Jump to navigation Jump to search
[unchecked revision][checked revision]
(Entwurf)
(Input Siemens ETCS-Arbeitsgruppe)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
<!--Element '''{{{element}}}'''-->
<!--Element '''{{{element}}}'''-->
=={{introduction}}==
=={{introduction}}==
Speed limits are modelled in {{rml}} using {{tag|is|speedSection}} elements in combination with {{tag|co|speedProfile}} elements. A simple example is shown [[#examples|below]]. A more complex example is provided in [[CO:speedProfile#Example3|Example 3 of {{rml}} element <speedProfile>]].
Speed limits are modelled in {{rml}} using speedSection elements in combination with {{tag|co|speedProfile}} elements.
 
=={{documentation}}==
=={{documentation}}==
==={{syntax}}===
==={{syntax}}===
Line 9: Line 10:
{{importComment}}
{{importComment}}
=={{examples}}==
=={{examples}}==
A speed limit valid for a speed section is presented in {{rml}} by a {{tag|is|speedSection}} element. The {{tag|is|speedSection}} element defines the start and end location of the speed section and the maximum speed limit valid for this section.
A speed limit valid for a speed section is presented in {{rml}} by a speedSection element. The speedSection element defines the start and end location of the speed section and the maximum speed limit valid for this section.
<div class="res-img">
 
[[file:speedProfile1.pdf]]
[[File:Static speed profiles diagram.svg|thumb|1000px|Example of a static speed profile for a railway track section]]
</div>''Example Static Speed Profile for a railway track section''


;The modelling in {{rml}} is:
The modelling in {{rml}} is:
<syntaxhighlight lang=xml>
<syntaxhighlight lang="xml">
<speedSection id="spsec100" maxSpeed="80" isTemporary="false" isSignalized="false">
<speedSection id="spsec100" maxSpeed="80" isTemporary="false" isSignalized="false" refersToTrain="endOfTrain">
  <name name="JNA-201" description="Speed section" language="EN"/>
<name name="JNA-201" description="Speed section" language="EN"/>
  <linearLocation id="spsec100_lloc" applicationDirection="normal">
<linearLocation id="spsec100_lloc" applicationDirection="normal">
<associatedNetElement netElementRef="ne_102" keepsOrientation="true"
<associatedNetElement netElementRef="ne_102" keepsOrientation="true">
posBegin="200.0" posEnd="600.0">
<linearCoordinateBegin positioningSystemRef="lps01" measure="11200.0"/>
  <linearCoordinateBegin positioningSystemRef="lps01" measure="11200.0"/>
<linearCoordinateEnd positioningSystemRef="lps01" measure="11600.0"/>
  <linearCoordinateEnd positioningSystemRef="lps01" measure="11600.0"/>
</associatedNetElement>
</associatedNetElement>
</linearLocation>
  </linearLocation>
<validForSpeedProfile ref="ssp_basic"/>
  <validForSpeedProfile ref="ssp_basic"/>
</speedSection>
</speedSection>
</syntaxhighlight>
</syntaxhighlight>
Each {{rml}} {{tag|is|speedSection}} element must reference (at least) one global defined {{rml}} {{tag|co|speedProfile}} element. A {{tag|co|speedProfile}} element specifies a train type for which the speed limit given by a {{tag|is|speedSection}} element shall be valid.
Each {{rml}} speedSection element must reference (at least) one global defined {{rml}} speedProfile element. A speedProfile element specifies a train type for which the speed limit given by a speedSection element shall be valid.
 
For example a {{tag|co|speedProfile}} element can be used to provide for ETCS a '''''Basic''' Static Speed Profile'', a '''''Specific''' Static Speed Profile'' (cant deficiency or brake type depending train categories, ETCS Operational Train categories or International Train Categories) or an '''''Axle Load''' Speed Profile''. For detailed information see speedProfile Element (section X)


;Example:
For example a speedProfile element can be used to provide for ETCS a '''''Basic''' Static Speed Profile'', a '''''Specific''' Static Speed Profile'' (cant deficiency or brake type depending train categories, ETCS Operational Train categories or International Train Categories) or an '''''Axle Load''' Speed Profile''. For detailed information see {{tag|co|speedProfile}}.
<syntaxhighlight lang=xml>
;Example
<syntaxhighlight lang="xml">
<common id="co_01">
<common id="co_01">
  <speedProfiles>
<speedProfiles>
<speedProfile id="ssp_Basic" isBasicSpeedProfile="true" mVersion="32">
<speedProfile id="ssp_Basic" isBasicSpeedProfile="true" mVersion="32">
  <name name="ETCS Basic SSP" description="Basic ETCS static
<name name="ETCS Basic SSP" description="Basic ETCS static speed profile used by trains for which no Specific SSP matches" language="EN"/>
speed profile used by trains for which no Specific SSP matches"  
</speedProfile>
language="EN"/>
</speedProfiles>
</speedProfile>
  </speedProfiles>
</common>
</common>
</syntaxhighlight>
</syntaxhighlight>
=={{Additional Information}}==
=={{Additional Information}}==
==={{Notes}}===
==={{Notes}}===
==={{Open issues}}===
==={{Open issues}}===
# Shall the location of {{tag|is|speedSection}} in {{rml}} be provided as linear element or as area element?
# A {{rml}} attribute for {{tag|is|speedSection}} is missing to represent the UNISIG variable Q_FRONT.

Latest revision as of 18:16, 15 January 2024

Introduction

Speed limits are modelled in railML® using speedSection elements in combination with <speedProfile> elements.

Documentation

Syntax

Autoexport from the XML-Schema for element IS:speedSection of railML® version 3.2
Documentation locates part of a track where given permanent speed restriction is applicable
Subschema infrastructure
Parents* speeds
Children areaLocation (0..*), designator (0..*), external (0..*), gmlLocations (0..*), isValid (0..*), linearLocation (0..*), name (0..*), networkLocation (0..*), spotLocation (0..*), typeDesignator (0..*), validForSpeedProfile (0..*)
Attributes:
  • isSignalized: indicates whether the speed aspect is shown next to the track by a signal or panel (true) or only in the "driver's timetable" (false) (optional; xs:boolean),

  • isTemporary: boolean value to indicate whether the speed section is temporary (optional; xs:boolean),

  • maxSpeed: maximum permitted speed in the speed section, in [km/h] (optional; xs:decimal)
Possible values:
  • end,

  • refersToTrain: Reference to the part of the train from where on the speed aspect is valid. Normally, a limiting speed signal aspect relates to the head of the train while a speed release refers to the end of the train. In ETCS this is usually refered to as Q_FRONT (optional; xs:string)
Possible values:
  • endOfTrain: The tail of the train should be located at the stopping place when the train has stopped.
  • headOfTrain: The headof the train should be located at the stopping place when the train has stopped. This is the default setting.
  • midOfTrain: The center of the train should be located at the stopping place when the train has stopped.,

  • id: the identifier of the object; this can be either of type xs:ID or UUID (obligatory; xs:string; patterns: (urn:uuid:)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}); compare: Dev:Identities
*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:speedSection of railML® version 3.1
Documentation This element is not documented in the schema!
Subschema infrastructure
Parents* speeds
Children any (0..*), areaLocation (0..*), designator (0..*), external (0..*), gmlLocations (0..*), isValid (0..*), linearLocation (0..*), name (0..*), networkLocation (0..*), spotLocation (0..*), validForSpeedProfile (0..*)
Attributes:
  • maxSpeed: maximum permitted speed in the speed section, in [km/h] (optional; xs:decimal)
Possible values:
  • end,

  • isTemporary: boolean value to indicate whether the speed section is temporary (optional; xs:boolean),

  • isSignalized: indicates whether the speed aspect is shown next to the track by a signal or panel (true) or only in the "driver's timetable" (false) (optional; xs:boolean),

  • id: the identifier of the object; this can be either of type xs:ID or UUID (obligatory; xs:ID; patterns: (urn:uuid:)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}); compare: Dev:Identities
*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

The element documentation has been changed.

The children have changed.

The attributes have been changed.

Semantics

Best Practice / Examples

A speed limit valid for a speed section is presented in railML® by a speedSection element. The speedSection element defines the start and end location of the speed section and the maximum speed limit valid for this section.

Example of a static speed profile for a railway track section

The modelling in railML® is:

<speedSection id="spsec100" maxSpeed="80" isTemporary="false" isSignalized="false" refersToTrain="endOfTrain">
	<name name="JNA-201" description="Speed section" language="EN"/>
	<linearLocation id="spsec100_lloc" applicationDirection="normal">
		<associatedNetElement netElementRef="ne_102" keepsOrientation="true">
			<linearCoordinateBegin positioningSystemRef="lps01" measure="11200.0"/>
			<linearCoordinateEnd positioningSystemRef="lps01" measure="11600.0"/>
		</associatedNetElement>
	</linearLocation>
	<validForSpeedProfile ref="ssp_basic"/>
</speedSection>

Each railML® speedSection element must reference (at least) one global defined railML® speedProfile element. A speedProfile element specifies a train type for which the speed limit given by a speedSection element shall be valid.

For example a speedProfile element can be used to provide for ETCS a Basic Static Speed Profile, a Specific Static Speed Profile (cant deficiency or brake type depending train categories, ETCS Operational Train categories or International Train Categories) or an Axle Load Speed Profile. For detailed information see <speedProfile>.

Example
<common id="co_01">
	<speedProfiles>
		<speedProfile id="ssp_Basic" isBasicSpeedProfile="true" mVersion="32">
			<name name="ETCS Basic SSP" description="Basic ETCS static speed profile used by trains for which no Specific SSP matches" language="EN"/>
		</speedProfile>
	</speedProfiles>
</common>

Additional Information

Notes

Open Issues