home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume24 / gnuplot3 / part10 < prev    next >
Text File  |  1991-10-27  |  50KB  |  1,526 lines
  1. Newsgroups: comp.sources.misc
  2. From: gershon%gr@cs.utah.edu (Elber Gershon)
  3. Subject:  v24i032:  gnuplot3 - interactive function plotting utility, Part10/26
  4. Message-ID: <1991Oct28.002111.12035@sparky.imd.sterling.com>
  5. X-Md4-Signature: d552b94adbfaec352034e3662dbd63ca
  6. Date: Mon, 28 Oct 1991 00:21:11 GMT
  7. Approved: kent@sparky.imd.sterling.com
  8.  
  9. Submitted-by: gershon%gr@cs.utah.edu (Elber Gershon)
  10. Posting-number: Volume 24, Issue 32
  11. Archive-name: gnuplot3/part10
  12. Environment: UNIX, MS-DOS, VMS
  13. Supersedes: gnuplot2: Volume 11, Issue 65-79
  14.  
  15. #!/bin/sh
  16. # this is Part.10 (part 10 of a multipart archive)
  17. # do not concatenate these parts, unpack them in order with /bin/sh
  18. # file gnuplot/docs/gnuplot.doc continued
  19. #
  20. if test ! -r _shar_seq_.tmp; then
  21.     echo 'Please unpack part 1 first!'
  22.     exit 1
  23. fi
  24. (read Scheck
  25.  if test "$Scheck" != 10; then
  26.     echo Please unpack part "$Scheck" next!
  27.     exit 1
  28.  else
  29.     exit 0
  30.  fi
  31. ) < _shar_seq_.tmp || exit 1
  32. if test ! -f _shar_wnt_.tmp; then
  33.     echo 'x - still skipping gnuplot/docs/gnuplot.doc'
  34. else
  35. echo 'x - continuing file gnuplot/docs/gnuplot.doc'
  36. sed 's/^X//' << 'SHAR_EOF' >> 'gnuplot/docs/gnuplot.doc' &&
  37. ?nozeroaxis
  38. X `set zeroaxis` draws the x-axis and y-axis. By default, this option is
  39. X on.  `set nozeroaxis` causes GNUPLOT to omit the axes, and is
  40. X equivalent to `set noxzeroaxis; set noyzeroaxis.`
  41. X 
  42. X Syntax:
  43. X         set zeroaxis
  44. X         set nozeroaxis
  45. X         show zeroaxis
  46. X See `set xzeroaxis` and `set yzeroaxis`.
  47. 3 zlabel
  48. ?set zlabel
  49. ?show zlabel
  50. ?zlabel
  51. X The `set zlabel` command sets the z-axis label that is centered along
  52. X the z axis. Using the optional x,y screen offsets, the label can be
  53. X placed anywhere on the plot. `set zlabel` with no parameters clears
  54. X the label.
  55. X 
  56. X Syntax: 
  57. X          set zlabel {"<label>"} {<xoff>}{,<yoff>}
  58. X          show zlabel
  59. X 
  60. X Specifying constants <xoff> or <yoff> as optional offsets for the
  61. X label will move the label <xoff> or <yoff> character screen
  62. X coordinates. For example,
  63. X 
  64. X          set zlabel ,1
  65. X 
  66. X will change only the y offset of the zlabel, moving the label roughly
  67. X one character height up.
  68. X 
  69. X The zlabel will be drawn whenever surfaces or contours are plotted,
  70. X in the space above the grid level.
  71. X 
  72. X (The LaTeX, EEPIC, and Imagen drivers allow \\ in a string to specify
  73. X a newline.)
  74. 3 zrange
  75. ?set zrange
  76. ?show zrange
  77. ?zrange
  78. X The `set zrange` command sets the vertical range that will be
  79. X displayed. This command turns z axis autoscaling off.  The zrange is
  80. X used only by `splot` and is ignored by `plot`.
  81. X 
  82. X This range may also be specified on the `splot` command line.
  83. X 
  84. X Syntax:
  85. X         set zrange [{<zmin> : <zmax>}]
  86. X 
  87. X where <zmin> and <zmax> terms are constants or expressions.
  88. X 
  89. X Both the <zmin> and <zmax> terms are optional. Anything omitted will
  90. X not be changed, so
  91. X         set zrange [2:]
  92. X changes zmin to 2 without affecting zmax.
  93. 3 ztics
  94. ?set ztics
  95. ?set noztics
  96. ?show ztics
  97. ?ztics
  98. ?noztics
  99. X The `set ztics` and `set noztics` commands are similar to the `set
  100. X xtics` and `set noxtics` commands. Please see `set xtics`.
  101. 2 shell
  102. ?shell
  103. X The `shell` command spawns an interactive shell. To return to
  104. X GNUPLOT, type `logout` if using VMS, `exit` or the END-OF-FILE
  105. X character if using Unix, `endcli` if using AmigaDOS, or `exit` if
  106. X using MS-DOS.
  107. X 
  108. X A single shell command may be spawned by preceding it with the !
  109. X character ($ if using VMS) at the beginning of a command line.
  110. X Control will return immediately to GNUPLOT after this command is
  111. X executed. For example, in VMS, AmigaDOS, or MS-DOS,
  112. X 
  113. X      ! dir
  114. X 
  115. X prints a directory listing and then returns to GNUPLOT.
  116. 2 splot
  117. X Three-dimensional surface and contour plotting is available in
  118. X GNUPLOT with the `splot` command. See the `plot` command for features
  119. X common to the `plot` command.
  120. X 
  121. X See also `set contour`, `set cntrparam`, and `set surface`.
  122. 2 start-up
  123. ?startup
  124. ?start
  125. ?.gnuplot
  126. X When GNUPLOT is run, it looks for an initialization file to load.
  127. X This file is called `.gnuplot` on Unix and AmigaDOS systems, and
  128. X `GNUPLOT.INI` on other systems. If this file is not found in the
  129. X current directory, the program will look for it in the home directory
  130. X (under AmigaDOS and MS-DOS, the environment variable GNUPLOT should
  131. X contain the name of this directory).
  132. X 
  133. X If this file is found, GNUPLOT executes the commands in this file.
  134. X This is most useful for setting the terminal type and defining any
  135. X functions or variables that are used often.
  136. 2 substitution
  137. ?substitution
  138. X Command-line substitution is specified by a system command enclosed in
  139. X backquotes. This command is spawned and the output it produces
  140. X replaces the name of the command (and backquotes) on the command line.
  141. X 
  142. X Newlines in the output produced by the spawned command are replaced
  143. X with blanks.
  144. X 
  145. X Command-line substitution can be used anywhere on the GNUPLOT command
  146. X line.
  147. X 
  148. X Example:
  149. X 
  150. X This will run the program `leastsq` and replace `leastsq` (including
  151. X backquotes) on the command line with its output:
  152. X 
  153. X          f(x) = `leastsq`
  154. X 
  155. X or, in VMS
  156. X 
  157. X          f(x) = `run leastsq`
  158. 2 user-defined
  159. ?userdefined
  160. ?variables
  161. X New user-defined variables and functions of one or two variables may be 
  162. X declared and used anywhere.
  163. X 
  164. X User-defined function syntax:
  165. X         <function-name> ( <dummy-var1> {,<dummy-var2>} ) =  <expression>
  166. X 
  167. X where <expression> is defined in terms of <dummy-var1> and <dummy-var2>.
  168. X
  169. X User-defined variable syntax:
  170. X         <variable-name> = <constant-expression>
  171. X 
  172. X Examples:
  173. X         w = 2
  174. X         q = floor(tan(pi/2 - 0.1))
  175. X         f(x) = sin(w*x)
  176. X         sinc(x) = sin(pi*x)/(pi*x)
  177. X         delta(t) = (t == 0)
  178. X         ramp(t) = (t > 0) ? t : 0
  179. X         min(a,b) = (a < b) ? a : b
  180. X         comb(n,k) = n!/(k!*(n-k)!)
  181. X 
  182. X Note that the variable `pi` is already defined.
  183. X 
  184. X See `show functions` and `show variables`.
  185. 2 bugs
  186. ?bugs
  187. X The atan() function does not work correctly for complex arguments.
  188. X 
  189. X The bessel functions do not work for complex arguments.
  190. X 
  191. X The gamma function does not work for complex arguments.
  192. X 
  193. X There is a bug in the stdio library for old Sun operating systems
  194. X (SunOS Sys4-3.2). The "%g" format for 'printf' sometimes incorrectly
  195. X prints numbers (e.g., 200000.0 as "2"). Thus, tic mark labels may be
  196. X incorrect on a Sun4 version of GNUPLOT. A work-around is to rescale
  197. X the data or use the `set format` command to change the tic mark format
  198. X to "%7.0f" or some other appropriate format. This appears to have been
  199. X fixed in SunOS 4.0.
  200. X 
  201. X Another bug: On a Sun3 under SunOS 4.0, and on Sun4's under Sys4-3.2
  202. X and SunOS 4.0, the 'sscanf' routine incorrectly parses "00 12" with
  203. X the format "%f %f" and reads 0 and 0 instead of 0 and 12. This
  204. X affects data input. If the data file contains x coordinates that are
  205. X zero but are specified like '00', '000', etc, then you will read the
  206. X wrong y values. Check any data files or upgrade the SunOS.
  207. X It appears to have been fixed in SunOS 4.1.1.
  208. X 
  209. X Microsoft C 5.1 has a nasty bug associated with the %g format for
  210. X printf. When any of the formats "%.2g", "%.1g", "%.0g", "%.g" are
  211. X used, printf will incorrectly print numbers in the range 1e-4 to 1e-1.
  212. X Numbers that should be printed in the %e format are incorrectly 
  213. X printed in the %f format, with the wrong number of zeros after the 
  214. X decimal point.
  215. X
  216. X To work around this problem, use the %e or %f formats explicitly.
  217. X 
  218. X GNUPLOT, when compiled with Microsoft C, did not work correctly on two
  219. X VGA displays that were tested. The CGA, EGA and VGA drivers should 
  220. X probably be rewritten to use the Microsoft C graphics library.
  221. X GNUPLOT compiled with Turbo C uses the Turbo C graphics drivers and 
  222. X does work correctly with VGA displays.
  223. X 
  224. X VAX/VMS 4.7 C compiler release 2.4 also has a poorly implemented %g 
  225. X format for printf. The numbers are printed numerically correct, but 
  226. X may not be in the requested format. The K&R second edition says that 
  227. X for the %g format, %e is used if the exponent is less than -4 or greater 
  228. X than or equal to the precision. The VAX uses %e format if the exponent 
  229. X is less than -1. The VAX appears to take no notice of the precision 
  230. X when deciding whether to use %e or %f for numbers less than 1.
  231. X To work around this problem, use the %e or %f formats explicitly.
  232. X From the VAX C 2.4 release notes:
  233. X e,E,f,F,g,G  Result will always contain a decimal  point.
  234. X For g and G, trailing zeros will not be removed from the result.
  235. X 
  236. X VAX/VMS 5.2 C compiler release 3.0 has a slightly better implemented
  237. X %g format than release 2.4, but not much. Trailing decimal points are 
  238. X now removed, but trailing zeros are still not removed from %g numbers 
  239. X in exponential format.
  240. X
  241. X ULTRIX X11R3 has a bug that causes the X11 driver to display "every
  242. X other" plot.  The bug seems to be fixed in DEC's release of X11R4 so
  243. X newer releases of ULTRIX don't seem to have the problem.  Solutions for 
  244. X older sites include upgrading the X11 libraries (from DEC or direct from 
  245. X MIT) or defining ULTRIX_KLUDGE when compiling the x11.trm file.  Note 
  246. X that the kludge is not an ideal fix, however.
  247. X
  248. X The constant HUGE was incorrectly defined in the NeXT OS 2.0 operating
  249. X system.  HUGE should be set to 1e38 in plot.h. This error has been
  250. X corrected in the 2.1 version of NeXT OS.
  251. X
  252. X Please report any bugs to pixar!bug-gnuplot@sun.com or
  253. X pixar!bug-gnuplot@ucbvax.berkeley.edu.
  254. SHAR_EOF
  255. echo 'File gnuplot/docs/gnuplot.doc is complete' &&
  256. chmod 0644 gnuplot/docs/gnuplot.doc ||
  257. echo 'restore of gnuplot/docs/gnuplot.doc failed'
  258. Wc_c="`wc -c < 'gnuplot/docs/gnuplot.doc'`"
  259. test 90586 -eq "$Wc_c" ||
  260.     echo 'gnuplot/docs/gnuplot.doc: original size 90586, current size' "$Wc_c"
  261. rm -f _shar_wnt_.tmp
  262. fi
  263. # ============= gnuplot/docs/lasergnu.1 ==============
  264. if test -f 'gnuplot/docs/lasergnu.1' -a X"$1" != X"-c"; then
  265.     echo 'x - skipping gnuplot/docs/lasergnu.1 (File already exists)'
  266.     rm -f _shar_wnt_.tmp
  267. else
  268. > _shar_wnt_.tmp
  269. echo 'x - extracting gnuplot/docs/lasergnu.1 (Text)'
  270. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/lasergnu.1' &&
  271. .TH LASERGNU l 
  272. .SH NAME
  273. lasergnu \- send gnuplot output to a printer
  274. .SH SYNOPSIS
  275. .B lasergnu
  276. [ flags ] plot-command...
  277. .SH DESCRIPTION
  278. .I lasergnu
  279. runs
  280. .IR gnuplot (1)
  281. in an environment to produce typeset output on an IMAGEN  or
  282. Postscript printer.
  283. .PP
  284. The 
  285. .B gnuplot
  286. commands
  287. .B plot-command
  288. are performed and the output sent to the printer. 
  289. If the 
  290. .B -f
  291. option specifies a file for input, the plot command is optional. 
  292. The command-line plot commands are executed prior to any in the
  293. file(s).
  294. .PP
  295. For example, to plot the function
  296. .I sin(x)
  297. from -1 to +1, and to use printer im1, use the command
  298. .br
  299. .nf
  300. X    lasergnu -Pim1 'plot [-1:1] sin(x) with lines'
  301. .fi
  302. To execute the gnuplot command file
  303. .I myplot,
  304. on the postscript printer lw0, use the command
  305. .br
  306. .nf
  307. X    lasergnu -Plw0 -p -f myplot
  308. .fi
  309. The following switches are recognized:
  310. .TP
  311. .BI \-p
  312. Use the postscript language to make the plot, instead of Impress.
  313. This is for use on Postscript printers only. This uses a double-size
  314. plot in landscape mode as the default.
  315. .TP
  316. .BI \-P\0 printer
  317. The output of this program is intended for 
  318. .I printer.
  319. \ If the file is being spooled, this determines the printer it is spooled
  320. to (default: $LASER).
  321. Be sure to use the -p flag if the printer is a postscript printer.
  322. .TP
  323. .BI \-f\0 file
  324. Take gnuplot commands from the named file.
  325. Multiple files  may be supplied with separate -f options.
  326. .TP
  327. .BI  \-t\0 title
  328. Specify the title of the plot.
  329. .TP
  330. .BI \-b
  331. Do not print a banner page.
  332. .TP
  333. .BI \-J
  334. Do not print a banner page.
  335. .TP
  336. .B \-help
  337. Prints a list of options.
  338. .SH SEE ALSO
  339. gnuplot(l), lpr(1)
  340. SHAR_EOF
  341. chmod 0644 gnuplot/docs/lasergnu.1 ||
  342. echo 'restore of gnuplot/docs/lasergnu.1 failed'
  343. Wc_c="`wc -c < 'gnuplot/docs/lasergnu.1'`"
  344. test 1594 -eq "$Wc_c" ||
  345.     echo 'gnuplot/docs/lasergnu.1: original size 1594, current size' "$Wc_c"
  346. rm -f _shar_wnt_.tmp
  347. fi
  348. # ============= gnuplot/docs/latextut/Makefile ==============
  349. if test ! -d 'gnuplot/docs/latextut'; then
  350.     echo 'x - creating directory gnuplot/docs/latextut'
  351.     mkdir 'gnuplot/docs/latextut'
  352. fi
  353. if test -f 'gnuplot/docs/latextut/Makefile' -a X"$1" != X"-c"; then
  354.     echo 'x - skipping gnuplot/docs/latextut/Makefile (File already exists)'
  355.     rm -f _shar_wnt_.tmp
  356. else
  357. > _shar_wnt_.tmp
  358. echo 'x - extracting gnuplot/docs/latextut/Makefile (Text)'
  359. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/Makefile' &&
  360. # Makefile for gnuplot LaTeX tutorial
  361. # To make the manual from scratch, we run latex two times
  362. all: tutorial.dvi done
  363. X
  364. done:
  365. X    latex tutorial
  366. X    echo > done
  367. X
  368. # To touch it up after changes:
  369. remake: tutorial.dvi
  370. X
  371. # Always runs latex, e.g., to get labels right
  372. force: 
  373. X    latex tutorial
  374. X
  375. tutorial.dvi: eg1.tex eg2.tex eg3.tex eg4.tex eg5.tex eg6.tex linepoint.tex \
  376. X    tutorial.tex header.tex
  377. X    latex tutorial
  378. X    rm -f done
  379. X
  380. .SUFFIXES: .tex .plt
  381. X
  382. .plt.tex:
  383. X    gnuplot $<
  384. X
  385. clean:
  386. X    rm -f *~ *.log eg?.tex linepoint.tex
  387. X
  388. spotless:
  389. X    rm -f *~ *.log *.aux *.dvi eg?.tex linepoint.tex done
  390. SHAR_EOF
  391. chmod 0644 gnuplot/docs/latextut/Makefile ||
  392. echo 'restore of gnuplot/docs/latextut/Makefile failed'
  393. Wc_c="`wc -c < 'gnuplot/docs/latextut/Makefile'`"
  394. test 570 -eq "$Wc_c" ||
  395.     echo 'gnuplot/docs/latextut/Makefile: original size 570, current size' "$Wc_c"
  396. rm -f _shar_wnt_.tmp
  397. fi
  398. # ============= gnuplot/docs/latextut/eg1.plt ==============
  399. if test -f 'gnuplot/docs/latextut/eg1.plt' -a X"$1" != X"-c"; then
  400.     echo 'x - skipping gnuplot/docs/latextut/eg1.plt (File already exists)'
  401.     rm -f _shar_wnt_.tmp
  402. else
  403. > _shar_wnt_.tmp
  404. echo 'x - extracting gnuplot/docs/latextut/eg1.plt (Text)'
  405. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/eg1.plt' &&
  406. set terminal latex
  407. set output "eg1.tex"
  408. plot [-3.14:3.14] sin(x)
  409. SHAR_EOF
  410. chmod 0666 gnuplot/docs/latextut/eg1.plt ||
  411. echo 'restore of gnuplot/docs/latextut/eg1.plt failed'
  412. Wc_c="`wc -c < 'gnuplot/docs/latextut/eg1.plt'`"
  413. test 65 -eq "$Wc_c" ||
  414.     echo 'gnuplot/docs/latextut/eg1.plt: original size 65, current size' "$Wc_c"
  415. rm -f _shar_wnt_.tmp
  416. fi
  417. # ============= gnuplot/docs/latextut/eg2.plt ==============
  418. if test -f 'gnuplot/docs/latextut/eg2.plt' -a X"$1" != X"-c"; then
  419.     echo 'x - skipping gnuplot/docs/latextut/eg2.plt (File already exists)'
  420.     rm -f _shar_wnt_.tmp
  421. else
  422. > _shar_wnt_.tmp
  423. echo 'x - extracting gnuplot/docs/latextut/eg2.plt (Text)'
  424. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/eg2.plt' &&
  425. set terminal latex
  426. set output "eg2.tex"
  427. set size 5/5., 4/3.
  428. set format xy "$%g$"
  429. set title "This is a plot of $y=sin(x)$"
  430. set xlabel "This is the $x$ axis"
  431. set ylabel "This is\\the\\$y$ axis"
  432. plot [0:6.28] [0:1] sin(x)
  433. SHAR_EOF
  434. chmod 0666 gnuplot/docs/latextut/eg2.plt ||
  435. echo 'restore of gnuplot/docs/latextut/eg2.plt failed'
  436. Wc_c="`wc -c < 'gnuplot/docs/latextut/eg2.plt'`"
  437. test 219 -eq "$Wc_c" ||
  438.     echo 'gnuplot/docs/latextut/eg2.plt: original size 219, current size' "$Wc_c"
  439. rm -f _shar_wnt_.tmp
  440. fi
  441. # ============= gnuplot/docs/latextut/eg3.dat ==============
  442. if test -f 'gnuplot/docs/latextut/eg3.dat' -a X"$1" != X"-c"; then
  443.     echo 'x - skipping gnuplot/docs/latextut/eg3.dat (File already exists)'
  444.     rm -f _shar_wnt_.tmp
  445. else
  446. > _shar_wnt_.tmp
  447. echo 'x - extracting gnuplot/docs/latextut/eg3.dat (Text)'
  448. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/eg3.dat' &&
  449. -20.000000 -9.125028
  450. -19.000000 -9.109280
  451. -18.000000 -9.091787
  452. -17.000000 -9.072243
  453. -16.000000 -9.050265
  454. -15.000000 -9.025369
  455. -14.000000 -8.996933
  456. -13.000000 -8.964147
  457. -12.000000 -8.925931
  458. -11.000000 -8.880819
  459. -10.000000 -8.826766
  460. -9.000000 -8.760835
  461. -8.000000 -8.678648
  462. -7.000000 -8.573396
  463. -6.000000 -8.433886
  464. -5.000000 -8.240405
  465. -4.000000 -7.954906
  466. -3.000000 -7.494275
  467. -2.000000 -6.642892
  468. -1.000000 -4.712389
  469. 0.000000 0.000000
  470. 1.000000 4.712389
  471. 2.000000 6.642892
  472. 3.000000 7.494275
  473. 4.000000 7.954906
  474. 5.000000 8.240405
  475. 6.000000 8.433886
  476. 7.000000 8.573396
  477. 8.000000 8.678648
  478. 9.000000 8.760835
  479. 10.000000 8.826766
  480. 11.000000 8.880819
  481. 12.000000 8.925931
  482. 13.000000 8.964147
  483. 14.000000 8.996933
  484. 15.000000 9.025369
  485. 16.000000 9.050265
  486. 17.000000 9.072243
  487. 18.000000 9.091787
  488. 19.000000 9.109280
  489. SHAR_EOF
  490. chmod 0666 gnuplot/docs/latextut/eg3.dat ||
  491. echo 'restore of gnuplot/docs/latextut/eg3.dat failed'
  492. Wc_c="`wc -c < 'gnuplot/docs/latextut/eg3.dat'`"
  493. test 781 -eq "$Wc_c" ||
  494.     echo 'gnuplot/docs/latextut/eg3.dat: original size 781, current size' "$Wc_c"
  495. rm -f _shar_wnt_.tmp
  496. fi
  497. # ============= gnuplot/docs/latextut/eg3.plt ==============
  498. if test -f 'gnuplot/docs/latextut/eg3.plt' -a X"$1" != X"-c"; then
  499.     echo 'x - skipping gnuplot/docs/latextut/eg3.plt (File already exists)'
  500.     rm -f _shar_wnt_.tmp
  501. else
  502. > _shar_wnt_.tmp
  503. echo 'x - extracting gnuplot/docs/latextut/eg3.plt (Text)'
  504. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/eg3.plt' &&
  505. set terminal latex
  506. set output "eg3.tex"
  507. set format xy "$%g$"
  508. set title "This is another plot"
  509. set xlabel "$x$ axis"
  510. set ylabel "$y$ axis"
  511. set key 15,-10
  512. plot x with lines, "eg3.dat" with linespoints
  513. SHAR_EOF
  514. chmod 0666 gnuplot/docs/latextut/eg3.plt ||
  515. echo 'restore of gnuplot/docs/latextut/eg3.plt failed'
  516. Wc_c="`wc -c < 'gnuplot/docs/latextut/eg3.plt'`"
  517. test 199 -eq "$Wc_c" ||
  518.     echo 'gnuplot/docs/latextut/eg3.plt: original size 199, current size' "$Wc_c"
  519. rm -f _shar_wnt_.tmp
  520. fi
  521. # ============= gnuplot/docs/latextut/eg4.plt ==============
  522. if test -f 'gnuplot/docs/latextut/eg4.plt' -a X"$1" != X"-c"; then
  523.     echo 'x - skipping gnuplot/docs/latextut/eg4.plt (File already exists)'
  524.     rm -f _shar_wnt_.tmp
  525. else
  526. > _shar_wnt_.tmp
  527. echo 'x - extracting gnuplot/docs/latextut/eg4.plt (Text)'
  528. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/eg4.plt' &&
  529. set terminal latex
  530. set output "eg4.tex"
  531. set format y "$%g$"
  532. set format x "$%.2f$"
  533. set title "This is $\sin(x)$"
  534. set xlabel "This is the $x$ axis"
  535. set ylabel "$\sin(x)$"
  536. set nokey
  537. set xtics -pi, pi/4
  538. plot [-pi:pi] [-1:1] sin(x)
  539. SHAR_EOF
  540. chmod 0666 gnuplot/docs/latextut/eg4.plt ||
  541. echo 'restore of gnuplot/docs/latextut/eg4.plt failed'
  542. Wc_c="`wc -c < 'gnuplot/docs/latextut/eg4.plt'`"
  543. test 227 -eq "$Wc_c" ||
  544.     echo 'gnuplot/docs/latextut/eg4.plt: original size 227, current size' "$Wc_c"
  545. rm -f _shar_wnt_.tmp
  546. fi
  547. # ============= gnuplot/docs/latextut/eg5.plt ==============
  548. if test -f 'gnuplot/docs/latextut/eg5.plt' -a X"$1" != X"-c"; then
  549.     echo 'x - skipping gnuplot/docs/latextut/eg5.plt (File already exists)'
  550.     rm -f _shar_wnt_.tmp
  551. else
  552. > _shar_wnt_.tmp
  553. echo 'x - extracting gnuplot/docs/latextut/eg5.plt (Text)'
  554. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/eg5.plt' &&
  555. set terminal latex
  556. set output "eg5.tex"
  557. set format y "$%g$"
  558. set format x "$%4.1f\pi$"
  559. set noclip points
  560. set title "This is $\sin(x)$"
  561. set xlabel "This is the $x$ axis"
  562. set ylabel "$\sin(x)$"
  563. set nokey
  564. set xtics ("$-\pi$" -pi,\
  565. X "$-\frac{\pi}{2}$" -pi/2,\
  566. X "0" 0,\
  567. X "$\frac{\pi}{2}$" pi/2,\
  568. X "$\pi$" pi)
  569. plot [-pi:pi] [-1:1] sin(x)
  570. SHAR_EOF
  571. chmod 0666 gnuplot/docs/latextut/eg5.plt ||
  572. echo 'restore of gnuplot/docs/latextut/eg5.plt failed'
  573. Wc_c="`wc -c < 'gnuplot/docs/latextut/eg5.plt'`"
  574. test 331 -eq "$Wc_c" ||
  575.     echo 'gnuplot/docs/latextut/eg5.plt: original size 331, current size' "$Wc_c"
  576. rm -f _shar_wnt_.tmp
  577. fi
  578. # ============= gnuplot/docs/latextut/eg6.plt ==============
  579. if test -f 'gnuplot/docs/latextut/eg6.plt' -a X"$1" != X"-c"; then
  580.     echo 'x - skipping gnuplot/docs/latextut/eg6.plt (File already exists)'
  581.     rm -f _shar_wnt_.tmp
  582. else
  583. > _shar_wnt_.tmp
  584. echo 'x - extracting gnuplot/docs/latextut/eg6.plt (Text)'
  585. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/eg6.plt' &&
  586. set terminal latex
  587. set output "eg6.tex"
  588. set size 3.5/5, 3/3.
  589. set format y "$%g$"
  590. set format x "$%5.1f\mu$"
  591. set title "This is a title"
  592. set xlabel "This is the $x$ axis"
  593. set ylabel "This is\\a longer\\version\\ of\\the $y$\\ axis"
  594. set label "Data" at -5,-5 right
  595. set arrow from -5,-5 to -3.3,-6.7
  596. set key -4,8
  597. set xtic -10,5,10
  598. plot [-10:10] [-10:10] "eg3.dat" title "Data File"  with linespoints 1 7,\
  599. X   3*exp(-x*x)+1  title "$3e^{-x^{2}}+1$" with lines 4
  600. SHAR_EOF
  601. chmod 0666 gnuplot/docs/latextut/eg6.plt ||
  602. echo 'restore of gnuplot/docs/latextut/eg6.plt failed'
  603. Wc_c="`wc -c < 'gnuplot/docs/latextut/eg6.plt'`"
  604. test 457 -eq "$Wc_c" ||
  605.     echo 'gnuplot/docs/latextut/eg6.plt: original size 457, current size' "$Wc_c"
  606. rm -f _shar_wnt_.tmp
  607. fi
  608. # ============= gnuplot/docs/latextut/header.tex ==============
  609. if test -f 'gnuplot/docs/latextut/header.tex' -a X"$1" != X"-c"; then
  610.     echo 'x - skipping gnuplot/docs/latextut/header.tex (File already exists)'
  611.     rm -f _shar_wnt_.tmp
  612. else
  613. > _shar_wnt_.tmp
  614. echo 'x - extracting gnuplot/docs/latextut/header.tex (Text)'
  615. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/header.tex' &&
  616. % 
  617. % Header file for tutorial.tex
  618. %
  619. X
  620. % Spacing
  621. \newcommand{\singlespace}
  622. X  {\addtolength{\baselineskip}{-.333\baselineskip}}
  623. \newcommand{\doublespace}
  624. X  {\addtolength{\baselineskip}{.5\baselineskip}}
  625. X
  626. % Spacing for the whole document 
  627. \newcommand{\currentspace}{} % use this for single space
  628. % \newcommand{\currentspace}{\doubleespace} % use this for double space
  629. X
  630. % Common abbreviations
  631. % (Remember to put '\ ' after if an interword space is
  632. %  desired rather than end-of-sentence space. Same for '.etc)' ).
  633. \newcommand{\eg}{{\em e.g.}}        % e.g.
  634. \newcommand{\ie}{{\em i.e.}}        % i.e.
  635. \newcommand{\etc}{{\em etc.}}        % etc.
  636. \newcommand{\vs}{{\em vs.}}        % vs.
  637. \newcommand{\usec}{{$\mu$}sec}    % microseconds
  638. X
  639. % \boxfigure{pos}{wid}{text}:  A figure with a box around it
  640. %
  641. % pos    the usual figure placement arg: eg. htbp
  642. % wid    the width of the figure, in some units: eg. 5in
  643. % text    the contents of the figure, including picture/caption/label/etc
  644. %
  645. \newlength{\boxwidth}
  646. \newcommand{\boxfigure}[3]{
  647. X    \begin{figure}[#1]
  648. X        \setlength{\boxwidth}{#2}
  649. X        \addtolength{\boxwidth}{.1in}
  650. X
  651. X        \centering
  652. X        \framebox[\boxwidth]{
  653. X            \begin{minipage}{#2}
  654. X            #3
  655. X            \end{minipage}
  656. X        }
  657. X    \end{figure}  
  658. }
  659. X
  660. % use \fullboxwidth for arg 2 of boxfigure to get box of size \textwidth
  661. X
  662. % To show a syntax for a gnutex command
  663. \newenvironment{syntax}{\begin{quote}\tt}{\end{quote}}
  664. X
  665. \documentstyle[titlepage,11pt]{article}
  666. X
  667. % Margins
  668. \sloppy
  669. \setlength{\textwidth}{6.5in}
  670. \setlength{\textheight}{9in}
  671. \setlength{\topmargin}{-0.5in}
  672. \setlength{\oddsidemargin}{0pt}
  673. \setlength{\evensidemargin}{0pt}
  674. X
  675. % see above
  676. \newlength{\fullboxwidth}
  677. \setlength{\fullboxwidth}{\textwidth}
  678. \addtolength{\fullboxwidth}{-0.1in}
  679. X
  680. SHAR_EOF
  681. chmod 0644 gnuplot/docs/latextut/header.tex ||
  682. echo 'restore of gnuplot/docs/latextut/header.tex failed'
  683. Wc_c="`wc -c < 'gnuplot/docs/latextut/header.tex'`"
  684. test 1677 -eq "$Wc_c" ||
  685.     echo 'gnuplot/docs/latextut/header.tex: original size 1677, current size' "$Wc_c"
  686. rm -f _shar_wnt_.tmp
  687. fi
  688. # ============= gnuplot/docs/latextut/tutorial.tex ==============
  689. if test -f 'gnuplot/docs/latextut/tutorial.tex' -a X"$1" != X"-c"; then
  690.     echo 'x - skipping gnuplot/docs/latextut/tutorial.tex (File already exists)'
  691.     rm -f _shar_wnt_.tmp
  692. else
  693. > _shar_wnt_.tmp
  694. echo 'x - extracting gnuplot/docs/latextut/tutorial.tex (Text)'
  695. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/tutorial.tex' &&
  696. % 
  697. % Tutorial for GNUPLOT plotting program, for LaTeX users
  698. % David Kotz (David.Kotz@Dartmouth.edu)
  699. % Duke University Computer Science Department
  700. %
  701. % NOTE: If LaTeX runs out of memory processing plots,
  702. % add ``with lines 4'' to each curve in eg*.plt and rerun make.
  703. %
  704. X
  705. % some header info
  706. \input{header}
  707. X
  708. \begin{document}
  709. X
  710. \title{\LaTeX\ and the GNUPLOT Plotting 
  711. Program\thanks{This document describes GNUPLOT version 3.0. All plots
  712. in this document were made with that version of GNUPLOT.} }
  713. \author{David Kotz \\ \verb+David.Kotz@Dartmouth.edu+}
  714. \date{July 3, 1991}
  715. X
  716. \maketitle
  717. X
  718. \pagestyle{myheadings}
  719. \markright{GNUPLOT \LaTeX\ Tutorial Version 3.0}
  720. X
  721. \currentspace % defined in header.tex
  722. X
  723. \section{Introduction and History}
  724. X
  725. GNUPLOT was originally developed by Colin Kelley and Thomas Williams
  726. in 1986 to plot functions and data files on a variety of terminals.
  727. In 1988 and 1989 I created an alternate version, known as Gnu\TeX,
  728. that supported a new ``terminal type'' called {\tt latex}, so gnuplot
  729. would output \LaTeX\ code. The plot could then be included in a
  730. \LaTeX\ document. I added a number of embellishments, supported only
  731. by the {\tt latex} terminal, allowing the user to produce
  732. publication-quality plots.
  733. X
  734. In late 1989 and early 1990 Gnu\TeX\ and a number of other GNUPLOT
  735. variants were merged together into a new release of GNUPLOT, 2.0. This
  736. includes, among many other improvements, a \LaTeX\ driver derived from
  737. the one in Gnu\TeX. Former Gnu\TeX\ users are referred to
  738. Section~\ref{oldusers} for information about adapting to GNUPLOT.
  739. Anyone interested in using GNUPLOT with \LaTeX\ should read the next
  740. section, a tutorial, and the primary GNUPLOT manual.
  741. X
  742. The reader should note that the \LaTeX\ picture environments output by
  743. GNUPLOT can be quite large and complicated, and can easily exceed the
  744. memory capacity of \TeX. If an enlarged version of \TeX\ is available,
  745. it is wise to use it. Otherwise, keep your plots simple and add
  746. \verb+\clearpage+ to your document where necessary.
  747. X
  748. There is also a new EEPIC driver ({\tt eepic}), intended for use with
  749. the EEPIC macro package for \LaTeX. EEPIC allows for much more
  750. efficient line-drawing, runs through \LaTeX\ faster, and uses less
  751. memory.  See Section~\ref{s:eepic} for more information.
  752. X
  753. There is a small package of auxiliary files (makefiles and scripts)
  754. that I find useful for making \LaTeX\ plots with GNUPLOT. This is
  755. available for \verb+ftp+ as \verb+pub/gnuplot-latex.shar+ from
  756. \verb+cs.duke.edu+. I can mail copies (see the end of this paper for
  757. information).
  758. X
  759. \section{Using GNUPLOT for \LaTeX: a Tutorial}
  760. X
  761. GNUPLOT is by nature an interactive program. Users making plots for
  762. \LaTeX\ will generally not use GNUPLOT interactively.  Whenever hard
  763. copy is desired from GNUPLOT, the program need not be run on a
  764. graphics terminal. In this case the output is directed to a file or
  765. pipe, then sent to the appropriate output device. For example, output
  766. from the terminal type {\tt unixplot} may be sent to a program
  767. interpreting the Unix plotting standard. The terminal types {\tt
  768. imagen} and {\tt postscript} may be used for output to printers
  769. understanding those languages. (A shell script ({\tt lasergnu}) is
  770. supplied with the distribution that will accept a GNUPLOT command or
  771. input file and send the output to an Imagen or Postscript laser
  772. printer. This script may have been adapted to your site.) The terminal
  773. type {\tt fig} outputs FIG code that can be read by the Fig graphics
  774. program and translated into forms usable in both \TeX\ and
  775. \LaTeX\ documents.
  776. X
  777. We now ignore the interactive nature of GNUPLOT and provide the input
  778. to GNUPLOT from a file, \ie,
  779. \begin{verbatim}
  780. X      gnuplot gnu.input
  781. \end{verbatim}
  782. In this example, all of the commands to GNUPLOT are contained in the
  783. file {\tt gnu.input}. Multiple filenames may be supplied to GNUPLOT
  784. this way, read in the order they are given.  The output (one or more
  785. plots) may be piped to another program or redirected to a file.
  786. Usually, however, we direct the output explicitly with an instruction
  787. to GNUPLOT (the {\tt set output} command). GNUPLOT continues to print
  788. error messages to the terminal (stderr).
  789. X
  790. \paragraph{Example 1:} Here is a first example, producing a plot for
  791. this document. The GNUPLOT input file is given below, and the output
  792. appears as Figure~\ref{eg1}. The input file defines the output to be
  793. in \LaTeX, gives a file name for the output, and plots $y=sin(x)$ for
  794. $x$ on $[-\pi,\pi]$. To produce the figure, I simply
  795. \verb+\input{eg1}+ in a {\tt center} environment in a {\tt figure}
  796. environment. In following examples, I will enclose the figure in a box
  797. to make it look a little better.
  798. X
  799. \singlespace
  800. \begin{verbatim}
  801. X    set terminal latex
  802. X    set output "eg1.tex"
  803. X    plot [-3.14:3.14] sin(x)
  804. \end{verbatim}
  805. \currentspace
  806. X
  807. \begin{figure}[htbp]
  808. X  \begin{center}
  809. X    \input{eg1}
  810. X  \end{center}
  811. X  \caption{A first example: $y=sin(x)$} 
  812. X  \label{eg1}
  813. \end{figure}
  814. X
  815. Note that GNUPLOT has drawn in the axes, labeled the tic marks for us,
  816. scaled the $y$ axis automatically, and added a key in the
  817. upper-right-hand corner (this may be moved with the {\tt set key}
  818. command, and removed with {\tt set nokey}).
  819. X
  820. This is the default line style for the \LaTeX\ driver.  Because of the
  821. limited picture capabilities of \LaTeX, many dots are required to
  822. approximate drawing a solid line. This may overload the memory of many
  823. \TeX\ implementations. There are other line types available that draw
  824. dotted lines and use much less memory. The EEPIC driver draws solid
  825. lines with much less memory usage.
  826. X
  827. \paragraph{Example 2:} Now we will embellish the plot a little with
  828. some labels.  This input file produces Figure~\ref{eg2}.
  829. X
  830. \singlespace
  831. \begin{verbatim}
  832. X    set terminal latex
  833. X    set output "eg2.tex"
  834. X    set size 5/5., 4/3.
  835. X    set format xy "$%g$"
  836. X    set title "This is a plot of $y=sin(x)$"
  837. X    set xlabel "This is the $x$ axis"
  838. X    set ylabel "This is\\the\\$y$ axis"
  839. X    plot [0:6.28] [0:1] sin(x)
  840. \end{verbatim}
  841. \currentspace
  842. X
  843. \boxfigure{htbp}{\fullboxwidth}{
  844. X  \begin{center}
  845. X    \input{eg2}
  846. X  \end{center}
  847. X  \caption{A more fancy example.}
  848. X  \label{eg2}
  849. }
  850. X
  851. We have specified the plot to be 5 inches wide and 4 inches tall with
  852. the {\tt set size} command. This is the size of the area used by the
  853. plot, {\em including} space for the labels.  In the first example,
  854. this size was the default 5 inches by 3 inches. By specifying the
  855. scaling factors of 1 (or 5/5) and 1.3333 (or 4/3), we obtain the
  856. desired plot size. 
  857. X
  858. We have requested that the format used by the $x$- and $y$-axis tic
  859. mark labels be in \LaTeX\ math mode. This makes the labels look a
  860. little better. The default is \verb+set format xy "%g"+. The \verb+%g+
  861. represents the general-purpose floating point formatting specification
  862. for the {\tt printf} function in C. Any valid floating-point
  863. formatting specification, or \LaTeX\ command, is allowed in the
  864. format.
  865. X
  866. A title for the plot and labels for the axes were set up in the next
  867. three commands.  Note that they are processed by \LaTeX\ and so may
  868. have math mode and other symbols in them. The ylabel may have multiple
  869. lines, delineated with \verb+\\+.  The ylabel can be moved around with
  870. optional offset parameters (see {\tt set ylabel} in the GNUPLOT
  871. manual). Typically, the ylabel needs to be moved to the left to avoid
  872. interfering with the left-hand side of the plot.  Once these labels
  873. are set up, they will be used for all subsequent plot commands until
  874. they are changed. These labels are also supported by the other
  875. terminal types, but (of course) any \LaTeX\ code in the string will
  876. not be interpreted. We have also defined the range of both $x$ (now
  877. $[0,2\pi]$) and $y$ (here $[0,1]$).
  878. X
  879. So far we have plotted one curve, $y=\sin(x)$, on one plot. In
  880. GNUPLOT, each {\tt plot} command generates a new plot. If the output
  881. is to a screen, the screen is cleared. If to a printer, a new page is
  882. produced. In the {\tt latex} case, a new picture is started. It is not
  883. likely that \LaTeX\ users will want this to happen, so generally each
  884. plot has its own input file and is kept in a separate output ({\tt
  885. .tex}) file for inclusion at different places in the document.
  886. X
  887. \paragraph{Example 3:} To place more than one curve on a plot, use one
  888. {\tt plot} statement and separate the description of each curve by a
  889. comma. In our next example, we will plot both a function and a data
  890. file on the same plot. This plot is shown in Figure~\ref{eg3}.
  891. X
  892. \singlespace
  893. \begin{verbatim}
  894. X    set terminal latex
  895. X    set output "eg3.tex"
  896. X    set format xy "$%g$"
  897. X    set title "This is another plot"
  898. X    set xlabel "$x$ axis"
  899. X    set ylabel "$y$ axis"
  900. X    set key 15,-10
  901. X    plot x with lines, "eg3.dat" with linespoints
  902. \end{verbatim}
  903. \currentspace
  904. X
  905. \boxfigure{htbp}{\fullboxwidth}{
  906. X  \begin{center}
  907. X    \input{eg3}
  908. X  \end{center}
  909. X  \caption{An example with two curves on the same plot.}
  910. X  \label{eg3}
  911. }
  912. X
  913. Here you will see that the $x$ range was not specified. The $x$ range
  914. is determined automatically, unless specified by the user.  In
  915. this case, it is defined by the range of the data file
  916. \verb+"eg3.dat"+. The function is plotted over the same range. If no
  917. data files or $x$ range are supplied, the default range of $[-10:10]$
  918. is used. We have also moved the key to a different position.  The
  919. function $y=x$ is plotted ``with lines'', which is the default plot
  920. style for functions, and is shown here to illustrate the plot style
  921. option.  The data file {\tt eg3.dat} is plotted with style {\tt
  922. linespoints}, a style like {\tt lines} that also plots a symbol at
  923. each data point.
  924. X
  925. There is a style called {\tt points} that only plots the symbols at
  926. data points, and another called {\tt dots} that plots a tiny dot for
  927. each data point.  The {\tt points} and {\tt linespoints} styles
  928. produce a different point symbol for each curve on the plot (for up to
  929. twelve symbols, after which they are re-used; see
  930. Figure~\ref{linepoint} for a complete list). The {\tt lines} and {\tt
  931. linespoints} styles use a different line style for each curve on the
  932. plot (in this example the dots have different spacing). The
  933. style {\tt impulses} draws a perpendicular from each point to the
  934. $x$-axis. Finally, the {\tt errorbars} style can draw error bars at
  935. each data point (see the GNUPLOT manual). 
  936. X
  937. \paragraph{Example 4:} In the above plots of $\sin(x)$, it would make
  938. more sense to label the axis in units of $\pi$. The position and
  939. labels of the tic labels may be specified by the user, with the {\tt
  940. set xtics} and {\tt set ytics} commands. This is demonstrated by
  941. the following example, shown in Figure~\ref{eg4}.
  942. X
  943. \singlespace
  944. \begin{verbatim}
  945. X    set terminal latex
  946. X    set output "eg4.tex"
  947. X    set format y "$%g$"
  948. X    set format x "$%.2f$"
  949. X    set title "This is $\sin(x)$"
  950. X    set xlabel "This is the $x$ axis"
  951. X    set ylabel "$\sin(x)$"
  952. X    set nokey
  953. X    set xtics -pi, pi/4
  954. X    plot [-pi:pi] [-1:1] sin(x)
  955. \end{verbatim}
  956. \currentspace
  957. X
  958. \boxfigure{htbp}{\fullboxwidth}{
  959. X  \begin{center}
  960. X    \input{eg4}
  961. X  \end{center}
  962. X  \caption{An example of the {\tt set xtics} command.}
  963. X  \label{eg4}
  964. }
  965. X
  966. Since {\tt pi} is a predefined variable in GNUPLOT, we can use it
  967. anywhere we may use an expression. The {\tt set xtics} command here
  968. specifies that the tics on the $x$ axis start at $-\pi$ and increment
  969. by $\pi/4$. Since no end point is given, the tics continue to the
  970. right edge. We have also turned off the key, and changed the format to
  971. restrict the $x$-axis tic labels to 2 decimal places.
  972. X
  973. With a little more work, the plot can look even better.  Another form
  974. of this command allows us to specify the label and position of each
  975. tic individually.  Replacing the above {\tt set xtics} command with
  976. the following gives us Figure~\ref{eg5}. We also make use of the line
  977. continuation character, the backslash (\verb+\+), to spread out this
  978. command for readability.
  979. X
  980. \singlespace
  981. \begin{verbatim}
  982. X    set xtics ("$-\pi$" -pi,\
  983. X     "$-\frac{\pi}{2}$" -pi/2,\
  984. X     "0" 0,\
  985. X     "$\frac{\pi}{2}$" pi/2,\
  986. X     "$\pi$" pi)
  987. \end{verbatim}
  988. \currentspace
  989. X
  990. \boxfigure{htbp}{\fullboxwidth}{
  991. X  \begin{center}
  992. X    \input{eg5}
  993. X  \end{center}
  994. X  \caption{A fancy example of the {\tt set xtics} command.}
  995. X  \label{eg5}
  996. }
  997. X
  998. \paragraph{Going further:} You should now be able to make a variety of
  999. plots for your \LaTeX\ document. We will present a final example
  1000. without explanation that showcases some of the capabilities of
  1001. GNUPLOT. You may find documentation for the various commands in the
  1002. GNUPLOT manual, though hopefully this example is somewhat
  1003. self-explanatory. This is shown in Figure~\ref{eg6}.
  1004. X
  1005. \singlespace
  1006. \begin{verbatim}
  1007. X    set terminal latex
  1008. X    set output "eg6.tex"
  1009. X    set size 3.5/5, 3/3.
  1010. X    set format y "$%g$"
  1011. X    set format x "$%5.1f\mu$"
  1012. X    set title "This is a title"
  1013. X    set xlabel "This is the $x$ axis"
  1014. X    set ylabel "This is\\a longer\\version\\ of\\the $y$\\ axis"
  1015. X    set label "Data" at -5,-5 right
  1016. X    set arrow from -5,-5 to -3.3,-6.7
  1017. X    set key -4,8
  1018. X    set xtic -10,5,10
  1019. X    plot [-10:10] [-10:10] "eg3.dat" title "Data File"  with linespoints 1 7,\
  1020. X       3*exp(-x*x)+1  title "$3e^{-x^{2}}+1$" with lines 4
  1021. \end{verbatim}
  1022. \currentspace
  1023. X
  1024. \boxfigure{htbp}{\fullboxwidth}{
  1025. X  \begin{center}
  1026. X    \input{eg6}
  1027. X  \end{center}
  1028. X  \caption{An example of many features.}
  1029. X  \label{eg6}
  1030. }
  1031. X
  1032. \paragraph{Line and point types:} For reference, we show all of the
  1033. line and point types available in Figure~\ref{linepoint}.
  1034. X
  1035. \boxfigure{htbp}{\fullboxwidth}{
  1036. X  \begin{center}
  1037. X    \input{linepoint}
  1038. X  \end{center}
  1039. X  \caption{All of the line and point types in the \LaTeX\ driver.}
  1040. X  \label{linepoint}
  1041. }
  1042. X
  1043. \subsection{Summary --- Use with \LaTeX}
  1044. In summary, to use the \LaTeX\ facilities of GNUPLOT, the first
  1045. command to GNUPLOT should be
  1046. \begin{syntax}
  1047. X    set terminal latex
  1048. \end{syntax}
  1049. and the output of GNUPLOT should be directed to a file, for example,
  1050. \begin{verbatim}
  1051. X    set output "plot.tex"
  1052. \end{verbatim}
  1053. This may be anything you like but it should have a {\tt .tex} extension,
  1054. of course. Then the size of the plot should be given. For example, the
  1055. command 
  1056. \begin{verbatim}
  1057. X    set size 1,2
  1058. \end{verbatim}
  1059. tells GNUPLOT to use a 5 inch wide by 6 inch high box for the plot.
  1060. The numbers given are {\em scale factors}, not the actual size.  The
  1061. default is 5 inches by 3 inches.  This is the size of the complete
  1062. plot, including all labels.
  1063. X
  1064. When finished, the file will contain all of the plots you have
  1065. specified (you probably only want one plot per file). This file can
  1066. then be used in a \LaTeX\ document, \eg,
  1067. X
  1068. \singlespace
  1069. \begin{verbatim}
  1070. X    \begin {figure}
  1071. X      \begin{center}
  1072. X        \input{plot}
  1073. X      \end{center}
  1074. X    \end {figure}
  1075. \end{verbatim}
  1076. \currentspace
  1077. This puts the plot into a figure. 
  1078. X
  1079. You will also want to read about the following commands: {\tt set
  1080. title, set xlabel, set ylabel, set key, set label, set xtics, set
  1081. ytics}, and {\tt set clip}.  These are all described in the regular
  1082. GNUPLOT manual.
  1083. X
  1084. \section{Use with EEPIC}
  1085. \label{s:eepic}
  1086. EEPIC is a macro package extending the picture environment of \LaTeX.
  1087. If you have the EPIC or EEPIC macros, and your {\tt dvi} translator
  1088. supports the {\em tpic\/} \verb+\special+s, then you can save \LaTeX\
  1089. memory.  With EEPIC pictures, the {\tt plot.tex} file will be smaller,
  1090. \LaTeX\ will run much faster (and need much less memory), and the {\tt
  1091. dvi} file will be smaller. The quality of the output is about the
  1092. same. If you change the source, you can generate some more interesting
  1093. line styles.
  1094. X
  1095. To use EEPIC, set GNUPLOT's terminal type to {\tt eepic} instead of
  1096. {\tt latex}, and use GNUPLOT as before. The line styles will change.
  1097. Include the file {\tt plot.tex} in your document as before, along with
  1098. the document style options {\tt [epic,eepic]}.
  1099. X
  1100. \section{For Former Gnu\TeX\ Users}
  1101. \label{oldusers}
  1102. X
  1103. Former Gnu\TeX\ users may be pleased with many of the new features
  1104. (many inspired by your suggestions!), but will also find many changes.
  1105. GNUPLOT will {\em not\/} run all Gnu\TeX\ input files unchanged.
  1106. Several Gnu\TeX\ features were not included in GNUPLOT because they
  1107. were specific to the \LaTeX\ driver. I encourage you to use the newer
  1108. GNUPLOT.  A translator is available that attempts to translate your
  1109. old Gnu\TeX\ 1.6 input files into GNUPLOT 3.0 files. You can ftp it
  1110. from \verb+cs.duke.edu+ as \verb+dist/sources/gnuplot/gnut2p.tar.Z+.
  1111. This file also contains directions and a list of changes from Gnu\TeX\
  1112. to GNUPLOT.
  1113. X
  1114. \section{Contact}
  1115. Please contact me at \verb+David.Kotz@Dartmouth.edu+ with any comments you may
  1116. have on GNUPLOT's \LaTeX\ driver. For general GNUPLOT questions, send
  1117. mail to the GNUPLOT mailing list
  1118. (\verb+pixar!info-gnuplot@ucbvax.berkeley.edu+). 
  1119. X
  1120. X
  1121. \end{document}
  1122. SHAR_EOF
  1123. chmod 0644 gnuplot/docs/latextut/tutorial.tex ||
  1124. echo 'restore of gnuplot/docs/latextut/tutorial.tex failed'
  1125. Wc_c="`wc -c < 'gnuplot/docs/latextut/tutorial.tex'`"
  1126. test 16623 -eq "$Wc_c" ||
  1127.     echo 'gnuplot/docs/latextut/tutorial.tex: original size 16623, current size' "$Wc_c"
  1128. rm -f _shar_wnt_.tmp
  1129. fi
  1130. # ============= gnuplot/docs/latextut/linepoint.plt ==============
  1131. if test -f 'gnuplot/docs/latextut/linepoint.plt' -a X"$1" != X"-c"; then
  1132.     echo 'x - skipping gnuplot/docs/latextut/linepoint.plt (File already exists)'
  1133.     rm -f _shar_wnt_.tmp
  1134. else
  1135. > _shar_wnt_.tmp
  1136. echo 'x - extracting gnuplot/docs/latextut/linepoint.plt (Text)'
  1137. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/latextut/linepoint.plt' &&
  1138. # Plots all line types and point types
  1139. set term latex
  1140. set out "linepoint.tex"
  1141. set clip points
  1142. set dummy t,y
  1143. set nokey
  1144. set parametric
  1145. set samples 14     # for trange 0:13, we get 14 points: 0, 1, ..., 13
  1146. set function style lines
  1147. set xtics 1,1,12
  1148. set ytics 1,1,6
  1149. set title "Up to 6 line types and 12 point types"
  1150. set trange [0 : 13]
  1151. set xlabel "Points"
  1152. set xrange [0 : 13]
  1153. set ylabel "Lines"
  1154. set yrange [0 : 7]
  1155. plot t,1, t,2, t,3, t,4, t,5, t,6, 1,t w p, 2,t w p, 3,t w p, 4,t w p,5,t w p, 6,t w p, 7,t w p, 8,t w p, 9,t w p, 10,t w p, 11,t w p, 12,t w p
  1156. SHAR_EOF
  1157. chmod 0644 gnuplot/docs/latextut/linepoint.plt ||
  1158. echo 'restore of gnuplot/docs/latextut/linepoint.plt failed'
  1159. Wc_c="`wc -c < 'gnuplot/docs/latextut/linepoint.plt'`"
  1160. test 550 -eq "$Wc_c" ||
  1161.     echo 'gnuplot/docs/latextut/linepoint.plt: original size 550, current size' "$Wc_c"
  1162. rm -f _shar_wnt_.tmp
  1163. fi
  1164. # ============= gnuplot/docs/titlepage.ms ==============
  1165. if test -f 'gnuplot/docs/titlepage.ms' -a X"$1" != X"-c"; then
  1166.     echo 'x - skipping gnuplot/docs/titlepage.ms (File already exists)'
  1167.     rm -f _shar_wnt_.tmp
  1168. else
  1169. > _shar_wnt_.tmp
  1170. echo 'x - extracting gnuplot/docs/titlepage.ms (Text)'
  1171. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/titlepage.ms' &&
  1172. .nr HM 3.2i
  1173. .TL
  1174. GNUPLOT
  1175. .br
  1176. An Interactive Plotting Program
  1177. .sp
  1178. .AU
  1179. Thomas Williams & Colin Kelley
  1180. .br
  1181. X   Version 3.0 organized by: Gershon Elber
  1182. .br
  1183. X   Version 3.0 major contributors (alphabetic order):
  1184. .br
  1185. X  John Campbell
  1186. .br
  1187. X  Gershon Elber
  1188. .br
  1189. X  David Kotz
  1190. .br
  1191. X  Ed Kubaitis
  1192. .br
  1193. X  Russell Lang
  1194. .br
  1195. X  Tom Tkacik
  1196. .br
  1197. X  Alex Woo
  1198. X
  1199. .AI
  1200. X   Mailing list for comments: pixar!info-gnuplot@sun.com
  1201. .br
  1202. X   Mailing list for bug reports: pixar!bug-gnuplot@sun.com
  1203. \*(DY
  1204. .br
  1205. X
  1206. X
  1207. X
  1208. X
  1209. X
  1210. X
  1211. This manual is for GNUPLOT version 3.0.
  1212. .AB no
  1213. .AE
  1214. .LP
  1215. .nr HM 1.2i
  1216. .ds CH
  1217. .ds LH GNUPLOT 3.0
  1218. .ds RH %
  1219. .\".nr PS 12
  1220. .\".nr VS 13
  1221. SHAR_EOF
  1222. chmod 0644 gnuplot/docs/titlepage.ms ||
  1223. echo 'restore of gnuplot/docs/titlepage.ms failed'
  1224. Wc_c="`wc -c < 'gnuplot/docs/titlepage.ms'`"
  1225. test 599 -eq "$Wc_c" ||
  1226.     echo 'gnuplot/docs/titlepage.ms: original size 599, current size' "$Wc_c"
  1227. rm -f _shar_wnt_.tmp
  1228. fi
  1229. # ============= gnuplot/docs/doc2tex.c ==============
  1230. if test -f 'gnuplot/docs/doc2tex.c' -a X"$1" != X"-c"; then
  1231.     echo 'x - skipping gnuplot/docs/doc2tex.c (File already exists)'
  1232.     rm -f _shar_wnt_.tmp
  1233. else
  1234. > _shar_wnt_.tmp
  1235. echo 'x - extracting gnuplot/docs/doc2tex.c (Text)'
  1236. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/doc2tex.c' &&
  1237. /*
  1238. X * doc2tex.c  -- program to convert Gnuplot .DOC format to LaTeX document
  1239. X * Also will work for VMS .HLP files. 
  1240. X * Modified by Russell Lang from hlp2ms.c by Thomas Williams 
  1241. X * Extended by David Kotz to support quotes ("), backquotes, tables.
  1242. X *
  1243. X * usage:  doc2tex < file.doc > file.tex
  1244. X *
  1245. X *   where file.doc is a Gnuplot .DOC file, and file.tex will be an
  1246. X *     article document suitable for printing with LaTeX.
  1247. X *
  1248. X * typical usage for GNUPLOT:
  1249. X *
  1250. X *   doc2tex < gnuplot.doc > gnuplot.tex 
  1251. X *   latex gnuplot.tex ; latex gnuplot.tex
  1252. X */
  1253. X
  1254. static char rcsid[] = "$Id: doc2tex.c,v 1.1 90/01/11 15:44:06 dfk Exp Locker: dfk $";
  1255. X
  1256. #include <stdio.h>
  1257. #include <ctype.h>
  1258. #ifdef AMIGA_LC_5_1
  1259. #include <string.h>
  1260. #endif
  1261. X
  1262. #define MAX_NAME_LEN    256
  1263. #define MAX_LINE_LEN    256
  1264. #define TRUE 1
  1265. #define FALSE 0
  1266. X
  1267. typedef int boolean;
  1268. X
  1269. boolean intable = FALSE;
  1270. boolean verb = FALSE;
  1271. X
  1272. main()
  1273. {
  1274. X    init(stdout);
  1275. X    convert(stdin,stdout);
  1276. X    finish(stdout);
  1277. X    exit(0);
  1278. }
  1279. X
  1280. X
  1281. init(b)
  1282. FILE *b;
  1283. {
  1284. X    (void) fputs("\\input{titlepage.tex}\n",b);
  1285. }
  1286. X
  1287. X
  1288. convert(a,b)
  1289. X    FILE *a,*b;
  1290. {
  1291. X    static char line[MAX_LINE_LEN];
  1292. X
  1293. X    while (fgets(line,MAX_LINE_LEN,a)) {
  1294. X       process_line(line, b);
  1295. X    }
  1296. }
  1297. X
  1298. process_line(line, b)
  1299. X    char *line;
  1300. X    FILE *b;
  1301. {
  1302. X    switch(line[0]) {        /* control character */
  1303. X       case '?': {            /* interactive help entry */
  1304. X          break;            /* ignore */
  1305. X       }
  1306. X       case '@': {            /* start/end table */
  1307. X          if (intable) {
  1308. X             (void) fputs("\\hline\n\\end{tabular}\n", b);
  1309. X             (void) fputs("\\end{center}\n",b);
  1310. X             intable = FALSE;
  1311. X          } else {
  1312. X             if (verb) {
  1313. X                (void) fputs("\\end{verbatim}\n",b);
  1314. X                verb=FALSE;
  1315. X             } 
  1316. X             (void) fputs("\n\\begin{center}\n", b);
  1317. X             (void) fputs("\\begin{tabular}{|ccl|} \\hline\n", b);
  1318. X             intable = TRUE;
  1319. X          }
  1320. X          /* ignore rest of line */
  1321. X          break;
  1322. X       }
  1323. X       case '#': {            /* latex table entry */
  1324. X          if (intable)
  1325. X            (void) fputs(line+1, b); /* copy directly */
  1326. X          else
  1327. X            fprintf(stderr, "error: # line found outside of table\n");
  1328. X          break;
  1329. X       }
  1330. X       case '%': {            /* troff table entry */
  1331. X          break;            /* ignore */
  1332. X       }
  1333. X       case '\n':            /* empty text line */
  1334. X       case ' ': {            /* normal text line */
  1335. X          if (intable)
  1336. X            break;        /* ignore while in table */
  1337. X          if (line[1] == ' ') {
  1338. X             /* verbatim mode */
  1339. X             if (!verb) {
  1340. X                (void) fputs("\\begin{verbatim}\n",b);
  1341. X                verb=TRUE;
  1342. X             }
  1343. X             (void) fputs(line+1,b); 
  1344. X          } else {
  1345. X             if (verb) {
  1346. X                (void) fputs("\\end{verbatim}\n",b);
  1347. X                verb=FALSE;
  1348. X             } 
  1349. X             if (line[0] == '\n')
  1350. X               puttex(line,b); /* handle totally blank line */
  1351. X             else
  1352. X               puttex(line+1,b);
  1353. X          }
  1354. X          break;
  1355. X       }
  1356. X       default: {
  1357. X          if (isdigit(line[0])) { /* start of section */
  1358. X             if (!intable)    /* ignore while in table */
  1359. X               section(line, b);
  1360. X          } else
  1361. X            fprintf(stderr, "unknown control code '%c' in column 1\n", 
  1362. X                  line[0]);
  1363. X          break;
  1364. X       }
  1365. X    }
  1366. }
  1367. X
  1368. /* process a line with a digit control char */
  1369. /* starts a new [sub]section */
  1370. X
  1371. section(line, b)
  1372. X    char *line;
  1373. X    FILE *b;
  1374. {
  1375. X    static char string[MAX_LINE_LEN];
  1376. X    int sh_i;
  1377. X
  1378. X    if (verb) {
  1379. X       (void) fputs("\\end{verbatim}\n",b);
  1380. X       verb=FALSE;
  1381. X    } 
  1382. #ifdef AMIGA_LC_5_1
  1383. X    (void) sscanf(line,"%d",&sh_i);
  1384. X    strcpy(string,strchr(line,' ')+1);
  1385. X    {
  1386. X      char *p;
  1387. X      p = strchr(string,'\n');
  1388. X      if (p != NULL) *p = '\0';
  1389. X    }
  1390. #else
  1391. X    (void) sscanf(line,"%d %[^\n]s",&sh_i,string);
  1392. #endif
  1393. X    switch(sh_i)
  1394. X     {
  1395. X        case 1: 
  1396. X        (void) fprintf(b,"\\section{");
  1397. X        break;
  1398. X        case 2: 
  1399. X        (void) fprintf(b,"\\section{");
  1400. X        break;
  1401. X        case 3:
  1402. X        (void) fprintf(b,"\\subsection{");
  1403. X        break;
  1404. X        case 4: 
  1405. X        (void) fprintf(b,"\\subsubsection{");
  1406. X        break;
  1407. X        default:
  1408. X        case 5: 
  1409. X        (void) fprintf(b,"\\paragraph{");
  1410. X        break;
  1411. X     }
  1412. X    if (islower(string[0]))
  1413. X     string[0] = toupper(string[0]);
  1414. X    puttex(string,b);
  1415. X    (void) fprintf(b,"}\n");
  1416. }
  1417. X
  1418. /* put text in string str to file while buffering special TeX characters */
  1419. puttex(str,file)
  1420. FILE *file;
  1421. register char *str;
  1422. {
  1423. register char ch;
  1424. static boolean inquote = FALSE;
  1425. X
  1426. X     while( (ch = *str++) != '\0') {
  1427. X         switch(ch) {
  1428. X             case '#':
  1429. X             case '$':
  1430. X             case '%':
  1431. X             case '&':
  1432. X             case '_':
  1433. X             case '{':
  1434. X             case '}':
  1435. X                 (void) fputc('\\',file);
  1436. X                 (void) fputc(ch,file);
  1437. X                 break;
  1438. X             case '\\':
  1439. X                 (void) fputs("$\\backslash$",file);
  1440. X                 break;
  1441. X             case '~':
  1442. X                 (void) fputs("\\~{\\ }",file);
  1443. X                 break;
  1444. X             case '^':
  1445. X                 (void) fputs("\\verb+^+",file);
  1446. X                 break;
  1447. X             case '>':
  1448. X             case '<':
  1449. X             case '|':
  1450. X                 (void) fputc('$',file);
  1451. X                 (void) fputc(ch,file);
  1452. X                 (void) fputc('$',file);
  1453. X                 break;
  1454. X             case '"': 
  1455. X                 /* peek at next character: if space, end of quote */
  1456. X                 if (*str == NULL || isspace(*str) || ispunct(*str))
  1457. X                   (void) fputs("''", file);
  1458. X                 else
  1459. X                   (void) fputs("``", file);
  1460. X                 break;
  1461. X             case '`':    /* backquotes mean boldface */
  1462. X                 if (inquote) {
  1463. X                    fputs("}", file);
  1464. X                    inquote = FALSE;
  1465. X                 } else {
  1466. X                    fputs("{\\bf ", file);
  1467. X                    inquote = TRUE;
  1468. X                 }
  1469. X                 break;
  1470. X             default:
  1471. X                 (void) fputc(ch,file);
  1472. X                 break;
  1473. X         }
  1474. X     }
  1475. }
  1476. X
  1477. X
  1478. finish(b)
  1479. FILE *b;
  1480. {
  1481. X    (void) fputs("\\end{document}\n",b);
  1482. }
  1483. SHAR_EOF
  1484. chmod 0644 gnuplot/docs/doc2tex.c ||
  1485. echo 'restore of gnuplot/docs/doc2tex.c failed'
  1486. Wc_c="`wc -c < 'gnuplot/docs/doc2tex.c'`"
  1487. test 5029 -eq "$Wc_c" ||
  1488.     echo 'gnuplot/docs/doc2tex.c: original size 5029, current size' "$Wc_c"
  1489. rm -f _shar_wnt_.tmp
  1490. fi
  1491. # ============= gnuplot/docs/titlepage.tex ==============
  1492. if test -f 'gnuplot/docs/titlepage.tex' -a X"$1" != X"-c"; then
  1493.     echo 'x - skipping gnuplot/docs/titlepage.tex (File already exists)'
  1494.     rm -f _shar_wnt_.tmp
  1495. else
  1496. > _shar_wnt_.tmp
  1497. echo 'x - extracting gnuplot/docs/titlepage.tex (Text)'
  1498. sed 's/^X//' << 'SHAR_EOF' > 'gnuplot/docs/titlepage.tex' &&
  1499. \documentstyle[toc_entry]{article}
  1500. \setlength{\textwidth}{6.25in}
  1501. \setlength{\oddsidemargin}{0.5cm}
  1502. \setlength{\topmargin}{-0.5in}
  1503. \setlength{\textheight}{9in}
  1504. \setlength{\parskip}{1ex}
  1505. \setlength{\parindent}{0pt}
  1506. \adjustarticle
  1507. \begin{document}
  1508. X
  1509. \pagestyle{empty}
  1510. X   \rule{0in}{3in}
  1511. X   \begin{center}
  1512. SHAR_EOF
  1513. true || echo 'restore of gnuplot/docs/titlepage.tex failed'
  1514. fi
  1515. echo 'End of  part 10'
  1516. echo 'File gnuplot/docs/titlepage.tex is continued in part 11'
  1517. echo 11 > _shar_seq_.tmp
  1518. exit 0
  1519.  
  1520. exit 0 # Just in case...
  1521. -- 
  1522. Kent Landfield                   INTERNET: kent@sparky.IMD.Sterling.COM
  1523. Sterling Software, IMD           UUCP:     uunet!sparky!kent
  1524. Phone:    (402) 291-8300         FAX:      (402) 291-4362
  1525. Please send comp.sources.misc-related mail to kent@uunet.uu.net.
  1526.