plot, vaxis=vname1,vname2,..,vnamen,
vaxis1=vname1,vname2,..,vnamen, vaxis2=vname1,vname2,..,vnamen,
vaxis3=vname1,vname2,..,vnamen, vaxis4=vname1,vname2,..,vnamen,
haxis=vname, hmin=real, hmax=real, vmin=reals, vmax=reals, bars=integer,
style=integer, colour=integer, symbol=integer, noversion=logical,
interpolate=logical, noline=logical, notitle=logical, marker_plot=logical,
range_plot=logical, table=table_name, particle=particle1,particle2,..,particlen,
multiple=logical, title=string, range=range, file=file_name_start,
ptc=logical, ptc_table=table_name, trackfile=table_name;
where the
parameters have the following meaning: - vaxis: one or several
variables from the table to be plotted against the (only) vertical
axis.
- vaxis1: one or several variables from the table to be
plotted against the vertical axis number 1 (out of 4 possible ones).
- vaxis2: one or several variables from the table to be plotted
against the vertical axis number 2 (out of 4 possible ones).
- vaxis3: one or several variables from the table to be plotted
against the vertical axis number 3 (out of 4 possible ones).
- vaxis4: one or several variables from the table to be plotted
against the vertical axis number 4 (out of 4 possible ones).
- Important: vaxis and vaxisI are exclusive in
their application!
- haxis: name of the horizontal
variable
- hmin: lower horizontal edge
- hmax: upper horizontal
edge; to be used, both hmin and hmax must be given.
- vmin:lower
edges of vertical axes, up to four numbers
- vmax:upper edges of
vertical axes, up to four numbers; both vmin and vmax must be given
for an axis to be effective.
- bars: 0 (default) or 1 - in the
latter case, all curve points coming from the table are connected with
the horizontal axis by vertical bars.
- style: 1 (default), 2, 3,
or 4: curve style, being solid, dashed, dotted, and dot-dashed; a
value of 100 makes MAD-X use these four styles in turn for successive
curves in the same plot. If style is 0 no curve is printed between
points. N.B. If symbol and style are null at the same time, style is
forced to its default value (= 1).
- colour: 1 (default), 2, 3, ,
or 5: colour, being black, red, green, blue, and magenta; a value of
100 makes MAD-X use these five colours in turn for successive curves.
- symbol: 0 (default), 1, 2, 3, 4, or 5: none, dot, "+", "*",
circle, and "x". These symbols are potted at all curve points; there
size may have to be adapted (see below).
- noversion: logical,
default=false. If set true, the information concerning the madx
version and the date are suppressed from the title. This option frees
more space for the user's title.
- interpolate: logical,
default=false. Normally the curve points from the table are connected
by straight lines; if "interpolate" is requested, then on-momentum
Twiss parameters such as beta, alfa, and dispersion are interpolated
with calls to the Twiss module inside each element, for all other
variables splines are used to smooth the curves.
- noline: logical,
default=false. If s is the horizontal variable, then the machine will
be plotted in symbolic form above the curve plot (except for tables
having been read back into MAD-X). This may result in a thick black
block if the horizontal scale is too large. "noline" allows the user
to suppress the machine plotting.
- notitle: logical, default=false. If true, suppresses the title
line, including the information on the version and date.
- marker_plot: logical, default=false. If true, plotting is done
also at the location of marker elements. This is only useful for the
plotting of non-continuous functions like the "N1" from the aperture
module. Beware that the PS file might became very large if this flag
is invoked.
- range_plot: logical, default=false. Needed to allow to specify
a plotting range also for user defined horizontal axis.
- table: name of
the table to be plotted from (default: twiss). If it is track,
the data to be plotted are taken from the tracking files generated for
each required particle as defined by the attribute
particle. The name of this file has the following format: file
name as defined by the attribute trackfile, the observation
point fixed to 1 and the particle number,
e.g. testtrack.obs0001.p0003. If the required file has not
been generated by the previous MAD-X command track, no plot is done
for that particle. The plot is obtained through the gnuplot
package. N.B. the previous track command should
contain the attribute
dump. The tracking plots appends the plots to an existing file
specified via filename appended by .ps. The user should
make sure that this file does not exist before starting a MAD-X
run!
- particle: one or several numbers associated to the
tracked particles for which the specified plot has to be displayed.
- multiple: logical, default=false. If true all the curves generated
for each tracked particle are put on one plot. Otherwise there will be
one plot for each particle.
- title: plot title string; if absent,
the last overall title is used; if no such overall title as well, the
sequence name is used.
- range: horizontal plot range given by elements.
- file_name: start of the file name for the Postscript file(s). Only
the first occurrence of such a name will be used. Default is "madx" or
"madx_track" if the table attribute is track. Depending on the
format (.ps or .eps, see below) the plots will either all be written
into one file file_name.ps, or one per plot into file_name01.eps,
file_name02.eps, etc.
- ptc: logical, default=false. If set true,
the data to be plotted are taken from the table defined by the
attribute ptc_table which is expected to be generated
previously by the ptc package. The data belong to the column
identified by one of the names set in the definition of the ptc twiss
table. Interpolation is not available and the attribute
interpolate has no effect.
- ptc_table: name of the ptc
twiss table to be plotted from (default: ptc_twiss)
- trackfile:
first part of the name of the files containing tracking data for each
particle (default: track)