Skip to content

Commit 344d657

Browse files
committed
deploy: 86f8085
1 parent af54f0b commit 344d657

File tree

7 files changed

+56
-56
lines changed

7 files changed

+56
-56
lines changed

en/docs/_print/index.html

+8-8
Original file line numberDiff line numberDiff line change
@@ -263,18 +263,18 @@
263263
</span></span></span><span style=display:flex><span><span style=color:#f8f8f8;text-decoration:underline>
264264
</span></span></span><span style=display:flex><span><span style=color:#f8f8f8;text-decoration:underline> </span><span style=color:#204a87;font-weight:700>&#34;track_ranges&#34;: [{&#34;track&#34;: &#34;${TRACK_SECTION}&#34;, &#34;begin&#34;: 0, &#34;end&#34;: 42, &#34;applicable_directions&#34;: </span><span style=color:#4e9a06>&#34;START_TO_STOP&#34;</span>}<span style=color:#000;font-weight:700>],</span><span style=color:#f8f8f8;text-decoration:underline>
265265
</span></span></span><span style=display:flex><span><span style=color:#f8f8f8;text-decoration:underline></span>}<span style=color:#f8f8f8;text-decoration:underline>
266-
</span></span></span></code></pre></div><h2 id=design-considerations>Design considerations</h2><h3 id=where-to-put-the-speed-limit-value>Where to put the speed limit value</h3><p>When a speed limit is announced by dynamic signaling, we may be in a position where speed limit value is duplicated:</p><ul><li>once in the signal itself</li><li>once in the speed limit</li></ul><p>There are multiple ways this issue can be dealt with:</p><h4 id=hahahugoshortcode127s0hbhb-mandatory-speed-limit-value-in-the-speed-section>
267-
Mandatory speed limit value in the speed section</h4><p>Upsides:</p><ul><li>simpler to implement, works even without train reactions to signals nor additional API</li></ul><p>Downsides:</p><ul><li>more work on the side of users</li><li>room for inconsistencies between the speed limit announced by signaling, and the effective speed limit</li></ul><h4 id=hahahugoshortcode127s1hbhb-deduce-the-signal-constraint-from-the-speed-limit>
266+
</span></span></span></code></pre></div><h2 id=design-considerations>Design considerations</h2><h3 id=where-to-put-the-speed-limit-value>Where to put the speed limit value</h3><p>When a speed limit is announced by dynamic signaling, we may be in a position where speed limit value is duplicated:</p><ul><li>once in the signal itself</li><li>once in the speed limit</li></ul><p>There are multiple ways this issue can be dealt with:</p><h4 id=hahahugoshortcode126s0hbhb-mandatory-speed-limit-value-in-the-speed-section>
267+
Mandatory speed limit value in the speed section</h4><p>Upsides:</p><ul><li>simpler to implement, works even without train reactions to signals nor additional API</li></ul><p>Downsides:</p><ul><li>more work on the side of users</li><li>room for inconsistencies between the speed limit announced by signaling, and the effective speed limit</li></ul><h4 id=hahahugoshortcode126s1hbhb-deduce-the-signal-constraint-from-the-speed-limit>
268268
Deduce the signal constraint from the speed limit</h4><p>This option was not explored much, as it was deemed awkward
269-
to deduce signal parameters from a speed limit value.</p><h4 id=hahahugoshortcode127s2hbhb-deduce-the-speed-limit-from-the-signal>
269+
to deduce signal parameters from a speed limit value.</p><h4 id=hahahugoshortcode126s2hbhb-deduce-the-speed-limit-from-the-signal>
270270
Deduce the speed limit from the signal</h4><p>Make the speed limit value optional, and deduce it from the signal itself.
271271
Speed limits per tag also have to be deduced if missing.</p><p>Upsides:</p><ul><li>less work for users</li><li>lessens the likelyhood of configuration mismatches</li></ul><p>Downsides:</p><ul><li>not all signaling systems work well with this. It may be difficult to deduce the announced speed limit from a signal configuration, such as with TVM.</li><li>speed limits have to be deduced, which increases implementation complexity</li></ul><h3 id=how-to-link-announce-signals-and-speed-limit-area>How to link announce signals and speed limit area</h3><p>Speed limit announced by dynamic signaling often start being enforced at a specific location,
272272
which is distinct from the signal which announces the speed limit.</p><p>To allow for correct train reactions to this kind of limits, a link between the announce signal
273-
and the speed limit section has to be made at some point.</p><h4 id=hahahugoshortcode127s3hbhb-automated-matching-of-signals-and-speed-sections>
274-
Automated matching of signals and speed sections</h4><p>Was not deemed realistic.</p><h4 id=hahahugoshortcode127s4hbhb-explicit-link-from-route-to-speed-limit-and-signals>
273+
and the speed limit section has to be made at some point.</p><h4 id=hahahugoshortcode126s3hbhb-automated-matching-of-signals-and-speed-sections>
274+
Automated matching of signals and speed sections</h4><p>Was not deemed realistic.</p><h4 id=hahahugoshortcode126s4hbhb-explicit-link-from-route-to-speed-limit-and-signals>
275275
Explicit link from route to speed limit and signals</h4><p>Was deemed to be awkward, as signaling is currently built over interlocking.
276-
Referencing signaling from interlocking creates a circular dependency between the two schemas.</p><h4 id=hahahugoshortcode127s5hbhb-explicit-link-from-speed-limit-to-signals>
277-
Explicit link from speed limit to signals</h4><p>Add a list of <code>(route, signal)</code> tuples to speed sections.</p><p>Upside:</p><ul><li>a link with the signal can be made with creating the speed section</li></ul><p>Downside:</p><ul><li>Creates a dependency loop between speed limits and signaling. Part of the parsing of speed limit has to be deferred.</li><li>Signals parameters also have to be set per route, which is done in the signal. Having per-route options on both sides doubles the work.</li></ul><h4 id=hahahugoshortcode127s6hbhb-inlining-speed-limit-definitions-into-signals>
276+
Referencing signaling from interlocking creates a circular dependency between the two schemas.</p><h4 id=hahahugoshortcode126s5hbhb-explicit-link-from-speed-limit-to-signals>
277+
Explicit link from speed limit to signals</h4><p>Add a list of <code>(route, signal)</code> tuples to speed sections.</p><p>Upside:</p><ul><li>a link with the signal can be made with creating the speed section</li></ul><p>Downside:</p><ul><li>Creates a dependency loop between speed limits and signaling. Part of the parsing of speed limit has to be deferred.</li><li>Signals parameters also have to be set per route, which is done in the signal. Having per-route options on both sides doubles the work.</li></ul><h4 id=hahahugoshortcode126s6hbhb-inlining-speed-limit-definitions-into-signals>
278278
Inlining speed limit definitions into signals</h4><p>Introduces a new type of speed limit, which are announced by signals.
279279
These speed limits are directly defined within signal definitions.</p><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-yaml data-lang=yaml><span style=display:flex><span>{<span style=color:#f8f8f8;text-decoration:underline>
280280
</span></span></span><span style=display:flex><span><span style=color:#f8f8f8;text-decoration:underline> </span><span style=color:#8f5902;font-style:italic># ...</span><span style=color:#f8f8f8;text-decoration:underline>
@@ -291,7 +291,7 @@
291291
</span></span></span><span style=display:flex><span><span style=color:#f8f8f8;text-decoration:underline> </span><span style=color:#000;font-weight:700>]</span><span style=color:#f8f8f8;text-decoration:underline>
292292
</span></span></span><span style=display:flex><span><span style=color:#f8f8f8;text-decoration:underline> </span><span style=color:#8f5902;font-style:italic># ...</span><span style=color:#f8f8f8;text-decoration:underline>
293293
</span></span></span><span style=display:flex><span><span style=color:#f8f8f8;text-decoration:underline></span>}<span style=color:#f8f8f8;text-decoration:underline>
294-
</span></span></span></code></pre></div><p>Upsides:</p><ul><li>straightforward infrastructure edition experience for speed sections announced by a single signal</li></ul><p>Downsides:</p><ul><li>creates two separate kinds of speed limits:<ul><li>can cause code duplication</li><li>could make later changes of the data model trickier</li><li>it&rsquo;s unclear whether the criterion used to make this partition is appropriate</li></ul></li><li>speed sections created directly inside signals can only be announced by a single signal, which could be an issue for speed sections which apply to very large areas, and are announced by multiple signals (such as one for each direction)</li><li>the cost of reversing this decision could be fairly high</li></ul><h4 id=hahahugoshortcode127s7hbhb-explicit-link-from-signal-to-speed-section>
294+
</span></span></span></code></pre></div><p>Upsides:</p><ul><li>straightforward infrastructure edition experience for speed sections announced by a single signal</li></ul><p>Downsides:</p><ul><li>creates two separate kinds of speed limits:<ul><li>can cause code duplication</li><li>could make later changes of the data model trickier</li><li>it&rsquo;s unclear whether the criterion used to make this partition is appropriate</li></ul></li><li>speed sections created directly inside signals can only be announced by a single signal, which could be an issue for speed sections which apply to very large areas, and are announced by multiple signals (such as one for each direction)</li><li>the cost of reversing this decision could be fairly high</li></ul><h4 id=hahahugoshortcode126s7hbhb-explicit-link-from-signal-to-speed-section>
295295
Explicit link from signal to speed section</h4><div class=highlight><pre tabindex=0 style=background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-yaml data-lang=yaml><span style=display:flex><span>{<span style=color:#f8f8f8;text-decoration:underline>
296296
</span></span></span><span style=display:flex><span><span style=color:#f8f8f8;text-decoration:underline> </span><span style=color:#8f5902;font-style:italic># ...</span><span style=color:#f8f8f8;text-decoration:underline>
297297
</span></span></span><span style=display:flex><span><span style=color:#f8f8f8;text-decoration:underline> </span><span style=color:#204a87;font-weight:700>&#34;conditional_parameters&#34;: </span><span style=color:#000;font-weight:700>[</span><span style=color:#f8f8f8;text-decoration:underline>

en/docs/index.xml

+8-8
Original file line numberDiff line numberDiff line change
@@ -1097,7 +1097,7 @@ The implementation hasn&amp;rsquo;t been started.&lt;/p></description></item><it
10971097
&lt;li>once in the speed limit&lt;/li>
10981098
&lt;/ul>
10991099
&lt;p>There are multiple ways this issue can be dealt with:&lt;/p>
1100-
&lt;h4 id="hahahugoshortcode127s0hbhb-mandatory-speed-limit-value-in-the-speed-section">✅
1100+
&lt;h4 id="hahahugoshortcode126s0hbhb-mandatory-speed-limit-value-in-the-speed-section">✅
11011101
Mandatory speed limit value in the speed section&lt;/h4>
11021102
&lt;p>Upsides:&lt;/p>
11031103
&lt;ul>
@@ -1108,11 +1108,11 @@ Mandatory speed limit value in the speed section&lt;/h4>
11081108
&lt;li>more work on the side of users&lt;/li>
11091109
&lt;li>room for inconsistencies between the speed limit announced by signaling, and the effective speed limit&lt;/li>
11101110
&lt;/ul>
1111-
&lt;h4 id="hahahugoshortcode127s1hbhb-deduce-the-signal-constraint-from-the-speed-limit">❌
1111+
&lt;h4 id="hahahugoshortcode126s1hbhb-deduce-the-signal-constraint-from-the-speed-limit">❌
11121112
Deduce the signal constraint from the speed limit&lt;/h4>
11131113
&lt;p>This option was not explored much, as it was deemed awkward
11141114
to deduce signal parameters from a speed limit value.&lt;/p>
1115-
&lt;h4 id="hahahugoshortcode127s2hbhb-deduce-the-speed-limit-from-the-signal">❌
1115+
&lt;h4 id="hahahugoshortcode126s2hbhb-deduce-the-speed-limit-from-the-signal">❌
11161116
Deduce the speed limit from the signal&lt;/h4>
11171117
&lt;p>Make the speed limit value optional, and deduce it from the signal itself.
11181118
Speed limits per tag also have to be deduced if missing.&lt;/p>
@@ -1131,14 +1131,14 @@ Speed limits per tag also have to be deduced if missing.&lt;/p>
11311131
which is distinct from the signal which announces the speed limit.&lt;/p>
11321132
&lt;p>To allow for correct train reactions to this kind of limits, a link between the announce signal
11331133
and the speed limit section has to be made at some point.&lt;/p>
1134-
&lt;h4 id="hahahugoshortcode127s3hbhb-automated-matching-of-signals-and-speed-sections">❌
1134+
&lt;h4 id="hahahugoshortcode126s3hbhb-automated-matching-of-signals-and-speed-sections">❌
11351135
Automated matching of signals and speed sections&lt;/h4>
11361136
&lt;p>Was not deemed realistic.&lt;/p>
1137-
&lt;h4 id="hahahugoshortcode127s4hbhb-explicit-link-from-route-to-speed-limit-and-signals">❌
1137+
&lt;h4 id="hahahugoshortcode126s4hbhb-explicit-link-from-route-to-speed-limit-and-signals">❌
11381138
Explicit link from route to speed limit and signals&lt;/h4>
11391139
&lt;p>Was deemed to be awkward, as signaling is currently built over interlocking.
11401140
Referencing signaling from interlocking creates a circular dependency between the two schemas.&lt;/p>
1141-
&lt;h4 id="hahahugoshortcode127s5hbhb-explicit-link-from-speed-limit-to-signals">❌
1141+
&lt;h4 id="hahahugoshortcode126s5hbhb-explicit-link-from-speed-limit-to-signals">❌
11421142
Explicit link from speed limit to signals&lt;/h4>
11431143
&lt;p>Add a list of &lt;code>(route, signal)&lt;/code> tuples to speed sections.&lt;/p>
11441144
&lt;p>Upside:&lt;/p>
@@ -1150,7 +1150,7 @@ Explicit link from speed limit to signals&lt;/h4>
11501150
&lt;li>Creates a dependency loop between speed limits and signaling. Part of the parsing of speed limit has to be deferred.&lt;/li>
11511151
&lt;li>Signals parameters also have to be set per route, which is done in the signal. Having per-route options on both sides doubles the work.&lt;/li>
11521152
&lt;/ul>
1153-
&lt;h4 id="hahahugoshortcode127s6hbhb-inlining-speed-limit-definitions-into-signals">❌
1153+
&lt;h4 id="hahahugoshortcode126s6hbhb-inlining-speed-limit-definitions-into-signals">❌
11541154
Inlining speed limit definitions into signals&lt;/h4>
11551155
&lt;p>Introduces a new type of speed limit, which are announced by signals.
11561156
These speed limits are directly defined within signal definitions.&lt;/p>
@@ -1185,7 +1185,7 @@ These speed limits are directly defined within signal definitions.&lt;/p>
11851185
&lt;li>speed sections created directly inside signals can only be announced by a single signal, which could be an issue for speed sections which apply to very large areas, and are announced by multiple signals (such as one for each direction)&lt;/li>
11861186
&lt;li>the cost of reversing this decision could be fairly high&lt;/li>
11871187
&lt;/ul>
1188-
&lt;h4 id="hahahugoshortcode127s7hbhb-explicit-link-from-signal-to-speed-section">✅
1188+
&lt;h4 id="hahahugoshortcode126s7hbhb-explicit-link-from-signal-to-speed-section">✅
11891189
Explicit link from signal to speed section&lt;/h4>
11901190
&lt;div class="highlight">&lt;pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;">&lt;code class="language-yaml" data-lang="yaml">&lt;span style="display:flex;">&lt;span>{&lt;span style="color:#f8f8f8;text-decoration:underline">
11911191
&lt;/span>&lt;/span>&lt;/span>&lt;span style="display:flex;">&lt;span>&lt;span style="color:#f8f8f8;text-decoration:underline"> &lt;/span>&lt;span style="color:#8f5902;font-style:italic"># ...&lt;/span>&lt;span style="color:#f8f8f8;text-decoration:underline">

0 commit comments

Comments
 (0)