| 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> |
|---|
![(please configure the [header_logo] section in trac.ini)](/PSPA/chrome/site/pspa.gif)
