openMusiXplora

Forschung und Datenzugang

Mit den Forschungsdaten lokal arbeiten

Einen vollständigen Datensatz als JSON auslesen, die Überlieferung zuordnen und Dateien prüfen.

Beispiele aus Datenausgabe 1 vom 20. November 2026.

Die passende Datei wählen

Für tabellarische Auswertungen enthält catalogue-csv.zip Tabellen des Basiskatalogs. catalogue.jsonl.gz enthält dessen Datensätze im Format JSON Lines. Die Ortsabfrage vom Juli ist als eigener Download beschrieben. Vermerken Sie bei einer Auswertung, welche Bestandteile der Datenausgabe Sie kombiniert haben.

Einen Datensatz im Basisexport auswählen

Laden Sie catalogue.jsonl.gz von der Downloadseite des Onlinekatalogs herunter. Legen Sie die Datei im Arbeitsverzeichnis ab. Das Beispiel liest den Export zeilenweise bis zur Kennung f0394.

import gzip
import json

with gzip.open("catalogue.jsonl.gz", "rt", encoding="utf-8") as source:
    for line in source:
        record = json.loads(line)
        if record["profile"]["id"] == "f0394":
            print(record["profile"]["label"], len(record["relationships"]))
            break

Das Programm gibt „Josef Focht 229“ aus. Für dieselbe Abfrage in openMusiXplora Portable genügt eines der ZIP-Archive.

Eine einzelne JSON-Datei aus dem Archiv lesen

openMusiXplora Portable enthält 31 ZIP-Dateien mit einzelnen JSON-Datensätzen. Im Eintrag zu Josef Focht nennt der Abschnitt „JSON-Datei im Archiv der Datenausgabe“ den Archivnamen und den genauen Pfad. Laden Sie records-0024.zip herunter und führen Sie das Python-Beispiel im selben Verzeichnis aus.

import json
from zipfile import ZipFile

with ZipFile("records-0024.zip") as archive:
    with archive.open("records/d5/f0394.json") as source:
        record = json.load(source)
print(record["profile"]["label"], len(record["relationships"]))

Die Ausgabe lautet „Josef Focht 229“. profile enthält die Kurzbeschreibung. relationships enthält die vollständige Liste der Beziehungen. Die Online-API liefert diese Liste in mehreren Ergebnisseiten.

Den Dateistand festhalten

Vergleichen Sie die SHA-256-Prüfsumme der heruntergeladenen Datei mit derjenigen im Dateiverzeichnis derselben Datenausgabe. Geben Sie in einer Publikation Datenausgabe, Dateinamen und Prüfsumme an. Kennzeichnen Sie eigene Normalisierungen oder ergänzte Zuordnungen in der abgeleiteten Tabelle.