La documentation sur PGPLOT
Sur le web :
La documentation complète en ligne
de la version actuelle de PgPlot (5.2) peut être consultée
à l'adresse http://astro.caltech.edu/~tjp/pgplot/.
Si le réseau est lent, une version
allégée et ne contenant que la decription des fonctions est
disponible en local à l'adresse file:///usr/doc/pgplot-devel-5.2.0/pgplot.html
Documentation papier :
Deux fichiers peuvent être consultés,
ils contiennent la decription des fonctions PgPlot :
-
Un fichier texte : /usr/doc/pgplot-devel-5.2.0/pgplot.doc,
que l'on peut ouvrir avec n'importe quel éditeur de texte (kwrite,
xemacs, etc...)
-
Un fichier postscript : /usr/doc/pgplot-devel-5.2.0/pgplot-routines.ps
que l'on peut voir à l'écran avec gv.
Les deux fichiers peuvent être imprimés avec
la commande lpr. A utiliser avec modération car ils sont assez gros
(63 pages pour le fichier texte, 77 pages pour le fichier PostScript).
Comment lire la documentation :
Elle est écrite en anglais (des
utilitaires de traduction existent, par exemple http://babelfish.altavista.com/cgi-bin/translate
... les résultats sont parfois étonnants).
Elle est écrite pour l'appel
de PgPlot depuis le langage Fortran. Il est très simple de passer
du Fortran au C avec les conventions suivantes :
-
Les noms des fonctions Fortran commencent par les lettres
PG
(exemple : pgline). Les noms des
fonctions C correspondantes commencent par CPG
(exemple : cpgline).
-
Pour les types des variables :
| Fortran |
C |
| REAL |
float |
| INTEGER |
int |
| CHARACTER |
char* |
| LOGICAL |
int |
Un exemple :
Documentation Fortran pour la
fonction PGLINE :
SUBROUTINE PGLINE (N,
XPTS, YPTS)
INTEGER N
REAL
XPTS(*), YPTS(*)
Equivalent C :
cpgline(n, xpts, ypts)
int n;
float xpts[], ypts[];
Autre exemple :
Documentation Fortran pour la
fonction PGPTXT :
SUBROUTINE PGPTXT (X,
Y, ANGLE, FJUST, TEXT)
REAL X, Y, ANGLE,
FJUST
CHARACTER*(*) TEXT
Equivalent C :
cpgptxt(x, y, angle,
fjust, text)
float x,y, angle,
fjust;
char *text;