Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/Lineage
- Handbuch Im Aufbau...
Bitte haben Sie noch ein wenig Geduld..
Das Erweiterungsmodul Lineage ist ein Visualisierungsmodul, das ein Knoten-Link-Diagramm verwendet, um genealogische Beziehungen darzustellen.
Dieses Erweiterungsmodul hat viele Ähnlichkeiten mit dem Erweiterungsmodul TAM, so dass gemeinsame Funktionen und Eigenschaften auf der übergeordneten Seite "TAM und Lineage" beschrieben sind.
Das Programm Lineage wurde ursprünglich von Ben Garvey auf GitHub veröffentlicht. Horst Stern hat es in einer angepassten Version auf seiner Homepage verwendet. Max Hagspiel hat ebenfalls eine angepasste Version entwickelt, die es erlaubte GEDCOM-Daten einzulesen (nicht mehr im Web auffindbar). Die nun hier als webtrees-Modul realisierte Version kombiniert die Konzepte des Originals mit Elementen aus TAM und fügt einige Erweiterungen hinzu.
Beschreibung
Lineage (LIN) stellt die Verbindungen von Eltern und ihren Kindern und die Verbindungen zwischen den Eltern als Verbindungslinien dar. Die Personen werden als Knoten visualisiert.
Die primäre Darstellung ist die Baum-Ansicht mit den verknüpften Personen. Alternativ können die Personen auch in einer Zeitleiste oder nach Familiennamen gruppiert dargestellt werden (siehe nachfolgender Abschnitt "Alternative Darstellungen").
Die Verbindungen zwischen den Eltern und ihren Kindern sind gerichtet (Pfeilspitze zum Kind); Verbindungslinien zu männlichen Nachkommen und zu Nachkommen mit unbekanntem Geschlecht sind sie in hellblau, zu weiblichen in helllila dargestellt. Die Verbindungen zwischen den beiden Eltern sind ungerichtet (ohne Pfeilspitzen); sie sind gestrichelt und in lindgrün visualisiert.
Die Personen-Knoten werden in ihrer Darstellung nach Geschlecht differenziert - Männer werden als Quadrate, Frauen und Personen mit unbekanntem Geschlecht werden als Kreise präsentiert.
Die Farbe der Knoten variieret, je nach Familienname. webtrees bietet neben dem Nachnamen im Klartext auch die Umsetzung gemäß Soundex[1], sowohl in der Standardvariante als auch in der Daitch–Mokotoff-Variante (SoundDM) an. Alle drei Ausprägungen der Namen werden in Lineage übernommen. Die SoundDM-Ausprägung dient dabei als Index bei der Wahl der Knotenfarbe im verwendeten Farbraum. Familiennamen, die sich z.B. in Groß- und Klein-Schreibung oder in alternativen Umlaut-Schreibweisen unterscheiden, werden so gleichfarbig dargestellt; dies wäre anders, wenn man den Namen im Klartext für die Farbwahl verwenden würde.
Besonderheiten
Eine wesentliche Ergänzung gegenüber der Ursprungsversion von Lineage besteht in der Möglichkeit, den Bezugszeitpunkt der Darstellung zu wählen. Der Darstellungszeitraum ist auf die Zeitspanne von 1500 bis zum Zeitpunkt des letzten relevanten Ereignisses im Leben der dargestellten Personen eingestellt, wobei auf Zehnjahresstufen aufgerundet wird. Sollte ein Ereignis bei einer Person vor dem Jahr 1500 gefunden werden, erweitert sich der Zeitraum entsprechend in Stufen von einhundert Jahren. Im Menü-Bereich sind Sprungmarken eingefügt, so dass man den Bezugszeitpunkt auf eine Jahrhundert-Marke einstellen kann. Im oberen Bereich des Bildschirms befindet sich ein Steuerelement, mit dem man den Bezugszeitpunkt sowohl in 10-Jahres-Schritten als auch präzise um jeweils ein Jahr vor und zurück verändern kann.
Beim Wechsel des Bezugszeitpunkts werden solche Knoten, deren Bezugsjahr außerhalb des Zeitraums liegt, automatisch entfernt bzw. auch wieder eingefügt, wenn die Grenzwerte (Startjahr des Darstellungszeitraums - aktueller Bezugszeitpunkt) das Bezugsjahr mit einschließen.
Eine weitere Ergänzung zu Lineage in der Ursprungsversion betrifft die Option, Teilmengen der Nodes nach Familiennamen abzugrenzen. Man kann eine umfassende Liste der Familiennamen aufrufen, wahlweise sortiert nach Häufigkeit oder alphabetisch und innerhalb der Gesamtmenge auch noch abgrenzbar nach Anfangs-Buchstaben. Mittels Checkboxen können nun Namen ausgewählt und als Filter-Kriterium hinterlegt werden. Dabei können auch mehrere Filter-Definitionen gebildet und im weiteren Verlauf zwischen diesen gewechselt werden. Wie beim Bezugsjahr werden alle Nodes, deren Namenskriterium nicht dem aktiven Filter entsprechen, aus der Darstellung entfernt. Das relevante Namenskriterium ergibt sich gemäß der Vorgabe des Names-Schemas (siehe oben), ist z.B. SoundDM gesetzt, werden alle dem SoundDM-Wert eines Namens im Filter entsprechenden Nodes mit angezeigt, auch wenn deren Klarnamen davon abweicht.
Namensfilter und Zeitsteuerung sind hierarchisch angeordnet - auf die Grundgesamtheit der Personen im Datenbestand wird zuerst der Namensfilter angewendet, auf die dadurch abgegrenzte Teilmenge wirkt dann der Zeitfilter. In der Anwendung sind sie allerdings unabhängig - man kann also erst den Bezugszeitpunkt verändern und damit Personen ausblenden, und dann in einem zweiten Schritt zusätzlich noch einen Namensfilter setzen. Wird der Bezugszeitpunkt dann wieder auf das Endjahr gesetzt, bleibt der Namensfilter weiterhin wirksam.
Alternative Darstellungen
Die klassische Baumansicht ist die primäre Darstellung, mit dieser Ansicht wird LIN bei jedem Aufruf gestartet.
Daneben - und grundsätzlich ähnlich ausgestattet - gibt es auch Zeitleiste und Gruppen. Diese Ansichten stellen nur Knoten (=Personen) dar, die Links (=Familien-Bindungen) sind bei diesen Betrachtungen nicht relevant.
Die Gruppen-Ansicht führt alle Personen gleichen Familiennamens zusammen.
Die Zeitleiste ordnet die Personen von links nach rechts entsprechend ihres Geburtsdatums an.
Hier zum Vergleich der Testdatenbestand in den verschiedenen Ansichten:
Testdaten - Baum-Ansicht
Testdaten - Zeitleiste-Ansicht
Testdaten - Gruppen-Ansicht
WICHTIG! Zeitleiste und Gruppe sind noch nicht abschließend definiert, ihre konkrete Ausgestaltung kann und wird sich wahrscheinlich in Zukunft ändern ...
Bedienoberfläche
Der komplette Bildschirm dient als Anzeigefläche (Viewport), überlagert sind einige Bereiche, die Bedienfelder und Informationstexte beinhalten. In der nebenstehenden Abbildung sind diese Bereiche gelb markiert.
- Am linken Rand befindet sich das Steuermenü (Menübereich). Es kann durch einen Klick auf die Schaltfläche "Menü" (Menü-Toggle) am oberen Rand ausgeblendet werden - die Schaltfläche ist dann weiterhin sichtbar, ein erneuter Klick darauf blendet den Menübereich wieder ein.
- Am oberen Rand befindet sich die Zeitsteuerung.
- Oben rechts befinden sich Steuerflächen (Aktionen), die die Darstellung beeinflussen, und zwei Informationsfelder, die auf Details hinweisen ("Hitze", "Transform").
- Unten in der Mitte werden Informationen zum Bezugszeitpunkt und der Anzahl der dargestellten Knoten eingeblendet (Infobereich).
Etwas detaillierter lassen sich die Bereiche wie folgt beschreiben
- Menübereich: Enthält diverse Unterbereiche (Beschreibung siehe nachfolgend) - Lesen und Schreiben von und auf (lokales) Dateisystem bzw. IDB, erlaubt den Wechsel zwischen den Darstellungsvarianten, gibt Zugang zur Filterung nach Namen, gibt Einsprungpunkte für die Zeitdarstellung vor, steuert Elemente des Viewport und schließlich kann man die Anzeigesprache umschalten (aktuell DE, EN und NL).
- Zeitsteuerung: Erlaubt den Bezugszeitpunkt neu einzustellen, zum einen durch Verschieben eines Sliders, zum anderen durch den "Play-Modus" - das ist der automatische Jahreswechsel im Vorlauf oder auch zurück zum Anfangsjahr. Sowohl im "Play-Modus" als auch durch entsprechende Steuerflächen im Block wird um jeweils 1 Jahr gewechselt, die Slider haben ein 10-Jahres Raster.
- Links ein Block von Steuerflächen - Oben: "Play-Modus" Zurück, Stop, Vor | Unten: 1 Jahr Minus, 1 Jahr Plus.
- Rechts ein doppelter Slider - Oben: 10-Jahre Raster, der Schieber kann von Tick zu Tick bewegt werden | Unten: 10-Jahre Raster, 2 Schieber definieren Anfangs- und Endzeitpunkt für den oberen Schieber sowie den Zeitrahmen für den "Play-Modus"
- Steuerflächen: Die Aktionen sind als Symbole dargestellt:
- Export SVG Listen-Symbol - Ein Schnappschuss der Darstellung wird im SVG-Format exportiert und kann dann später in einem Betrachter (Browser, SVG-Viewer) unabhängig aufgerufen werden.
- Simulation Stop Stop-Symbol - Die Simulations-Schleife wird unterbrochen und der Darstellung wird - wie in TAM - eine Höhenlinien-Darstellung des zeitlichen Bezugsrahmens unterlegt. Erneutes Betätigen blendet die Hintergrund-Karte aus und die Simulations-Schleife wird fortgesetzt.
- Simulation Animieren Thermometer-Symbol - Die Simulations-Schleife durchläuft einen Zyklus abnehmender Intensität. Bei komplexen Zusammenhängen, das hängt auch von der Anzahl der Knoten und Verbinden ab, ist der Zustand der Darstellung noch nicht so, dass die Auffächerung der Verteilung gemäß den Randbedingungen das Optimum erreicht hätte. Mit diesem Schalter wird ein weiterer Iterations-Zyklus gestartet. Ist die Auffächerung nahezu optimal, wird sich keine wesentliche Veränderung mehr ergeben, ansonsten wird man anfänglich wieder deutliche Positions-Änderungen sehen.
- Zentrieren Zielscheiben-Symbol - Mit Zoom und Pan lässt sich die Darstellung im Viewport nach Belieben verschieben. Diese Schaltfläche zentriert die Darstellung wieder auf den visuellen Nullpunkt und setzt die Skalierung auf 100% zurück.
- Steuerflächen: Informationen
- Hitze - Zeigt den Wert alpha, dass ist der "Energie-Level" der Simulations-Intensität und lässt erkennen, wie dieser im Verlauf der Iterationen abnimmt.
- Transform - Zeigt die Werte zoom sowie x und y, also die aktuelle Skalierung sowie die Verschiebung des Darstellungs-Mittelpunkts durch Zoom und Pan.
- Infobereich - Oben: das Bezugsjahr der Darstellung | Unten: Anzahl der Knoten in der Darstellung, dazu die Anzahl der fallweise nicht angezeigten Knoten (Namensfilter, außerhalb der Zeitscheibe).
Die gesamte Darstellung lässt sich auf der Bildschirmfläche verschieben (Pan) und nach Belieben vergrößern und verkleinern (Zoom). Einzelne Knoten lassen sich durch Klick auswählen und auf eine andere Position in der Darstellung verschieben (Drag-n-Drop), dabei wird auch ihre Position festgelegt. Fixierte Knoten sind besonders hervorgehoben. Ein Knoten lässt sich auch durch Doppel-Klick auf seine aktuelle Position fixieren. Ein Klick auf einen fixierten Knoten gibt ihn wieder frei.
Fährt die Maus über einen Knoten, werden Informationen zur Person als Tooltip angezeigt (siehe Abbildung).
Aktive Elemente
Alle aktiven Elemente, also jene bei denen ein Klick darauf eine Veränderung auslöst - Alternative Darstellung, Folgeaktionen, Viewport-Steuerung - färben sich beim Darüber-fahren mit der Maus (Hovern) grün ein.
Detaillierte Beschreibung
Menü-Toggle
Ein Klick auf diese Schaltfläche blendet den Menübereich aus, die Schaltfläche selbst schiebt sich an den linken Rand. Ein erneuter Klick lässt den Menübereich wieder erscheinen, die Schaltfläche wandert entsprechend mit.
Menübereich
In diesem Bereich können verschiedene Folgeaktionen ausgelöst und Viewport-Veränderungen bewirkt werden. Der Menübereich ist selbst wiederum in verschiedene Bereich unterteilt:
Öffnen/Speichern
Klick auf diese Schaltfläche öffnet im Menübereich einen zusätzlichen Block, in dem man Lese- und Schreiboperationen im Dateisystem oder in IndexedDB (IDB) steuern kann. Wählt man die Datei-Aktionen, werden als Folgeaktion die üblichen Datei-Dialoge aufgerufen. Für IDB-Aktionen wird der Viewport mit einer Übersicht über die verfügbaren IDB-Slots geöffnet. Zwischen den Schaltflächenbereichen wird der Name der gewählten Datei bzw. des IDB-Slots angezeigt und kann auch beschrieben werden.
Knotenansichten
Hier kann man zwischen den alternativen Darstellungsvarianten umschalten
Nachnamenfilter
Dieser Unterbereich ist selbst noch einmal untergliedert:
- obere Zeile - 1 Schaltfläche, Checkbox beliebig, Checkbox mit Partnern
- Schaltfläche - Der angezeigte Text zeigt, welches Substitutionsschema derzeit aktiv ist. Klick auf die Schaltfläche öffnet eine Übersicht mit weiteren Schaltflächen für die verfügbaren Schemata - surName, soundDM, soundSTD - Klick auf eine dieser zusätzlichen Schaltflächen bewirkt im Hintergrund entsprechende Reaktionen - die Knoten-Einfärbungen können sich ändern, in der Gruppen-Ansicht auch die Verteilung.
- Checkbox beliebig - ...
- Checkbox mit Partnern - diese Checkbox zeigt ihre Wirkung dann, wenn ein Nachnamen-Filter gesetzt ist. Der Filter bewirkt eine primäre Einschränkung der dargestellten Nodes auf solche Personen, deren Nachname dem aktuellen Namens-Substitutionsschema entspricht. Da Partner üblicherweise mit ihrem eigenen Familiennamen geführt werden, deren Umsetzung dann auch entsprechend anders ausfällt, scheinen sie in der Darstellung nicht auf. Ist die Checkbox gesetzt, werden sie aber doch mit angezeigt. Um solche Nodes von denen zu differenzieren, die dem Filterkriterium entsprechen, werden die Partner-Nodes in halber Größe angezeigt.
- mittlere Zeile - Hinweistext, 1 Schaltfläche
- Hinweistext - Man kann grundsätzlich auch selbst direkt Einträge im Filterfeld machen. Stellt man dabei mehrere Namen ein, muss man diese mit ; trennen, damit das System die Namen voneinander abgrenzen kann.
- Schaltfläche - Klick auf diese Schaltfläche öffnet im Viewport einen modalen Dialog - er wird anschließend beschrieben.
- untere Zeile - Filterfeld: Hier stehen die im aktuellen Filter definierten Namen. Das Feld wird entweder über den speziellen Dialog oder durch direkte Eingabe gefüllt. Bei direkter Eingabe ist auf abschließende ; zu achten. HINWEIS: Die Namen werden wie geschrieben übernommen, Groß- und Kleinschreibung, Umlaute und Aktzentuierengen etc. sind relevant. Die Soundex-Operationen nehmen zwar diverse Normalisierungen und Anpassungen vor, der Klarnamen wie im Gedcom hinterlegt ist allerdings der relevante Schlüssel, mit dem die dazu passende Substituierung gefunden wird. Die Soundex-Ausprägungen werden aus webtrees übernommen, die Operationen dahinter sind komplex und umfangreichen Regeln unterworfen, welche nicht hier nachgebaut worden sind. Die Namen müssen also so geschrieben sein, wie man sie im Stammbaum findet, damit das Verfahren wirken kann.
Ein Feld von Schaltflächen mit Jahreszahlen - Klick auf eine Schaltfläche setzt den Bezugs-Zeitpunkt auf den entsprechenden Jahreswert, der Umfang der Darstellung wird entsprechend angepasst.
Graph Darstellung
Klick auf diese Schaltfläche öffnet im Menübereich einen zusätzlichen Block, in dem man verschiedene Eigenschaften der Darstellung im Viewport verändern kann. Diese betreffen nur die Oberfläche, nicht die Anzahl der Knoten.
- Checkbox Graph zeigen - Wählt man die Option ab, werden die Nodes und Links ausgeblendet.
- Checkbox Links zeigen' - Wählt man die Option ab, werden die Links ausgeblendet.
- Checkbox Namen zeigen - Wählt man die Option ab, verschwinden die Namen unter den Nodes, die Nodes selbst bleiben erhalten.
- Checkbox Node Info zeigen - Wählt man die Option ab, wird kein Tooltip mit den Informationen zur Person gezeigt.
- Spinner Link Intensität - Verändert man den Wert, werden die Links entsprechend kräftiger oder blasser/dünner gezeichnet.
- Spinner Node Radius - Verändert man den Wert, werden die Nodes entsprechend größer oder kleiner gezeichnet. (Option derzeit nicht aktiv)
- Spinner Node Text Deckkraft - Verändert man den Wert, werden die Text zu den Nodes entsprechend kräftiger oder blasser dargestellt. (betrifft nur die Texte, nicht den Tooltip)
Sprache
Klick auf diese Schaltfläche öffnet im Menübereich einen zusätzlichen Block, in dem man die Anzeige-Sprache umstellen kann.
- de - Deutsch
- en - Englisch
- nl - Niederländisch
Die Schaltflächen-Texte, Meldungen usw. sind über eine im System integrierte I18N-Bibliothek internationalisiert, die entsprechenden Texte und Verweise dazu im Code hinterlegt. Korrekturwünsche und weitere Übersetzungen bitte über Github reklamieren bzw. einreichen.
|
Das Folgende ist rohes Textmaterial, das noch bearbeitet wird. |
|
Am unteren Rand des Bildschirms werden der aktuelle Bezugszeitpunkt sowie die Anzahl der aktiven sowie der ausgeblendeten Nodes angezeigt.
Jede Simulation beginnt mit einer relativ kompakten Zusammenballung aller Nodes. Jeder Node wirkt auf seine Umgebung. Enthält ein Datenbestand viele Nodes, ist es recht wahrscheinlich, dass bei Ende des Iterations-Zyklus die Verteilung der Nodes durch gegenseitige quasi Blockaden noch nicht wirklich ausgeglichen ist. Ein Iterations-Zyklus beinhaltet ca. 300 Durchläufe, eventuell auch weniger, wenn ein End-Energiewert > "0" vorgegeben ist. Die dritte Schaltfläche - ein Thermometer-Symbol - setzt den aktuellen Energie-Level pro Betätigung um jeweils 0.1 hoch (der Maximalwert ist 1), so dass eine weitere Abfolge von Iterationen angestoßen wird. Bei großer Node-Anzahl wird sich das in weiteren Verschiebungen bemerkbar machen, liegt die Node-Anzahl in eher niedrigem Bereich von maximal einigen 100ern, wird sich die Darstellung eher nicht mehr verändern, da ein stabiler Gleichgewichtszustand der wirkenden Kräften eingetreten sein dürfte.
