git.maemo.org Git - gnuplot/blob - docs/old/README.pic

   1
   2 HOW TO USE PIC driver:
   3
   4
   5 I have tested driver under gnuplot3.2, and I am currently using it
   6 with the reengineered troff, groff, which is distributed by Free
   7 Software Foundation, but it should work for AT&T's DWB as well. As
   8 gpic can produce TeX output, it could possibly be an alternative to
   9 the LaTeX driver for TeX-users having the tpic macros (see the gpic
  10 man page - I don't know much about TeX so please don't ask me about
  11 this).
  12
  13 A simple graph can be formatted using
  14
  15 groff -p -mpic -Tps file.pic > file.ps.
  16
  17 The output from pic can be pipe-lined into eqn, so it is possible to put
  18 complex functions in a graph with the set label and set {x/y}label commands.
  19 For instance,
  20
  21 set ylab '@space 0 int from 0 to x alpha ( t ) roman d t@'
  22
  23 Will lable the y-axis with a nice integral if formatted with the
  24 command:
  25
  26 gpic filename.pic | geqn -d@@ -Tps | groff -m[macro-package] -Tps > filename.ps
  27
  28 Figures made this way can be scaled to fit into a document. The pic
  29 language is easy to understand, so the graphs can be edited by hand if
  30 need be. All coordinates in the pic-file produced by gnuplot are given
  31 as x+gnuplotx and y+gnuploty. By default x and y are given the value 0
  32 If this line is removed with an editor in a number of files one can
  33 put several graphs i one figure like this (default size is 5.0x3.0 inches)
  34
  35 .PS 8.0
  36 x=0;y=3
  37 copy "figa.pic"
  38 x=5;y=3
  39 copy "figb.pic"
  40 x=0;y=0
  41 copy "figc.pic"
  42 x=5;y=0
  43 copy "figd.pic"
  44 .PE
  45
  46 This will produce an 8 inches wide figure with four graphs in two rows
  47 on top of each other
  48
  49 One can also achieve the same thing by the command
  50
  51 set term pic x y
  52
  53 For example, using
  54
  55 .PS 6.0
  56 copy "trig.pic"
  57 .PE
  58
  59 the following session generated a two by two figure with
  60 four graphs:
  61
  62
  63         G N U P L O T
  64         unix version 3.2
  65         patchlevel 2, Mar 24 92
  66         last modified Sat Mar 24 21:08:47 PST 1992
  67
  68 Copyright(C) 1986, 1987, 1990, 1991, 1992  Thomas Williams, Colin Kelley
  69
  70         Send bugs and comments to bug-gnuplot@ames.arc.nasa.gov
  71
  72 Terminal type set to 'x11'
  73 gnuplot> set out 'trig.pic'
  74 gnuplot> set ter pic 0 5
  75 Terminal type set to 'pic'
  76 Options are 'Pic's origin is at (0.000000,5.000000)'
  77 gnuplot> plot sin(x)
  78 gnuplot> set ter pic 5 5
  79 Terminal type set to 'pic'
  80 Options are 'Pic's origin is at (5.000000,5.000000)'
  81 gnuplot> plot cos(x)
  82 gnuplot> set ter pic 0 0
  83 set ter pic 0 0
  84 Terminal type set to 'pic'
  85 Options are 'Pic's origin is at (0.000000,0.000000)'
  86 gnuplot> plot tan(x)
  87 gnuplot> set ter pic 5 0
  88 Terminal type set to 'pic'
  89 Options are 'Pic's origin is at (5.000000,0.000000)'
  90 gnuplot> plot cos(x)/sin(x)
  91 plot cos(x)/sin(x)
  92 gnuplot> quit
  93
  94
  95
  96 Scaling can be done using set size.
  97
  98
  99 I prefer this way of including graphs to using encapsulated in troff
 100 documents, because of the possiblity to preprocess with eqn, and
 101 because pic is much easier to understand than postscript  - at least for me.
 102
 103
 104 WHAT HAS TO BE DONE TO IMPROVE THIS DRIVER
 105
 106 1.) Nice markers
 107
 108 2.) Dot-dashed line styles
 109
 110 3.) Possibly make line thickness an option when set term pic
 111
 112 4.) Making it possible to select fonts for both pic and eqn from
 113     gnuplot's command line.
 114
 115
 116 I am happy to share this piece of software with anyone, in the hope
 117 that it will be useful for at least someone. But taking into account
 118 that it is the very first version of the driver, I would be happy if I
 119 could get into contact with people able to help me improve it.
 120
 121 Mind you: Anything thats free comes with no guarantee!
 122
 123 Good Luck
 124
 125 Sigfrid Lundberg (siglun@volterra.teorekol.lu.se)