Contents:

• 1. Interrogation WEB
• 2. Mise en oeuvre - Apercu
• 3. Description des syntaxes utilisées
  • 3.1. Le pseudo-SQL
  • 3.2. Le fichier .status
  • 3.3. Le fichier SQL et exemples pratiques
    • 3.3.1. Type de plot, barres d'erreurs, ...
    • 3.3.2. Interagir sur le plot
    • 3.3.3. Interagir sur des valeurs variables ou des valeurs de colonnes(SQL dynamique)
    • 3.3.4. Plusieurs plots dans un seul graphe
    • 3.3.5. Simplification du SQL: utiliser un alias
    • 3.3.6. Timeserie avec une periode dynamique
    • 3.3.7. Ajouter des conditions à l'aide de la commande ifmatch (fichier .status)
    • 3.3.8. Un plot composé par plusieurs requêtes SQL
    • 3.3.9. Utiliser une constante issue d'une commande SHELL
    • 3.3.10. Tracer un plot à partir d'une colonne contenant des vecteurs dans un fichier FITS
    • 3.3.11. Utilisation d'un compteur
    • 3.3.12. Personnalisation des labels des axes du graphe
    • 3.3.13. Personnalisation du mode de tracé et des couleurs
• 4. Description des Outils
• 5. Creation d'imagettes

2 méthodes sont disponibles dans VizieR pour générer des graphes.

• par script dédié nommé .graph: extraction des donnés par un script AWK puis utilisation du programme graph (GNU). (voir doc graph)
• utilisation du script générique vizgraph: extraction des donnés à partir d'un pseudo-SQL

Le document traite uniquement de la méthode utilisant le pseudo-SQL pour extraire des données. La méthode peut s'appliquer aux fichiers FITS, TSV, ASCII ou depuis une commande SHELL.

1  Interrogation WEB

2 méthodes sont disponibles:

1. exécution (du script) sur le serveur. Cette méthode est à privilégier lorsque le nombre de lignes est > 10,000.
   Le résultat est une simple page statique contenant le graphe et un formulaire

   Exemple

2. exécution sur le navigateur client.
   Le résultat est une page dynamique contenant le graphe et un formulaire complet.

   Exemple

2  Mise en oeuvre - Apercu

Dans le fichier ".status", l'instruction \vPlot indique le fichier SQL qui sera exécuté lors de l'affichage du graphe.

3  Description des syntaxes utilisées

3.1  Le pseudo-SQL

Le language d'extraction des donnés s'apparente au SQL. La syntaxe générale est la suivante:

SELECT expression1, expression2, ... FROM ressource WHERE conditions

Où:

expression	: expression arithmétique constituée par des noms de colonnes. Une colonne peut être désignée par son numéro de colonne: $i (i-ème colonne)
ressource	: le nom de la ressource entouré par des doubles-quotes: un fichier ASCII, TSV, FITS ou une commande SHELL
conditions	: Condition d'extraction de la donnée

Exemple:
Sélection des 2 premières colonnes du fichier 'fichier.fits' lorsque la valeur de la premi\ère colonne est inférieur à 10:

SELECT $1,$2 FROM "fichier.fits" WHERE $1<10 

Sélection des colonnes RAW, FLUX, ERRFLUX du fichier 'fichier.fits' lorsque la valeur ERRFLUX est inérieur à 0.1:

SELECT RAW, FLUX, ERRFLUX FROM "fichier.fits" WHERE ERRFLUX < 0.1 

Sélection de 2 colonnes calculés à partir des 2 premi\ères colonnes du fichier 'fichier.fits':

SELECT  ($1+2)*10, $1+$2 FROM "fichier.fits" 

Notes: on peut:

• combiner des conditions avec les instruction AND et OR.

  SELECT $1,$2 FROM "fichier.fits" WHERE $1 < 10 AND $3=0
  

• travailler sur plusieurs tables (jointure):
  

  SELECT f.$1, g.$2 FROM "fichier1.tsv" f, "fichier2.tsv" g WHERE f.$1=g.$1
  

• travailler avec le résultat d'une commande pour ressource:

  SELECT $1, $2 FROM "asu -source=II/246/out -c=0+0 -c.rm=1"
  

• utiliser la transposé d'une ressource (fichier FITS,ASCII, ...): (voir section)

  SELECT .... from "transpose(fichier.dat)"
  

3.2  Le fichier .status

\vPlot{catalogue}{fichier_sql}{options}{column_value}	Graphe standard exécuté sur le serveur (cas 1)
\vplot{catalogue}{fichier_sql}{options}{column_value}	Graphe standard exécuté sur le navigateur (cas 2)
\vPlotTS{catalogue}{fichier_sql}{options}{column_value}	Time serie exécuté sur le serveur (cas 1)
\vplotTS{catalogue}{fichier_sql}{options}{column_value}	Time serie exécuté sur le serveur (cas 2)

Explications des arguments: