Template:InheritConnection: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[checked revision][checked revision]
(added radius definition)
(Simplified template as it is now only used by switch and crossing. Modified descriptions.)
 
(22 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<includeonly>{{ElementDocu|
<includeonly>{{ElementDocu|
elementName = connection
elementName = connection
|parent = {{{parentLink|FIXME}}}
|parent = {{{parentLink|FIXME}}}
|childs={{#if:{{{childs|}}}|{{{childs}}}|''None''}}
|minocc={{{minocc|1}}}
|minocc={{{minocc|1}}}
|maxocc={{{maxocc|1}}}
|maxocc={{{maxocc|1}}}
|semantics =
|semantics = The {{{selfLink|FIXME}}} describes a branch of the {{{parentLink|FIXME}}}, including which other {{IS:Doc|track}} this branch is connected to. See [[Dev:Connection between tracks]] for more details on different connections between tracks.
A {{{selfLink|FIXME}}} is an element to determine which branches of a {{IS:Doc|track}} are connected at a certain position. {{AddAnn|{{{semantics_en|}}}|{{{semantics_de|}}} }}


|inheritedAttributes =  
|inheritedAttributes =  
{{InheritId
{{InheritId}}
|id = {{{id|}}}
|id_de = {{{id_de|}}}
}}
{{InheritRef
{{InheritRef
|attributeName = ref
|attributeName = ref
|contextLink = '''<connection>'''
|contextLink = {{IS:Tag|connection}}
|notes_en = {{{ref|}}}
|notes_de = {{{ref_de|}}}
}}
}}
<!--|ownAttributes={{#if:{{{ownAttributes|}}}|{{{ownAttributes}}}|''None''}}-->
|ownAttributes =
|ownAttributes =
{{#switch: {{FULLPAGENAMEE}}
* {{Attr|orientation}}: Orientation of the {{{parentLink|FIXME}}} branch relative to the direction of the {{IS:Tag|track}} (looking towards the {{IS:Tag|trackEnd}}).
| IS:connection_switch
:* {{Enum|incoming}}: This branch is merging into the track, tracks are converging relative to the direction.
| IS:connection_crossing =
:* {{Enum|outgoing}}: Twis branch is splitting out from the track, tracks are diverging relative to the direction.
* {{Attr|orientation}}: Orientation of the switch element relative to general track direction (aligned with increasing mileage) [Norwegian railML 2.4 glossary]
:* {{Enum|rightAngled}}: This branch is crossing perpendicular to the track. Only meaningful for {{IS:Tag|crossing}}, not for {{IS:Tag|switch}}.
{{missing information|user=[[User:Ferri Leberl|Ferri Leberl]] ([[User talk:Ferri Leberl|talk]]) 16:28, 25 April 2018 (CEST)|topic=the semantics of the enumeration items}}
:* {{Enum|unknown}}: The direction is not known.
:* {{Enum|incoming}}: A track is merging into the principal track, tracks are converging relative to the direction [Norwegian railML 2.4 glossary]
:* {{OtherEnum}}
:* {{Enum|outgoing}}: A track is splitting out from the principal track, tracks are diverging relative to the direction [Norwegian railML 2.4 glossary]
* {{Attr|course}}: Sideways direction of this branch relative to the continuation of the {{IS:Tag|track}} in the track's direction (looking towards the {{IS:Tag|trackEnd}}).
:* {{Enum|rightAngled}}
:* {{Enum|straight}} This branch continues straight. This assumes the principal track is not considered straight ({{IS:Tag|switch|@=trackContinueCourse}} is not <tt>"straight"</tt>).
:* {{Enum|unknown}}
:* {{Enum|left}}: This branch is merging from the left or is diverging leftward from the track.
:* {{OtherEnum
:* {{Enum|right}}: This branch is merging from the right or is diverging rightward from the track.
|notes_en = {{{orientation|}}}
:* {{OtherEnum}}
|notes_de = {{{orientation_de|}}}
* {{Attr|radius}}: Radius of the curve with which the branch rails converge into or diverge from the track, measured from an imaginary center of a circle. Defined in the same way as {{IS:Tag|radiusChange|@=value}}.
}}
* {{Attr|maxSpeed}}: Speed restriction for passing over the switch on this branch.
* {{Attr|course}}: Relative direction of a converging/diverging track connection facilitated by a switch in a crossing. Course is always defined relative to the switch element (i.e. to stock rail), regardless of global track direction. [Norwegian railML 2.4 glossary]
 
{{missing information|user=[[User:Ferri Leberl|Ferri Leberl]] ([[User talk:Ferri Leberl|talk]]) 16:28, 25 April 2018 (CEST)|topic=the semantics of the enumeration items}}
* {{Attr|passable}} Denotes if you can pass between the track the {{{selfLink|FIXME}}} is placed on and the track referred to by {{Attr|ref}}. See [[Dev:Connection_between_tracks]] for descriptions of the usage.
:* {{Enum|straight}}
* {{Attr|branchDist}} {{Depr|2.1}} Since originally no separate, connecting track element was allowed, a special attribute denoted the length of the connection. See [[Dev:Connection_between_tracks]].
:* {{Enum|left}}: A switch track is merging from the left or is diverging leftward from the principal track [Norwegian railML 2.4 glossary]
 
:* {{Enum|right}}: A switch track is merging from the right or is diverging rightward from the principal track [Norwegian railML 2.4 glossary]
:* {{OtherEnum
|notes_en = {{{course|}}}
|notes_de = {{{course_de|}}}
}}
* {{Attr|radius}}: Radius of the curve with which the switch rails converge into or diverge from the principal track, measured from an imaginary center of a circle.
Value will usually be non-zero.
{{AddAnn|{{{radius|}}}|{{{radius_de|}}} }}
* {{Attr|maxSpeed}} {{AddAnn|{{{maxSpeed|}}}|{{{maxSpeed_de|}}} }}
* {{Attr|passable}} {{AddAnn|{{{passable|}}}|{{{passable_de|}}} }}
* {{Attr|branchDist}} {{Depr|2.1}}
}}
|constraints =
|constraints =
{{InheritIdConstraints}}
{{InheritIdConstraints}}
*{{constraint|ref|rml|tGenericRef|required}} {{AddAnn|Must point to the {{Attr|id}} of another {{IS:Tag|connection}}}}
*{{constraint|ref|rml|tGenericRef|required}} {{AddAnn|Must point to the {{Attr|id}} of another {{IS:Tag|connection}}}}
{{#switch: {{FULLPAGENAMEE}}
|IS:connection_switch
|IS:connection_crossing =
*{{constraint|orientation|rml|tConnectionOrientation|required}}
*{{constraint|orientation|rml|tConnectionOrientation|required}}
*{{constraint|course|rml|tCourse}}
*{{constraint|course|rml|tCourse}}
Line 63: Line 39:
*{{constraint|passable|xsd|boolean|default=TRUE}}
*{{constraint|passable|xsd|boolean|default=TRUE}}
*{{constraint|branchDist|rml|tLengthM}}
*{{constraint|branchDist|rml|tLengthM}}
}} {{AddAnn|{{{constraints_en|}}}|{{{constraints_de|}}} }}
 
|notes = {{AddAnn|{{{notes_en|None.}}}|{{{notes_de|}}} }}
|notes = {{AddAnn|{{{notes_en|None.}}}|{{{notes_de|}}} }}
|bestpractice={{{bestpractice|}}}
|bestpractice={{{bestpractice|}}}
|example=
|example =  
|example =  
Please also refer to [[Dev:Connection_between_tracks]] for information on how to use connections and switches.
Please also refer to [[Dev:Connection between tracks]] for information on how to use connections and switches/crossings.


}}</includeonly><noinclude>{{TemplateDocu}}</noinclude>
}}</includeonly><noinclude>{{TemplateDocu}}</noinclude>

Latest revision as of 06:04, 5 June 2024

Usage

This is an Element Template. Element templates are intended to avoid routine work in railML® element documentation. These templates are very specific and are therefore documented uniformely by Template:TemplateDocu. They are collected in Category:Element Template and are based on Template:ElementDocu. They represent Template:ElementDoku with specific values and hand all other parameters through to Template:ElementDoku. If you want to use or handle an Element Template, you have to examine the code to find out, which arguments are set, and you have to be careful, because occationally arguments will be renamed, so that the use of argument names of Template ElementDoku may cause errors.

Arguments

As this is a bulk documentation, we do not explain the specific arguments of element templates.

Dependencies

As this is a bulk documentation, we do not explain the specific dependencies of element templates. You can find out, which other templates the current template supports by following this link. You can find out easily, which other templates the current template employs, as templates are included via {{doubble braces}}.

Example

As this is a bulk documentation, we do not offer specific examples of element templates. You can find in the field examples by following this link.

Retrieved from "https://wiki2.railml.org/index.php?title=Template:InheritConnection&oldid=15663"