descqa

DESCQA

Este repositorio contiene el marco DESCQA que valida catálogos de galaxias simuladas. Para obtener más información sobre este marco, consulte el documento DESCQA.

Una interfaz web alojada en NERSC muestra los resultados de validación recientes del marco DESCQA.

! Importante ! A partir de DESCQA v2 (versión actual), separamos las configuraciones y los lectores de catálogos de DESCQA y los trasladamos a un repositorio independiente, el repositorio GCRCatalogs. También hemos cambiado gran parte de las pruebas de validación. Si está buscando catálogos y pruebas en DESCQA v1 (como se presenta en el documento complementario), consulte el subdirectorio v1.

Ejemplo de ejecución de una prueba en DESCQA

Para ejecutar una prueba DESCQA de muestra desde la línea de comandos:

 git clone [email protected]:LSSTDESC/descqa
cd descqa
sh run_master.sh -c cosmoDC2_v1.1.4_small -t SkyArea

Consulte "¿Cómo ejecutar DESCQA?" sección en CONTRIBUTING.md para obtener más opciones que puede usar con el script de ejecución.

Guía de inicio rápido para realizar pruebas.

1. ¡En primer lugar, prueba a acceder a los catálogos! Puedes encontrar información sobre los catálogos en esta página de Confluence y en esta presentación (vídeo). Sin embargo, la forma más sencilla de comenzar es ir a https://jupyter.nersc.gov, iniciar sesión con su cuenta NERSC y seguir este cuaderno tutorial (enlace de descarga; luego puede cargar el cuaderno a través de la interfaz de jupyter).

2. Una vez que pueda acceder a los catálogos, intente crear algunas tramas sobre las cosas que le interesan. Puede encontrar algunas ideas que se han propuesto, ¡pero puede proponer otras nuevas!

3. Ahora que puede hacer algunos gráficos, piense en cómo "validar" los catálogos (es decir, ¿hay datos de observación/teoría que se puedan trazar en la misma figura para compararlos? ¿Cómo decidir si un catálogo es satisfactorio?)

4. ¡Ahora podemos integrar su trabajo en la interfaz web de DESCQA! Este paso es un poco más complicado, pero puedes seguir las instrucciones aquí.

Estructura del código

• run_master.sh : un script de shell conveniente para ejecutar DECSQA
• fix_web_permission.sh : un conveniente script de shell para garantizar que los permisos estén configurados correctamente.
• index.cgi : script CGI para interfaz web
• descqa/ : paquete que contiene todas las clases de prueba de validación y utilidades relevantes
• descqa/configs/ : directorio que aloja todos los archivos YAML de configuración de prueba de validación
• descqa/data/ : directorio que aloja pequeños archivos de datos que necesitan las pruebas de validación
• descqaqweb/ : paquete que contiene la interfaz web
• descqaqrun/ : paquete que contiene los scripts de ejecución
• v1 : lectores de catálogo y pruebas de validación para DESCQA v1

Dependencias

Consulte install_requires y extras_require en setup.py para conocer las dependencias de instalación completas.

Tenga en cuenta que para ejecutar DESCQA (v2), también se requiere GCRCatalogs.

Dependencias adicionales para v1

• Solo Python 2.7
• kcorrecto
• fast3tree
• https://bitbucket.org/yymao/helpers