1 | <head> <title>PLOT</title> <!-- Changed by: Chris ISELIN, 27-Jan-1997 |
---|
2 | --> <!-- Changed by: Hans Grote, 25-Sep-2002 --> <!-- Changed by: |
---|
3 | E. T. d'Amico, 20-Oct-2004 --> </head> |
---|
4 | |
---|
5 | <body bgcolor="#ffffff"> |
---|
6 | <center> |
---|
7 | EUROPEAN ORGANIZATION FOR NUCLEAR RESEARCH <IMG |
---|
8 | SRC="http://cern.ch/madx/icons/mx7_25.gif" align=right> <h2>PLOT</h2> </center> |
---|
9 | <p> |
---|
10 | Values contained in MAD-X tables can be plotted in the form column |
---|
11 | versus column, with up to four differently scaled vertical axes; |
---|
12 | furthermore, if the horizontal axis is the position "s" of the |
---|
13 | elements in a sequence, then the symbolic machine can be plotted above |
---|
14 | the curves as well. In certain conditions True interpolation inside |
---|
15 | the element is available (through calls to the Twiss module for each |
---|
16 | slice) . The "environment" (interpolation, line thickness, annotation |
---|
17 | size, PostScript format) can be set with the <a |
---|
18 | href="#setplot">setplot</a> command. <ul> <li><h4><a |
---|
19 | name=plot>PLOT</a></h4> <pre> plot, vaxis=vname1,vname2,..,vnamen, |
---|
20 | vaxis1=vname1,vname2,..,vnamen, vaxis2=vname1,vname2,..,vnamen, |
---|
21 | vaxis3=vname1,vname2,..,vnamen, vaxis4=vname1,vname2,..,vnamen, |
---|
22 | haxis=vname, hmin=real, hmax=real, vmin=reals, vmax=reals, bars=integer, |
---|
23 | style=integer, colour=integer, symbol=integer, noversion=logical, |
---|
24 | interpolate=logical, noline=logical, notitle=logical, marker_plot=logical, |
---|
25 | range_plot=logical, table=table_name, particle=particle1,particle2,..,particlen, |
---|
26 | multiple=logical, title=string, range=range, file=file_name_start, |
---|
27 | ptc=logical, ptc_table=table_name, trackfile=table_name; </pre> where the |
---|
28 | parameters have the following meaning: <ul> <li>vaxis: one or several |
---|
29 | variables from the table to be plotted against the (only) vertical |
---|
30 | axis. <li>vaxis1: one or several variables from the table to be |
---|
31 | plotted against the vertical axis number 1 (out of 4 possible ones). |
---|
32 | <li>vaxis2: one or several variables from the table to be plotted |
---|
33 | against the vertical axis number 2 (out of 4 possible ones). |
---|
34 | <li>vaxis3: one or several variables from the table to be plotted |
---|
35 | against the vertical axis number 3 (out of 4 possible ones). |
---|
36 | <li>vaxis4: one or several variables from the table to be plotted |
---|
37 | against the vertical axis number 4 (out of 4 possible ones). |
---|
38 | <li><font color=ff0000><i>Important: vaxis and vaxisI are exclusive in |
---|
39 | their application!</i></font> <li>haxis: name of the horizontal |
---|
40 | variable <li>hmin: lower horizontal edge <li>hmax: upper horizontal |
---|
41 | edge; to be used, both hmin and hmax must be given. <li>vmin:lower |
---|
42 | edges of vertical axes, up to four numbers <li>vmax:upper edges of |
---|
43 | vertical axes, up to four numbers; both vmin and vmax must be given |
---|
44 | for an axis to be effective. <li>bars: 0 (default) or 1 - in the |
---|
45 | latter case, all curve points coming from the table are connected with |
---|
46 | the horizontal axis by vertical bars. <li>style: 1 (default), 2, 3, |
---|
47 | or 4: curve style, being solid, dashed, dotted, and dot-dashed; a |
---|
48 | value of 100 makes MAD-X use these four styles in turn for successive |
---|
49 | curves in the same plot. If style is 0 no curve is printed between |
---|
50 | points. N.B. If symbol and style are null at the same time, style is |
---|
51 | forced to its default value (= 1). <li>colour: 1 (default), 2, 3, , |
---|
52 | or 5: colour, being black, red, green, blue, and magenta; a value of |
---|
53 | 100 makes MAD-X use these five colours in turn for successive curves. |
---|
54 | <li>symbol: 0 (default), 1, 2, 3, 4, or 5: none, dot, "+", "*", |
---|
55 | circle, and "x". These symbols are potted at all curve points; there |
---|
56 | size may have to be adapted (see below). <li>noversion: logical, |
---|
57 | default=false. If set true, the information concerning the madx |
---|
58 | version and the date are suppressed from the title. This option frees |
---|
59 | more space for the user's title. <li>interpolate: logical, |
---|
60 | default=false. Normally the curve points from the table are connected |
---|
61 | by straight lines; if "interpolate" is requested, then on-momentum |
---|
62 | Twiss parameters such as beta, alfa, and dispersion are interpolated |
---|
63 | with calls to the Twiss module inside each element, for all other |
---|
64 | variables splines are used to smooth the curves. <li>noline: logical, |
---|
65 | default=false. If s is the horizontal variable, then the machine will |
---|
66 | be plotted in symbolic form above the curve plot (except for tables |
---|
67 | having been read back into MAD-X). This may result in a thick black |
---|
68 | block if the horizontal scale is too large. "noline" allows the user |
---|
69 | to suppress the machine plotting. |
---|
70 | <li>notitle: logical, default=false. If true, suppresses the title |
---|
71 | line, including the information on the version and date. |
---|
72 | <li>marker_plot: logical, default=false. If true, plotting is done |
---|
73 | also at the location of marker elements. This is only useful for the |
---|
74 | plotting of non-continuous functions like the "N1" from the aperture |
---|
75 | module. Beware that the PS file might became very large if this flag |
---|
76 | is invoked. |
---|
77 | <li>range_plot: logical, default=false. Needed to allow to specify |
---|
78 | a plotting range also for user defined horizontal axis. |
---|
79 | <li>table: name of |
---|
80 | the table to be plotted from (default: twiss). If it is <i>track</i>, |
---|
81 | the data to be plotted are taken from the tracking files generated for |
---|
82 | each required particle as defined by the attribute |
---|
83 | <i>particle</i>. The name of this file has the following format: file |
---|
84 | name as defined by the attribute <i>trackfile</i>, the observation |
---|
85 | point fixed to 1 and the particle number, |
---|
86 | e.g. <i>testtrack.obs0001.p0003</i>. If the required file has not |
---|
87 | been generated by the previous MAD-X command track, no plot is done |
---|
88 | for that particle. The plot is obtained through the <i>gnuplot</i> |
---|
89 | package. <font color=ff0000>N.B. the previous track command should |
---|
90 | contain the attribute |
---|
91 | <i>dump</i>. The tracking plots appends the plots to an existing file |
---|
92 | specified via <i>filename</i> appended by <i>.ps</i>. The user should |
---|
93 | make sure that this file does not exist before starting a MAD-X |
---|
94 | run!</font> <li>particle: one or several numbers associated to the |
---|
95 | tracked particles for which the specified plot has to be displayed. |
---|
96 | <li>multiple: logical, default=false. If true all the curves generated |
---|
97 | for each tracked particle are put on one plot. Otherwise there will be |
---|
98 | one plot for each particle. <li>title: plot title string; if absent, |
---|
99 | the last overall title is used; if no such overall title as well, the |
---|
100 | sequence name is used. <li>range: horizontal plot <a |
---|
101 | href="../Introduction/ranges.html">range</a> given by elements. |
---|
102 | <li>file_name: start of the file name for the Postscript file(s). Only |
---|
103 | the first occurrence of such a name will be used. Default is "madx" or |
---|
104 | "madx_track" if the <i>table</i> attribute is track. Depending on the |
---|
105 | format (.ps or .eps, see below) the plots will either all be written |
---|
106 | into one file file_name.ps, or one per plot into file_name01.eps, |
---|
107 | file_name02.eps, etc. <li>ptc: logical, default=false. If set true, |
---|
108 | the data to be plotted are taken from the table defined by the |
---|
109 | attribute <i>ptc_table</i> which is expected to be generated |
---|
110 | previously by the ptc package. The data belong to the column |
---|
111 | identified by one of the names set in the definition of the ptc twiss |
---|
112 | table. Interpolation is not available and the attribute |
---|
113 | <i>interpolate</i> has no effect. <li>ptc_table: name of the ptc |
---|
114 | twiss table to be plotted from (default: ptc_twiss) <li>trackfile: |
---|
115 | first part of the name of the files containing tracking data for each |
---|
116 | particle (default: track) </ul> |
---|
117 | <p> |
---|
118 | <li><h4><a name=setplot>SETPLOT</a></h4> <pre> setplot, |
---|
119 | post=integer,font=integer, lwidth=real,xsize=real,ysize=real, |
---|
120 | ascale=real, lscale=real, sscale=real, rscale=real; </pre> where the |
---|
121 | parameters have the following meaning: <ul> <li>post: default = 1. If |
---|
122 | =1, makes one PostScript file (.ps) with all plots; if =2, makes one |
---|
123 | Encapsulated PostSscript file (.eps) per plot. <li>font: there are |
---|
124 | two defaults: 1 for screen plotting: this uses characters made from |
---|
125 | polygons; -1 for PostScript files; this is Times-Italic. There are |
---|
126 | various fonts available for positive and negative integers, best to be |
---|
127 | tried out, since they will look different on different systems |
---|
128 | anyway. GhostView will show strange vertical axis annotations, but the |
---|
129 | printed versions are normally OK. <li>lwidth: default = 1. Allows the |
---|
130 | user to set the curve line width. Depends on the system as well, so |
---|
131 | to be tried out. <li>xsize: bounding box size for PostScript, |
---|
132 | default=27 cm. <li>ysize: bounding box size for PostScript, |
---|
133 | default=19 cm. <li>ascale: annotation character height scale factor, |
---|
134 | default=1. <li>lscale: axis label character height scale factor, |
---|
135 | default=1. <li>sscale: curve symbol (see above) scale factor, |
---|
136 | default=1. <li>rscale: axis text character height scale factor, |
---|
137 | default=1. </ul> |
---|
138 | <p> |
---|
139 | <li><h4><a name=resplot>RESPLOT</a></h4> <pre> resplot; </pre> resets |
---|
140 | all defaults for the setplot command. </ul> |
---|
141 | |
---|
142 | <address> |
---|
143 | <a href="http://www.cern.ch/Hans.Grote/hansg_sign.html">hansg</a>, |
---|
144 | June 17, 2002, rdemaria <a |
---|
145 | href="http://cern.ch/rdemaria">rdemaria</a></a>, September 2007. |
---|
146 | </address> |
---|
147 | |
---|
148 | </body> |
---|