Les données associées VizieR se regroupent en deux catégories:
URL d'accès aux données associées | http://cdsarc.cds.unistra.fr.fr/assocdata/ |
(version locale) | http://cdsarc.cds.unistra.fr.fr/local/assocdata/ |
URL de Saada | http://cdsarc.cds.unistra.fr.fr/saadavizier/ |
(version locale) | http://cdsarc.cds.unistra.fr.fr/saadavizierlocal/ |
URL de soumission des données | http://cdsarc.cds.unistra.fr.fr/vizier.submit/ |
Deux bases sont disponibles:
Les métadonnés pour les données associées sont les métadonnées "mandatory" ObsCore de l'IVOA (voir la desciption ici).
Le système de gestion de bases de données est Saada.
L'interface propose 2 modes:
Note: les modifications (ex: ajout de nouveau catalogue) sont effectives sur le site web de production (webassocdata) une fois par semaine.
Toutefois, la table "obscore2", disponible via ADQL est mise à jour à chaque ingestion de catalogue en base de production.
Note : on entend par "collection" un mapping (entête FITS - ObsCore) relatif à un ou plusieurs fichiers FITS. Un mapping s'appliquant à une collection de fichiers, s'appliquera pour tous les fichiers de la collection. Cela est utile lorsque des fichiers ont des entêtes FITS similaires.
Le format du fichier peut être:
Outils:
----------------------------------------------- image: rasters/ (384) hdu: -1 target_name: TARGET # Assigned by keyword - Value: LN2225B s_ra: WCS.getCenter(1)# Assigned by WCS - Value: 250.2513303042088 s_dec: WCS.getCenter(2)# Assigned by WCS - Value: -46.92333464412786 s_fov: WCS.getFieldOfView()# Assigned by WCS - Value: 0.19998514701814568 s_region: WCS.getWorldPixelRegion()# Assigned by WCS - Value: Polygon ICRS 249.95903730828033 -46.82296872113044 249.95795323935064 -47.02296635561337 250.54471636792442 -47.02295386814858 250.54361408030866 -46.822956320733006 s_resolution: WCS.getWorldPixelSize()# Assigned by WCS - Value: 8.485298618489859 system: WCS.getAstroFrame()# Assigned by WCS - Value: FK5,2000.0,2000.0 t_min: OBS_TIME t_max: t_exptime: t_resolution: em_min: 0.000007 em_max: 0.000015 em_res_power: spcunit: 'm' em_band: # Value: pol_states: instrument_name: 'ISOGAL' facility_name: TELESCOP # Assigned by keyword - Value: ISO
Ce fichier peut être modifié à la main par un éditeur (vi). C'est le format de sortie des commandes getimg et getspec ainsi que le format en entrée des programmes putimg et putspec.
Le commentaire suivant la valeur indique la valeur trouvée par Saada (utile lorsque l'on utilise des mots clés FITS). Dans le cas de collection regroupant plusieurs fichiers, la valeur est mise à titre indicatif : il s'agit de la valeur prise dans le premier fichier FITS de la collection.
Note : le fichier JSON est affiché au format text par les programmes putimg et putspec.
ex: mapping pour un fichier fits: getimg fits/monfichier.fit mapping pour un repertoire contenant des fichiers fits et etablissant un mapping commun a tous les fichiers getimg fits/ mapping pour un repertoire contenant des fichiers fits et etablissant un mapping dedie a chaque fichiers getimg "fits/*" mapping pour une collection (description commune) pour une liste de fichiers getimg liste ou liste est un fichier contenant les fichiers de la collection (un fichier FITS par ligne) Pour rediriger le resultat vers un fichier: getimg fits/ > obscoreimage
getspec : Idem que "getimg" appliqué aux spectres.
Note : il est possible de concaténer des mappings afin de regouper dans le même fichier de mapping (obscoreimage ou obscorespectrum) des mappings relatifs à plusieurs collections ou fichiers FITS:
getimg fits/fichier1.fits>obscoreimage getimg fits/fichier2.fits>> obscoreimage ...
Note: plusieurs fichiers mapping peuvent exister au sein d'un même catalogue (mais peut être pas souhaitée).
Les programmes d'ingestions putimg et putspec peuvent incrementer un catalogue déjà existant (voir etapes pgm ingestion)
putimg : le programme qui met en forme et ajoute les données dans la base Saada (local).
ex: ingestion du mapping present dans le fichier "obscoreimage" putimg ingestion du mapping nomme "obscoreimage1" putimg obscoreimage1
putspec: idem que putimg" appliqué aux spectres/SED/time-series.
Etape des programmes putimg et putspec:
saadaconv : programme avec plus d'option pour créer un mapping ou ingérer les données en base locale.
ex: aide en ligne saadaconv -h afficher le resultat d'un mapping existant: saadaconv -f obscoreimage -o table transformer un format de fichier json en text saadaconv -f obscoreimage -o text
ex: target_name: 'M31'
Les expressions dans le mapping:
target_name: substring(FICHIER,1,10)
-name=split(FICHIER, '_', '0') - param 1 : clé fits, nom du fichier ou chaine - param 2 : séparateur - param 3 : num de l'élément à prendre. Si cet élement n'existe pas le param 1 est pris comme valeur exemple: FICHIER = 'G2634A_12CO.fits' split(FICHIER, '_', '0') = G2634A split(FICHIER, '_', '1') = 12CO.fits split(FICHIER, '_', '2') = G2634A_12CO.fits split(FICHIER, '_', '-1234') = G2634A_12CO.fits
ex: em_min: WCS.getMin(1)
ex: target_name: OBJECT # Assigned by keyword - Value: HD2012 s_ra: ${SESAME} s_dec: ${SESAME}
ex: catalogue J/MNRAS/404/661: s_ra: ${J/MNRAS/404/661/table}.${RAJ2000}.${File.Hc} s_dec: ${J/MNRAS/404/661/table}.${DEJ2000}.${File.Hc}
ex: le mapping ignore le mot cle OBJECT ignore: OBJECT
wcs.CUNIT1= 'Angstrom'
Un mapping (soit une entrée/record dans Saada) correspond a 1 HDU.
Par défaut, le mapping s'applique au premier HDU.
S'il existe plusieurs HDU, on utilise le spécifie dans le mapping:
ex: mapping s'appliquent au HDU=2 hdu: 2Note: la vaeleur -1 est la valeur par défaut: elle correspond au 1er HDU valide.
Il est possible de créer un mapping qui s'appliqueà tous les HDU d'un fichier:
ex: mapping s'appliquent a toutes les extensions HDU hdu: *Dans ce cas les utilitaires putimg, img ou encore saadaconv créérons un nouveau mapping détaillée. Voir l'exemple du catalogue J/ApJ/802/60.
ex: utilisation de l'utilitaire saadaconv pour generer un mapping s'appliquant a tous les hdu (catalogue J/ApJ/802/60) saadaconv -f obscoreimage
note: em_band peut être assignée si les coordonées spectrales (em_min, em_max) ne sont pas trouvées.
em_band peut prendre les valeurs suivante (voir la liste complète dans l'interface d'accès aux données webassocdata):
'Gamma', 'Xray', 'EUV', 'UV', 'Optical, 'IR', 'Millimeter', 'Radio', etc.
Exemple:
fichier obscorespectrum.py pour J/ApJS/261/31
\VizAssocData{obscoreimage}Ce tag est ajoutée en base pour signaler qu'il existe des entrées du catalogue dans la base de données associées. Le tag n'est effectif qu'après avoir réinseré le catalogue (2v).
On peut aussi ajouter une colonne "assocdata" qui est un lien vers le site web des données associées:
Pour un spectre:
\vizMore{ table }{AssocData}{\AssocDataSpecLink{@{@cat}}{@{***FITSfile}}} \vizAddColumn{ table }{AssocData}{fits}{}{ -FITSfile}{Associated Data web page} ou FITSfile est le nom de la colonne dont le contenu = nom u fichier FITS
Pour une image (on utilise AssocDataImageLink pour creer une imagette):
\vizMore{ table }{AssocData}{\AssocDataImageLink{@{@cat}}{@{***FITSfile}}} \vizAddColumn{ table }{AssocData}{fits}{}{ -FITSfile}{Associated Data web page}
Exemple: https://cdsarc.cds.unistra.fr/viz-bin/cat/J/A+A/654/A40
Exemple: VIII/39, J/A+A/589/A36 V/127
voir obscorespectrum.py