=================================================================== RCS file: /home/cvs/OpenXM_contrib/gnuplot/docs/Attic/gnuplot.doc,v retrieving revision 1.1.1.2 retrieving revision 1.1.1.3 diff -u -p -r1.1.1.2 -r1.1.1.3 --- OpenXM_contrib/gnuplot/docs/Attic/gnuplot.doc 2000/01/22 14:16:13 1.1.1.2 +++ OpenXM_contrib/gnuplot/docs/Attic/gnuplot.doc 2003/09/15 07:09:33 1.1.1.3 @@ -1,4 +1,4 @@ -C RCS $Id: gnuplot.doc,v 1.1.1.2 2000/01/22 14:16:13 maekawa Exp $ +C RCS $Id: gnuplot.doc,v 1.1.1.3 2003/09/15 07:09:33 ohara Exp $ C 3 December 1998 C Copyright (C) 1986 - 1993, 1998 Thomas Williams, Colin Kelley C @@ -215,7 +215,8 @@ C 14. The `call` command: `load` with arguments. - 15. More flexible `range` commands with `reverse` and `writeback` keywords. + 15. More flexible `range` commands with `reverse`, `writeback` and 'restore' + keywords. 16. `set encoding` for multi-lingual encoding. @@ -302,7 +303,7 @@ C ^K deletes from current position to the end of line. ^L,^R redraws line in case it gets trashed. ^U deletes the entire line. - ^W deletes the last word. + ^W deletes from the current word to the end of line. `History`: @@ -389,7 +390,7 @@ C Help - `help` plus return. Ctrl Help - `help `. #\begin{tabular}{|cl|} \hline -#Arrow key & Function \\ \hline +#Key & Function \\ \hline #Undo & same as \verb~^L~. \\ #Home & same as \verb~^A~. \\ #Ctrl Home & same as \verb~^E~. \\ @@ -397,7 +398,7 @@ C #Help & `{\bf help}' plus return. \\ #Ctrl Help & `{\bf help }'. \\ %c l . -%Arrow key@Function +%Key@Function %_ %Undo@same as ^L. %Home@same as ^A. @@ -625,7 +626,7 @@ C ?besy0 #besy0(x) & int or real & $y_{0}$ Bessel function of $x$, in radians \\ %besy0(x)@int or real@$y sub 0$ Bessel function of $x$, in radians - The `besy0` function returns the y0th Bessel function of its argument. + The `besy0(x)` function returns the y0th Bessel function of its argument. `besy0` expects its argument to be in radians. 4 besy1 ?expressions functions besy1 @@ -828,8 +829,8 @@ C ?expressions functions sinh ?functions sinh ?sinh -#sinh(x) & any & $\sinh x$, hyperbolic sine $x$ in radians \\ -%sinh(x)@any@$sinh~x$, hyperbolic sine $x$ in radians +#sinh(x) & any & $\sinh x$, hyperbolic sine of $x$ in radians \\ +%sinh(x)@any@$sinh~x$, hyperbolic sine of $x$ in radians The `sinh(x)` function returns the hyperbolic sine of its argument. `sinh` expects its argument to be in radians. 4 sqrt @@ -1257,7 +1258,7 @@ C ... and restart the table: blanks. Command-line substitution can be used anywhere on the `gnuplot` command - line. + line, except inside strings delimited by single quotes. Example: @@ -1267,6 +1268,11 @@ C ... and restart the table: or, in VMS f(x) = `run leastsq` + + These will generate labels with the current time and userid: + set label "generated on `date +%Y-%m-%d`by `whoami`" at 1,1 + set timestamp "generated on %Y-%m-%d by `whoami`" + 2 Syntax ?syntax ?specify @@ -1579,7 +1585,7 @@ C ... and restart the table: parameter file. The two use different means to set initial values. Adjustable parameters can be specified by a comma-separated list of variable - names after the `via` keyword. Any variable that is not already defined is + names after the `via` keyword. Any variable that is not already defined is created with an initial value of 1.0. However, the fit is more likely to converge rapidly if the variables have been previously declared with more appropriate starting values. @@ -1830,7 +1836,7 @@ C ... and restart the table: Setting FIT_LAMBDA_FACTOR to zero re-enables the default factor of 10.0. - Oher variables with the FIT_ prefix may be added to `fit`, so it is safer + Other variables with the FIT_ prefix may be added to `fit`, so it is safer not to use that prefix for user-defined variables. The variables FIT_SKIP and FIT_INDEX were used by earlier releases of @@ -2823,7 +2829,7 @@ C ... and restart the table: plot sin(x) with impulses This plots x with points, x**2 with the default: - plot x*y w points, x**2 + y**2 + plot x w points, x**2 This plots tan(x) with the default function style, file "data.1" with lines: plot [ ] [-2:5] tan(x), 'data.1' with l @@ -3851,7 +3857,7 @@ C ... and restart the table: %M minute, 0--60 %p "am" or "pm" %r shorthand for "%I:%M:%S %p" - %R shorthand for %H:%M" + %R shorthand for "%H:%M" %S second, 0--60 %T shorthand for "%H:%M:%S" %U week of the year (week starts on Sunday) @@ -4465,7 +4471,7 @@ C ... and restart the table: A cartesian coordinate system is used by default. For a spherical coordinate system, the data occupy two or three columns (or - `using` entries). The first two are interpreted as the polar and azimuthal + `using` entries). The first two are interpreted as the azimuthal and polar angles theta and phi (in the units specified by `set angles`). The radius r is taken from the third column if there is one, or is set to unity if there is no third column. The mapping is: @@ -5214,8 +5220,8 @@ C ... and restart the table: it requires four columns of data. It also draws a small arrowhead at the end of the vector. - The `vector` style is still experimental: it doesn't get clipped properly - and other things may also be wrong with it. Use it at your own risk. + `set clip one` and `set clip two` affect drawing vectors. + Please see `set clip`. 4 xerrorbars ?commands set style xerrorbars ?set style xerrorbars @@ -5244,7 +5250,7 @@ C ... and restart the table: `plot` command should be used to set up the appropriate form. For example, if the data are of the form (x,y,xdelta,ylow,yhigh), then you can use - plot 'data' using 1:2:($1-$3),($1+$3),4,5 with xyerrorbars + plot 'data' using 1:2:($1-$3):($1+$3):4:5 with xyerrorbars 4 yerrorbars ?commands set style yerrorbars ?commands set style errorbars @@ -5281,7 +5287,7 @@ C ... and restart the table: appropriate style, data or function. Whenever `set nosurface` is issued, `splot` will not draw points or lines - corresponding to the function or data file points. Contours may be still be + corresponding to the function or data file points. Contours may still be drawn on the surface, depending on the `set contour` option. `set nosurface; set contour base` is useful for displaying contours on the grid base. See also `set contour`. @@ -5393,7 +5399,7 @@ C ... and restart the table: year). With `top` or `bottom` you can place the timestamp at the top or bottom of the left margin (default: bottom). `rotate` lets you write the timestamp vertically, if your terminal supports vertical text. The constants - and are offsets from the default position given in character + and are offsets from the default position given in character screen coordinates. is used to specify the font with which the time is to be written. @@ -5428,6 +5434,7 @@ C ... and restart the table: %j day of the year, 1--365 %H hour, 0--24 %M minute, 0--60 + %s seconds since the Unix epoch (1970-01-01, 00:00 UTC) %S second, 0--60 %b three-character abbreviation of the name of the month %B name of the month @@ -5442,6 +5449,7 @@ C ... and restart the table: #\verb@%j@ & day of the year, 1--365 \\ #\verb@%H@ & hour, 0--24 \\ #\verb@%M@ & minute, 0--60 \\ +#\verb@%s@ & seconds since the Unix epoch (1970-01-01 00:00 UTC) \\ #\verb@%S@ & second, 0--60 \\ #\verb@%b@ & three-character abbreviation of the name of the month \\ #\verb@%B@ & name of the month \\ @@ -5455,6 +5463,7 @@ C ... and restart the table: %%j@day of the year, 1--365 %%H@hour, 0--24 %%M@minute, 0--60 +%%s@seconds since the Unix epoch (1970-01-01 00:00 UTC) %%S@second, 0--60 %%b@three-character abbreviation of the name of the month %%B@name of the month @@ -5694,7 +5703,7 @@ C ... and restart the table: See `set timefmt` to tell `gnuplot` how to read date or time data. The time/date is converted to seconds from start of the century. There is currently only one timefmt, which implies that all the time/date columns must - confirm to this format. Specification of ranges should be supplied as quoted + conform to this format. Specification of ranges should be supplied as quoted strings according to this format to avoid interpretation of the time/date as an expression. @@ -5792,7 +5801,7 @@ C ... and restart the table: label` instead--that command gives you much more control over where text is placed. - Please see `set syntax` for further information about backslash processing + Please see `syntax` for further information about backslash processing and the difference between single- and double-quoted strings. 3 xmtics ?commands set xmtics @@ -5803,7 +5812,7 @@ C ... and restart the table: ?show xmtics ?xmtics ?noxmtics - The `set xmtics` commands converts the x-axis tic marks to months of the + The `set xmtics` command converts the x-axis tic marks to months of the year where 1=Jan and 12=Dec. Overflows are converted modulo 12 to months. The tics are returned to their default labels by `set noxmtics`. Similar commands perform the same duties for the other axes. @@ -5821,13 +5830,16 @@ C ... and restart the table: ?commands show xrange ?set xrange ?show xrange +?writeback +?restore ?xrange The `set xrange` command sets the horizontal range that will be displayed. A similar command exists for each of the other axes, as well as for the polar radius r and the parametric variables t, u, and v. Syntax: - set xrange [{{}:{}}] {{no}reverse} {{no}writeback} + set xrange { [{{}:{}}] {{no}reverse} {{no}writeback} } + | restore show xrange where and terms are constants, expressions or an asterisk to set @@ -5847,12 +5859,13 @@ C ... and restart the table: the buffers that would be filled by `set xrange`. This is useful if you wish to plot several functions together but have the range determined by only some of them. The `writeback` operation is performed during the `plot` - execution, so it must be specified before that command. For example, + execution, so it must be specified before that command. To restore + the last saved horizontal range use `set xrange restore`. For example, set xrange [-10:10] set yrange [] writeback plot sin(x) - set noautoscale y + set yrange restore replot x/2 results in a yrange of [-1:1] as found only from the range of sin(x); the @@ -5931,7 +5944,7 @@ C ... and restart the table: The defaults are `border mirror norotate` for tics on the x and y axes, and `border nomirror norotate` for tics on the x2 and y2 axes. For the z axis, - the the `{axis | border}` option is not available and the default is + the `{axis | border}` option is not available and the default is `nomirror`. If you do want to mirror the z-axis tics, you might want to create a bit more room for them with `set border`. @@ -5948,7 +5961,7 @@ C ... and restart the table: of . If is not given, it is assumed to be infinity. The increment may be negative. If neither nor is given, is assumed to be negative infinity, is assumed to be positive infinity, - and the tics will be drawn at integral multiples of . If the axis is + and the tics will be drawn at integral multiples of . If the axis is logarithmic, the increment will be used as a multiplicative factor. Examples: @@ -5960,7 +5973,7 @@ C ... and restart the table: set xtics 5 Make tics at 1, 100, 1e4, 1e6, 1e8. - set logscale x; set xtics 1,100,10e8 + set logscale x; set xtics 1,100,1e8 The explicit ("