geobrowser.rst 15.4 KB
Newer Older
Stefan Funk's avatar
Stefan Funk committed
1
2
3
4
5
6
7
8
9
10
.. Geo-Browser documentation master file, created by
   sphinx-quickstart on Wed May 20 16:07:38 2015.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.


=========================
Der DARIAH-DE Geo-Browser
=========================

11
12
Der `DARIAH-DE Geo-Browser <https://geobrowser.de.dariah.eu>`__ ermöglicht eine vergleichende Visualisierung mehrerer Anfragen und unterstützt die Darstellung von Daten und deren Visualisierung in einer Korrelation von geographischen Raumverhältnissen zu entsprechenden Zeitpunkten und -abläufen. Hierdurch können Forscherinnen und Forscher Raum-Zeit-Relationen von Daten- und Quellensammlungen analysieren und zugleich Korrelationen zwischen diesen herstellen. Hier findet sich ein `Beispiel-Datensatz <https://geobrowser.de.dariah.eu/?kml1=http://geobrowser.de.dariah.eu/data/schiller.kml&kml2=http://geobrowser.de.dariah.eu/data/goethe.kml>`__ für den Geo-Browser, in dem Publikationszeiten und -Orte von Veröffentlichungen Friedrich Schillers und Johann Wolfgang von Goethes gegeneinander aufgetragen sind.

Stefan Funk's avatar
Stefan Funk committed
13
14
15
16
17
Der DARIAH-DE Geo-Browser ist unter https://geobrowser.de.dariah.eu im Internet abrufbar. Alle Funktionen sind ohne Anmeldung frei zugänglich. Der Geo-Browser ist ein Tool zur Visualisierung und Analyse von Raum-Zeit-Relationen für Geisteswissenschaftler. Der Browser zeigt eine Karte der Welt.
Durch Scrollen lässt sich in die Karte hinein- oder herauszoomen. Links gibt es eine Leiste, auf der man durch Ziehen Richtung „+“ oder „-“ ebenfalls hinein- oder herauszoomen kann.

.. figure:: ../images/image_1.png

18
19
Weitere Informationen zum Geo-Browser und zum Datasheet Editor finden Sie im `DARIAH-DE-Portal <https://de.dariah.eu/geobrowser>`__

Stefan Funk's avatar
Stefan Funk committed
20

21
22
GUI-Dokumentation
-----------------
Stefan Funk's avatar
Stefan Funk committed
23
24

Load Data
25
^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

Im oberen Bereich kann man auswählen, welche Art von Daten in den Geo-Browser geladen werden. Unter „Static Data“ lassen sich Beispieldaten auswählen. Diese sind aus dem WebOPAC Göttingen, von `Flickr <https://www.flickr.com/>`__, aus der `Internet Movie Database <https://www.imdb.com/>`__ und von `Wikidata <https://www.wikidata.org/wiki/Wikidata:Main_Page>`__ extrahiert und für den Geo-Browser aufgearbeitet worden.

