Differences

This shows you the differences between two versions of the page.

--- analyzer-de [2018/12/07 23:53] – rainerk
+++ analyzer-de [2019/04/22 01:49] – rainerk
@@ Line 8: / Line 8: @@
 =====Wichtige Änderung=====
+|< >|
 ^Analyser-Markierung geändert^
-|:!: Ab Rev. 12.859+ ist die "**autogen-**"-Markierung durch die Option __**[[route-gen-de#automatisch_erzeugt|Automatisch erzeugt]]**__ ersetzt. \\ Bei Fahrstraßen-Kennungen, die noch das führende "autogen-" enthalten, wird dies beim nächsten Analyser-Lauf entfernt und durch die neue Option ersetzt. \\ Zusätzlich ist im Feld 'Beschreibung'  "Generated by the analyser" eingetragen. \\ Im Dialog __**[[route-index-de|Fahrstraßen: Übersicht]]**__ zeigt ein führendes "** * **" in der Spalte 'Beschreibung' die aktivierte Option 'Automatisch erzeugt'. \\ In den Beispielen unten auf dieser Seite ist diese Änderung berücksichtigt. |
+|:!: Ab Rev. 12.859+ ist die "**autogen-**"-Markierung von Fahrstraßen durch die Option __**[[route-gen-de#automatisch_erzeugt|Automatisch erzeugt]]**__ ersetzt. \\ Bei Fahrstraßen-Kennungen, die noch das führende "autogen-" enthalten, wird dies beim nächsten Analyser-Lauf entfernt und durch die neue Option ersetzt. \\ Zusätzlich ist im Feld 'Beschreibung'  "Generated by the analyser" eingetragen. \\ Im Dialog __**[[route-index-de|Fahrstraßen: Übersicht]]**__ zeigt ein führendes "** * **" in der Spalte 'Beschreibung' die aktivierte Option 'Automatisch erzeugt'. \\ In den Beispielen unten auf dieser Seite ist diese Änderung berücksichtigt. |
+Eine weitere wichtige Änderung: Siehe __**[[#verbinder|Verbinder]]**__
+ \\
  \\
@@ Line 77: / Line 80: @@
 \\
 === Signale ===
-Das zu einem Hauptsignal einer Blockseite gehörende Vorsignal muss an der Blockseite gegenüber positioniert sein.\\
+Das zu einem Hauptsignal einer Blockseite gehörende Vorsignal muss an der anderen Seite des Blocks positioniert sein.\\
 Die Zuordnung ist auf der Registerkarte **[[block-signals-de|Block: Signale]]** ersichtlich und kann bei Bedarf manuell geändert werden.\\
 \\
@@ Line 96: / Line 99: @@
  \\
-==== Verbinder ====
+===== Verbinder =====
-Über Verbinder können entfernte Objekte miteinander verbunden werden: Der Analyser sucht nach einem Gegenstück (zweiter Verbinder) und ignoriert sowohl leere Felder als auch andere, zwischen diesen beiden liegende Objekte.\\
+|< >|
+^  Wichtige Änderung ab Rev. 15.164+  ^
+|  :!: Es müssen __immer eindeutig__ mit **0...65535**((=16Bit-Wert)) nummerierte Verbinder-Paare gebildet werden.\\ Die bisher mögliche Verwendung der Nummern **0...9** für mehrere Verbinder-Paare führt zum Abbruch des Analyser-Laufs. \\ Die orthogonale Positionierung und zueinander zeigende Schnittflächen beider Symbole werden nicht mehr berücksichtigt. \\ Dies gilt auch für das geteilte Brückenelement (tracknr 2). {{symbols:track-2.png?20}} \\ **Damit der Gleisplan für den Analyser "gesund" ist \\ und bisherige Paarungen auch zukünftig gültig bleiben, müssen die "alten" Verbinder-Paare 0...9 \\ auf eine im gesamten Gleisplan mit allen Ebenen eindeutige Nummerierung geändert werden.**  |
+====Wozu Verbinder ?====
+Über Verbinder können voneinander entfernte Objekte miteinander verbunden werden: Der Analyser sucht nach einem Gegenstück (zweiter Verbinder) und ignoriert sowohl leere Felder als auch andere, zwischen diesen beiden liegende Objekte.\\
+Mit Verbindern ist es einfach, Gleisabschnitte verschiedener Ebenen eines Gleisplans miteinander zu verbinden.\\
 ^ Beispiele für Verbinder \\ Vermeiden von Gleiselementen ohne Funktion ^^
@@ Line 103: / Line 111: @@
 | \\ ||
 ^ Schematische Darstellung von Brücken ^^
-|  {{:analyzer:bridge.png}} \\ {{:analyzer:bridge-connector-example.png}}  |  {{:analyzer:bridge-crossing-example.png}}  |
+|  {{:analyzer:bridge.png}}  |  {{:analyzer:bridge-crossing-example.png}}  |
-|  Brücke mit zwei Verbindern \\ Oben Typ = **connector** \\ Unten Typ = **tracknr** mit Nummer = **2**  |  Brücken-Symbol als Typ = **tracknr** mit Nummer = **3** \\ Damit kann der Analyser die möglichen Fahrstraßen A- < > B+ und C- < > D+ erkennen und erzeugen.  |
+|  Brücke mit zwei Verbindern \\ Typ = **connector**  |  Brücken-Symbol als Typ = **tracknr** mit Nummer = **3** \\ Damit kann der Analyser die möglichen Fahrstraßen A- < > B+ und C- < > D+ erkennen und erzeugen.  |
-\\
-  * Der maximale Abstand zwischen den zusammengehörenden Verbindern eines Verbinder-Paares ist unbegrenzt.
+  * Verbinderpaare werden in den Eigenschaften des **[[tracks-gen-de#nummer|Gleis-Objekts]]** mit __derselben__ Nummer zwischen **0** und **65535** konfiguriert. \\ Die Lage bzw. Ausrichtung der Verbinder eines Paares ist beliebig und sie können auf __verschiedenen__ Gleisplan-Ebenen liegen.
-  * Verbinderpaare können sich entweder auf derselben Gleisplan-Ebene befinden und müssen, wie oben abgebildet, in einer Linie liegen und zueinander orientiert sein, \\ oder
-  * beide Verbinder eines Paares werden in den Eigenschaften des **[[tracks-gen-de#nummer|Gleis-Objekts]]** mit __derselben__ Nummer zwischen 10 und 99 konfiguriert. \\ Die Lage bzw. Ausrichtung der Verbinder solcher Paare ist dann beliebig und sie werden auch berücksichtigt, wenn sie auf __verschiedenen__ Gleisplan-Ebenen liegen.
 \\
 ==== Verbinder bei Modulanlagen vermeiden ====
-Bei Modulplänen können an den Modul-Übergängen Verbinder verwendet werden, wenn sie paarweise \\
+Bei Modulplänen können an den Modul-Übergängen Verbinder verwendet werden, wenn sie paarweise mit **derselben** Nummer definiert sind.
-  * mit **beliebiger** (auch unterschiedlicher) Nummer im Bereichs **0 - 9** gegenüberstehen.\\
-oder
-  * mit **derselben** Nummer im Bereich **10 - 99** definiert sind.
 **Nachteile:**\\
-Hat ein Verbinder mit einer Nummer im Bereich **0 - 9** keinen Partner am Übergang, darf in der Richtung bis zum Modulplan-Rand kein anderer Verbinder ohne Partner gegenüberstehen.\\
+Verbinder am Modul-Übergang ohne Partner mit derselben Nummer meldet der Analyser als Fehler. \\
-Verbinder am Modul-Übergang ohne Partner mit derselben Nummer im Bereich **10 - 99** meldet der Analyser als Fehler. \\
+Wird die Modul-Anlage in einer anderen Zusammenstellung aufgebaut, muss die Nummerierung betroffener Verbinder-Paare angepasst werden.\\
-Wird die Modul-Anlage in einer anderen Zusammenstellung aufgebaut, müssen betroffene Verbinder-Paare mit Nummern im Bereich **10 - 99** angepasst werden.\\
+Werden dabei in der Zusammenstellung zwei Verbinder mit derselben Nummer irgendwo - auch in beliebig weit voneinader entfernten Modulen - vergessen, können "seltsame" Fahrstraßen entstehen.\\
-Werden dabei in der Zusammenstellung zwei Verbinder mit derselben Nummer im Bereich **10 - 99** irgendwo vergessen, können "seltsame" Fahrstraßen entstehen.\\
 **Empfehlung:**\\
@@ Line 132: / Line 134: @@
 |  An Modul-Übergängen gerade Gleiselemente verwenden :!:  |
 |  {{:modules:no-connector.png?200}}  |
+Siehe auch: __**[[#meldungen_im_server-log|Meldungen im Server-Log]]**__\\
 \\
@@ Line 145: / Line 148: @@
   * Elemente vom Typ "Straße" werden nicht unterstützt.
   * Nur ein Teil der Gleisplan-Objekte des **[[switch-gen-de#zubehoer|Weichentyps "Zubehör"]]** und des **[[tracks-gen-de#typ|Gleistyps "tracknr"]]** werden erkannt:
-\\
-^Weichentyp "Zubehör"^^
+|< >|
-^Zubehör#^Beschreibung^
+^  Weichentyp "Zubehör"  ^^
+^  Zubehör#  ^Beschreibung^
 |  1  | doppelgleisiger Bahnübergang, veraltet |
 |  10  | eingleisiger Bahnübergang, unbeschrankt |
@@ Line 155: / Line 159: @@
 |  41  | eingleisige Klappbrücke |
 | ||
-^Gleistyp "tracknr"^^
+^  Gleistyp "tracknr"  ^^
-^Nummer^Beschreibung^
+^  Nummer  ^Beschreibung^
-|  2  | Brücken-Verbinder |
 |  3  | kreuzende Brücke |
-\\
 Andere Zubehör- u. Gleis- Nummern werden vom Analyser __nicht__ unterstützt. Der Analyser kennt die unterschiedlichen Raster-Größen und Ausrichtungen der Symbole nicht. Deshalb müssen diese Objekte vor einer Auswertung __temporär__ (evtl. auch später wieder) durch normale Gleis-Objekte ersetzt werden.
@@ Line 202: / Line 204: @@
 {{:analyzer:alt_route_ab.png}} \\
-- Vorher:
+  * Vorher:
-  * "[A-]-[B+]" (direkter Weg)
+    * "[A-]-[B+]" (direkter Weg)
-  * "[A-]-[B+]-42" (alternative Fahrstraße über das Gegengleis)
+    * "[A-]-[B+]-42" (alternative Fahrstraße über das Gegengleis) \\ \\
-- Manuelle Aktionen:
+  * Manuelle Aktionen:
-  * Deaktivieren der Option "Automatisch erzeugt" bei "[A-]-[B+]"
+    * Deaktivieren der Option "Automatisch erzeugt" bei "[A-]-[B+]"
-  * Löschen von "[A-]-[B+]-42"
+    * Löschen von "[A-]-[B+]-42" \\ \\
-- Nachher:
+  * Nachher:
-  * Aufruf des Analyser lässt "[A-]-[B-+]" unberührt (da die Option "Automatisch erzeugt" nicht gesetzt ist) und erzeugt auch keine neue/alternative Fahrstraße von [A-] nach [B+], da es bereits eine "manuell angelegte" Fahrstraße für diesen Fahrweg gibt.
+    * Aufruf des Analyser lässt "[A-]-[B-+]" unberührt (da die Option "Automatisch erzeugt" nicht gesetzt ist) und erzeugt auch keine neue/alternative Fahrstraße von [A-] nach [B+], da es bereits eine "manuell angelegte" Fahrstraße für diesen Fahrweg gibt.
 \\
-==== Meldungen im Server-Log ====
+===== Meldungen im Server-Log =====
-- ''ANALYSER: max. recursion depth (101 > 100) reached''
+Zur Anzeige der Analyser-Ergebisse muss **[[rocrailini-trace-de#berechnung|Traces: Berechnungen]]** aktiviert sein.
-  * Bei der Suche von Verbindungen zwischen 2 Blöcken werden mehr als 100 Gleisplanelemente gefunden. \\ **[[http://forum.rocrail.net/viewtopic.php?p=89410#p89410|Siehe diesen Forumbeitrag]]**
+  * **Hinweis:** \\ Die Aktivierung der Trace-Ebene "Analysieren" wird nicht empfohlen. \\ Diese Option sollte der Fehlersuche in Analyser-Funktionen vorbehalten bleiben.
-  => Bitte **[[goldenrules-de|Bewährtes Vorgehen]]** beachten\\
+==== Beispiele ====
-Zur Anzeige der Analyse-Ergebisse muss **[[rocrailini-trace-de#berechnung|Traces: Berechnungen]]** aktiviert sein.\\
+//**Hinweis:** Die jeweils letzte Aktion steht oben im Log.//
-Server-Log-Beispiel mit "Analyser zurücksetzen" mit anschließendem "Analysieren":
+**Server-Log bei "Analysieren" mit typischem Fehler beim Entwurf des Gleisplans:**
+<code>
+:23:09 route generator (re)created routes (0 -> 8)
+:23:08 ANALYSER: max. recursion depth (101 > 100) reached
+:23:08 ANALYSER: max. recursion depth (101 > 100) reached
+</code>
+  - Bei der Suche von Verbindungen zwischen 2 Blöcken wurden mehr als 100 Gleisplanelemente gefunden. //(Zwei Meldungen = Suche in beiden Richtungen)// \\ **[[http://forum.rocrail.net/viewtopic.php?p=89410#p89410|Siehe diesen Forumbeitrag]]**
+  - Der Analyser hat 8 Fahrstraßen erzeugt
+  * Bitte **[[goldenrules-de|Bewährtes Vorgehen]]** beachten.
+**Server-Log bei "Analyser zurücksetzen" und anschließendem "Analysieren":**
 <code>
 :45:36 route generator (re)created routes (0 -> 4)
@@ Line 225: / Line 238: @@
 :45:24 starting analyzer cleanup...
 </code>
+  - Es wurden 4 Fahrstraßen gelöscht
+  - Es wurden 4 Fahrstraßen neu erzeugt
+**Server-Log bei "Analysieren" mit typischen Fehlern bei Verbindern:**
+<code>
+:08:06 Analyser skipped because plan has ERRORs
+:08:06 ERROR: connector [tk5] at (6-5-1) number[3] : Too many counterparts (total 3)
+:08:06 WARNING: connector [tk4] at (14-3-0) with number[2] : no counterpart found.
+:08:06 ERROR: connector [tk3] at (14-1-0) number[3] : Too many counterparts (total 3)
+:08:06 ERROR: connector [tk2] at (6-3-0) number[3] : Too many counterparts (total 3)
+</code>
+  - Es gibt mehr als die zwei zu einem Paar gehörenden Verbinder mit Nummer **3** an den angegebenen Positionen. //(Beispiel: **6-3-0** = x-y-z)//
+  - Dem Verbinder mit Nummer **2** fehlt der Partner.
+  - Der Analyserlauf wurde wegen der gelisteten Fehler im Gleisplan abgebrochen.
 \\
 ===== Wichtige Hinweise zu Neustarts von Rocrail und Rocview =====
@@ Line 232: / Line 260: @@
 |  :!: **Vor einem Neustart von Rocview dürfen __keinesfalls__ die Schaltflächen [ < ], [ > ], [ Übernehmem ] und [ OK ] in den Dialogen bedient werden. \\
 Anderenfalls werden die aktuellen Daten im Rocrail-Server durch ggf. nicht mehr aktuelle Daten der Dialog-Felder überschrieben.**  |