home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume11 / gnuplot2 / part03 < prev    next >
Encoding:
Text File  |  1990-03-25  |  51.4 KB  |  1,469 lines

  1. Newsgroups: comp.sources.misc
  2. organization: Pixar -- Marin County, California
  3. subject: v11i068: Gnuplot 2.0 - 3 of 14
  4. From: thaw@ucbvax.Berkeley.EDU@pixar.UUCP (Tom Williams)
  5. Sender: allbery@uunet.UU.NET (Brandon S. Allbery - comp.sources.misc)
  6.  
  7. Posting-number: Volume 11, Issue 68
  8. Submitted-by: thaw@ucbvax.Berkeley.EDU@pixar.UUCP (Tom Williams)
  9. Archive-name: gnuplot2/part03
  10.  
  11. This is gnuplot.sh03
  12.  
  13. --- CUT HERE ---
  14. #! /bin/sh
  15. echo x - docs/gnuplot.doc
  16. sed 's/^X//' >docs/gnuplot.doc <<'*-*-END-of-docs/gnuplot.doc-*-*'
  17. X1 gnuplot
  18. X?
  19. X GNUPLOT is a command-driven interactive function plotting program.  It
  20. X is case sensitive (commands and function names written in lowercase
  21. X are not the same as those written in CAPS).  All command names may be
  22. X abbreviated, as long as the abbreviation is not ambiguous.  Any number
  23. X of commands may appear on a line, separated by semicolons (;). 
  24. X
  25. X Any command-line arguments are assumed to be names of files containing 
  26. X gnuplot commands. Each file is loaded with the `load` command, in the
  27. X order specified. Gnuplot exits after the last file is processed.
  28. X
  29. X Commands may extend over several input lines, by ending each line but
  30. X the last with a backslash (\). The backslash must be the LAST
  31. X character on each line. The effect is as if the backslash and newline
  32. X were not there. That is, no white space is implied, nor is a comment
  33. X terminated. Therefore, commenting out a continued line comments out
  34. X the entire command (see `comment`).
  35. X
  36. X In this documentation, curly braces ({}) denote optional arguments to
  37. X many commands.
  38. X
  39. X For help on any topic, type 'help' followed by the name of the topic.
  40. X2 clear
  41. X?clear
  42. X The `clear` command erases the current screen or output device as
  43. X specified by `set output`.  This usually generates a formfeed on
  44. X hardcopy devices.  Use `set terminal` to set the device type. 
  45. X2 comment
  46. X?comments
  47. X Comments are supported as follows: a # may appear in most places in a line
  48. X and GNUPLOT will ignore the rest of the line. It will not have this
  49. X affect inside quotes, inside numbers (including complex numbers), inside
  50. X command substitutions, etc. In short, it works anywhere it makes sense
  51. X to work.
  52. X2 environment
  53. X?environment
  54. X A number of shell environment variables are understood by GNUPLOT.
  55. X None of these are required, but may be useful.
  56. X If GNUTERM is defined, it is used as the name of the terminal type to
  57. X be used. This overrides any terminal type sensed by GNUPLOT on start
  58. X up, but is itself overridden by the .gnuplot (or equivalent) start-up
  59. X file (see help start-up), and of course by later explicit changes.
  60. X On Unix and MS-DOS, GNUHELP may be defined to be the pathname of the 
  61. X HELP file (gnuplot.gih).
  62. X
  63. X On VMS, the symbol GNUPLOT$HELP should be defined as the name of 
  64. X the help library for gnuplot.
  65. X On Unix, HOME is used as the name of a directory to search for a 
  66. X .gnuplot file if none is found in the current directory. 
  67. X On MS-DOS, GNUPLOT is used.  On VMS, SYS$LOGIN: is used.  
  68. X See help start-up.  
  69. X On Unix, PAGER is used as an output filter for help messages. SHELL
  70. X is used for the `shell` command.
  71. X On MS-DOS, COMSPEC is used for the `shell` command. 
  72. X2 exit
  73. X?exit
  74. X?quit
  75. X The commands `exit` and `quit` and your computer's END-OF-FILE character
  76. X will exit GNUPLOT.  All these commands will clear the output device
  77. X (as the `clear` command does) before exiting. 
  78. X2 expressions
  79. X?expressions
  80. X In general, any mathematical expression accepted by C, FORTRAN,
  81. X Pascal, or BASIC is valid.  The precedence of these operators is
  82. X determined by the specifications of the C programming language.
  83. X White space (spaces and tabs) is ignored inside expressions. 
  84. X Complex constants may be expressed as the {<real>,<imag>}, where <real>
  85. X and <imag> must be numerical constants.  For example {3,2}
  86. X represents 3 + 2i; {0,1} represents `i` itself. The curly braces 
  87. X are explicitly required here. 
  88. X3 functions
  89. X?expressions functions
  90. X?functions
  91. X The functions in GNUPLOT are the same as the corresponding functions
  92. X in the UNIX math library, except that all functions accept integer,
  93. X real, and complex arguments, unless otherwise noted.  The `sgn`
  94. X function is also supported, as in BASIC. 
  95. X@start table
  96. X#Function & Arguments & Returns \\ \hline
  97. X%Function@Arguments@Returns
  98. X%_
  99. X4 abs
  100. X?expressions functions abs
  101. X?functions abs
  102. X?abs
  103. X#abs(x) & any  &  absolute value of {\tt x}, $|x|$; same type \\
  104. X#abs(x) & complex &  length of {\tt x}, $\sqrt{{\mbox{real}(x)^{2} +
  105. X#\mbox{imag}(x)^{2}}}$ \\
  106. X%abs(x)@any@absolute value of x, $|x|$; same type 
  107. X%abs(x)@complex@length of x, $sqrt{real (x) sup 2 + imag (x) sup 2}$ 
  108. X The `abs` function returns the absolute value of its argument.  The
  109. X returned value is of the same type as the argument. 
  110. X For complex arguments, abs(x) is defined as the length of x in the
  111. X complex plane [i.e.,  sqrt(real(x)**2 + imag(x)**2) ].
  112. X4 acos
  113. X?expressions functions acos
  114. X?functions acos
  115. X?acos
  116. X#acos(x) & any  & $\cos^{-1} x$ (inverse cosine) in radians \\
  117. X%acos(x)@any@$cos sup -1 x$ (inverse cosine) in radians 
  118. X The `acos` function returns the arc cosine (inverse cosine) of its
  119. X argument.  `acos` returns its argument in radians. 
  120. X4 arg
  121. X?expressions functions arg
  122. X?functions arg
  123. X?arg
  124. X#arg(x) & complex & the phase of $x$ in radians\\
  125. X%arg(x)@complex@the phase of $x$ in radians
  126. X The `arg` function returns the phase of a complex number, in radians.  
  127. X4 asin
  128. X?expressions functions asin
  129. X?functions asin
  130. X?asin
  131. X#asin(x) & any  & $\sin^{-1} x$ (inverse sin) in radians \\
  132. X%asin(x)@any@$sin sup -1 x$ (inverse sin) in radians 
  133. X The `asin` function returns the arc sin (inverse sin) of its argument.
  134. X `asin` returns its argument in radians. 
  135. X4 atan
  136. X?expressions functions atan
  137. X?functions atan
  138. X?atan
  139. X#atan(x) & any  & $\tan^{-1} x$ (inverse tangent) in radians \\
  140. X%atan(x)@any@$tan sup -1 x$ (inverse tangent) in radians 
  141. X The `atan` function returns the arc tangent (inverse tangent) of its
  142. X argument.  `atan` returns its argument in radians. 
  143. X4 besj0
  144. X?expressions functions besj0
  145. X?functions besj0
  146. X?besj0
  147. X#besj0(x) & radians &  $j_{0}$ Bessel function of $x$ \\
  148. X%besj0(x)@radians@$j sub 0$ Bessel function of $x$ 
  149. X The `besj0` function returns the j0th Bessel function of its argument.
  150. X `besj0` expects its argument to be in radians.
  151. X4 besj1
  152. X?expressions functions besj1
  153. X?functions besj1
  154. X?besj1
  155. X#besj1(x) & radians & $j_{1}$ Bessel function of $x$ \\
  156. X%besj1(x)@radians@$j sub 1$ Bessel function of $x$ 
  157. X The `besj1` function returns the j1st Bessel function of its argument.
  158. X `besj1` expects its argument to be in radians.
  159. X4 besy0
  160. X?expressions functions besy0
  161. X?functions besy0
  162. X?besy0
  163. X#besy0(x) & radians & $y_{0}$ Bessel function of $x$ \\
  164. X%besy0(x)@radians@$y sub 0$ Bessel function of $x$ 
  165. X The `besy0` function returns the y0th Bessel function of its argument.
  166. X `besy0` expects its argument to be in radians.
  167. X4 besy1
  168. X?expressions functions besy1
  169. X?functions besy1
  170. X?besy1
  171. X#besy1(x) & radians & $y_{1}$ Bessel function of $x$ \\
  172. X%besy1(x)@radians@$y sub 1$ Bessel function of $x$ 
  173. X The `besy1` function returns the y1st Bessel function of its argument.
  174. X `besy1` expects its argument to be in radians.
  175. X4 ceil
  176. X?expressions functions ceil
  177. X?functions ceil
  178. X?ceil
  179. X#ceil(x) & any & $\lceil x \rceil$, smallest integer not less than $x$
  180. X#(real part) \\
  181. X%ceil(x)@any@$left ceiling x right ceiling$, smallest integer not less than $x$ (real part) 
  182. X The `ceil` function returns the smallest integer that is not less than its
  183. X argument.  For complex numbers, `ceil` returns the smallest integer
  184. X not less than the real part of its argument. 
  185. X4 cos
  186. X?expressions functions cos
  187. X?functions cos
  188. X?cos
  189. X#cos(x) & radians & $\cos x$, cosine of $x$ \\
  190. X%cos(x)@radians@$cos~x,$ cosine of $x$ 
  191. X The `cos` function returns the cosine of its argument.  `cos` expects its
  192. X argument to be in radians. 
  193. X4 cosh
  194. X?expressions functions cosh
  195. X?functions cosh
  196. X?cosh
  197. X#cosh(x) & radians & $\cosh x$, hyperbolic cosine of $x$ \\
  198. X%cosh(x)@radians@$cosh~x,$ hyperbolic cosine of $x$ 
  199. X The `cosh` function returns the hyperbolic cosine of its argument.
  200. X `cosh` expects its argument to be in radians. 
  201. X4 exp
  202. X?expressions functions exp
  203. X?functions exp
  204. X?exp
  205. X#exp(x) & any & $e^{x}$,  exponential function of $x$ \\
  206. X%exp(x)@any@$e sup x$, exponential function of $x$ 
  207. X The `exp` function returns the exponential function of its argument
  208. X (`e` raised to the power of its argument). 
  209. X4 floor
  210. X?expressions functions floor
  211. X?functions floor
  212. X?floor
  213. X#floor(x) & any & $\lfloor x \rfloor$,  largest integer not greater
  214. X#than $x$ (real part) \\
  215. X%floor(x)@any@$left floor x right floor$, largest integer not greater than $x$ (real part) 
  216. X The `floor` function returns the largest integer not greater than its
  217. X argument.  For complex numbers, `floor` returns the largest
  218. X integer not greater than the real part of its argument. 
  219. X4 imag
  220. X?expressions functions imag
  221. X?functions imag
  222. X?imag
  223. X#imag(x) & complex &  imaginary part of $x$ as a real number \\
  224. X%imag(x)@complex@imaginary part of $x$ as a real number 
  225. X The `imag` function returns the imaginary part of its argument as a
  226. X real number. 
  227. X4 int
  228. X?expressions functions int
  229. X?functions int
  230. X?int
  231. X#int(x) & real &  integer part of $x$, truncated toward zero \\
  232. X%int(x)@real@integer part of $x,$ truncated toward zero 
  233. X The `int` function returns the integer part of its argument, truncated
  234. X toward zero. 
  235. X4 log
  236. X?expressions functions log
  237. X?functions log
  238. X?log
  239. X#log(x) & any & $\log_{e} x$,  natural logarithm (base $e$) of $x$ \\
  240. X%log(x)@any@$ln~x,$ natural logarithm (base $e$) of $x$ 
  241. X The `log` function returns the natural logarithm (base `e`) of its
  242. X argument. 
  243. X4 log10
  244. X?expressions functions log10
  245. X?functions log10
  246. X?log10
  247. X#log10(x) & any & $\log_{10} x$,  logarithm (base $10$) of $x$ \\
  248. X%log10(x)@any@${log sub 10}~x,$ logarithm (base $10$) of $x$ 
  249. X The `log10` function returns the logarithm (base 10) of its argument.
  250. X4 real
  251. X?expressions functions real
  252. X?functions real
  253. X?real
  254. X#real(x) & any &  real part of $x$ \\
  255. X%real(x)@any@real part of $x$ 
  256. X The `real` function returns the real part of its argument.
  257. X4 sgn
  258. X?expressions functions sgn
  259. X?functions sgn
  260. X?sgn
  261. X#sgn(x) & any & 1 if $x>0$, -1 if $x<0$, 0 if $x=0$. imag($x$) ignored \\
  262. X%sgn(x)@any@1 if $x > 0$, -1 if $x < 0$, 0 if $x = 0$. $imag (x)$ ignored 
  263. X The `sgn` function returns 1 if its argument is positive, -1 if its
  264. X argument is negative, and 0 if its argument is 0.  If the argument
  265. X is a complex value, the imaginary component is ignored. 
  266. X4 sin
  267. X?expressions functions sin
  268. X?functions sin
  269. X?sin
  270. X#sin(x) & radians & $\sin x$, sine of $x$ \\
  271. X%sin(x)@radians@$sin~x,$ sine of $x$ 
  272. X The `sin` function returns the sine of its argument.  `sin` expects its
  273. X argument to be in radians. 
  274. X4 sinh
  275. X?expressions functions sinh
  276. X?functions sinh
  277. X?sinh
  278. X#sinh(x) & radians & $\sinh x$, hyperbolic sine $x$ \\
  279. X%sinh(x)@radians@$sinh~x,$ hyperbolic sine $x$ 
  280. X The `sinh` function returns the hyperbolic sine of its argument.  `sinh`
  281. X expects its argument to be in radians. 
  282. X4 sqrt
  283. X?expressions functions sqrt
  284. X?functions sqrt
  285. X?sqrt
  286. X#sqrt(x) & any & $\sqrt{x}$,  square root of $x$ \\
  287. X%sqrt(x)@any@$sqrt x $, square root of $x$ 
  288. X The `sqrt` function returns the square root of its argument.
  289. X4 tan
  290. X?expressions functions tan
  291. X?functions tan
  292. X?tan
  293. X#tan(x) & radians & $\tan x$,  tangent of $x$ \\
  294. X%tan(x)@radians@$tan~x,$ tangent of $x$ 
  295. X The `tan` function returns the tangent of its argument.  `tan` expects
  296. X its argument to be in radians. 
  297. X4 tanh
  298. X?expressions functions tanh
  299. X?functions tanh
  300. X?tanh
  301. X#tanh(x) & radians & $\tanh x$, hyperbolic tangent of $x$\\
  302. X%tanh(x)@radians@$tanh~x,$ hyperbolic tangent of $x$
  303. X The `tanh` function returns the hyperbolic tangent of its argument.
  304. X `tanh` expects its argument to be in radians. 
  305. X@end table
  306. X3 operators
  307. X?expressions operators
  308. X?operators
  309. X The operators in GNUPLOT are the same as the corresponding operators
  310. X in the C programming language, except that all operators accept
  311. X integer, real, and complex arguments, unless otherwise noted.
  312. X The ** operator (exponentiation) is supported, as in FORTRAN.
  313. X Parentheses may be used to change order of evaluation.
  314. X4 binary
  315. X?expressions operators binary
  316. X?operators binary
  317. X?binary
  318. X The following is a list of all the binary operators and their
  319. X usages:
  320. X@start table - first is interactive cleartext form
  321. X  Symbol      Example      Explanation
  322. X   **          a**b          exponentiation
  323. X   *           a*b           multiplication
  324. X   /           a/b           division
  325. X   %           a%b         * modulo
  326. X   +           a+b           addition
  327. X   -           a-b           subtraction
  328. X   ==          a==b          equality
  329. X   !=          a!=b          inequality
  330. X   &           a&b         * bitwise AND
  331. X   ^           a^b         * bitwise exclusive OR
  332. X   |           a|b         * bitwise inclusive OR
  333. X   &&          a&&b        * logical AND
  334. X   ||          a||b        * logical OR
  335. X   ?:          a?b:c       * ternary operation
  336. X#\multicolumn{3}{|c|}{Binary Operators} \\
  337. X#Symbol & Example & Explanation \\ \hline
  338. X#\verb~**~ & \verb~a**b~ & exponentiation\\
  339. X#\verb~*~ & \verb~a*b~ & multiplication\\
  340. X#\verb~/~ & \verb~a/b~ & division\\
  341. X#\verb~%~ & \verb~a%b~ & * modulo\\
  342. X#\verb~+~ & \verb~a+b~ & addition\\
  343. X#\verb~-~ & \verb~a-b~ & subtraction\\
  344. X#\verb~==~ & \verb~a==b~ & equality\\
  345. X#\verb~!=~ & \verb~a!=b~ & inequality\\
  346. X#\verb~&~ & \verb~a&b~ & * bitwise AND\\
  347. X#\verb~^~ & \verb~a^b~ & * bitwise exclusive OR\\
  348. X#\verb~|~ & \verb~a|b~ & * bitwise inclusive OR\\
  349. X#\verb~&&~ & \verb~a&&b~ & * logical AND\\
  350. X#\verb~||~ & \verb~a||b~ & * logical OR\\
  351. X#\verb~?:~ & \verb~a?b:c~ & * ternary operation\\
  352. X%Symbol@Example@Explanation
  353. X%_
  354. X%**@a**b@exponentiation
  355. X%*@a*b@multiplication
  356. X%/@a/b@division
  357. X%%@a%b@* modulo
  358. X%+@a+b@addition
  359. X%-@a-b@subtraction
  360. X%==@a==b@equality
  361. X%!=@a!=b@inequality
  362. X%&@a&b@* bitwise AND
  363. X%^@a^b@* bitwise exclusive OR
  364. X%|@a|b@* bitwise inclusive OR
  365. X%&&@a&&b@* logical AND
  366. X%||@a||b@* logical OR
  367. X%?:@a?b:c@* ternary operation
  368. X
  369. X@end table 
  370. X (*) Starred explanations indicate that the operator requires
  371. X integer arguments.
  372. X Logical AND (&&) and OR (||) short-circuit the way they do in C.
  373. X That is, the second && operand is not evaluated if the first is
  374. X false; the second || operand is not evaluated if the first is true.
  375. X The ternary operator evaluates its first argument (a).  If it is
  376. X true (non-zero) the second argument (b) is evaluated and returned,
  377. X otherwise the third argument (c) is evaluated and returned. 
  378. X4 unary
  379. X?expressions operators unary
  380. X?operators unary
  381. X?unary
  382. X The following is a list of all the unary operators and their
  383. X usages:
  384. X@start table - first is interactive cleartext form
  385. X  Symbol     Example      Explanation
  386. X   -           -a          unary minus
  387. X   ~           ~a        * one's complement
  388. X   !           !a        * logical negation
  389. X   !           a!        * factorial
  390. X#\multicolumn{3}{|c|}{Unary Operators}\\
  391. X#Symbol & Example & Explanation \\ \hline
  392. X#\verb@-@ & \verb@-a@ & unary minus \\
  393. X#\verb@~@ & \verb@~a@ & * one's complement \\
  394. X#\verb@!@ & \verb@!a@ & * logical negation \\
  395. X#\verb@!@ & \verb@a!@ & * factorial \\
  396. X%-@-a@unary minus
  397. X%~@~a@* one's complement
  398. X%!@!a@* logical negation
  399. X%!@a!@*factorial
  400. X
  401. X@end table 
  402. X (*) Starred explanations indicate that the operator requires an
  403. X integer argument.
  404. X The factorial operator returns a real number to allow a greater range.
  405. X2 help
  406. X?help
  407. X The `help` command displays on-line help.  To specify information on a
  408. X particular topic use the syntax:
  409. X     help <topic> 
  410. X If <topic> is not specified, a short message is printed about
  411. X GNUPLOT. After help for the requested topic is given, help for
  412. X a subtopic may be requested by typing its name, extending the help
  413. X request. After that subtopic has been printed, you may extend the
  414. X request again, as before, or go back one level to the previous topic,
  415. X by simply pressing return without typing anything. Eventually, you
  416. X will return to the GNUPLOT command line.
  417. X2 load
  418. X?load
  419. X The `load` command executes each line of the specified input file as
  420. X if it had been typed in interactively.  Files created by the `save`
  421. X command can later be `load`ed.  Any text file containing valid
  422. X commands can be created and then executed by the `load` command.
  423. X Files being `load`ed may themselves contain `load` commands. See
  424. X `comment` for information about comments in commands. 
  425. X The `load` command must be the last command on the line. 
  426. X Syntax:
  427. X         load <input-file>
  428. X The name of the input file must be enclosed in quotes.
  429. X Examples:
  430. X         load 'work.gnu'
  431. X         load "func.dat"
  432. X
  433. X The `load` command is performed implicitly on any file names given as
  434. X arguments to gnuplot. These are loaded in the order specified, and
  435. X then gnuplot exits. 
  436. X2 pause
  437. X?pause
  438. X Pause is useful in conjunction with `load` files.  The command `pause`
  439. X displays any text associated with the command and then waits the
  440. X specified amount of time.  This allows one to build a `load` file
  441. X and control the amount of time a finished graph is displayed.  The
  442. X first argument is an expression that can be -1, 0, or a positive
  443. X integer. Choosing -1 will wait until a carriage return is hit. Zero (0)
  444. X won't pause at all, and a positive integer (such as 1 or 15) will
  445. X wait the specified number of seconds. 
  446. X Note: Since pause is not part of the plot it may interact with
  447. X different device drivers differently (depending upon how text and
  448. X graphics are mixed).
  449. X Examples:
  450. X         pause -1    ! Wait until a carriage return is hit
  451. X         pause 3     ! Wait three seconds
  452. X         pause -1  "Hit return to continue"
  453. X         pause 10  "Isn't this pretty?  It's a cubic-spline."
  454. X Syntax:
  455. X         pause <expression> {"string"}
  456. X Note the string is optional, and if present must be enclosed in quotes.
  457. X2 plot
  458. X?plot
  459. X `plot` is the primary command of the program.  It plots functions and
  460. X data in many, many ways.  The full syntax of this command is:
  461. X   plot {ranges}  <function> {title} {style} {, <function> {title} {style}...}
  462. X Where <function> is either a mathematical expression or the name of a
  463. X data file enclosed in quotes.  User-defined functions and variables
  464. X may also be defined here. 
  465. X Curly braces {,} denote optional items.
  466. X A `plot` command can be as simple as
  467. X  plot sin(x)
  468. X or as complex as (!)
  469. X  plot [t=1:10] [-pi:pi*2] tan(t),"data.1" with lines,t**2 with points
  470. X3 data-file
  471. X?plot datafile
  472. X?plot data-file
  473. X?datafile
  474. X?data-file
  475. X?data
  476. X Discrete data contained in a file can displayed by specifying the
  477. X name of the data file (enclosed in quotes) on the `plot` command
  478. X line. 
  479. X Data files should contain one data point per line.  A data point may
  480. X be specified either as an X and Y value separated by blank space, or
  481. X as just the Y value, in which case the program will use the number
  482. X of the coordinate as the X value.  Coordinate numbers start at 0
  483. X and are incremented for each data point read.  Lines beginning with #
  484. X (or ! on VMS) will be treated as comments and ignored. 
  485. X
  486. X NOTE that blank lines cause a break in the input, and if the plot
  487. X style is `lines` or `linespoints` (see `plot style`) there will be no
  488. X line drawn between the preceding and following points. This does not
  489. X change the plot style, as would plotting the data as separate curves.
  490. X This example compares the data in the file population.dat to a
  491. X theoretical curve:
  492. X         pop(x) = 103*exp((1965-x)/10)
  493. X         plot [1960:1990] 'population.dat', pop(x)
  494. X The file population.dat might contain:
  495. X  # Gnu population in Antarctica since 1965
  496. X  1965   103
  497. X  1970   55
  498. X  1975   34
  499. X  1980   24
  500. X  1985   10
  501. X3 ranges
  502. X?plot ranges
  503. X?ranges
  504. X The optional range specifies the region of the plot which will be displayed. 
  505. X Ranges may be provided on the `plot` command line and affect only
  506. X that plot, or in the `set xrange` and `set yrange` commands, to
  507. X change the default ranges for future plots.
  508. X Syntax:
  509. X         [{dummy-var =} {xmin : xmax}] { [{ymin : ymax}] }
  510. X Where dummy-var is the independent variable (the default is `x`,
  511. X but this may be changed with the `set dummy` command) and the min
  512. X and max terms can be expressions or constants. 
  513. X Both the min and max terms are optional.  The ':' is also optional
  514. X if neither a min nor a max term is specified.  This allows '[]' to
  515. X be used as a null range specification. 
  516. X Specifying a range in the `plot` command line turns autoscaling for
  517. X that axis OFF for that plot. Using one of the `set` range commands
  518. X turns autoscaling off for that axis for future plots, unless changed
  519. X later. (See `set autoscale`).
  520. X Examples:
  521. X This uses current ranges:
  522. X         plot cos(x)
  523. X This sets the xrange only:
  524. X         plot [-10:30] sin(pi*x)/(pi*x)
  525. X This is the same, but uses t as the dummy-variable:
  526. X         plot [t = -10 :30]  sin(pi*t)/(pi*t)
  527. X This sets both the x and yranges:
  528. X         plot [-pi:pi] [-3:3]  tan(x), 1/x
  529. X This sets only the yrange:
  530. X         plot [] [-2:sin(5)*-8] sin(x)**besj0(x)
  531. X This sets xmax and ymin only:
  532. X         plot [:200] [-pi:]  exp(sin(x))
  533. X3 style
  534. X?plot style
  535. X?style
  536. X Plots may be displayed in one of four styles: `lines`, `points`,
  537. X `linespoints`, `impulses`, or `dots`.  The `lines` style connects
  538. X adjacent points with lines. The `points` style displays a small
  539. X symbol at each point.  The `linespoints` style does both `lines` and
  540. X `points`. The `impulses` style displays a vertical line from the X
  541. X axis to each point. The `dots` style plots a tiny dot at each point;
  542. X this is useful for scatter plots with many points.
  543. X Default styles are chosen with the `set function style` and
  544. X `set data style` commands. 
  545. X By default, each function and data file will use a different 
  546. X line type and point type, up to the maximum number of available 
  547. X types. All terminal drivers support at least six different point
  548. X types, and re-use them, in order, if more than six are required. 
  549. X The LaTeX driver supplies an additional six point types (all variants
  550. X of a circle), and thus will only repeat after twelve curves are
  551. X plotted with points.
  552. X If desired, the actual line type and point type used for a plot can
  553. X be specified. Syntax:
  554. X         with <style> {<linetype> {<pointtype>}}
  555. X Where <style> is either `lines`, `points`, `linespoints`, `impulses`,
  556. X or `dots`. These keywords may be abbreviated. 
  557. X Curly braces denote optional items.  The <linetype> and <pointtype> 
  558. X are positive integers, and specify the line type and point type to
  559. X be used for the plot.  Line type 1 is the first line type used by
  560. X default, line type 2 is the second line type used by default etc.
  561. X Examples:
  562. X This plots sin(x) with impulses:
  563. X         plot sin(x) with impulses
  564. X This plots sin(x) with points, cos(x) default:
  565. X         plot [-9:30]  sin(x) w points, cos(x)
  566. X This plots tan(x) with the default function style, "data.1" with lines:
  567. X         plot [] [-2:5] tan(x), "data.1" with l
  568. X This plots "leastsq.dat" with impulses:
  569. X         plot 'leastsq.dat' w i
  570. X This plots sin(x) and cos(x) with the same line type:
  571. X         plot sin(x) with line 1, cos(x) with line 1
  572. X This plots sin(x) and cos(x) with linespoints, using the
  573. X same line type but different point types:
  574. X         plot sin(x) with linesp 1 3, cos(x) with linesp 1 4
  575. X
  576. X This plots file "data" with points style 3:
  577. X         plot "data" with points 1 3 
  578. X Note that the line style must be specified in order to specify the
  579. X point style, even when it is irrelevant. Here the line style is 1 and
  580. X the point style is 3, and the line style is irrelevant.
  581. X3 title
  582. X?plot title
  583. X A title of each plot appears in the key.  By default the title is
  584. X the function or file name as it appears on the plot command line.
  585. X The title can be changed by using the `title` option. This option 
  586. X should precede any `with` option.
  587. X Syntax:
  588. X         title <title>
  589. X Where <title> is the new title of the plot and must be enclosed in
  590. X quotes.
  591. X Examples:
  592. X This plots y=x with the title 'x':
  593. X         plot x
  594. X This plots y=x with the title 'y=x':
  595. X         plot x title 'y=x'
  596. X This plots x squared with title 'x^2' and "data.1" with title 'measured data':
  597. X         plot x**2 title "x^2", "data.1" t 'measured data'
  598. X2 print
  599. X?print
  600. X The `print` command prints the value of <expression> to the screen.
  601. X Syntax:
  602. X         print <expression>
  603. X See `expressions`.
  604. X2 quit
  605. X?quit
  606. X The `exit` and `quit` commands and your computer's END-OF-FILE
  607. X character will exit GNUPLOT.  All these commands will clear the
  608. X output device (as the `clear` command does) before exiting. 
  609. X2 replot
  610. X?replot
  611. X The `replot` command without arguments repeats the last `plot` command.  
  612. X This can be useful for viewing a plot with different `set` options, 
  613. X or when generating the same plot for several devices.
  614. X Arguments specified after a `replot` command will be added onto the last
  615. X `plot` command (with an implied ',' separator) before it is repeated.
  616. X `replot` accepts the same arguments as the `plot` command except that
  617. X ranges cannot be specified. 
  618. X2 save
  619. X?save
  620. X The `save` command saves user-defined functions, variables, set
  621. X options or all three plus the last plot command to the specified file. 
  622. X Syntax:
  623. X         save  {<option>} <filename>
  624. X Where <option> is `functions`, `variables` or `set`.  If no option is
  625. X used GNUPLOT saves functions, variables, set options and the last plot
  626. X command. 
  627. X `save`d files are written in text format and may be read by the `load`
  628. X command.
  629. X The filename must be enclosed in quotes.
  630. X Examples:
  631. X         save "work.gnu"
  632. X         save functions 'func.dat'
  633. X         save var 'var.dat'
  634. X         save set "options.dat"
  635. X2 set-show
  636. X?set
  637. X?show
  638. X The `set` command sets LOTS of options.
  639. X The `show` command shows their settings.  `show all` shows all the
  640. X settings. 
  641. X3 arrow
  642. X?set arrow
  643. X?set noarrow
  644. X?show arrow
  645. X?arrow
  646. X?noarrow
  647. X Arbitrary arrows can be placed on the plot using the `set arrow`
  648. X command.
  649. X Syntax:
  650. X          set arrow {tag} {from sx,sy} {to ex,ey}
  651. X          set noarrow {tag}
  652. X          show arrow
  653. X Curly braces {} denote optional items.
  654. X All positions x,y default to 0,0.
  655. X The x and y values are in the graph's coordinate system.  
  656. X The tag is an integer that is used to identify the arrow. 
  657. X If no tag is given, the lowest unused tag value is assigned
  658. X automatically. The tag can be used to delete or change a specific
  659. X arrow. To change any attribute of an existing arrow, use the `set
  660. X arrow` command with the appropriate tag, and specify the parts of the
  661. X arrow to be changed. 
  662. X
  663. X Arrows outside the plotted boundaries are permitted but may cause
  664. X device errors; use at your own risk.
  665. X Examples: 
  666. X To set an arrow pointing from the origin to (1,2) use
  667. X          set arrow to 1,2
  668. X To set an arrow from (-10,4) to (-5,5), and tag the arrow number 3, use:
  669. X          set arrow 3 from -10,4 to -5,5
  670. X To change the preceding arrow begin at 1,1, use
  671. X          set arrow 3 from 1,1
  672. X To delete arrow number 2 use:
  673. X          set noarrow 2
  674. X To delete all arrows use:
  675. X          set noarrow
  676. X To show all arrows (in tag order) use:
  677. X          show arrow
  678. X3 autoscale
  679. X?set autoscale
  680. X?show autoscale
  681. X?autoscale
  682. X Auto scaling may be set on the X and/or Y axis. The default is to
  683. X autoscale both axes.
  684. X If autoscaling of the Y axis is set, the Y axis is automatically scaled 
  685. X to fit the range of the function or data being plotted.  If autoscaling 
  686. X of the Y axis is not set, the current Y range is used.  See `set yrange`. 
  687. X If autoscaling of the X axis is set, the X axis is automatically scaled
  688. X to fit the range of the data being plotted.  Autoscaling of the X axis 
  689. X will operate only on data.  Functions do not affect the X range and the
  690. X range used for functions is determined by the data plots.
  691. X See `set xrange`.
  692. X Syntax:
  693. X         set autoscale <axes>
  694. X         set noautoscale <axes>
  695. X         show autoscale
  696. X where <axes> is either `x`, `y`, or `xy`.
  697. X If <axes> is not given then both axes are assumed.
  698. X Examples:
  699. X These set autoscaling of the Y axis.  X axis autoscaling not affected.
  700. X         set autoscale y
  701. X This sets autoscaling of the X and Y axes.
  702. X         set autoscale xy
  703. X         set autoscale
  704. X This disables autoscaling of the X and Y axes.
  705. X         set noautoscale
  706. X
  707. X This disables autoscaling of the X axis only.
  708. X         set noautoscale x
  709. X3 clip
  710. X?set clip
  711. X?set noclip
  712. X?show clip
  713. X?clip
  714. X?noclip
  715. X GNUPLOT can clip (actually, not plot at all) data points that fall
  716. X within but too close to the boundaries (this is so the large symbols
  717. X used for points will not extend outside the boundary lines).  To turn
  718. X on clipping, use `set clip points`.  To turn it back off, use `set
  719. X noclip points`. The default is `noclip`.  Without clipping you may have
  720. X points near the boundaries that look bad; try adjusting the x and y ranges.
  721. X Syntax:
  722. X         set clip points
  723. X         set noclip points
  724. X
  725. X GNUPLOT can also clip lines that connect a point that is in range
  726. X with a point that is out of range. The default is to draw the 
  727. X in-range portion of such lines (i.e., to "clip" them). With the 
  728. X following syntax, the default is `set clip one`. The alternative 
  729. X (`set noclip one`) is to not draw any portion of the line segment. In
  730. X no case is a line drawn outside the plotting area.
  731. X Syntax:
  732. X         set clip one
  733. X         set noclip one
  734. X
  735. X GNUPLOT does not show lines that are wholly out of range. Some lines
  736. X may have both endpoints out of range, but pass through the plotting
  737. X area. By default, GNUPLOT does not draw these lines (`set noclip
  738. X two`). They may be drawn (and clipped) with `set clip two`.
  739. X
  740. X Syntax:
  741. X         set clip two
  742. X         set noclip two
  743. X
  744. X To check the state of all forms of clipping, use
  745. X         show clip
  746. X
  747. X The following forms are also permitted. These allow backward
  748. X compatibility with older versions. 
  749. X        set clip
  750. X        set noclip
  751. X `set clip` is synonymous with `set clip points`. `set noclip` turns
  752. X off all three types of clipping (`points`, `one`, and `two`).
  753. X3 dummy
  754. X?set dummy
  755. X?show dummy
  756. X?dummy
  757. X By default, GNUPLOT assumes that the independent variable for 
  758. X the `plot` command line is `x`.  `x` is called the dummy variable because
  759. X it is just a notation to indicate the independent variable.  The
  760. X `set dummy` command changes this default dummy variable name.  For
  761. X example, you may find it more convenient to call the dummy variable
  762. X `t` when plotting time functions:
  763. X         set dummy t
  764. X         plot sin(t), cos(t)
  765. X Syntax:
  766. X         set dummy <dummy-var>
  767. X         show dummy
  768. X3 format
  769. X?set format
  770. X?show format
  771. X?format
  772. X The format of the tic-mark labels can be set with the `set format`
  773. X command.  The default format for both axes is "%g", but other formats
  774. X such as "%.2f" or "%3.0fm" are often desirable.  Anything accepted by
  775. X printf when given a double precision number, and then accepted by the
  776. X terminal, will work.  In particular, the formats f, e, and g will work,
  777. X and the d, o, x, c, s, and u formats will not work.
  778. X Syntax:
  779. X         set format {<axes>} {"format-string"}
  780. X         show format
  781. X where <axes> is either `x`, `y`, `xy`, or nothing (which is the same
  782. X as `xy`).  The length of the string representing a ticmark (after 
  783. X formatting with printf) is restricted to 100 characters.
  784. X If the format string is omitted, the format will be returned to 
  785. X the default "%g". For LaTeX users, the format "$%g$" is often desirable.
  786. X If the empty string "" is used, no label will be plotted with each
  787. X tic, though the tic mark will still be plotted. To eliminate all tic
  788. X marks, use `set noxtics` or `set noytics`. 
  789. X See also `set xtics` and `set ytics` for more control over tic labels.
  790. X3 functions
  791. X?show functions
  792. X The `show functions` command lists all user-defined functions and
  793. X their definitions. 
  794. X Syntax:
  795. X         show functions
  796. X3 grid
  797. X?set grid
  798. X?show grid
  799. X?grid
  800. X The optional `set grid` draws a grid at the tic marks with the axis
  801. X linetype.
  802. X Syntax:
  803. X         set grid
  804. X         set nogrid
  805. X         show grid
  806. X3 key
  807. X?set key
  808. X?show key
  809. X?key
  810. X The `set key` enables a key describing curves on a plot.  
  811. X By default the key is placed in the upper right corner of
  812. X the plot.  
  813. X Syntax:
  814. X         set key
  815. X         set key x,y
  816. X         set nokey
  817. X         show key
  818. X The coordinates x,y specify the location of the key on the plot.
  819. X The key is drawn as a sequence of lines, with one plot described
  820. X on each line.  On the right hand side of each line is a 
  821. X representation that attempts to mimic the way the curve is plotted.
  822. X On the left side of each line is the text description,
  823. X obtained from the `plot` command.  The lines are vertically
  824. X arranged so an imaginary straight line divides the left- and 
  825. X right-hand sides of the key.  It is the x-coordinate of this
  826. X line that you specify with the optional x in the `set key`
  827. X command; the y in the `set key` command is top of the key.
  828. X Some or all of the key may be outside of the plot boundary, if you
  829. X wish, although this may interfere with other labels and may cause an
  830. X error on some devices. 
  831. X Examples:
  832. X This places the key at the default location:
  833. X         set key
  834. X This disables the key.
  835. X         set nokey
  836. X This places a key at coordinates 2,3.5
  837. X         set key 2,3.5
  838. X3 label
  839. X?set label
  840. X?set nolabel
  841. X?show label
  842. X?label
  843. X?nolabel
  844. X Arbitrary labels can be placed on the plot using the `set label`
  845. X command.
  846. X Syntax:
  847. X          set label {tag} {"label_text"} {at x,y} {<justification>}
  848. X          set nolabel {tag}
  849. X          show label
  850. X Curly braces {} denote optional items.
  851. X The text defaults to "", and the position x,y to 0,0.
  852. X The x and y values are in the graph's coordinate system.  
  853. X The tag is an integer that is used to identify the label. 
  854. X If no tag is given, the lowest unused tag value is assigned
  855. X automatically. The tag can be used to delete or change a specific
  856. X label. To change any attribute of an existing label, use the `set
  857. X label` command with the appropriate tag, and specify the parts of the
  858. X label to be changed. 
  859. X
  860. X By default, the text is placed flush left against point x,y. If you
  861. X want to adjust the way the label is positioned with respect to the
  862. X point x,y, add the parameter <justification>, which may be `left`,
  863. X `right` or `center`, indicating that the point is to be at the left,
  864. X right or center of the text.  The <justification> may be abbreviated.
  865. X Labels outside the plotted boundaries are permitted but may interfere
  866. X with axes labels or other text; use at your own risk.
  867. X Examples: 
  868. X To set a label at (1,2) to "y=x" use:
  869. X          set label "y=x" at 1,2
  870. X To set a label "y=x^2" with the right of the text at (2,3), and tag
  871. X the label number 3, use:
  872. X          set label 3 "y=x^2" at 2,3 right
  873. X To change the preceding label to center justification, use:
  874. X          set label 3 center
  875. X To delete label number 2 use:
  876. X          set nolabel 2
  877. X To delete all labels use:
  878. X          set nolabel
  879. X To show all labels (in tag order) use:
  880. X          show label
  881. X
  882. X The Imagen driver allows \\ in a string to specify a newline.
  883. X3 logscale
  884. X?set logscale
  885. X?set nologscale
  886. X?show logscale
  887. X?logscale
  888. X?nologscale
  889. X Log scaling may be set on the X and/or Y axis.
  890. X Syntax:
  891. X         set logscale <axes>
  892. X         set nologscale <axes>
  893. X         show logscale
  894. X Where <axes> is either `x`, `y`, or `xy`.
  895. X If <axes> is not given then both axes are assumed.
  896. X The command `set logscale` turns on log scaling on the specified
  897. X axes, while `set nologscale` turns off log scaling.
  898. X3 offsets
  899. X?set offsets
  900. X?show offsets
  901. X?offsets
  902. X The amount of the graph that the plot takes up may be controlled
  903. X to some extent with the `set offsets` command.  This command takes
  904. X four offset arguments -- <left>, <right>, <top> and <bottom>.  
  905. X By default, each offset is 0.  Each offest may be a constant or
  906. X an expression.  Left and right offsets are given in units of 
  907. X the x axis, while top and bottom offsets are given in units of 
  908. X the y axis.  The plot of sin(x), displayed with offsets of 
  909. X 0, 0, 2, 2 will take up  1/3 of the displayed y axis.  
  910. X Offsets are particularly useful with polar coordinates as a means
  911. X of compensating for aspect ratio distortion.
  912. X Syntax:
  913. X         set offsets <left>, <right>, <top>, <bottom>
  914. X         show offsets
  915. X3 output
  916. X?set output
  917. X?show output
  918. X?output
  919. X By default, plots are displayed to the standard output.  The
  920. X `set output` command redirects the display to the specified file or
  921. X device. 
  922. X Syntax:
  923. X         set output {<filename>}
  924. X         show output
  925. X The filename must be enclosed in quotes.  If the filename is
  926. X omitted, output will be sent to the standard output. 
  927. X3 polar
  928. X?set polar
  929. X?show polar
  930. X?polar
  931. X The `set polar` command changes the meaning of the plot from
  932. X rectangular coordinates to polar coordinates.  In polar
  933. X coordinates, the dummy variable (x) is an angle.  The range
  934. X of this angle is changed from whatever it was to [0:2*pi].
  935. X The command `set nopolar` changes the meaning of the plot back
  936. X to the default rectangular coordinate system.  The range of
  937. X x is changed from whatever it was to [-10:10].
  938. X While in polar coordinates the meaning of an expression in x
  939. X is really r = f(x), where x is an angle of rotation. The xrange
  940. X controls the domain (the angle) of the function, and the yrange
  941. X controls the range (the radius). The plot is plotted on a rectangular
  942. X grid, and the `x` and `y` axes are both in units of the radius. Thus,
  943. X the yrange controls both dimensions of the plot output. There is no
  944. X way to specify the output dimensions separately.
  945. X Syntax:
  946. X         set polar
  947. X         set nopolar
  948. X         show polar
  949. X Example:
  950. X         set polar
  951. X         plot x*sin(x)
  952. X         plot [-2*pi:2*pi] [-3:3] x*sin(x)
  953. X The first plot uses the default polar angular domain of 0 to 2*pi.
  954. X The radius (and the size of the plot) is scaled automatically. The
  955. X second plot expands the domain, and restricts the range of the radius
  956. X (and the size of the plot) to [-3:3].
  957. X3 samples
  958. X?set samples
  959. X?show samples
  960. X?samples
  961. X The sampling rate of functions may be changed by the `set samples`
  962. X command.  By default, sampling is set to 160 points.  A higher
  963. X sampling rate will produce more accurate plots, but will take
  964. X longer.  When plotting datafiles, the sampling rate must be set 
  965. X higher than the number of data points.
  966. X Syntax:
  967. X         set samples <expression>
  968. X         show samples
  969. X3 size
  970. X?set size
  971. X?show size
  972. X?size
  973. X The `set size` command scales the displayed size of the plot.
  974. X On some terminals, changing the size of the plot will result in
  975. X text being misplaced.  Increasing the size of the plot may 
  976. X produce strange results.  Decreasing is safer.
  977. X Syntax:
  978. X         set size {x,y}
  979. X         show size
  980. X The x and y values are the scaling factors for the size.
  981. X The defaults (1,1) are selected if the scaling factors are omitted.
  982. X Examples: 
  983. X To set the size to normal size use:
  984. X         set size
  985. X To make the plot half size use:
  986. X         set size 0.5,0.5
  987. X To show the size use:
  988. X         show size
  989. X
  990. X For the LaTeX and Fig terminals the default size (scale factor 1,1)
  991. X is 5 inches wide by 3 inches high. Note that the size of the plot
  992. X includes the space used by the labels; the plotting area itself is
  993. X smaller. 
  994. X3 style
  995. X?set style
  996. X?show style
  997. X?style
  998. X Plots may be displayed in one of five styles: `lines`, `points`,
  999. X `linespoints`, `impulses`, or `dots`.  The `lines` style connects
  1000. X adjacent points with lines. The `points` style displays a small
  1001. X symbol at each point.  The `linespoints` style does both `lines` and
  1002. X `points`. The `impulses` style displays a vertical line from the X
  1003. X axis to each point. The `dots` style plots a tiny dot at each data
  1004. X point; this is useful for scatter plots with many points.
  1005. X Default styles are chosen with the `set function style` and `set
  1006. X data style` commands.  See `plot style` for information about how 
  1007. X to override the default plotting style for individual functions. 
  1008. X Syntax:
  1009. X         set function style <style>
  1010. X         set data style <style>
  1011. X         show function style
  1012. X         show data style
  1013. X Where <style> is either `lines`, `points`, `linespoints`, `impulses`,
  1014. X or `dots`.
  1015. X3 terminal
  1016. X?set terminal
  1017. X?show terminal
  1018. X?terminal
  1019. X GNUPLOT supports many different graphics devices.  Use the `set
  1020. X terminal` command to select the type of device for which GNUPLOT
  1021. X will produce output. 
  1022. X Syntax:
  1023. X         set terminal {<terminal-type>}
  1024. X         show terminal
  1025. X If <terminal-type> is omitted, GNUPLOT will list the available
  1026. X terminal types.  <terminal-type> may be abbreviated. 
  1027. X Use `set output` to redirect this output to a file or device.
  1028. X3 tics
  1029. X?set tics
  1030. X?show tics
  1031. X?tics
  1032. X By default, tics are drawn inwards from the border on all four sides.
  1033. X The `set tics` command can be used to change the tics to be 
  1034. X drawn outwards on the left and bottom borders only.  
  1035. X This is useful when doing impulse plots.
  1036. X Syntax:
  1037. X         set tics {<direction>}
  1038. X         show tics
  1039. X Where <direction> may be `in`, `out` or nothing (which is the same as in).
  1040. X See also the `set xtics` and `set ytics` command for more control of
  1041. X tic marks. 
  1042. X3 title
  1043. X?set title
  1044. X?show title
  1045. X?title
  1046. X The `set title` command sets the title which will be centered
  1047. X at the top of the plot.
  1048. X Syntax: 
  1049. X          set title 
  1050. X          set title "title-text"
  1051. X          show title
  1052. X The first clears the title (default).
  1053. X The second form sets the title to "title-text" (without the quotes).
  1054. X
  1055. X The Imagen driver allows \\ in a string to specify a newline.
  1056. X3 variables
  1057. X?show variables
  1058. X The `show variables` command lists all user-defined variables and
  1059. X their values. 
  1060. X Syntax:
  1061. X         show variables
  1062. X3 xlabel
  1063. X?set xlabel
  1064. X?show xlabel
  1065. X?xlabel
  1066. X The `set xlabel` command sets the x-axis label which will be centered
  1067. X at the bottom of the plot.
  1068. X Syntax: 
  1069. X          set xlabel 
  1070. X          set xlabel "label"
  1071. X          show xlabel
  1072. X The first clears the x-axis label (default).
  1073. X The second form sets the x-axis label to "label" (without the quotes).
  1074. X
  1075. X The Imagen driver allows \\ in a string to specify a newline.
  1076. X3 xrange
  1077. X?set xrange
  1078. X?show xrange
  1079. X?xrange
  1080. X The `set xrange` command sets the horizontal range which will be
  1081. X displayed.  This command turns X axis autoscaling OFF.
  1082. X This range may also be specified on the `plot` command line.
  1083. X Syntax:
  1084. X         set xrange [{<xmin> : <xmax>}]
  1085. X Where <xmin> and <xmax> terms are expressions or constants.
  1086. X Both the <xmin> and <xmax> terms are optional. Anything omitted will
  1087. X not be changed, so 
  1088. X         set xrange [:10]
  1089. X changes xmax to 10 without affecting xmin. 
  1090. X3 xtics
  1091. X?set xtics
  1092. X?set noxtics
  1093. X?show xtics
  1094. X?xtics
  1095. X?noxtics
  1096. X Very fine control of the `x` axes tic marks is possible with the `set
  1097. X xtics` and `set noxtics` command. The x-axis tic marks may be turned
  1098. X off with the `set noxtics` command. They may be turned on (the
  1099. X default state) with `set xtics`.
  1100. X
  1101. X If you prefer your own series of tic marks, you may use the form
  1102. X          set xtics <start>, <incr>{, <end>}
  1103. X The curly braces indicate that the <end> parameter is optional. 
  1104. X This command specifies that a series of tics will be plotted on the
  1105. X `x` axis between the `x` values <start> and <end> with an increment
  1106. X of <incr>. If <end> is not given it is assumed to be infinity. The
  1107. X increment may be negative. Example:
  1108. X           set xtics 0,.5,10
  1109. X makes tics 0, 0.5, 1, 1.5, ..., 9.5, 10.
  1110. X
  1111. X If you need arbitrary tic positions, or non-numeric tic labels, 
  1112. X any non-empty set of tic positions and labels may be given with this
  1113. X format:
  1114. X          set xtics ({"label"} pos {, {"label"} pos}...)
  1115. X Again curly braces contain optional components. Thus, a set of tics
  1116. X are a set of positions, each with its own optional label. Note that
  1117. X the label is a string enclosed by quotes, and may be a constant
  1118. X string, such as "hello", or contain formatting information for the tic
  1119. X number (which is the same as the position), such as "%3f clients".
  1120. X See `set format` for more information about this case. The label may 
  1121. X even be empty. Examples:
  1122. X          set xtics ("low" 0, "medium" 50, "high" 100)
  1123. X          set xtics (1,2,4,8,16,32,64,128,256,512,1024)
  1124. X          set xtics ("bottom" 0, "" 10, "top" 20)
  1125. X
  1126. X Tics will only be plotted when in range.
  1127. X
  1128. X The `set ytics` and `set noytics` commands work identically.
  1129. X See also `set format` command.
  1130. X3 ylabel
  1131. X?set ylabel
  1132. X?show ylabel
  1133. X?ylabel
  1134. X The `set ylabel` command sets the y-axis label.
  1135. X The position of this label depends on the terminal, and can be
  1136. X one of the following three positions.
  1137. X 1. Horizontal text flushed left at the top left of the plot.  
  1138. X Terminals that cannot rotate text will probably use this method.
  1139. X 2. Vertical text centered vertically at the left of the plot.
  1140. X Terminals that can rotate text will probably use this method.
  1141. X 3. Horizontal text centered vertically at the left of the plot.
  1142. X The Latex and EEPIC drivers use this method.  The user must insert 
  1143. X line breaks using \\ to prevent the ylabel from overwriting
  1144. X the plot.  To produce a vertical row of characters, add \\
  1145. X between every printing character.
  1146. X Syntax:  
  1147. X          set ylabel 
  1148. X          set ylabel "label"
  1149. X          show ylabel
  1150. X The first clears the y-axis label (default).
  1151. X The second form sets the y-axis label to "label" (without the quotes).
  1152. X The Latex, EEPIC, and Imagen drivers allow \\ in a string to specify
  1153. X a newline. 
  1154. X3 yrange
  1155. X?set yrange
  1156. X?show yrange
  1157. X?yrange
  1158. X The `set yrange` command sets the vertical range which will be
  1159. X displayed.  This command turns Y axis autoscaling OFF. 
  1160. X This range may also be specified on the `plot` command line.
  1161. X Syntax:
  1162. X         set yrange [{<ymin> : <ymax>}]
  1163. X Where <ymin> and <ymax> terms are expressions or constants.
  1164. X Both the <ymin> and <ymax> terms are optional. Anything omitted will
  1165. X not be changed, so 
  1166. X         set yrange [:10]
  1167. X changes ymax to 10 without affecting ymin. 
  1168. X3 ytics
  1169. X?set ytics
  1170. X?set noytics
  1171. X?show ytics
  1172. X?ytics
  1173. X?noytics
  1174. X The `set ytics` and `set noytics` commands are similar to the `set xtics`
  1175. X and `set noxtics` commands. Please see `set xtics`.
  1176. X3 zero
  1177. X?set zero
  1178. X?show zero
  1179. X?zero
  1180. X GNUPLOT will not plot a point if its imaginary part is greater in
  1181. X magnitude than the `zero` threshold.  The default `zero` value is
  1182. X 1e-8. This can be changed with the `set zero` command.
  1183. X Syntax:
  1184. X         set zero <expression>
  1185. X         show zero
  1186. X2 shell
  1187. X?shell
  1188. X The `shell` command spawns an interactive shell.  To return to
  1189. X GNUPLOT, type `logout` if using VMS, `exit` or your END-OF-FILE
  1190. X character if using Unix, or `exit` if using MS-DOS. 
  1191. X A single shell command may be spawned by preceding it with the !
  1192. X character ($ if using VMS) at the beginning of a command line.
  1193. X Control will return immediately to GNUPLOT after this command is
  1194. X executed.  For example,
  1195. X      ! dir
  1196. X prints a directory listing and then returns to GNUPLOT.
  1197. X2 start-up
  1198. X?startup
  1199. X?start
  1200. X?.gnuplot
  1201. X When GNUPLOT is run, it looks for an initialization file to load. 
  1202. X This file is called `.gnuplot` on Unix systems, and `GNUPLOT.INI` on
  1203. X other systems.  If this file is not found in the current directory,
  1204. X the program will look for it in your home directory (under MS-DOS, the
  1205. X environment variable GNUPLOT should contain the name of this
  1206. X directory). 
  1207. X If this file is found, GNUPLOT executes the commands in this file.
  1208. X This is most useful for setting your terminal type and defining any
  1209. X functions or variables which you use often.  The variable `pi` is
  1210. X already defined for you. 
  1211. X2 substitution
  1212. X?substitution
  1213. X Command-line substitution is specified by a system command enclosed in
  1214. X backquotes.  This command is spawned and the output it produces
  1215. X replaces the name of the command (and backquotes) on the command line.
  1216. X Newlines in the output produced by the spawned command are replaced with
  1217. X blanks.
  1218. X Command-line substitution can be used anywhere on the GNUPLOT command
  1219. X line. 
  1220. X Example:
  1221. X This will run the program `leastsq` and substitute `leastsq`
  1222. X (including quotes) on the command line with its output:
  1223. X  f(x) = `leastsq`
  1224. X or, in VMS
  1225. X  f(x) = `run leastsq`
  1226. X2 user-defined
  1227. X?userdefined
  1228. X?variables
  1229. X You may define your own functions and variables.  User-defined
  1230. X functions and variables may be used anywhere. 
  1231. X User-defined function syntax:
  1232. X     <function-name> ( <dummy-var> ) =  <expression>
  1233. X Where <expression> is defined in terms of <dummy-var>.
  1234. X User-defined variable syntax:
  1235. X     <variable-name> = <constant-expression>
  1236. X Examples:
  1237. X     w = 2
  1238. X     q = floor(tan(pi/2 - 0.1))
  1239. X     f(x) = sin(w*x)
  1240. X     sinc(x) = sin(pi*x)/(pi*x)
  1241. X     delta(t) = (t == 0)
  1242. X     ramp(t) = (t > 0) ? t : 0
  1243. X The variable `pi` is already defined for you.
  1244. X See `show functions` and `show variables`.
  1245. X2 bugs
  1246. X?bugs
  1247. X The atan() function does not work correctly for complex arguments.
  1248. X The most important known bug is actually in the stdio library for the
  1249. X Sun4 operating system (SunOS Sys4-3.2). The "%g" format for `printf`
  1250. X sometimes incorrectly prints numbers (e.g., 200000.0 as "2").  Thus,
  1251. X tic mark labels may be incorrect on a Sun4 version of gnuplot.  You
  1252. X may work around it by rescaling your data or by using the `set format`
  1253. X command to change the tic mark format to "%7.0f" or some other
  1254. X appropriate format. This appears to have been fixed in SunOS 4.0.
  1255. X Another bug: On a Sun3 under SunOS 4.0, and on Sun4's under Sys4-3.2
  1256. X and SunOS 4.0, the `sscanf` routine incorrectly parses "00 12" with
  1257. X the format "%f %f" and reads 0 and 0 instead of 0 and 12.  This
  1258. X affects data input. If your data file contains X coordinates that are
  1259. X zero but are specified like '00', '000', etc, then you will read the
  1260. X wrong Y values. Check your data files or do not use a Sun4 until they
  1261. X fix the bug. It does NOT appear that this has been fixed in SunOS 4.0.
  1262. X Microsoft C 5.1 has a nasty bug associated with the %g format for
  1263. X printf.  When any of the formats "%.2g", "%.1g", "%.0g", "%.g" are
  1264. X used, printf will incorrectly print numbers in the range 1e-4 to 1e-1.  
  1265. X Numbers that should be printed in the %e format are incorrectly 
  1266. X printed in the %f format, with the wrong number of zeros after the 
  1267. X decimal point.
  1268. X To work around this problem, use the %e or %f formats explicitly.
  1269. X Gnuplot when compiled with Microsoft C did not work correctly on two
  1270. X VGA displays that were tested.  The CGA, EGA and VGA drivers should 
  1271. X probably be rewritten to use the Microsoft C graphics library.
  1272. X Gnuplot compiled with Turbo C uses the Turbo C graphics drivers and 
  1273. X does work correctly with VGA displays. 
  1274. X VAX/VMS 4.7 C compiler release 2.4 also has a poorly implemented %g 
  1275. X format for printf.  The numbers are printed numerically correct, but 
  1276. X may not be in the requested format.  The K&R second edition says that 
  1277. X for the %g format, %e is used if the exponent is less than -4 or greater 
  1278. X than or equal to the precision.  The VAX uses %e format if the exponent 
  1279. X is less than -1.  The VAX appears to take no notice of the precision 
  1280. X when deciding whether to use %e or %f for numbers less than 1.
  1281. X To work around this problem, use the %e or %f formats explicitly.
  1282. X From the VAX C 2.4 release notes:
  1283. X e,E,f,F,g,G  Result will always contain  a  decimal  point.
  1284. X For g and G, trailing zeros will not be removed from the result.
  1285. X VAX/VMS 5.2 C compiler release 3.0 has a slightly better implemented
  1286. X %g format than release 2.4, but not much.  Trailing decimal points are 
  1287. X now removed, but trailing zeros are still not removed from %g numbers 
  1288. X in exponential format.
  1289. *-*-END-of-docs/gnuplot.doc-*-*
  1290. exit
  1291.  
  1292.  
  1293.