home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource5 / 334_01 / gnuplot.doc < prev    next >
Text File  |  1991-02-06  |  60KB  |  1,643 lines
  1. 1 gnuplot
  2. ?
  3.  GNUPLOT is a command-driven interactive function plotting program.  It
  4.  is case sensitive (commands and function names written in lowercase
  5.  are not the same as those written in CAPS).  All command names may be
  6.  abbreviated, as long as the abbreviation is not ambiguous.  Any number
  7.  of commands may appear on a line, separated by semicolons (;). 
  8.  
  9.  Any command-line arguments are assumed to be names of files containing 
  10.  gnuplot commands, with the exception of standard X11 arguments, which
  11.  are processed first. Each file is loaded with the `load` command, in the
  12.  order specified. Gnuplot exits after the last file is processed.
  13.  
  14.  Commands may extend over several input lines, by ending each line but
  15.  the last with a backslash (\). The backslash must be the LAST
  16.  character on each line. The effect is as if the backslash and newline
  17.  were not there. That is, no white space is implied, nor is a comment
  18.  terminated. Therefore, commenting out a continued line comments out
  19.  the entire command (see `comment`).
  20.  
  21.  In this documentation, curly braces ({}) denote optional arguments to
  22.  many commands.
  23.  
  24.  For help on any topic, type 'help' followed by the name of the topic.
  25. 2 cd
  26. ?cd
  27.  The `cd` command changes working directory.
  28.  
  29.  Syntax:
  30.          cd <directory-name>
  31.  
  32.  The directory name must be enclosed in quotes.
  33.  
  34.  Examples:
  35.  
  36.          cd 'subdir'
  37.          cd ".."
  38. 2 clear
  39. ?clear
  40.  The `clear` command erases the current screen or output device as
  41.  specified by `set output`.  This usually generates a formfeed on
  42.  hardcopy devices.  Use `set terminal` to set the device type. 
  43. 2 comment
  44. ?comments
  45.  Comments are supported as follows: a # may appear in most places in a line
  46.  and GNUPLOT will ignore the rest of the line. It will not have this
  47.  effect inside quotes, inside numbers (including complex numbers), inside
  48.  command substitutions, etc. In short, it works anywhere it makes sense
  49.  to work.
  50. 2 environment
  51. ?environment
  52.  A number of shell environment variables are understood by GNUPLOT.
  53.  None of these are required, but may be useful.
  54.  
  55.  If GNUTERM is defined, it is used as the name of the terminal type to
  56.  be used. This overrides any terminal type sensed by GNUPLOT on start
  57.  up, but is itself overridden by the .gnuplot (or equivalent) start-up
  58.  file (see help start-up), and of course by later explicit changes.
  59.  
  60.  On Unix and MS-DOS, GNUHELP may be defined to be the pathname of the 
  61.  HELP file (gnuplot.gih).
  62.  
  63.  On VMS, the symbol GNUPLOT$HELP should be defined as the name of 
  64.  the help library for gnuplot.
  65.  
  66.  On Unix, HOME is used as the name of a directory to search for 
  67.  a .gnuplot file if none is found in the current directory. 
  68.  On MS-DOS, GNUPLOT is used.  On VMS, SYS$LOGIN: is used.  
  69.  See help start-up.  
  70.  
  71.  On Unix, PAGER is used as an output filter for help messages. SHELL
  72.  is used for the `shell` command.
  73.  
  74.  On MS-DOS, COMSPEC is used for the `shell` command. 
  75. 2 exit
  76. ?exit
  77. ?quit
  78.  The commands `exit` and `quit` and your computer's END-OF-FILE character
  79.  will exit GNUPLOT.  All these commands will clear the output device
  80.  (as the `clear` command does) before exiting. 
  81. 2 expressions
  82. ?expressions
  83.  In general, any mathematical expression accepted by C, FORTRAN,
  84.  Pascal, or BASIC is valid.  The precedence of these operators is
  85.  determined by the specifications of the C programming language.
  86.  White space (spaces and tabs) is ignored inside expressions. 
  87.  
  88.  Complex constants may be expressed as the {<real>,<imag>}, where <real>
  89.  and <imag> must be numerical constants.  For example {3,2}
  90.  represents 3 + 2i; {0,1} represents `i` itself. The curly braces 
  91.  are explicitly required here. 
  92. 3 functions
  93. ?expressions functions
  94. ?functions
  95.  The functions in GNUPLOT are the same as the corresponding functions
  96.  in the UNIX math library, except that all functions accept integer,
  97.  real, and complex arguments, unless otherwise noted.  The `sgn`
  98.  function is also supported, as in BASIC. 
  99. @start table
  100. #Function & Arguments & Returns \\ \hline
  101. %Function@Arguments@Returns
  102. %_
  103. 4 abs
  104. ?expressions functions abs
  105. ?functions abs
  106. ?abs
  107. #abs(x) & any  &  absolute value of {\tt x}, $|x|$; same type \\
  108. #abs(x) & complex &  length of {\tt x}, $\sqrt{{\mbox{real}(x)^{2} +
  109. #\mbox{imag}(x)^{2}}}$ \\
  110. %abs(x)@any@absolute value of x, $|x|$; same type 
  111. %abs(x)@complex@length of x, $sqrt{real (x) sup 2 + imag (x) sup 2}$ 
  112.  The `abs` function returns the absolute value of its argument.  The
  113.  returned value is of the same type as the argument. 
  114.  
  115.  For complex arguments, abs(x) is defined as the length of x in the
  116.  complex plane [i.e.,  sqrt(real(x)**2 + imag(x)**2) ].
  117. 4 acos
  118. ?expressions functions acos
  119. ?functions acos
  120. ?acos
  121. #acos(x) & any  & $\cos^{-1} x$ (inverse cosine) in radians \\
  122. %acos(x)@any@$cos sup -1 x$ (inverse cosine) in radians 
  123.  The `acos` function returns the arc cosine (inverse cosine) of its
  124.  argument.  `acos` returns its argument in radians. 
  125. 4 arg
  126. ?expressions functions arg
  127. ?functions arg
  128. ?arg
  129. #arg(x) & complex & the phase of $x$ in radians\\
  130. %arg(x)@complex@the phase of $x$ in radians
  131.  The `arg` function returns the phase of a complex number, in radians.  
  132. 4 asin
  133. ?expressions functions asin
  134. ?functions asin
  135. ?asin
  136. #asin(x) & any  & $\sin^{-1} x$ (inverse sin) in radians \\
  137. %asin(x)@any@$sin sup -1 x$ (inverse sin) in radians 
  138.  The `asin` function returns the arc sin (inverse sin) of its argument.
  139.  `asin` returns its argument in radians. 
  140. 4 atan
  141. ?expressions functions atan
  142. ?functions atan
  143. ?atan
  144. #atan(x) & any  & $\tan^{-1} x$ (inverse tangent) in radians \\
  145. %atan(x)@any@$tan sup -1 x$ (inverse tangent) in radians 
  146.  The `atan` function returns the arc tangent (inverse tangent) of its
  147.  argument.  `atan` returns its argument in radians. 
  148. 4 besj0
  149. ?expressions functions besj0
  150. ?functions besj0
  151. ?besj0
  152. #besj0(x) & radians &  $j_{0}$ Bessel function of $x$ \\
  153. %besj0(x)@radians@$j sub 0$ Bessel function of $x$ 
  154.  The `besj0` function returns the j0th Bessel function of its argument.
  155.  `besj0` expects its argument to be in radians.
  156. 4 besj1
  157. ?expressions functions besj1
  158. ?functions besj1
  159. ?besj1
  160. #besj1(x) & radians & $j_{1}$ Bessel function of $x$ \\
  161. %besj1(x)@radians@$j sub 1$ Bessel function of $x$ 
  162.  The `besj1` function returns the j1st Bessel function of its argument.
  163.  `besj1` expects its argument to be in radians.
  164. 4 besy0
  165. ?expressions functions besy0
  166. ?functions besy0
  167. ?besy0
  168. #besy0(x) & radians & $y_{0}$ Bessel function of $x$ \\
  169. %besy0(x)@radians@$y sub 0$ Bessel function of $x$ 
  170.  The `besy0` function returns the y0th Bessel function of its argument.
  171.  `besy0` expects its argument to be in radians.
  172. 4 besy1
  173. ?expressions functions besy1
  174. ?functions besy1
  175. ?besy1
  176. #besy1(x) & radians & $y_{1}$ Bessel function of $x$ \\
  177. %besy1(x)@radians@$y sub 1$ Bessel function of $x$ 
  178.  The `besy1` function returns the y1st Bessel function of its argument.
  179.  `besy1` expects its argument to be in radians.
  180. 4 ceil
  181. ?expressions functions ceil
  182. ?functions ceil
  183. ?ceil
  184. #ceil(x) & any & $\lceil x \rceil$, smallest integer not less than $x$
  185. #(real part) \\
  186. %ceil(x)@any@$left ceiling x right ceiling$, smallest integer not less than $x$ (real part) 
  187.  The `ceil` function returns the smallest integer that is not less than its
  188.  argument.  For complex numbers, `ceil` returns the smallest integer
  189.  not less than the real part of its argument. 
  190. 4 cos
  191. ?expressions functions cos
  192. ?functions cos
  193. ?cos
  194. #cos(x) & radians & $\cos x$, cosine of $x$ \\
  195. %cos(x)@radians@$cos~x,$ cosine of $x$ 
  196.  The `cos` function returns the cosine of its argument.  `cos` expects its
  197.  argument to be in radians. 
  198. 4 cosh
  199. ?expressions functions cosh
  200. ?functions cosh
  201. ?cosh
  202. #cosh(x) & radians & $\cosh x$, hyperbolic cosine of $x$ \\
  203. %cosh(x)@radians@$cosh~x,$ hyperbolic cosine of $x$ 
  204.  The `cosh` function returns the hyperbolic cosine of its argument.
  205.  `cosh` expects its argument to be in radians. 
  206. 4 exp
  207. ?expressions functions exp
  208. ?functions exp
  209. ?exp
  210. #exp(x) & any & $e^{x}$,  exponential function of $x$ \\
  211. %exp(x)@any@$e sup x$, exponential functio