descqa
v2.8.0
Dieses Repository enthält das DESCQA-Framework, das simulierte Galaxienkataloge validiert. Weitere Informationen zu diesem Framework finden Sie im DESCQA-Papier.
Eine auf NERSC gehostete Weboberfläche zeigt aktuelle Validierungsergebnisse des DESCQA-Frameworks an.
! Wichtig ! Ab DESCQA v2 (aktuelle Version) haben wir die Konfigurationen und Leser von Katalogen von DESCQA getrennt und sie in ein eigenständiges Repo verschoben, das GRCCatalogs-Repo. Wir haben auch viele Validierungstests geändert. Wenn Sie nach den Katalogen und Tests in DESCQA v1 (wie im Begleitpapier dargestellt) suchen, sehen Sie sich bitte das Unterverzeichnis v1 an.
So führen Sie einen Beispiel-DESCQA-Test über die Befehlszeile aus:
git clone [email protected]:LSSTDESC/descqa
cd descqa
sh run_master.sh -c cosmoDC2_v1.1.4_small -t SkyArea
Siehe „Wie führt man DESCQA aus?“ Weitere Optionen, die Sie mit dem Ausführungsskript verwenden können, finden Sie im Abschnitt in CONTRIBUTING.md .
Versuchen Sie zunächst, auf die Kataloge zuzugreifen! Informationen zu den Katalogen finden Sie auf dieser Confluence-Seite und dieser Präsentation (Video). Am einfachsten ist es jedoch, zu https://jupyter.nersc.gov zu gehen, sich mit Ihrem NERSC-Konto anzumelden und diesem Tutorial-Notizbuch zu folgen (Download-Link, Sie können das Notizbuch dann über die Jupyter-Schnittstelle hochladen).
Sobald Sie Zugriff auf die Kataloge haben, versuchen Sie, einige Handlungsstränge zu den Dingen zu erstellen, die Sie interessieren. Sie können einige vorgeschlagene Ideen finden, aber Sie sind herzlich willkommen, sich neue auszudenken!
Nachdem Sie nun in der Lage sind, einige Diagramme zu erstellen, überlegen Sie, wie Sie die Kataloge „validieren“ können (d. h. gibt es Beobachtungs-/Theoriedaten, die zum Vergleich auf derselben Abbildung dargestellt werden können? Wie kann entschieden werden, ob ein Katalog zufriedenstellend ist?)
Jetzt können wir Ihre Arbeit in die DESCQA-Weboberfläche integrieren! Dieser Schritt ist etwas aufwändiger, aber Sie können der Anleitung hier folgen.
run_master.sh : ein praktisches Shell-Skript zum Ausführen von DECSQAfix_web_permission.sh : ein praktisches Shell-Skript, um sicherzustellen, dass Berechtigungen korrekt festgelegt werden.index.cgi : CGI-Skript für die Weboberflächedescqa/ : Paket, das alle Validierungstestklassen und relevanten Dienstprogramme enthältdescqa/configs/ : Verzeichnis, das alle YAML-Dateien für die Validierungstestkonfiguration hostetdescqa/data/ : Verzeichnis, das kleine Datendateien hostet, die für Validierungstests erforderlich sinddescqaqweb/ : Paket, das die Weboberfläche enthältdescqaqrun/ : Paket, das die Ausführungsskripte enthältv1 : Katalogleser und Validierungstests für DESCQA v1 Die vollständigen Installationsabhängigkeiten finden Sie unter install_requires und extras_require in setup.py.
Beachten Sie, dass zum Ausführen von DESCQA (v2) auch GCRCatalogs erforderlich ist.
