Metainformationen zur Seite
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
de:styloahonline:handbuch [2024-09-11] – [2.1 Arbeitsschritt: Benennung] Hannes Kahl | de:styloahonline:handbuch [2024-09-11] (aktuell) – [Mehrer Config files] Hannes Kahl | ||
---|---|---|---|
Zeile 148: | Zeile 148: | ||
==== 2. Konfigurieren der Analyseschritte ==== | ==== 2. Konfigurieren der Analyseschritte ==== | ||
- | === 2.1 Arbeitsschritt: | + | ==== 2.1 Arbeitsschritt: |
{{: | {{: | ||
Zeile 154: | Zeile 154: | ||
Die Benennung beinhaltet zusammengesetzte Namen für die Experimente. Dabei werden die einzelnen Teile der Benennung durch Unterstriche abgetrennt. Leerzeichen in Einträgen werden durch Bindestriche ersetzt. Die einzelnen Einträge der Benennung erlauben verschiedene Organisationsmuster für Experimente. Das Datum wird beim ersten Programmlauf automatisch ausgefüllt. Der einmal erstellte Name charakterisiert den Programmablauf und die Einstellungen genau. Änderungen in der Benennung führt auf ein neues Experiment, welches auch separat gespeichert wird. Die Benennung geht in die Config-Datei ein und ein erneuter Aufruf einer Config-Datei stellt alles unter dieser Bezeichnung wieder her. Auf diese Weise können mehrere Konfigurationen unterschieden werden. | Die Benennung beinhaltet zusammengesetzte Namen für die Experimente. Dabei werden die einzelnen Teile der Benennung durch Unterstriche abgetrennt. Leerzeichen in Einträgen werden durch Bindestriche ersetzt. Die einzelnen Einträge der Benennung erlauben verschiedene Organisationsmuster für Experimente. Das Datum wird beim ersten Programmlauf automatisch ausgefüllt. Der einmal erstellte Name charakterisiert den Programmablauf und die Einstellungen genau. Änderungen in der Benennung führt auf ein neues Experiment, welches auch separat gespeichert wird. Die Benennung geht in die Config-Datei ein und ein erneuter Aufruf einer Config-Datei stellt alles unter dieser Bezeichnung wieder her. Auf diese Weise können mehrere Konfigurationen unterschieden werden. | ||
- | - Auswahl und Anzahl der Zeichen<a name=" | + | === 2.1.1 Auswahl und Anzahl der Zeichen === |
* Dateinamen sollten so lang wie nötig und so kurz wie möglich gehalten werden. | * Dateinamen sollten so lang wie nötig und so kurz wie möglich gehalten werden. | ||
* Es werden nur **Kleinbuchstaben [a-z]** und **Zahlen [0-9]** sowie der **Unterstrich [_]** und **Bindestrich [-]** verwendet. Für von der Software automatisch benannte Dateien wird als Ausnahme die Zeichenklasse [A-Z] zugelassen. | * Es werden nur **Kleinbuchstaben [a-z]** und **Zahlen [0-9]** sowie der **Unterstrich [_]** und **Bindestrich [-]** verwendet. Für von der Software automatisch benannte Dateien wird als Ausnahme die Zeichenklasse [A-Z] zugelassen. | ||
Zeile 160: | Zeile 160: | ||
* Altgriechische Bezeichnungen zu Werken oder Autoren werden ins lateinische transliteriert, | * Altgriechische Bezeichnungen zu Werken oder Autoren werden ins lateinische transliteriert, | ||
* Aus Kompatibilitätsgründen sollte die MAX_PATH Einstellung von 260 bei Windows nicht überschritten werden, dass bedeutet, Ordnerstruktur + Dateinamen sollten maximal aus 256 Zeichen bestehen, da die Laufwerksbezeichnung und das unsichtbar endende Nullzeichen mitgezählt werden. Der maximale Pfad auf einem Windows-Laufwerk D wäre demzufolge " | * Aus Kompatibilitätsgründen sollte die MAX_PATH Einstellung von 260 bei Windows nicht überschritten werden, dass bedeutet, Ordnerstruktur + Dateinamen sollten maximal aus 256 Zeichen bestehen, da die Laufwerksbezeichnung und das unsichtbar endende Nullzeichen mitgezählt werden. Der maximale Pfad auf einem Windows-Laufwerk D wäre demzufolge " | ||
- | - Mögliche Bestandteile im Dateinamen | ||
- | * **Typ des Dokumentes**: | ||
- | * **Subjekt**: | ||
- | * **Status**: der Bearbeitungzustand des Dokumentes, wenn es der stetigen Veränderung unterworfen ist. Bei Listen böte sich zum Beispiel voll oder unvoll an, um zu erklären, ob sie komplett sind. Bei Office-Dokumenten könnte auf final oder unfinal zurückgegriffen werden. | ||
- | * **ID**: bei automatisch vergebenen Identifikationsnummern ist es mitunter hilfreich, die ID im Namen zu behalten, um die Datei der Originalversion zuordnen zu können. Zum Beispiel wäre es sinnvoll eine Statistik zu Plutarchs //De tranquillitate animi// aus dem TLG mit tlg0007-096 im Dateinamen zu kennzeichnen. | ||
- | * **Datum**: Datumsangaben im Dateinamen sind insbesondere dann sinnvoll, wenn ein Dokument unveränderlich zu Archivierung abgelegt werden soll (protokoll_projektmeeting_replikation_2023-04-28.pdf) oder es zu sukzessiven Änderungen kommt, um die Versionierung übersichtlicher zu gestalten (replikation_stylesheed_2023_v01). | ||
- | * **Versionsnummer**: | ||
- | * **Autorname**: | ||
- | * **Zeichenkodierung**: | ||
- | * ** Dateiendung**: | ||
- | - Lesbarkeit\\ Als mögliche Trennzeichen wurden unter Punkt 1 bereits der Binde- und der Unterstrich benannt. Für zusammenhängende Sinneinheiten wird der Bindestrich zur Strukturierung benutzt (z.B. Datum: 2023-04-28), | ||
- | === 2.2 Arbeitsschritt: | + | === 2.1.2 Mögliche Bestandteile im Dateinamen === |
+ | == Typ des Dokumentes: == | ||
+ | |||
+ | beschluss / protokoll / rechnung / notiz / skizze etc. Ein Typ ist immer dann anzugeben, wenn er sich nicht zwangsläufig aus der Dateiendung ergibt. Bei den Endungen jpg oder png beispielsweise den Typ " | ||
+ | |||
+ | == Subjekt: == | ||
+ | |||
+ | als Subjekt wird jene Enität verstanden, über die eine Aussage getroffen wird. Eine Rechnung über den bestellten Medion-Rechner bei Saturn würde demzufolge als Subjekt saturn und medion bekommen, die Datei mit rechnung_saturn_medion beginnen. | ||
+ | |||
+ | == Status: == | ||
+ | |||
+ | der Bearbeitungzustand des Dokumentes, wenn es der stetigen Veränderung unterworfen ist. Bei Listen böte sich zum Beispiel voll oder unvoll an, um zu erklären, ob sie komplett sind. Bei Office-Dokumenten könnte auf final oder unfinal zurückgegriffen werden. | ||
+ | |||
+ | == ID: == | ||
+ | |||
+ | bei automatisch vergebenen Identifikationsnummern ist es mitunter hilfreich, die ID im Namen zu behalten, um die Datei der Originalversion zuordnen zu können. Zum Beispiel wäre es sinnvoll eine Statistik zu Plutarchs //De tranquillitate animi// aus dem TLG mit tlg0007-096 im Dateinamen zu kennzeichnen. | ||
+ | |||
+ | == Datum: == | ||
+ | |||
+ | Datumsangaben im Dateinamen sind insbesondere dann sinnvoll, wenn ein Dokument unveränderlich zu Archivierung abgelegt werden soll (protokoll_projektmeeting_replikation_2023-04-28.pdf) oder es zu sukzessiven Änderungen kommt, um die Versionierung übersichtlicher zu gestalten (replikation_stylesheed_2023_v01). | ||
+ | |||
+ | == Versionsnummer: | ||
+ | |||
+ | Um die Bedeutung als Versionsnummer klar zu machen wird ein kleines v vorangestellt. Die Anzahl der führenden Nullen ist abhängig von der zu erwartbaren Menge. | ||
+ | |||
+ | == Autorname: == | ||
+ | |||
+ | Auf die Benennung des (letzten) Autoren im Dateinamen sollte verzichtet werden außer eine Dateiversion wird parallel und unabhängig voneinander von mehreren Personen bearbeitet und es entstehen dadurch horizontale (anstatt vertikale) Dateiversionen, | ||
+ | |||
+ | |||
+ | == Dateiendung: | ||
+ | |||
+ | Die Dateiendung bezeichnet den Teil, der nach dem abschließenden Punkt folgt. Er verweist in aller Regel auf den Dateityp, also die Art und Weise, wie die Informationen in der Datei kodiert sind. | ||
+ | |||
+ | |||
+ | ==== 2.2 Arbeitsschritt: | ||
{{: | {{: | ||
Zeile 178: | Zeile 202: | ||
Für umfangreichere Corpora ist es nötig die Darstellung von Zwischenergebnissen zu beschränken. Das kann an dieser Stelle mit dem Haken bei " | Für umfangreichere Corpora ist es nötig die Darstellung von Zwischenergebnissen zu beschränken. Das kann an dieser Stelle mit dem Haken bei " | ||
+ | == Input eines Config files == | ||
+ | |||
+ | Wenn config files über die "Save config file"- oder "Gen all..." | ||
+ | |||
+ | |||
+ | == Mehrere Config files == | ||
+ | |||
+ | Werden mehrer config files geladen, dann werden diese nacheinander verarbeitet und die Ergebnisse werden, wie angegeben, abgespeichert. Mehrer Konfigurationen dieser Art werden auf dem aktuellen Korpus ausgeführt. | ||
+ | |||
+ | == Serien von config files == | ||
+ | |||
+ | Wenn man die "Gen all..." | ||
+ | |||
+ | == Reset des Tools == | ||
+ | |||
+ | Sowohl das Tool, als auch der Browser betreiben ein Caching. Caching bezeichnet die Speicherung von Einstellungen, | ||
+ | Wenn der Button "Delet configuration" | ||
+ | Wenn der Button " | ||
+ | Wenn man den Button "Reset stylo-ah-online" | ||
+ | Will man die Seite und somit den Zustand (Programmversion) des Tools nicht aus dem Browser-Cach laden, sondern den neusten Code vom Server, dann kann man den Button " | ||
=== 2.3 Arbeitsschritt: | === 2.3 Arbeitsschritt: | ||
- | {{: | + | {{: |
Im Abschnitt "Input / Replication" | Im Abschnitt "Input / Replication" | ||
Zeile 192: | Zeile 236: | ||
=== 2.4 Arbeitsschritt: | === 2.4 Arbeitsschritt: | ||
- | {{: | + | {{: |
- | Es wird außerdem ein Histogramm der absoluten Häufigkeiten der Zeichen in den normalisierten Texten angezeigt. | + | Auf der rechten Seite werden die Zwischenergebnisse des Normalisierungsschritts angezeigt. Man kann somit Einsicht in die Güte der Normalisierung nehmen und gegebenen falls Änderungen vornehmen. Unter dem Anzeigetext befindet sich die Liste der Eingabetexte, |
== 2.4.1 Word masking / stop words == | == 2.4.1 Word masking / stop words == | ||
Zeile 215: | Zeile 259: | ||
=== 2.5 Arbeitsschritt: | === 2.5 Arbeitsschritt: | ||
- | {{: | + | {{: |
== 2.5.1 Word level decomposition == | == 2.5.1 Word level decomposition == | ||
Zeile 226: | Zeile 270: | ||
=== 2.6 Arbeitsschritt: | === 2.6 Arbeitsschritt: | ||
- | {{: | + | {{: |
Im oberen Pulldown-Menü des Abschnitts kann man sich für die Zählweise entscheiden, | Im oberen Pulldown-Menü des Abschnitts kann man sich für die Zählweise entscheiden, | ||
Um dem Umstand verschieden langer Texte noch auf eine andere Weise zu begegnen, existiert die Einstellung "Text length normalization" | Um dem Umstand verschieden langer Texte noch auf eine andere Weise zu begegnen, existiert die Einstellung "Text length normalization" | ||
+ | |||
+ | Es wird zusätzlich eine Diagramm angegeben, was die Zählung pro Token und Text als Barplot angibt. | ||
== 2.6.1 Most frequent token / words (per text) == | == 2.6.1 Most frequent token / words (per text) == | ||
Zeile 240: | Zeile 286: | ||
Mit den beiden Werten kann man angeben, in wie viel Prozent der Texte ein Token mindestens und maximal auftreten soll, um im Profil Berücksichtigung zu finden. Im Kontrast zu Most frequent words oder TF-IDF kann man dabei nicht absehen, wie die Profile beeinflusst werden. Es kann durchaus sein, dass damit null-besetzte Bereiche vermindert werden, allerdings kann auch das Gegenteil eintreten. Hier sollte man die Profile genau untersuchen. | Mit den beiden Werten kann man angeben, in wie viel Prozent der Texte ein Token mindestens und maximal auftreten soll, um im Profil Berücksichtigung zu finden. Im Kontrast zu Most frequent words oder TF-IDF kann man dabei nicht absehen, wie die Profile beeinflusst werden. Es kann durchaus sein, dass damit null-besetzte Bereiche vermindert werden, allerdings kann auch das Gegenteil eintreten. Hier sollte man die Profile genau untersuchen. | ||
+ | == 2.6.3 Textlängen Normalisierung == | ||
+ | |||
+ | Eine Normalisierung, | ||
=== 2.7 Arbeitsschritt: | === 2.7 Arbeitsschritt: | ||
- | {{: | + | {{: |
Aus dem Pulldown-Menü können verschiedene Distanzmaße ausgewählt werden, die zum Vergleich zwischen der Token-Profilen benutzt werden sollen. Die Anwendung der Maße auf die Profil-Vektoren ergibt die Distanzmatrix. Die Distanzmatrix ist Grundlage der Gruppierung der Texte untereinander. Manche Maße erfordern die Angabe eines Zahlenwerts. Was dieser bedeutet, ist von Maß zu Maß verschieden. Man sollte die Dokumentation der Maß, wie sie in stylo-ah-online verlinkt ist, konsultieren. | Aus dem Pulldown-Menü können verschiedene Distanzmaße ausgewählt werden, die zum Vergleich zwischen der Token-Profilen benutzt werden sollen. Die Anwendung der Maße auf die Profil-Vektoren ergibt die Distanzmatrix. Die Distanzmatrix ist Grundlage der Gruppierung der Texte untereinander. Manche Maße erfordern die Angabe eines Zahlenwerts. Was dieser bedeutet, ist von Maß zu Maß verschieden. Man sollte die Dokumentation der Maß, wie sie in stylo-ah-online verlinkt ist, konsultieren. | ||
+ | |||
+ | Es wird außerdem eine Darstellung des Distanzmatrix (Distanzen aller Textpaare) als Heatmap angegeben. | ||
=== 2.8 Arbeitsschritt: | === 2.8 Arbeitsschritt: | ||
- | {{: | + | {{: |
Zur Zeit stehen noch nicht alle Cluster-Verfahren, | Zur Zeit stehen noch nicht alle Cluster-Verfahren, | ||
Zeile 253: | Zeile 304: | ||
=== 2.9 Arbeitsschritt: | === 2.9 Arbeitsschritt: | ||
- | {{: | + | {{: |
Im Abschnitt " | Im Abschnitt " |