descqa
v2.8.0
Ce référentiel contient le framework DESCQA qui valide les catalogues de galaxies simulées. Pour plus d'informations sur ce cadre, veuillez consulter le document DESCQA.
Une interface Web hébergée sur NERSC affiche les résultats de validation récents du framework DESCQA.
! Important ! À partir de DESCQA v2 (version actuelle), nous avons séparé les configurations et les lecteurs de catalogues de DESCQA et les avons déplacés vers un dépôt autonome, le dépôt GCRCatalogs. Nous avons également modifié une grande partie des tests de validation. Si vous recherchez les catalogues et les tests dans DESCQA v1 (tels que présentés dans le document complémentaire), veuillez consulter le sous-répertoire v1.
Pour exécuter un exemple de test DESCQA à partir de la ligne de commande :
git clone [email protected]:LSSTDESC/descqa
cd descqa
sh run_master.sh -c cosmoDC2_v1.1.4_small -t SkyArea
Voir « Comment exécuter DESCQA ? » section dans CONTRIBUTING.md pour plus d'options que vous pouvez utiliser avec le script d'exécution.
Tout d’abord, essayez d’accéder aux catalogues ! Vous pouvez retrouver des informations sur les catalogues dans cette page Confluence et cette présentation (vidéo). Cependant, le moyen le plus simple de commencer est d'aller sur https://jupyter.nersc.gov et de vous connecter avec votre compte NERSC, puis de suivre ce cahier de didacticiel (lien de téléchargement, vous pouvez ensuite télécharger le cahier via l'interface jupyter).
Une fois que vous pouvez accéder aux catalogues, essayez de faire des intrigues sur les choses qui vous intéressent. Vous pouvez trouver quelques idées qui ont été proposées, mais vous êtes plus que bienvenu pour en proposer de nouvelles !
Maintenant que vous êtes capable de réaliser quelques tracés, réfléchissez à la manière de « valider » les catalogues (c'est-à-dire existe-t-il des données d'observation/théorie qui peuvent être tracées sur la même figure à des fins de comparaison ? Comment décider si un catalogue est satisfaisant ?)
Nous pouvons désormais intégrer votre travail dans l’interface web DESCQA ! Cette étape est légèrement plus complexe, mais vous pouvez suivre les instructions ici.
run_master.sh : un script shell pratique pour exécuter DECSQAfix_web_permission.sh : un script shell pratique pour garantir que les autorisations sont correctement définies.index.cgi : script CGI pour interface webdescqa/ : package qui contient toutes les classes de tests de validation et les utilitaires pertinentsdescqa/configs/ : répertoire qui héberge tous les fichiers YAML de configuration des tests de validationdescqa/data/ : répertoire qui héberge les petits fichiers de données dont les tests de validation ont besoindescqaqweb/ : package qui contient l'interface webdescqaqrun/ : package qui contient les scripts d'exécutionv1 : lecteurs de catalogue et tests de validation pour DESCQA v1 Voir install_requires et extras_require dans setup.py pour les dépendances complètes de l'installation.
Notez que pour exécuter DESCQA (v2), GCRCatalogs est également requis.
