3. Operands#
3.1. Presentation of curves#
A set of optional operands defines the layout of the curve. All have a value by default.
3.1.1. Operand FORMAT#
◊ FORMAT =
Function print format
“AGRAF” |
printing intended for the agraf software, which also makes it possible to adapt the presentation parameters interactively, |
“TABLEAU” |
printing in columns makes it easy to import data into a spreadsheet, if you give several curves, it is the list of the abscissas of the first function that is used to interpolate the values of the other functions, |
“XMGRACE” |
Print for the xmgrace software. You can also adapt the presentation parameters interactively. The use of the PILOTEpermet keyword to directly produce an image or postscript file. |
“LISS_ENVELOP” |
Print intended for shows from CALC_FONCTION/LISS_ENVELOP. The curves are drawn using the Matplotlib python libraries available in the Salomé-Méca distribution. |
Note
The format XMGRACE is intended for versions 5 of grace and is not compatible with grace6 (version 5.99) .
3.1.2. Operand PILOTE#
By choosing FORMAT = “XMGRACE”, you have the output drivers used by xmgrace using the PILOTE keyword. This is equivalent to using xmgrace’s export functions via its « File/Print Setup… » menu.
The exact list of drivers available on your server is provided by the xmgrace « -version » option.
Possible values of PILOTE:
3.1.3. Chart layout common to XMGRACE, AGRAF, and LISS_ENVELOP#
3.1.3.1. Operands BORNE_X/BORNE_Y#
◊ BORNE_X =
Plot of the function in a given x-axis interval.
◊ BORNE_Y =
Plot of the function in a given ordinate interval.
3.1.3.2. Operands ECHELLE_X/ECHELLE_Y#
◊ ECHELLE_X =
Desired scale type for the abscissa, LINéaire or LOGarithmique.
◊ ECHELLE_Y =
Desired scale type for ordinates, LINéaire or LOGarithmique.
3.1.3.3. Operands LEGENDE_X/LEGENDE_Y#
◊ LEGENDE_X =
Legend associated with the x-axis.
◊ LEGENDE_Y =
Legend associated with the y-axis.
3.1.3.4. Operands GRILLE_X/GRILLE_Y#
◊ GRILLE_X = nx
For xmgrace, nx is the distance between two successive vertical lines in the grid.
For agraf, nx is the integer defining the frequency of drawing these lines.
◊ GRILLE_Y = ny
The same goes for the horizontal lines of the grid.
3.1.4. Layout in TABLEAU format#
See IMPR_TABLE [U4.91.03] for the description of formatting keywords (DEBUT_LIGNE, COMMENTAIRE…).
Note:
Column labels are suffixed with « _ + column number » (starting at 0) in order to avoid repetition because the column names must all be different.
3.1.5. Keywords common to all formats#
◊ TITRE
◊ SOUS_TITRE
Allows you to define the main and secondary titles of the graph or table.
If FORMAT = LISS_ENVELOP then the titles and subtitles are used to fill in the chart cartridges. The subtitle must respect the « Floor, Details » nomenclature for both boxes to be filled in correctly. If the subtitle contains more than one comma, items after the second comma will not be taken into account in the cartridge.
Note
The value of TITRE stored by some commands (example RECU_FONCTION ) in function objects is not used by IMPR_FONCTION .
3.2. Keyword COURBE#
♦ COURBE
Keyword factor allowing you to print the defined functions or to plot one or more functions in the same graph (one function per occurrence of the factor keyword).
3.2.1. Additional attributes for plotting each function by xmgrace or agraf software#
This keyword defines the line style of the curve.
For xmgrace, the correspondence is as follows:
0 line steps |
1 solid line |
2 dotted lines |
3 short dashes |
4 long dashes |
5, 6, 7, 8 alternating dashed dashes
For stap, the styles are:
0 line |
1 dotted |
2 point |
This keyword defines the type of marker or symbol for the points on the curve.
For xmgrace:
0 marker steps |
1 circle |
2 squares |
3 diamonds |
4 high triangle |
5 left triangle |
6 low triangle |
7 right triangle |
8 plus |
9 crosses |
10 stars |
For stap, the markers are:
0 circle |
1 square |
2 plus |
3 rhombus |
4 full circle |
5 full square |
6 solid diamond |
7 circle+cross |
8 diamond+cross |
|
This keyword defines the color of the curve.
For xmgrace, the colors are:
0 white |
1 black |
2 red |
3 green |
4 blue |
|
5 yellow |
6 brown |
7 gray |
7 gray |
8 purple |
9 cyan |
10 magenta |
11 orange |
12 brown |
13 indigo |
14 turquoise |
|
15 dark green |
For stap, the colors are:
0 black |
1 red |
2 dark green |
3 blue |
4 magenta |
|
5 cyan |
6 green |
7 brown |
7 brown |
8 orange |
9 mauve |
10 yellow |
11 light brown |
Legend given to the function (by default we get the name of the function).
An integer that indicates how often the marker associated with a function is printed. Every freqmarq discretization points of the function, a marker is printed (by default all the points).
3.2.2. Additional attributes for plotting by the agraf software#
This keyword allows you to sort the parameters defining the function in ascending order:
tr = “N”, no sorting,
tr = “X”, sorting the function points in ascending order of the x-axis,
tr = “Y”, sorting the function points according to the ascending order of the y-coordinates,
tr = “XY”, sorting the points of the function according to the ascending order of the x-axis and in case of equality according to the ascending order of the ordinates,
tr = “YX”, sorting the points of the function according to the ascending order of the y-coordinates and in the case of a tie according to the ascending order of the abscissa,
3.2.3. Printing or plotting a real function#
/♦ FONCTION = en
The name of the actual function to be printed or traced.
Print or plot the function according to the list of parameters given.
3.2.4. Printing or drawing a complex function#
You draw either the real part or the imaginary part. If you want to plot the real part and the imaginary part in the same graph, you have to repeat the keyword factor COURBE.
/FONCTION = fc
Name of the complex function to be printed or traced.
Print or trace part REELle or IMAGinaire.
Print or plot the function according to the list of parameters given.
No effect when printing in columns (“TABLEAU” format).
3.2.5. Printing or drawing a function defined by 2 lists of real numbers#
/♦ LIST_PARA = for
Name of the list of abscissa.
Name of the ordinate list.
Or else:
/♦ ABSCISSE = labs
Python list of abscissa.
Python list of ordinates.
3.2.6. Printing or drawing a parametric function#
/♦ FONC_X = fx
Name of the parametric function x=f (t) to be printed or plotted.
Name of the parametric function y=g (t) to be printed or plotted.
Print or plot the function according to the list of parameters given.
3.2.7. Operand UNITE#
◊ UNITE_DIGR = unit_digr if FORMAT = “AGRAF”
Allow you to choose on which logical unit the functions are printed.
If you draw a lot of curves, it is more flexible to use the repe type combined with the DEFI_FICHIER command, the files will be in the directory. /REPE_OUT.
In AGRAF format, data is written in UNITE while directives are written in UNITE_DIGR (26 by default).
The default value for unit is:
8 in TABLEAU format,
25 in AGRAF format,
29 in XMGRACE format (optional if PILOTE = “INTERACTIF /_BG”),
25 in LISS_ENVELOP format.
3.2.8. Trace of a tablecloth or a smoothed tablecloth#
/♦ NAPPE = tablecloth
Name of the raw tablecloth to be traced. The layout will be done in dashes.
Name of the smoothed tablecloth to be traced. The layout will be done in full line.
The values of the smoothed groundwater will be entered in a table under the curve. If several smoothed tablecloths are provided, the last data entered will be taken into account for the table.
3.2.9. Features that existed in IMPR_COURBE#
Formatting charts from tables is now provided by IMPR_TABLE.
Plotting a resu_gene into a shock node must be done in two steps: retrieve a function with RECU_FONCTION, keyword RESU_GENE, then print the graph with IMPR_FONCTION.