Static Flickr Data verwendet Daten von Flickr. Hier sind Ort und Zeit der Aufnahmen von Nutzern gespeichert. (Beispielsuche: Konzerte einer bestimmten Band), „Political Data“ enthält politische Beispieldaten. Static IMDB-Data verwendet Daten der „Internet Movie Database“ und extrahiert die Metadaten Zeit und Ort, an dem der Film jeweils produziert wurde. „DBPedia Queries“ ist eine Sammlung von strukturierter Information der Plattform Wikipedia (https://wiki.dbpedia.org/About).

.. figure:: ../images/image_2.png

Unter „KML file URL“ kann man über die URL eine KML-Datei hochladen. Eine KML-Datei kann zum Beispiel mit der `GoogleMaps-Engine <https://mapsengine.google.com/map/?hl=de>`__ erstellt werden. Hier kann eine Karte erstellt werden, die dann heruntergeladen werden kann. Die heruntergeladene Datei hat das Format KMZ, was z. B. mit `7-zip <https://www.7-zip.org/>`__ zu einer KML-Datei konvertiert werden, oder auch direkt als KMZ-Datei hochgeladen werden kann. Es können auch KML-Dateien von der eigenen Festplatte hochgeladen werden, dazu muss „local KML file“ ausgewählt werden. Das gleiche kann auch mit CSV-Dateien gemacht werden. Anmerkung: CSV-Dateien können unter Windows zum Beispiel mit Microsoft Excel, OpenOffice Calc oder unter Mac OS X auch mit Numbers erstellt werden. Die geladenen Daten werden in bunten Kreisen auf der Karte dargestellt. Durch Doppelklick auf einen bunten Kreis werden die Kategorie und Anzahl der Treffer für diesen bestimmten Bereich angezeigt.

.. figure:: ../images/image_3.png

Werden unterschiedliche Kategorien geladen, wird jede Kategorie in einer anderen Farbe angezeigt. Unten rechts in der Karte erscheint dann eine Liste mit Farben und den jeweiligen zugeordneten Kategorien.


Load Overlay
41
^^^^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
42
43
44
45
46
47
48
49
50

Im oberen Fenster unter „Load Overlay“ muss der Datentyp der Datei bestimmt werden, der als Overlay geladen werden soll. Ein Overlay ist eine grafische Karte, die sich über die tatsächliche Karte legt. Das heißt, wenn Orte aus einer aktuellen Karte geladen sind und ein Overlay einer historischen Karte geladen wird, sind die Orte dort, wo sie heute sind und man kann sehen, wo dieser Ort zum Beispiel im 19 Jhd. lag. Hier können ebenfalls URLs von KML/KMZ-Dateien geladen werden, mit Auswahl der Option „KML File URL“ bzw. „KMZ File URL“.

Unter „ArcGIS WMS“ kann eine WMS-Server-URL und ein Layer angegeben werden, welches angezeigt werden soll.

Das „XYZ Layer“ hat neben den Informationen Breiten- und Längengrad noch die „thickness“. Hier kann eine URL mit x/y/z Platzhaltern eingetragen werden. (Das Format ist dasselbe, wie es in OpenLayers verwendet wird). „Roman Empire“ lädt eine Karte aus dem römischen Reich.


Dataset Information
51
^^^^^^^^^^^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
52
53
54
55
56

Sobald Daten in den Geo-Browser geladen wurden, kann man diese im Bereich „Dataset“ als „Magnetic Link“ öffnen. Der Geo-Browser öffnet sich bei Klick auf den Magnetic Link mit allen momentan referenzierten Datasets und kann so immer wieder aufgerufen werden. Beim Klick auf „Magnetic Link“ öffnet sich ein neuer Tab im Browser. Per „[upload to DARIAH storage]“ können Sie Ihre Datei im DARIAH Storage speichern, sie ist so über den Magnetic Link auch für andere sichtbar.


Background Map
57
^^^^^^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
58
59
60
61
62

Es gibt mehrere Optionen für Karten im Hintergrund. Es gibt eine aktuelle Karte „Contemporary Map (2010)“, es gibt historische Karten, die älteste ist von 2000 v. Chr, es gibt eine Karte des „Barrington Roman Empire“, eine Karte der Antike aus den Jahren zwischen 550 v. Chr. und 640 n. Chr. Als Default ist eine Karte von Open Street Map (MapQuest) eingestellt, hier werden neben Straßen und Staatsgrenzen auch Gebirge, Vegetation und Wüsten angezeigt.


Map Selector Tools
63
^^^^^^^^^^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
64
65
66
67
68
69
70
71
72
73
74

.. figure:: ../images/mapselectortools.png

Mit den Map Selector Tools ist es möglich, eine geometrische Form auf der Karte zu markieren. Durch Klicken auf die Form kann danach die entsprechende Form auf der Karte markiert werden. Es gibt ein Rechteck, einen Kreis, eine flexible Form mit der Möglichkeit, Punkte auf der Karte zu setzen, die verbunden werden. Dazu müssen die Punkte jeweils angeklickt werden. Wenn die Form fertig ist, kann man den Bereich durch Doppelklick auf den letzten Punkt fixieren. Sobald ein Bereich ausgewählt wurde, sind die Punkte in dem Bereich in der Auflistung der Ergebnisse markiert.

.. figure:: ../images/image_4.png

Es gibt außerdem die Möglichkeit, Staaten zu markieren, was allerdings momentan nur bei den historischen Karten funktioniert.


Filter
75
^^^^^^
Stefan Funk's avatar
Stefan Funk committed
76
77
78
79
80
81
82

.. figure:: ../images/filterminus.png

Mit dem Filter können Daten in einem mit den Map Selector Tools markierten Bereich ausgefiltert werden. Sie sind dann nicht mehr im Geo-Browser sichtbar.


Publication Place
83
^^^^^^^^^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
84
85
86
87
88

„Publication Place“ zeigt an, wieviele Ergebnisse es an unterschiedlichen Orten für die Suchanfrage gibt.


Liste unter der Weltkarte
89
^^^^^^^^^^^^^^^^^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

Wenn Daten in den Geo-Browser geladen werden, erscheint zusätzlich in einem Feld unter der Weltkarte eine Grafik, die den zeitlichen Verlauf der Daten anzeigt, und darunter eine Auflistung der Daten.

.. figure:: ../images/timestart.png

Unter „Time start“ lässt sich der Zeitpunkt auswählen, an dem die Grafik beginnen soll.

.. figure:: ../images/timeunit.png

Unter „Time unit“ lassen sich die Zeiteinheiten auswählen. Diese reichen von „continuous“ bis zu 500 Jahren. Die ausgewählte Einheit wird jeweils in Kästchen angezeigt. Im Auswahlfenster „Scaling“ kann die Skalierung des Diagramms verändert werden. Es gibt neben „normal“ die Optionen „logarithm“ und „percentage“.

.. figure:: ../images/image_5.png


Animation
105
^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

Um eine Animation zu starten, muss zuerst auf der Timeline ein bestimmter Bereich ausgewählt werden. Mit Klick auf die Grafik lässt sich ein Zeitfenster markieren.

.. figure:: ../images/animation.png

Beim Klick auf den Play- Button läuft der markierte Bereich einmal von links nach rechts über die Grafik und auf der Karte blinken jeweils die Punkte auf, die mit einem bestimmten Zeitpunkt verknüpft sind. Dies kann zu Demonstrationszwecken verwendet werden.

.. figure:: ../images/schliessen.png

Unter der Grafik ist ein orangefarbenes Feld, in dem durch Klick auf  die geladenen Daten gelöscht werden können.

.. figure:: ../images/herunterladenorange.png

Außerdem können die Daten hier mit Klick als KML Datei heruntergeladen werden. Unter der Zeitleiste befindet sich eine Auflistung aller Ereignisse. Mit Klick auf

.. figure:: ../images/hochklappen.png

kann diese Ansicht hochgeklappt werden. Es kann eingestellt werden, wie viele Ergebnisse der Liste jeweils auf einer Seite angezeigt werden (10 bis 100). Durch Klick auf

.. figure:: ../images/weiter.png

kann die Seite weitergeblättert werden. Durch Klick auf

.. figure:: ../images/N.png

kann die letzte Seite der Ergebnisse angezeigt werden. Mit Klick auf

.. figure:: ../images/Bild1.png

gelangt man zurück auf die erste Seite.

Unter der Grafik wird eine Liste angezeigt, die die Beschreibung (description), den Name (name) und den Ort (place) jedes gefundenen Objekts anzeigt. Beim Klick auf die Box links neben einem Eintrag wird der Eintrag markiert. Beim Klick auf die Lupe neben dem Suchfenster wird nur noch dieser Eintrag in der Weltkarte und in der Liste angezeigt. Alle anderen Elemente werden aus der Weltkarte und aus der Liste entfernt.


Kartenmaterial
141
--------------
Stefan Funk's avatar
Stefan Funk committed
142

Julius Dudensing's avatar
Julius Dudensing committed
143
Soweit nicht anders angezeigt, wird vom Geo-Browser freies Kartenmaterial zur Verfügung gestellt, das über den `DARIAH-DE GeoServer <https://ref.de.dariah.eu/geoserver/>`__ zur Verfügung gestellt wird, z. B. wurden die historischen Karten im Rahmen des Projekts europeana4D für den Vorgänger des Geo-Browsers (`e4D <https://www.sub.uni-goettingen.de/en/projects-research/project-details/projekt/europeanaconnect-europeana4d/>`__) genutzt. Die historischen Karten vom `ThinkQuest Team C006628 <https://web.archive.org/web/20060630061554/http://library.thinkquest.org/C006628/>`__ sind „in den meisten Fällen für eine Nutzung im Großen Maßstab gedacht, so dass nur die relativen Positionen der Länder verhältnismäßig genau sind. Bei den politischen Grenzen sollte ein durchschnittlicher Fehler von 40 Meilen angenommen werden." (siehe auch `Disclaimer <https://web.archive.org/web/20060903200541/http://library.thinkquest.org/C006628/disclaimer.html>`__)
Stefan Funk's avatar
Stefan Funk committed
144
145
146

Weitere genutzte Karten werden online von anderen Anbietern/Diensten eingebunden, beispielsweise Karten von OpenStreetmap und MapQuest. Die Lizensierung der Karten findet sich jeweils im unteren Teil der Geo-Browser-Kartenansicht.

Julius Dudensing's avatar
Julius Dudensing committed
147
Die Karte der Römischen Imperiums (`Digital Atlas of the Roman Empire <https://dare.ht.lu.se/>`__) wurde von Johan Åhlfeldt mit Unterstützung des Projekts `Pelagios <http://commons.pelagios.org/>`__entwickelt. Das Projekt ist im Artikel `A digital map of the Roman Empire <http://pelagios-project.blogspot.com/2012/09/a-digital-map-of-roman-empire.html>`__ näher beschrieben. Weitere Lizenzinformationen finden sich `hier <http://pelagios.org/maps/greco-roman/about.html>`__.
Stefan Funk's avatar
Stefan Funk committed
148
149
150


Versionierung and Release
151
-------------------------
Stefan Funk's avatar
Stefan Funk committed
152

153
Die aktuelle Version des DARIAH-DE Geo-Browsers ist zu erreichen unter https://geobrowser.de.dariah.eu. Seit Juni 2020 ist das die Release Version 2.7.8. Im Allgemeinen sind neue Versionen abwärtskompatibel.
Stefan Funk's avatar
Stefan Funk committed
154
155
156


Release-History
157
^^^^^^^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
158

159
160
161
162
163
Änderungen in Release Version 2.7.8 (Juni 2020):

* Die Popup Label beim mouseOver neben den Ortskreisen werden nun zunächst mit dem Inhalten der „name“-Felder gefüllt. Sind diese leer, werden die Inhalte der „place“-Felder genommen, ansonsten wird „unknowm“ gesetzt.
* Dokumentation leicht überarbeitet.

Stefan Funk's avatar
Stefan Funk committed
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
Änderungen in Release Version 2.7.0 (April 2019):

* Aktualisierung des `GeoServers <https://ref.de.dariah.eu/geoserver/>`__ auf Version 2.13.1.
* Dokumentation der CSV-Spezifikation
* Übersetzung der FAQs ins Englische
* Inhaltliche Überarbeitung der Dokumentation
* Nutzung von `Sphinx <http://sphinx-doc.org/>`__ für die Generierung der Dokumentation

Änderungen in Release Version 2 (Juli 2016):

*  Der `GeoServer <https://ref.de.dariah.eu/geoserver/>`__, der den Geo-Browser mit Karten versorgt, wurde aktualisiert auf Version 2.8.3.
*  Die Kontinentgrenzen der historischen Karten wurden korrigiert (GeoServer).
*  Es sind nun die aktuellsten EuroStat-Karten von 2013 und 2014 verfügbar (GeoServer).
*  Die Dokumentation liegt nun auch in Englisch vor.
*  Lizenzinformationen sind direkt in der Kartenansicht verfügbar (PLATIN).
*  Es gibt die Möglichkeit, lokale XLS/XLSX-Dateien unter „Load Data“ zu visualisieren (PLATIN).
*  Unter „Load Overlay“ kann der Water Layer von Maps-For-Free genutzt werden (PLATIN).
*  Ein globales DARIAH-DE Tool-Menü wurde integriert.
*  Das PIWIK der GWDG wurde eingebunden, um unter Berücksichtigung des Datenschutzes die Besucherströme nachzuvollziehen (dies können Sie auf der Seite `Datenschutzhinweis <https://de.dariah.eu/datenschutz>`__ jederzeit deaktivieren).
* Die Nutzung von `OpenGeoNames <http://www.geonames.org/>`__ im Datasheet Editor ist wieder möglich.
* Der Code von Geo-Browser und Datasheet Editor wurde in `ein gemeinsames Code-Repositorium <https://projects.gwdg.de/projects/geo-browser/repository>`__ zusammengelegt.
* `PLATIN <https://github.com/DARIAH-DE/PLATIN>`__ wurde für die Nutzung im Geo-Browser von DARIAH-DE geforked auf Github.
* Die statischen Daten wurden ebenfalls dem PLATIN-Fork hinzugefügt.

Änderungen in Release Version 1 (Oktober 2015):

* Anpassung der GUI an den DARIAH-DE Styleguide.
* Verweise auf Dokumentation, FAQ und weiterführende Information.
* Aktualisierung der Zeitleiste, so dass nun auch Einträge mit Zeiträumen angezeigt werden.


Spezifizierungen für die Nutzung
196
--------------------------------
Stefan Funk's avatar
Stefan Funk committed
197
198
199
200
201
202

* :download:`KML Spezifikation <../examples/M3.3.2_eConnect_KML_Specification_v1.0_UGOE.pdf>` für das Geo-Browser KML (PDF)
* :doc:`CSV Spezifikation <csvspec>`


Tools für die Erzeugung von KML- bzw. CSV-Dateien
203
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
204
205
206
207
208
209
210

* https://www.freemaptools.com/kml-file-creator.htm
* https://www.latlong.net/
* https://mapsengine.google.com/map/?hl=de


Beispieldateien
211
^^^^^^^^^^^^^^^
Stefan Funk's avatar
Stefan Funk committed
212
213
214
215
216
217
218
219
220
221
222

KML
    * https://steinheim-institut.de/daten/epidat.kml (`öffnen im Geo-Browser <https://geobrowser.de.dariah.eu/?kml=https://steinheim-institut.de/daten/epidat.kml>`__)
    * https://geobrowser.de.dariah.eu/data/goethe.kml (`öffnen im Geo-Browser <https://geobrowser.de.dariah.eu/?kml=https://geobrowser.de.dariah.eu/data/goethe.kml>`__)
    * https://geobrowser.de.dariah.eu/data/rechtegewalt.kml (`öffnen im Geo-Browser <https://geobrowser.de.dariah.eu/?kml=https://geobrowser.de.dariah.eu/data/rechtegewalt.kml>`__)

CSV
    * :download:`Universal-Kirchenzeitung-Nachrichten-aus-der-Israelitschen-Abteilung.csv <../examples/Universal-Kirchenzeitung-Nachrichten-aus-der-Israelitschen-Abteilung.csv>`


GIT Repository
223
--------------
Stefan Funk's avatar
Stefan Funk committed
224
225
226
227
228
229
230
231
232
233
234
235

DARIAH-DE Geo-Browser Repository
    * https://projects.gwdg.de/projects/geo-browser/repository

GeoTemCo
    * https://github.com/stjaenicke/GeoTemCo

PLATIN-Fork vom DARIAH-DE Geo-Browser (hauptsächlich angepasste Konfiguration)
    * https://github.com/DARIAH-DE/PLATIN


Bugtracking
236
-----------
Stefan Funk's avatar
Stefan Funk committed
237

Julius Dudensing's avatar
Julius Dudensing committed
238
    * https://projects.gwdg.de/projects/geo-browser/work_packages