Adapp : tutoriel xmgrace

Présentation

Xmgrace est un outil du domaine public pour le tracé de courbes et d'histogrammes sous X.

Fonctions

  • Définition de l'échelle, des libellés, des symboles, des types de ligne, etc.
  • Lecture/Écriture des paramètres en cours de session.
  • Régression polynomiale, splines, DFT/FFT, fonction d'auto/corrélation
  • Copie en format PostScript, HPGL et FrameMaker (format .mif).

Utilisation

Xmgrace peut être obtenue à partir d'un grand nombre de sites, c'est le successeur de xmgr.

Session xmgrace

Appel de xmgrace

Représentation du fichier de données z.data

1.000000 1.000000
2.000000 1.775862
3.000000 2.901408
4.000000 4.204082

xmgr z.data

Ecrire un titre

Pour ajouter un titre au tracé il suffit de faire un double clic sur le haut du dessin. On obtient alors le menu Graph Appearance. Les différents boutons Main, Title … permettent de personnaliser la présentation.

Modifier les axes et choisir leur représentation

La présentation des axes s'obtient par un double clic au niveau des axes du tracé, le menu Axes apparaît alors .

Différents boutons Main, Axis label & bar, Tick labels, Ticks marks, Special permettent de modifier la présentation.

Ajout d'une légende

L'ajout d'une légende est réalisé par le menu Symbols/legends qui apparait après un double clic sur le graphique.

Sauvegarde des données et/ou des paramètres de tracé

Après avoir choisi la mise en page on peut sauver au choix les données, les paramètres de présentation ou les deux.

Lecture/écriture des données et des paramètres de tracé simultanément

Le menu File permet, via le sous menu Save, de sauvegarder les données et les paramètres de présentation. La relecture d'un fichier sauvegardé par le sous menu Save, se fait par le sous menu Open ou lors de l'appel de xmgrace.

Exemple : relecture d'un fichier z.save sauvegardé par le sous menu Save.

xmgrace z.save

Extrait du fichier z.save crée par le menu Save

Lecture/écriture des données seulement

Le menu Data permet, via le sous menu Export, de sauvegarder les données sans les paramètres de présentation du tracé. La relecture se faisant ensuite avec le sous menu Import. On peut aussi relire les données sauvegardées directement à l'appel de xmgrace.

Exemple : Relecture du fichier z.data sauvegardé par le sous menu Export

xmgr z.data

Lecture/écriture des paramètres seulement

Le menu Plot permet, via le sous menu Save parameters, de sauvegarder les paramètres d'un tracé sans les données. On peut ainsi avoir plusieurs présentations pour un seul ensemble de données. La relecture se fait par le sous menu Load parameters ou directement à l'appel de xmgrace.

Exemple : relecture d'un fichier de données z.data et d'un fichier de paramètres z.parm qui a été préalablement sauvegardé par le sous menu Save parameters.

xmgrace z.data -p z.parm

Modification des paramètres

Le menu Window permet la modification de la présentation du tracé grâce à des commandes entrées interactivement. On peut également modifier des paramètres sauvés dans un fichier par le menu Save. La syntaxe est la même pour l'interpréteur de commandes interactif et pour le fichier de paramètres sauvé par le menu Save parameters. La syntaxe des commandes est disponible dans la documentation en ligne.

Options d'appel

Un certain nombre d'options peuvent être utilisées à l'appel de xmgrace

 xmgrace -help | more

-autoscale [x|y|xy|none]              Set autoscale type
-barebones                            Turn off all toolbars
-batch     [batch_file]               Execute batch_file on start up
-block     [block_data]               Assume data file is block data
-bxy       [x:y:etc.]                 Form a set from the current block data set
                                        using the current set type from columns
                                        given in the argument
-datehint  [iso|european|us
            |days|seconds|nohint]     Set the hint for dates analysis
                                        (it is only a hint for the parser)
-dpipe     [descriptor]               Read data from descriptor on startup
-fixed     [width] [height]           Set canvas size fixed to width*height
-free                                 Use free page layout
-graph     [graph_number]             Set the current graph number
-graphtype [graph_type]               Set the type of the current graph
-hardcopy                             No interactive session, just print and
                                        quit
-hdevice   [hardcopy_device_name]     Set default hardcopy device
-install                              Install private colormap
-legend    [load]                     Turn the graph legend on
-log       [x|y|xy]                   Set the axis scaling of the current graph
                                        to logarithmic
-mono                                 Run Grace in monochrome mode (affects
                                        the display only)
-netcdf    [netcdf file]              Assume data file is in netCDF format
-netcdfxy  [X var name] [Y var name]  If -netcdf was used previously, read from
                                        the netCDF file 'X var name' and 'Y
                                        var name' and create a set. If 'X var
                                        name' is ''null'' then load the
                                        index of Y to X
-noask                                Assume the answer is yes to all requests -
                                        if the operation would overwrite a file,
                                        grace will do so without prompting
-noinstall                            Don't use private colormap
-noprint                              In batch mode, do not print
-nosigcatch                           Don't catch signals
-npipe     [file]                     Read data from named pipe on startup
-nxy       [nxy_file]                 Assume data file is in X Y1 Y2 Y3 ...
                                        format
-param     [parameter_file]           Load parameters from parameter_file to the
                                        current graph
-pexec     [parameter_string]         Interpret string as a parameter setting
-pipe                                 Read data from stdin on startup
-printfile [file for hardcopy output] Save print output to file
-remove                               Remove data file after read
-results   [results_file]             Write results of some data manipulations
                                        to results_file
-rvideo                               Exchange the color indices for black and
                                        white
-saveall   [save_file]                Save all to save_file
-seed      [seed_value]               Integer seed for random number generator
-source    [disk|pipe]                Source type of next data file
-timer     [delay]                    Set allowed time slice for real time
                                        inputs to delay ms
-timestamp                            Add timestamp to plot
-settype   [xy|xydx|...]              Set the type of the next data file
-version                              Show the program version
-viewport  [xmin ymin xmax ymax]      Set the viewport for the current graph
-wd        [directory]                Set the working directory
-world     [xmin ymin xmax ymax]      Set the world coordinates for the
                                        current graph
-usage|-help                          This message