home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 16 / CD_ASCQ_16_0994.iso / maj / 2199 / graphica.fil < prev    next >
Text File  |  1994-07-09  |  173KB  |  4,766 lines
  1. ≡about
  2. ≡
  3.  ┌──────────────────────────────────────────────────────────────────────┐
  4.  │                            G R A P H I C A                           │
  5.  └──────────────────────────────────────────────────────────────────────┘
  6.  
  7.  Graphica is a command-driven interactive/batch graphics program for
  8.  making presentation quality graphs on a computer.  This two-dimensional
  9.  data plotting system is designed specifically for scientific and
  10.  engineering applications.  Graphica is easy to use, powerful and it
  11.  runs on personal computers, mainframes and workstations.  With Graphica,
  12.  you can:
  13.  
  14.      o   plot data or functions
  15.      o   evaluate and plot mathematical expressions
  16.      o   fit splines, polynomials and smooth data
  17.      o   display and print graphs on hardcopy devices
  18.      o   export graphs in HPGL, PostScript and other output formats
  19.      o   draw text in 11 different fonts, including roman, greek,
  20.          cyrillic and gothic
  21.      o   draw hundreds of specialized symbols
  22.      o   get online help
  23. ≡arc
  24. ≡noarc
  25.  Purpose:
  26.      Draw an Arc
  27.  
  28.  Syntax:
  29.  ┌──────────────────────────────────────────────────────────────────────┐
  30.  │   arc {tag} {center at <x>,<y>}                                      │
  31.  │             {radius <value>}                                         │
  32.  │             {start/end angle <value>}                                │
  33.  │   noarc {tag}                                                        │
  34.  └──────────────────────────────────────────────────────────────────────┘
  35.  
  36.  Description:
  37.  
  38.  This command draws an arc with the given radius starting at angle
  39.  <start angle> and ending at angle <end angle>.
  40.  
  41.  Entering 'arc' by itself simply shows the currently defined arcs.
  42.  
  43.  Examples:
  44.  
  45.      » arc radius 2.0 center at 3.0 4.0 start angle 10 end 45
  46.      » arc center at 2 1 start 23 end 90
  47.      » noarc 4
  48.  
  49.  Also see ARROW, CIRCLE, LABEL, LEGEND, LINE, RECTANGLE and SECTOR.
  50. ≡arrow
  51. ≡noarrow
  52.  Purpose:
  53.      Plot an Arrow at the End of a Line
  54.  
  55.  Syntax:
  56.  ┌──────────────────────────────────────────────────────────────────────┐
  57.  │   arrow {tag} {from sx,sy} {to ex,ey} {len} {ang} {type (1-5)}       │
  58.  │   noarrow {tag}                                                      │
  59.  └──────────────────────────────────────────────────────────────────────┘
  60.  
  61.  Description:
  62.  
  63.  The 'arrow' command is used to draw arrows.  All positions (x,y) default
  64.  to 0,0.  The x and y values are real numbers.  These values can be either
  65.  in paper (inches) or graph coordinate system (mapped) units
  66.  depending on the status of the location flag (see the LOCATION command).
  67.  
  68.  The tag is an integer that may be used to identify a given arrow.
  69.  If no tag is given, the lowest unused tag value is assigned
  70.  automatically.  This tag can be used to delete or change a specific
  71.  arrow.  To change any attribute of an existing arrow, use the arrow
  72.  command with the appropriate tag, and specify the parts of the arrow
  73.  to be changed.
  74.  
  75.  An optional arrow type may be specified.  The default arrow type is
  76.  3 or full.  The available arrow types are:
  77.  
  78.      1           single wing
  79.      2           single wing with a back line
  80.      3           full
  81.      4           full with a half dimension line
  82.      5           full with a dimension line
  83.  
  84.  The arrowhead length and width are 20% and 6% of the total arrow length.
  85.  If the arrowhead length is less than 1/8", it will remain at 1/8"
  86.  regardless of the total arrow length.
  87.  
  88.  Entering 'arrows' by itself simply shows the currently defined arrows.
  89.  
  90.  Examples:
  91.  
  92.  to set an arrow pointing from the origin to (1,2) use:
  93.      » arrow to 1.0,2.0
  94.  
  95.  to set an arrow from (-10,4) to (-5,5), and tag the arrow number 3, use:
  96.      » arrow 3 from -10,4 to -5,5
  97.  
  98.  to change the preceding arrow begin at 1.1,1.3, use:
  99.      » arrow 3 from 1.1,1.3
  100.  
  101.  to delete arrow number 2 use:
  102.      » noarrow 2
  103.  
  104.  to delete all arrows use:
  105.      » noarrow
  106.  
  107.  Also See:
  108.      CIRCLE, LINE and RECTANGLE.
  109.  
  110. ≡audit
  111.  Purpose:
  112.      Set Command Trace
  113.  
  114.  Syntax:
  115.  ┌──────────────────────────────────────────────────────────────────────┐
  116.  │   audit {'filename'}                                                 │
  117.  └──────────────────────────────────────────────────────────────────────┘
  118.  
  119.  Description:
  120.  
  121.  This command makes a copy of all your input commands into the given
  122.  filename.  You may later use it as a 'load' or 'input' file.
  123.  
  124.  Examples:
  125.  
  126.      » audit 'trace.dat'
  127.      » audit
  128.  
  129.  in the latter case, a file called 'graphica.odt' will contain a trace
  130.  of anything entered at the command line after entering 'audit'.
  131. ≡autoscale
  132. ≡noautoscale
  133.  Purpose:
  134.      Set Axis Autoscaling
  135.  
  136.  Syntax:
  137.  ┌──────────────────────────────────────────────────────────────────────┐
  138.  │   autoscale {x,y,y2,x2}                                              │
  139.  │   noautoscale                                                        │
  140.  └──────────────────────────────────────────────────────────────────────┘
  141.  
  142.  Description:
  143.  
  144.  Frequently, it is difficult for the user to select suitable axis limits
  145.  and step sizes, especially if the data being plotted varies greatly from
  146.  one execution of the program to the next.  For this reason Graphica
  147.  provides automatic axis scaling for all axes as the default.
  148.  
  149.  The autoscale command sets the autoscaling feature for an axis.  If an
  150.  axis is not autoscaled, the default or current map is used when data is
  151.  plotted.
  152.  
  153.  Entering 'autoscale' by itself simply shows the currently defined scaling.
  154.  
  155.  Examples:
  156.  
  157.      » autoscale x
  158.      » noautoscale
  159.  
  160.  Another example.  Suppose you have a data file with two columns of data,
  161.  x and y but don't know their ranges.  You could do the following:
  162.  
  163.      » data 'mydata.dat'
  164.      » draw data
  165.      » plot x y
  166.  
  167.  and determine how the data looks.  The axes are autoscaled.  Then you could
  168.  say,
  169.  
  170.      » noaxes
  171.      » map x 0 100 y 30 200
  172.  
  173.  where the mapped range would be your own values and then,
  174.  
  175.      » draw x y
  176.  
  177.  would draw the axes with the desired mapped range.
  178. ≡noaxes
  179. ≡axes
  180.  Purpose:
  181.      Show, Delete All Axes
  182.  
  183.  Syntax:
  184.  ┌──────────────────────────────────────────────────────────────────────┐
  185.  │   axes                                                               │
  186.  │   noaxes                                                             │
  187.  └──────────────────────────────────────────────────────────────────────┘
  188.  
  189.  Description:
  190.  
  191.  The 'noaxes' command will delete any previously specified axes, so the
  192.  effect is as if the axes had never been drawn.  It is very useful for one
  193.  important reason:  Graphica maintains a list in memory of all the axes that
  194.  have been drawn on the same page.  For example, if you had 2 graphs on one
  195.  page and needed to get a hardcopy, Graphica would have to keep track of
  196.  where everything is so that it could give you an exact reproduction on
  197.  paper of what you had on your screen.  The 'noaxes' command effectively
  198.  wipes out all traces of previously drawn axes and lets you start anew.
  199.  
  200.  Entering 'axes' by itself simply shows the currently defined axes.
  201.  
  202.  Examples:
  203.      » axes
  204.      » noaxes
  205. ≡background
  206.  Purpose:
  207.      Specify Background Color
  208.  
  209.  Syntax:
  210.  ┌──────────────────────────────────────────────────────────────────────┐
  211.  │   background {color} {integer}/<name>                                │
  212.  └──────────────────────────────────────────────────────────────────────┘
  213.  
  214.  Description:
  215.  
  216.  Sets the background color.  See the PEN COLOR command for more
  217.  details about the colors available to use with this command.
  218.  
  219.  Entering 'background' by itself simply shows the currently defined
  220.  background color.  The default background color is 'black'.
  221.  
  222.  Examples:
  223.  
  224.      » background 3
  225.      » back red
  226. ≡beep
  227. ≡nobeep
  228.  Purpose:
  229.      Toggle Beep On and Off
  230.  
  231.  Syntax:
  232.  ┌──────────────────────────────────────────────────────────────────────┐
  233.  │   beep                                                               │
  234.  │   nobeep                                                             │
  235.  └──────────────────────────────────────────────────────────────────────┘
  236.  
  237.  Description:
  238.  
  239.  These two commands are used to toggle Graphica beeps on and off.
  240.  The default is on.
  241.  
  242.  Examples:
  243.  
  244.      » beep
  245.  
  246.  activates the beep when the screen has been drawn or when there is an error.
  247.  
  248.      » nobeep
  249.  
  250.  turns beeping off.
  251. ≡character
  252. ≡fonts
  253. ≡character fonts
  254.  Purpose:
  255.      Set Character Font and Attributes
  256.  
  257.  Syntax:
  258.  ┌──────────────────────────────────────────────────────────────────────┐
  259.  │   character {gap,ratio,size,slant} <value>                           │
  260.  │   character {font} <integer>                                         │
  261.  └──────────────────────────────────────────────────────────────────────┘
  262.  
  263.  Description:
  264.  
  265.  This command sets character attributes such as the font type,
  266.  character gap, ratio, size and slant.
  267.  
  268.  A font is a collection of characters with a unified design.  The 'font'
  269.  command defines the font style for characters.  Characters may be
  270.  hardware or software generated.  The default font style is 1 which is a
  271.  software generated character.  The software generated character fonts are
  272.  based on a database originally created by Dr. A.V. Hershey while working at
  273.  the U.S. National Bureau of Standards.  They have been reorganized and
  274.  classified into several groups following the ASCII set.  The font sets
  275.  currently implemented are:
  276.  
  277.      font 1 = simplex roman
  278.      font 2 = simplex greek
  279.      font 3 = complex roman
  280.      font 4 = complex greek
  281.      font 5 = complex cyrillic
  282.  
  283.  and for registered users ten more:
  284.  
  285.      font 6 = simplex script
  286.      font 7 = complex script
  287.      font 8 = triplex roman
  288.      font 9 = gothic german
  289.      font 10 = gothic english
  290.      font 11 = gothic italian
  291.      font 12 = symbols I
  292.      font 13 = symbols II
  293.      font 14 = symbols II
  294.      font 15 = symbols IV
  295.  
  296.  Entering 'character' by itself simply shows the currently defined
  297.  character specs.
  298.  
  299.  The font files have to be somewhere in your DOS path.  Alternatively,
  300.  you may specify an environment variable called GRAPFONT containing the
  301.  font directory.  For example, if your fonts are in C:\GRAPHICA\FONTS,
  302.  then you would specify,
  303.  
  304.      SET GRAPFONT=C:\GRAPHICA\FONTS
  305.  
  306.  somewhere in your autoexec.bat file or in a batch file just before
  307.  running Graphica.  (Font files have the names YY**.BIN where ** is a
  308.  number from 01 to 15.)
  309.  
  310.  Extended character sets:
  311.  ------------------------
  312.  
  313.  Fonts 1 and 3 (simplex roman and complex roman) include "extended
  314.  ascii" characters.  This means that you can draw some more characters
  315.  without changing the font.  For example, A with an "umlaut" (two dots)
  316.  is ASCII 143, a with a circle on top of it is 134, etc.  The extended
  317.  set is by no means complete yet but I'm getting there.  It maps the
  318.  MSDOS Multilingual (Latin I) code page set from ASCII 127 to 212 (so
  319.  far, with a few missing symbols).  To use characters from the extended
  320.  set, lookup TEXT in this help system.
  321.  
  322.  Examples:
  323.  
  324.      » character size 0.15 ratio 0.6
  325.      » char gap 0.2 slant -10
  326.      » character font 2
  327.      » font 3
  328.  
  329.  This last command specifies a font of complex roman style.
  330.  
  331.  Also see CHARACTER FONT, CHARACTER GAP, CHARACTER RATIO, CHARACTER SIZE,
  332.  CHARACTER SLANT, SUBSCRIPT, SUPERSCRIPT, TEXT and ENVIRONMENT.
  333. ≡character gap
  334. ≡gap
  335.  Purpose:
  336.      Change the Character Gap
  337.  
  338.  Syntax:
  339.  ┌──────────────────────────────────────────────────────────────────────┐
  340.  │   character gap <value>                                              │
  341.  └──────────────────────────────────────────────────────────────────────┘
  342.  
  343.  Description:
  344.  
  345.  The character gap attribute defines the spacing between adjacent
  346.  characters in a text string, in the direction of the character path.
  347.  The character gap is defined as a fraction of the average character box
  348.  size.  The default gap of 0.0 implies that adjacent character boxes are
  349.  to be abutting.  A gap of 1.0 implies that a gap, equivalent to the
  350.  size of the average character box, is to be inserted between adjacent
  351.  characters along the path.  A gap of -0.5 implies that character boxes
  352.  are to partially overlap.
  353.  
  354.  Example:
  355.  
  356.      » character gap 1.0
  357. ≡character ratio
  358. ≡ratio
  359.  Purpose:
  360.      Change the Character Ratio
  361.  
  362.  Syntax:
  363.  ┌──────────────────────────────────────────────────────────────────────┐
  364.  │   character ratio <value>                                            │
  365.  └──────────────────────────────────────────────────────────────────────┘
  366.  
  367.  Description:
  368.  
  369.  Specifies the ratio of the width of the character to its height.  The
  370.  default character ratio is 1.0.
  371.  
  372.  Example:
  373.  
  374.      » character ratio 0.8
  375. ≡character size
  376.  Purpose:
  377.      Change the Character Size
  378.  
  379.  Syntax:
  380.  ┌──────────────────────────────────────────────────────────────────────┐
  381.  │   character size <value>                                             │
  382.  └──────────────────────────────────────────────────────────────────────┘
  383.  
  384.  Description:
  385.  
  386.  The character size attribute defines the vertical size of the
  387.  characters in default units (in, cm, mm).  Graphica sets the default
  388.  character size of all strings and labels to 0.17 in.
  389.  
  390.  Example:
  391.  
  392.      » character size 0.2
  393. ≡character slant
  394. ≡slant
  395.  Purpose:
  396.      Set the Character Slant
  397.  
  398.  Syntax:
  399.  ┌──────────────────────────────────────────────────────────────────────┐
  400.  │   character slant <value>                                            │
  401.  └──────────────────────────────────────────────────────────────────────┘
  402.  
  403.  Description:
  404.  
  405.  Specifies the number of degrees the characters tilt from the vertical.
  406.  The sign convention for the direction of rotation is as follows:
  407.  
  408.      + clockwise
  409.      - counterclockwise
  410.  
  411.  The default character slant is 0.0 degrees.
  412.  
  413.  Example:
  414.  
  415.      » character slant 25
  416. ≡cd
  417.  Purpose:
  418.      Change the Working Directory
  419.  
  420.  Syntax:
  421.  ┌──────────────────────────────────────────────────────────────────────┐
  422.  │   cd <directory-name>                                                │
  423.  └──────────────────────────────────────────────────────────────────────┘
  424.  
  425.  Description:
  426.  
  427.  The 'cd' command changes the working directory to the directory specified
  428.  by <directory-name>.
  429.  
  430.  Examples:
  431.  
  432.      » cd c:\work
  433.      » cd ..
  434.      » cd c:\work\examples
  435. ≡circle
  436. ≡nocircle
  437.  Purpose:
  438.      Draw a Circle
  439.  
  440.  Syntax:
  441.  ┌──────────────────────────────────────────────────────────────────────┐
  442.  │   circle {tag} {center at <x>,<y>} {radius <value>} {filled/nofill}  │
  443.  │   nocircle {tag}                                                     │
  444.  └──────────────────────────────────────────────────────────────────────┘
  445.  
  446.  Description:
  447.  
  448.  This command draws a circle with the given radius in user default
  449.  units at the given position (also in user default units).
  450.  
  451.  Entering 'circles' by itself simply shows the currently defined circles.
  452.  
  453.  Examples:
  454.  
  455.      » circle radius 2.0 center at 3.0 4.0
  456.      » circle 4 center at 2 1 filled
  457.      » nocircle 3
  458.  
  459.  Also see ARC, ARROW, LABEL, LEGEND, LINE, RECTANGLE and SECTOR.
  460. ≡clc
  461.  Purpose:
  462.      Clear Text Screen
  463.  
  464.  Syntax:
  465.  ┌──────────────────────────────────────────────────────────────────────┐
  466.  │   clc                                                                │
  467.  └──────────────────────────────────────────────────────────────────────┘
  468.  
  469.  Description:
  470.  
  471.  The 'clc' command erases the current text screen.
  472.  
  473.  Example:
  474.  
  475.      » clc
  476.  
  477.  See also CLEAR and DEFAULT.
  478. ≡clear
  479.  Purpose:
  480.      Erase Output Device
  481.  
  482.  Syntax:
  483.  ┌──────────────────────────────────────────────────────────────────────┐
  484.  │   clear                                                              │
  485.  └──────────────────────────────────────────────────────────────────────┘
  486.  
  487.  Description:
  488.  
  489.  The 'clear' command erases the current graphics screen or output device
  490.  as specified by output.  It also resets all internal flags to the default
  491.  state found when entering Graphica, i.e. no axes, no frame, default map,
  492.  etc.  This usually generates a formfeed on hardcopy devices.
  493.  
  494.  Example:
  495.  
  496.      » clear
  497.  
  498.  See also CLC and DEFAULT.
  499. ≡column
  500.  Purpose:
  501.      Assign Data Columns to Axes
  502.  
  503.  Syntax:
  504.  ┌──────────────────────────────────────────────────────────────────────┐
  505.  │   column <integer> {is} {x,y,y2,x2}                                  │
  506.  └──────────────────────────────────────────────────────────────────────┘
  507.  
  508.  Description:
  509.  
  510.  This powerful command allows the assignment of any data column read
  511.  from a user file to a certain axis.
  512.  
  513.  Entering 'columns' by itself simply shows the currently defined columns.
  514.  
  515.  Examples:
  516.  
  517.       » column 3 y2
  518.       » column 2 is x 1 is y
  519.  
  520.  assigns column 3 of a data file to the x-axis and column 1 to the y-axis.
  521.  Then plot x y add points will generate a graph of column 3 versus column 1.
  522.  
  523.  Also see PLOT.
  524. ≡comment
  525.  Purpose:
  526.      Ignore the Rest of a Line
  527.  
  528.  ┌──────────────────────────────────────────────────────────────────────┐
  529.  │   comments                                                           │
  530.  └──────────────────────────────────────────────────────────────────────┘
  531.  
  532.  Comments are supported as follows:  a '#' (hatch) may appear in most
  533.  places in a line and Graphica will ignore the rest of the line.  It
  534.  will not have this effect inside quotes or inside numbers (including
  535.  complex numbers).
  536.  
  537.  Examples:
  538.  
  539.      » # test file
  540.      » echo               # echo all commands from here on out
  541.      » # map axes
  542.      » map x 0 10 y 0 10  # this is the map command
  543. ≡contributions
  544.  ┌──────────────────────────────────────────────────────────────────────┐
  545.  │ GRAPHICA Copyright (c) 1992-94 Antonio Montes.  All rights reserved. │
  546.  └──────────────────────────────────────────────────────────────────────┘
  547.  
  548.  GRAPHICA is shareware and as such is NOT FREE for use in a business,
  549.  commercial, government, or institutional environment.  Registration
  550.  of GRAPHICA for personal (not at the office) use is optional.  If you
  551.  like this program and find it useful, you can support its continued
  552.  development by sending me a contribution of NFL 55 (dutch guilders)
  553.  or US$30 (US dollars).  Your financial support is needed to encourage
  554.  further improvements to GRAPHICA.  Business, commercial, government,
  555.  or institutional GRAPHICA users must register GRAPHICA after a 30-day
  556.  evaluation period.  If you want to see additional features in GRAPHICA,
  557.  please send in a contribution.  Feel free to contact me for any reason.
  558.  
  559.  ┌──────────────────────────────────────────────────────────────────────┐
  560.  │   Antonio Montes      Internet address: tony@amontes.oss.nl          │
  561.  │   Postbus 13          CompuServe ID: 71031,1162                      │
  562.  │   2350 AA Leiderdorp                                                 │
  563.  │   The Netherlands                                                    │
  564.  └──────────────────────────────────────────────────────────────────────┘
  565. ≡data
  566. ≡file
  567.  Purpose:
  568.      Read Data from Terminal or a File
  569.  
  570.  Syntax:
  571.  ┌──────────────────────────────────────────────────────────────────────┐
  572.  │   data {from} {file} {'filename'} {autox}                            │
  573.  │            x(1) y(1)                                                 │
  574.  │            x(2) y(2)                                                 │
  575.  │            x(3) y(3)                                                 │
  576.  │              .    .                                                  │
  577.  │            x(n) y(n)                                                 │
  578.  │   end                                                                │
  579.  └──────────────────────────────────────────────────────────────────────┘
  580.  
  581.  Description:
  582.  
  583.  Discrete data contained in a file can displayed by specifying the name
  584.  of a data file (enclosed in quotes) on the plot command line.  Using the
  585.  'data' command simply reads in the data from a file, without plotting it.
  586.  
  587.  If the data to be plotted is on a data file already, then the command
  588.  'data {from} {file}' opens the data file and reads data points.
  589.  
  590.  Data files may contain one or more data points per line.  If more than
  591.  one data point is encountered on a line, the data points in a given
  592.  column are referred to as columns.  If just one value is given on a
  593.  line, the program will use the number of the coordinate as the x value.
  594.  Coordinate numbers start at 1 and are incremented for each data point
  595.  read.
  596.  
  597.  Lines beginning with # will be treated as comments and ignored.
  598.  Graphica will also ignore anything within two double quotes before
  599.  data on a line.
  600.  
  601.  Numbers can be separated by a comma or one or more blanks (free format).
  602.  There is no limit to the number of data points possible (well, until
  603.  memory is exhausted.)  Optionally, data pairs read interactively can be
  604.  put on a single input line.  You can't input multiple columns of data
  605.  interactively, just two columns.
  606.  
  607.  In data files, up to 20 columns of data can be read in on a line.  These
  608.  data can in turn be assigned to different axes with the COLUMN command
  609.  later on.
  610.  
  611.  Specifying 'autox' will result in the automatic assignment of the x
  612.  values starting from 1.  In other words, you may read in one or more
  613.  columns of y data only and Graphica will assign the x values for you.
  614.  
  615.  It is possible to have several sets of data one after another in the
  616.  same data file.  Simply separate the sets with blank lines:  Graphica
  617.  will read each set in sequence and plot the curves one after another.
  618.  This way you won't need a bunch of data filenames in one script file:
  619.  just put all the data in one data file separated by blank lines.
  620.  
  621.  Also see COLUMN and MISSING.
  622.  
  623.  Examples:
  624.  
  625.  Interactive data input:
  626.  
  627.      » data                   # interactive data input only
  628.      » 1.0,10.0 2.0,20.0 3.0,30.0 4.0,40.0 5.0,50.0
  629.      » end
  630.  
  631.  Data file input:
  632.  
  633.      » data 'gel3.dat'
  634.      » data file 'comfil'
  635.      » data 'test.dat' autox
  636.  
  637.  In this last example, if 'test.dat' contained only one column of data
  638.  (the y values), x would be assigned automatically by Graphica.
  639. ≡default
  640.  Purpose:
  641.      Reset Parameter Settings to a Default State
  642.  
  643.  Syntax:
  644.  ┌──────────────────────────────────────────────────────────────────────┐
  645.  │   default <parameter>                                                │
  646.  └──────────────────────────────────────────────────────────────────────┘
  647.  
  648.  Description:
  649.  
  650.  The 'default' command resets parameter settings to their default value.
  651.  The available parameters are:
  652.  
  653.      all
  654.      character
  655.      division
  656.      map
  657.      tic
  658.      unit
  659.  
  660.  Examples:
  661.  
  662.      » default all
  663.  
  664.  resets all the above parameters to their default value.  Graphica does
  665.  the equivalent of 'default all' at startup or when a 'paper size'
  666.  command is given.
  667.  
  668.      » def map
  669.  
  670.  resets all axes mapping to the default state.
  671.  
  672.  Also see CLEAR.
  673. ≡del
  674. ≡delete
  675. ≡rm
  676.  Purpose:
  677.      Delete a File
  678.  
  679.  Syntax:
  680.  ┌──────────────────────────────────────────────────────────────────────┐
  681.  │   del <file>                                                         │
  682.  │   rm <file>                                                          │
  683.  └──────────────────────────────────────────────────────────────────────┘
  684.  
  685.  Description:
  686.  
  687.  The 'del' command deletes a file.  Pathnames, wildcards, and drive
  688.  designators may be used in the usual way for your operating system.
  689.  Other operating system commands can be issued using the $ character
  690.  followed by a command.  'rm' is the equivalent UNIX command.
  691.  
  692.  Examples:
  693.  
  694.      » del script.plt
  695.  
  696.  deletes the ASCII file script.plt.
  697.  
  698.      » del foo
  699.  
  700.  deletes the ASCII file foo.
  701.  
  702.  Also see DIR, SHELL, TYPE and WHAT.
  703. ≡digitize
  704.  Purpose:
  705.      Establish an x-y Position
  706.  
  707.  Syntax:
  708.  ┌──────────────────────────────────────────────────────────────────────┐
  709.  │   digitize                                                           │
  710.  └──────────────────────────────────────────────────────────────────────┘
  711.  
  712.  Description:
  713.  
  714.  Establish the (x,y) coordinates of a point on the plot.  This position is
  715.  relative to the graphic origin (0,0), the lower left hand corner of the
  716.  paper on which the plot appears, and is given is the default unit system.
  717.  
  718.  If the mouse driver is loaded and your graphics card supports it (I
  719.  can only make it work with VGA), a crosshair will appear and you may
  720.  move it around by moving your mouse.  By pressing any mouse button the
  721.  point will be digitized.  If the mouse can't be used, the keyboard
  722.  (up/down/left/right) arrow keys will let you move a cross-hair around
  723.  until you hit the enter (or return) key.  Pressing H or D will half or
  724.  double the cursor step size.
  725.  
  726.  Example:
  727.  
  728.      » digitize
  729.  
  730.  will give you the coordinates of the point on which the cursor was on the
  731.  plot before you pressed return, in inches, cm or mm.
  732. ≡dir
  733. ≡ls
  734.  Purpose:
  735.      List Files
  736.  
  737.  Syntax:
  738.  ┌──────────────────────────────────────────────────────────────────────┐
  739.  │   dir <file>                                                         │
  740.  │   ls <file>                                                          │
  741.  └──────────────────────────────────────────────────────────────────────┘
  742.  
  743.  Description:
  744.  
  745.  The 'dir' command lists the files and subdirectories in a directory.
  746.  Pathnames, wildcards, and drive designators may be used in the usual way
  747.  for your operating system.  Other operating system commands can be issued
  748.  using the $ character on the very first position of a line followed by a
  749.  command.  'ls' is the equivalent UNIX command.
  750.  
  751.  Examples:
  752.  
  753.      » dir
  754.  
  755.  lists all files in the current directory.
  756.  
  757.      » dir *.plt
  758.  
  759.  lists all files with an extension of .plt in the current directory.
  760.  
  761.  Also see DEL, SHELL, TYPE and WHAT.
  762. ≡display
  763. ≡nodisplay
  764.  Purpose:
  765.      Toggle Mouse/Cursor Location
  766.  
  767.  Syntax:
  768.  ┌──────────────────────────────────────────────────────────────────────┐
  769.  │   display                                                            │
  770.  │   nodisplay                                                          │
  771.  └──────────────────────────────────────────────────────────────────────┘
  772.  
  773.  Description:
  774.  
  775.  This command shuts off the display of the mouse position on DOS systems
  776.  at the bottom right corner of the screen in graphics mode.
  777. ≡divisions
  778.  Purpose:
  779.      Set Number of Major and Minor Axis Divisions
  780.  
  781.  Syntax:
  782.  ┌──────────────────────────────────────────────────────────────────────┐
  783.  │   divisions {x,y,y2,x2} <major> <minor>                              │
  784.  └──────────────────────────────────────────────────────────────────────┘
  785.  
  786.  Description:
  787.  
  788.  Graphica draws a tic at each axis value (major tic) and other tic marks
  789.  in between (minor tics).
  790.  
  791.  The 'divisions' command determines the number of major and minor tic
  792.  marks.  These two numbers must be integers.  Major and minor tic marks
  793.  are one less than the total number of divisions for a particular axis.
  794.  For example, if the x-axis range is 0 to 25, a good selection for major
  795.  divisions would be 5.  The major tic marks will appear at 5, 10, 15,
  796.  and 20.  5 could be chosen as the number of minor divisions.  This
  797.  results in four minor tic marks between two major ones.  The default
  798.  divisions are 5 and 2.
  799.  
  800.  Entering 'divisions' by itself simply shows the currently defined divisions.
  801.  
  802.  Example:
  803.  
  804.      » divisions x 6,3 y 4,2
  805. ≡draw
  806.  Purpose:
  807.      Draw an Axis
  808.  
  809.  Syntax:
  810.  ┌──────────────────────────────────────────────────────────────────────┐
  811.  │   draw {x,y,y2,x2} {mask} {reflect}                                  │
  812.  └──────────────────────────────────────────────────────────────────────┘
  813.  
  814.  Description:
  815.  
  816.  Draws the specified axis with the given range, tic size and number of
  817.  divisions.  The key words 'x,x2,y,y2' may be followed by two optional
  818.  key words, 'mask' and/or 'reflect'.  If 'mask' is specified, that axis
  819.  is drawn with the major and minor tic marks but with no numbers or
  820.  label.  If the 'reflect' option is used, a mirror image of that axis is
  821.  drawn.  The 'reflect' option doesn't apply when ORIGIN is used.
  822.  
  823.  Example:
  824.  
  825.      » draw x reflect y reflect
  826.  
  827.  draws the x and y axes with opposite mirror images.
  828.  
  829.  Note:  You may draw more than one axis of the same kind by suitably
  830.  changing the subplot area.
  831. ≡dummy
  832.  Purpose:
  833.      Specify Dummy Variables
  834.  
  835.  Syntax:
  836.  ┌──────────────────────────────────────────────────────────────────────┐
  837.  │   dummy <dummy-var-1> <dummy-var-2>                                  │
  838.  └──────────────────────────────────────────────────────────────────────┘
  839.  
  840.  Description:
  841.  
  842.  By default, Graphica assumes that the independent variable for the
  843.  'plot' command line is 'x'.  These variables are called the dummy variable
  844.  because it is just a notation to indicate the independent variable.  The
  845.  'dummy' command changes the default dummy variable names.  For example,
  846.  you may find it more convenient to call the dummy variable 't' when
  847.  plotting time functions.
  848.  
  849.  Entering 'dummy' by itself simply shows the currently defined dummy
  850.  variables.
  851.  
  852.  Examples:
  853.  
  854.      » dummy t
  855.      » dummy u,v
  856.  
  857.  See also FUNCTIONS and WHO.
  858. ≡dump
  859.  Purpose:
  860.      Generate Hardcopy Output
  861.  
  862.  Syntax:
  863.  ┌──────────────────────────────────────────────────────────────────────┐
  864.  │   dump {device-type} {'filename'}                                    │
  865.  └──────────────────────────────────────────────────────────────────────┘
  866.  
  867.  Description:
  868.  
  869.  Generates hardcopy output into a file.  The available device types are:
  870.  
  871.           epson, epsf, gif, hpgl, hpgl2, lj2, lj4, pcx, pic,
  872.           postscript and tif
  873.  
  874.  If the filename is omitted, Graphica will use a default filename of the
  875.  form 'graphica.xxx' where xxx is one of:
  876.  
  877.           prn, eps, gif, hpg, lj2, lj4, pcx, pic, ps, tif
  878.  
  879.  depending on the chosen device type.  If the device type is missing and
  880.  you have defined the environment variable GRAPDUMP, then this device will
  881.  be used.  A device type specified on the command line overrides any device
  882.  type previously specified in GRAPDUMP.  You will get an error message if
  883.  Graphica can't find a device type somewhere (either in the environment or
  884.  on the command line.)
  885.  
  886.  If you wish to dump directly to a device, there are two options.  First,
  887.  you can dump to a file and then use the OS command $ to perform a copy
  888.  to a printer or plotter.  The second option is not to use the dump command,
  889.  but to use the OUTPUT command and then do a SHOW.  Both achieve the same
  890.  purpose.  Let's illustrate both on the DOS version:
  891.  
  892.      » dump postscript
  893.      » $copy graphica.ps prn
  894.  
  895.  or
  896.  
  897.      » (do some graphics on screen)
  898.      » output prn
  899.      » term postscript
  900.      » show
  901.  
  902.  This last example would 'redraw' everything in PostScript to the printer
  903.  specified by prn.
  904.  
  905.  Examples:
  906.  
  907.      » dump hpgl 'plotter.dat'
  908.  
  909.  generates a file called plotter.dat containing HPGL commands.  You may
  910.  send this file directly to an HP plotter or import it into another
  911.  program which accepts HPGL commands, such as WordPerfect, Ventura
  912.  Publisher, etc.
  913.  
  914.      » dump hpgl
  915.  
  916.  does the same thing except it dumps the output to 'graphica.hpg'.
  917.  
  918.      » dump 'plotter.dat' hpgl
  919.  
  920.  same effect as the first example.
  921.  
  922.      » dump
  923.  
  924.  In this case, if GRAPDUMP=post, a postscript file will be generated,
  925.  but you will get an error message otherwise.
  926.  
  927.      » dump post "graph.ps" color
  928.  
  929.  generates a PostScript file called 'graph.ps' for color printers.
  930.  
  931.  On DOS systems,
  932.  
  933.      » dump epson
  934.  
  935.  generates a binary file called 'graphica.prn' which you may send to an
  936.  Epson-compatible printer (after you're out of Graphica or by 'shelling'
  937.  out to DOS) by typing:
  938.  
  939.      C:\>copy/b graphica.prn lpt1:
  940.  
  941.  The resolution of this plot is 512 x 768 pixels on a 9-pin dot-matrix
  942.  printer.
  943.  
  944.  Also see ENVIRONMENT, HPGL, LASERJET, OUTPUT, TERMINAL and POSTSCRIPT.
  945. ≡echo
  946. ≡noecho
  947.  Purpose:
  948.      Echo Typed Commands
  949.  
  950.  Syntax:
  951.  ┌──────────────────────────────────────────────────────────────────────┐
  952.  │   echo                                                               │
  953.  │   noecho                                                             │
  954.  └──────────────────────────────────────────────────────────────────────┘
  955.  
  956.  Description:
  957.  
  958.  The 'echo' command causes all input typed at the terminal or picked up
  959.  from a load file to be displayed at the terminal.  This is useful with
  960.  a load file because progress can be monitored.  The default is 'noecho.'
  961.  
  962.  Examples:
  963.  
  964.      » echo
  965.  
  966.  switches echoing on
  967.  
  968.      » noecho
  969.  
  970.  switches echoing off.
  971. ≡quit
  972. ≡exit
  973.  Purpose:
  974.      Exit Graphica
  975.  
  976.  Syntax:
  977.  ┌──────────────────────────────────────────────────────────────────────┐
  978.  │   exit                                                               │
  979.  │   quit                                                               │
  980.  └──────────────────────────────────────────────────────────────────────┘
  981.  
  982.  Description:
  983.  
  984.  The commands 'exit' and 'quit' will terminate Graphica.  These commands
  985.  will clear the output device (as the clear command does) before exiting.
  986.  If this command is used in a script file, program execution halts
  987.  immediately.  Do not use this command until you really want to exit the
  988.  program.
  989.  
  990.  Example:
  991.  
  992.      » exit
  993.  
  994.  and you will be back at the command line prompt.
  995. ≡exponent
  996. ≡noexponent
  997.  Purpose:
  998.      Select Between Fixed or Exponential Format in Log Labels
  999.  
  1000.  Syntax:
  1001.  ┌──────────────────────────────────────────────────────────────────────┐
  1002.  │   exponent                                                           │
  1003.  │   noexponent                                                         │
  1004.  └──────────────────────────────────────────────────────────────────────┘
  1005.  
  1006.  Description:
  1007.  
  1008.  Use this option to select either a fixed or exponential format for
  1009.  logarithmic axis tic mark labels.
  1010.  
  1011.  Exponential format is displayed as the number 10 with an exponent.  For
  1012.  example, the value 0.001 will be displayed as 10 to the power -3 on a log
  1013.  axis with exponential format.
  1014.  
  1015.  Example:
  1016.  
  1017.      » exponent
  1018.  
  1019.  Also see FORMAT.
  1020. ≡format
  1021.  Purpose:
  1022.      Specify Number of Decimal Places in an Axis Label
  1023.  
  1024.  Syntax:
  1025.  ┌──────────────────────────────────────────────────────────────────────┐
  1026.  │   format {x,y,y2,x2} <integer>                                       │
  1027.  │   format {x,y,y2,x2} ({"<lab>"} <pos> {, {"<lab>"} <pos>}...)        │
  1028.  │   format {log} n                                                     │
  1029.  │   format {long} {short}                                              │
  1030.  └──────────────────────────────────────────────────────────────────────┘
  1031.  
  1032.  Description:
  1033.  
  1034.  The main 'format' command controls the format of numbers plotted next
  1035.  to the major tic marks.  The parameter in angle brackets indicates the
  1036.  number of digits drawn after the decimal point.  A -1 or 0 causes the
  1037.  numbers to be displayed in integer format.  The default value for the
  1038.  number of digits to the right of the decimal point is 1.
  1039.  
  1040.  The ("<label>" <pos>, ...) format allows non-numeric tic labels.  Each
  1041.  set of tics can have an optional label.  The label is a string enclosed
  1042.  by quotes, such as "hello".  The label may even be empty.  You have to
  1043.  include the ( and ) for the non-numeric tic labels to work.  Of course,
  1044.  the corresponding axis will have to be mapped properly for user-defined
  1045.  labels to work.  That is, if you map the y axis from -10 to -5 and
  1046.  specify "format y ("one" 1, "two" 2), you'll get labels like "-10",
  1047.  etc. instead of "one", "two", etc.  User-defined tic labels only work
  1048.  in linear or square root axes.
  1049.  
  1050.  For logarithmic axes, 'format log' controls how often major and minor
  1051.  tic marks should be labeled.  Enter a frequency of:
  1052.  
  1053.     n = 1     to label all minor tics and all major tics
  1054.     n = 2     to label even minor tics and all major tics
  1055.     n = 3     to label minor tics 2 and 5, and all major tics
  1056.     n = 4     to label minor tic 3, and all major tics
  1057.     n = 5     to label only major tics.
  1058.  
  1059.  The result of any Graphica assignment statement is displayed on the
  1060.  screen.  The numeric display format can be controlled using the
  1061.  'format' command.  The default format, called the 'short' format, shows
  1062.  approximately 5 significant decimal digits.  For the 'long' format
  1063.  (approx. 15 digits) the last significant digit may appear to be
  1064.  incorrect but the output is actually an accurate representation of the
  1065.  binary number stored in the computer.
  1066.  
  1067.  Entering 'format' by itself simply shows the currently defined formats.
  1068.  
  1069.  Examples:
  1070.  
  1071.      » format x 2 y 3
  1072.  
  1073.  In this example, the x-axis labels will be printed with 2 decimal
  1074.  points and the y-axis labels with 3.
  1075.  
  1076.      » format x ("Jan" 1, "Feb" 2, "Mar" 3)
  1077.      » format y ("bottom" 0, "" 10, "top" 20)
  1078.  
  1079.  Here, we're using the user-defined axis labels.  "Jan" will be printed
  1080.  instead of a "1", "Feb" instead of 2, and "Mar" instead of 3.  In the
  1081.  second example, the label "bottom" will appear at the "0" position, and
  1082.  "top" will appear at the "20" position.
  1083.  
  1084.      » format log 2
  1085.  
  1086.  in this case, the even minor tic marks will be labeled (2,4,6,8) for
  1087.  each log cycle.
  1088.  
  1089.      » a = 4./3.
  1090.      » format short
  1091.      » print a
  1092.  
  1093.      a = 1.33333
  1094.  
  1095.      » format long
  1096.      » print a
  1097.  
  1098.      a = 1.333333333333333
  1099.  
  1100.  Also see EXPONENT.
  1101. ≡frame
  1102. ≡noframe
  1103.  Purpose:
  1104.      Draw a Frame
  1105.  
  1106.  Syntax:
  1107.  ┌──────────────────────────────────────────────────────────────────────┐
  1108.  │   frame                                                              │
  1109.  │   noframe                                                            │
  1110.  └──────────────────────────────────────────────────────────────────────┘
  1111.  
  1112.  Description:
  1113.  
  1114.  This command draws a frame around the subplot area.  'noframe' cancels
  1115.  this effect.
  1116.  
  1117.  Example:
  1118.  
  1119.      » frame
  1120.  
  1121.  produces a frame around the subplot area.
  1122. ≡terminal gif
  1123. ≡terminal pcx
  1124. ≡terminal tif
  1125. ≡dump gif
  1126. ≡dump pcx
  1127. ≡dump tif
  1128. ≡gif
  1129. ≡pcx
  1130. ≡tif
  1131.  Purpose:
  1132.      Dump graphics in GIF, PCX or TIF formats
  1133.  
  1134.  Syntax:
  1135.  ┌──────────────────────────────────────────────────────────────────────┐
  1136.  │   dump {gif,pcx,tif} {low,med,high,75,100,150,300}                   │
  1137.  └──────────────────────────────────────────────────────────────────────┘
  1138.  
  1139.  Description:
  1140.  
  1141.  GIF files were originally developed by CompuServe as a machine
  1142.  independent image file format.  PCX files were originally created by
  1143.  ZSoft for use by their painting packages and can be read by almost
  1144.  all MS-DOS paint software and desktop publishing software.
  1145.  
  1146.  Graphica's GIF, PCX and TIF drivers can output 16-color graphs in five
  1147.  different resolutions: low (75 dpi), 100 dpi, medium (150 dpi), 200
  1148.  dpi and high (300 dpi).  The default is 75 dpi, corresponding to
  1149.  640x480 pixels.  The higher resolutions are, respectively, 1100x825,
  1150.  1600x1200, 2200x1650 and 3200x2400.
  1151.  
  1152.  It can take a little while to generate output at the higher
  1153.  resolutions but Graphica can handle it, especially if you have
  1154.  EMS/XMS (disk space will work, too).
  1155.  
  1156.  Examples:
  1157.  
  1158.      » dump gif
  1159.      » dump tif "graph.tif" med
  1160.      » dump pcx high
  1161.  
  1162.  Also see TERMINAL.
  1163. ≡grace
  1164.  Purpose:
  1165.      Specifiy a Grace Margin within the Subplot Area
  1166.  
  1167.  Syntax:
  1168.  ┌──────────────────────────────────────────────────────────────────────┐
  1169.  │   grace <value>                                                      │
  1170.  └──────────────────────────────────────────────────────────────────────┘
  1171.  
  1172.  Description:
  1173.  
  1174.  Graphica assumes that data points are in range if they fall within the
  1175.  subplot area.  To give the user a little leeway, Graphica allows a grace
  1176.  margin on all axes of the subplot area before it definitely declares a
  1177.  data point to be out of range and refuses to plot it.
  1178.  
  1179.  The 'grace' command lets you specify a grace margin around the subplot
  1180.  area in default units.  The default is 0.0, i.e. data points falling
  1181.  outside the subplot area are clipped by the software.  The grace margin
  1182.  can also be negative.
  1183.  
  1184.  Example:
  1185.  
  1186.      » grace 0.2
  1187.  
  1188.  would allow data to be plotted within a rectangular area 0.2 inches
  1189.  larger on each size of the subplot area.
  1190. ≡grid
  1191. ≡nogrid
  1192.  Purpose:
  1193.      Toggle Grid Flag
  1194.  
  1195.  Syntax:
  1196.  ┌──────────────────────────────────────────────────────────────────────┐
  1197.  │   grid {pen {style} <integer>} {color <integer>/name}                │
  1198.  │   nogrid                                                             │
  1199.  └──────────────────────────────────────────────────────────────────────┘
  1200.  
  1201.  Description:
  1202.  
  1203.  You may specify whether or not to put a set of horizontal and vertical
  1204.  reference lines on a plot at the same points as the axis tic marks.
  1205.  The grid may make it easier to read values off and may improve plot
  1206.  appearance.
  1207.  
  1208.  The 'grid' command sets an internal flag that signals the axis drawing
  1209.  routine to generate a grid.  'nogrid' cancels this effect for subsequent
  1210.  axis draws.  The 'pen' and 'color' keywords may be specified to change
  1211.  the appearance of the grid.  The defaults are:
  1212.  
  1213.      nogrid, pen = current pen style + 2, color = red.
  1214.  
  1215.  Examples:
  1216.  
  1217.      » grid
  1218.      » draw x
  1219.  
  1220.      » grid pen 2 color 3
  1221.  
  1222.      » grid color cyan
  1223. ≡help
  1224.  Purpose:
  1225.      Provide Online Help
  1226.  
  1227.  Syntax:
  1228.  ┌──────────────────────────────────────────────────────────────────────┐
  1229.  │   help <topic>                                                       │
  1230.  └──────────────────────────────────────────────────────────────────────┘
  1231.  
  1232.      Invoking the HELP utility
  1233.      -------------------------
  1234.  The HELP utility displays information about requested Graphica topics.
  1235.  From the Graphica command level (in response to the > prompt), you can
  1236.  display a list of topics for which help information is available by
  1237.  typing HELP (or ?) and pressing the RETURN key.  The system responds by
  1238.  displaying a brief description of Graphica, followed by a list of
  1239.  topics for which help is available, followed by the prompt "topic?".
  1240.  
  1241.      Specifying topic names
  1242.      ----------------------
  1243.  To display information on a particular topic, respond to the prompt by
  1244.  typing the name of the topic and pressing the RETURN key.
  1245.  
  1246.      Subtopic information
  1247.      --------------------
  1248.  The information displayed by HELP on a particular topic includes a
  1249.  description of the topic and a list of subtopics that further describe
  1250.  the topic.  To display subtopic information, type one of the subtopic
  1251.  names from the list in response to the "subtopic?" prompt.
  1252.  
  1253.      Special responses to prompts
  1254.      ----------------------------
  1255.  If you press RETURN in response to the "subtopic?" prompt instead of
  1256.  typing a subtopic name, the "topic?" prompt reappears,  enabling you to
  1257.  enter another topic name.  If you press RETURN in response to the
  1258.  "topic?" prompt, you will exit from HELP.  You can also exit HELP by
  1259.  pressing 'q' or ESC (escape key) at the "press any key to continue"
  1260.  prompt.
  1261.  
  1262.  You can type a question mark (?) in response to any of the prompts to
  1263.  redisplay the most recently requested text and a list of topic or
  1264.  subtopic names.  For example, if you type ? in response to the
  1265.  "subtopic?" prompt, a list of subtopics is displayed followed by the
  1266.  "subtopic?" prompt.
  1267.  
  1268.  Examples:
  1269.  
  1270.      » help subplot
  1271.      » help ?
  1272.      » help
  1273.  
  1274.  Also see ENVIRONMENT and STARTUP.
  1275. ≡dump hpgl
  1276. ≡terminal hpgl
  1277. ≡hpgl
  1278. ≡hpgl2
  1279.  Purpose:
  1280.      Hewlett-Packard Graphics Language
  1281.  
  1282.  Syntax:
  1283.  ┌──────────────────────────────────────────────────────────────────────┐
  1284.  │   terminal {hpgl,hpgl2}                                              │
  1285.  └──────────────────────────────────────────────────────────────────────┘
  1286.  
  1287.  Description:
  1288.  
  1289.  The hpgl device driver can also output HPGL-2 commands.  This is
  1290.  especially useful when you'd like filled symbols on the plotter.
  1291.  I haven't implemented filled symbols in software yet.  Any HPGL-2
  1292.  commands sent to an hpgl plotter like the HP7475 (or a program
  1293.  that understands hpgl) will be ignored.
  1294.  
  1295.  Examples:
  1296.  
  1297.      » term hpgl
  1298.      » dump hpgl "graph1.hpg"
  1299.      » dump hpgl2 "graph2.hpg"
  1300.  
  1301.  Also see DUMP, OUTPUT and TERMINAL.
  1302. ≡labels
  1303. ≡titles
  1304. ≡nolabels
  1305.  Purpose:
  1306.      Draw a Label
  1307.  
  1308.  Syntax:
  1309.  ┌──────────────────────────────────────────────────────────────────────┐
  1310.  │   label {top,bottom,right,left} "label text"                         │
  1311.  │   label {tag} "label_text" {at <x>,<y>} {justification} {<angle>}    │
  1312.  │   label {origin} <integer>                                           │
  1313.  │   title "title text"                                                 │
  1314.  │   nolabel {tag}                                                      │
  1315.  └──────────────────────────────────────────────────────────────────────┘
  1316.  
  1317.  Description:
  1318.  
  1319.  Draw a label.  By default, the text is placed flush left against point (x,y).
  1320.  If you want to adjust the way the label is positioned with respect to the
  1321.  point (x,y), add the parameter <justification>, which may be 'start',
  1322.  'stop' or 'center'.  This indicates that the point is to be at the
  1323.  left, right or center of the text.  The <justification> may be
  1324.  abbreviated.
  1325.  
  1326.  The top label lies above the plot frame line.  The bottom label is
  1327.  drawn below the frame.  'start', 'center' and 'stop' cause the
  1328.  program to halt for pen positioning if a label position was not
  1329.  specified.  The start label is drawn left-justified.  The center
  1330.  label is centered around (x,y) and the stop label is right-justified.
  1331.  the top and bottom labels are centered and each subsequent label goes
  1332.  either above or below the previously drawn label.  The label will be
  1333.  drawn at an 'angle'from the horizontal.
  1334.  
  1335.  'tag' is an integer that is used to identify the label.  If no tag
  1336.  is given, the lowest unused tag value is assigned automatically.  The
  1337.  tag can be used to delete or change a specific label.  To change any
  1338.  attribute of an existing label, use the label command with the
  1339.  appropriate tag, and specify the parts of the label to be changed.
  1340.  
  1341.  The 'xlabel' command is equivalent to the label bottom command (and so
  1342.  are the 'x2label', 'ylabel' and 'y2label' commands equivalent to the
  1343.  label top, left and right commands.)
  1344.  
  1345.  Entering just 'labels' or 'titles' simply shows the currently defined
  1346.  labels and titles.
  1347.  
  1348.  Examples:
  1349.  
  1350.  to set a label at (1,2) to "y=x" use:
  1351.      » label "y=x" at 1,2
  1352.  
  1353.  to set a label "y=x^2" with the right of the text at (2,3), and
  1354.  tag the label number 3, use:
  1355.      » label 3 "y=x≡U2" at 2,3 stop
  1356.  
  1357.  to change the preceding label to center justification, use:
  1358.      » label 3 center
  1359.  
  1360.  to delete label number 2 use:
  1361.      » nolabel 2
  1362.  
  1363.  to delete all labels use:
  1364.      » nolabel
  1365. ≡dump laserjet
  1366. ≡laserjet
  1367. ≡lj2
  1368. ≡lj4
  1369.  Purpose:
  1370.      LaserJet Hardcopy
  1371.  
  1372.  Syntax:
  1373.  ┌──────────────────────────────────────────────────────────────────────┐
  1374.  │   terminal {lj2,lj4} {low,med,high} {us,a4}                          │
  1375.  └──────────────────────────────────────────────────────────────────────┘
  1376.  
  1377.  Description:
  1378.  
  1379.  The LaserJet II driver can output graphs in five resolutions: 75 dpi
  1380.  (low), 100 dpi, 150 dpi (medium), 200 dpi and 300 dpi (high).  The
  1381.  LaserJet 4 can also print graphs in six resolutions: 75, 100, 150 (low),
  1382.  200, 300 (medium) and 600 dpi (high).
  1383.  
  1384.  The 'us' and 'a4' switches are used by the driver to select the
  1385.  correct paper tray size installed in the printer.  The default is
  1386.  'a4' for a paper size of 210 mm by 297 mm.  The 'us' paper tray has
  1387.  dimensions of 8.5 by 11 in.
  1388.  
  1389.  Examples:
  1390.  
  1391.      » term lj2 med
  1392.      » dump lj2 "graph1.lj2" med
  1393.      » dump lj4 high us
  1394.  
  1395.  Also see DUMP, OUTPUT and TERMINAL.
  1396. ≡legends
  1397.  Purpose:
  1398.      Draw a Legend
  1399.  
  1400.  Syntax:
  1401.  ┌──────────────────────────────────────────────────────────────────────┐
  1402.  │   legend {framed} {offset <value>} {left} {center}                   │
  1403.  │          {right} {flat} {stacked} {at <x>,<y>}                       │
  1404.  │          "legend string"                                             │
  1405.  │          {pen {style} {width} <integer>}                             │
  1406.  │          {length {value}}                                            │
  1407.  │          {symbol {<integer>}/{name}}                                 │
  1408.  │          {{pen} color {<integer>}/{name}}                            │
  1409.  │   end                                                                │
  1410.  └──────────────────────────────────────────────────────────────────────┘
  1411.  Description:
  1412.  
  1413.  This command places a legend at a digitized location.  This location
  1414.  is (x,y) default units away from the lower left hand corner of the
  1415.  current page size.  If a line pattern is specified a small segment of
  1416.  the line is drawn before the text.  If a symbol is specified, that
  1417.  symbol is drawn before the text.  'pen', 'length', 'symbol' and 'color'
  1418.  can be specified in any order.
  1419.  
  1420.  The 'color' command applies to the entire group (line segment, symbol
  1421.  and text) but the 'pen style' and 'pen width' commands apply only to
  1422.  the line segment and the symbol, not the text.  The text style and
  1423.  width will be those in effect just before the legend was specified.  If
  1424.  you want a legend with thick letters, specify 'pen width 3' before the
  1425.  'legend' command.
  1426.  
  1427.  The 'legend' command processes information until the word 'end' is
  1428.  encountered.  'left', 'center' and 'right' are keywords to place the
  1429.  whole legend (lines, symbols and text) at that relative given position.
  1430.  
  1431.  'offset' specifies the separation between lines in a given legend in
  1432.  multiples of the current character size.  The default is 2.5 times the
  1433.  character size.
  1434.  
  1435.  'length' specifies the length of the line drawn, if one has been asked
  1436.  for with the 'pen' keyword.  It is in default paper units (inches).
  1437.  
  1438.  'framed' places a frame around the legend.  This frame is also a
  1439.  masked area.  So if you draw a legend first, then anything drawn "over"
  1440.  the legend will effectively be masked out.  You can only have one
  1441.  "masked" area (see MASK).
  1442.  
  1443.  'flat' is a keyword used to draw all the legend information in one
  1444.  line (Lotus-style).  The default mode of operation is 'stacked'.
  1445.  
  1446.  Entering 'legends' by itself simply shows the currently defined legends.
  1447.  
  1448.  Examples:
  1449.  
  1450.      » legend framed at 2.0 3.0
  1451.      » 'This is one line with a symbol' symbol square
  1452.      » color 3 'This second line is in another color'
  1453.      » pen 4 length 1.0 'one inch line'
  1454.      » end
  1455.  
  1456.      » legend center at 5.0,4.0
  1457.      » symb 1 'experimental data set 1'
  1458.      » symb 2 'experimental data set 2'
  1459.      » pen 3 'simulation results'
  1460.      » end
  1461.  
  1462.      » legend center at 5.0,4.0 flat framed
  1463.      » pen 1 'data 1'
  1464.      » pen 2 'data 2'
  1465.      » end
  1466.  
  1467.  This last example draws all the legend information on one line as
  1468.  compared to the other two examples above which draw stacked legends.
  1469.  
  1470.  Also see the example script files 'legend.plt' and 'flat.plt' for
  1471.  more examples.
  1472. ≡lines
  1473. ≡nolines
  1474.  Purpose:
  1475.      Draw a Line
  1476.  
  1477.  Syntax:
  1478.  ┌──────────────────────────────────────────────────────────────────────┐
  1479.  │   line {<tag>} {from <sx>,<sy>} {to <ex>,<ey>}                       │
  1480.  │   noline {<tag>}                                                     │
  1481.  └──────────────────────────────────────────────────────────────────────┘
  1482.  
  1483.  Description:
  1484.  
  1485.  This command is used to make more complicated diagrams by specifying
  1486.  each line to be drawn.  The linked list so created may be corrected and
  1487.  modified by specifying new coordinates.  'noline tag' eliminates the
  1488.  line from the list.  The coordinates can also be mapped units.  Just
  1489.  precede the 'line' command by a 'location mapped' command.
  1490.  
  1491.  Entering 'lines' by itself simply shows the currently defined lines.
  1492.  
  1493.  Examples:
  1494.  
  1495.      » line from 3,4 to 6,8
  1496.      » line 2 to 3,5
  1497.  
  1498.  this last command modifies line number 2 to end at (3,5).
  1499.  
  1500.  See also LINETO and MOVETO.
  1501. ≡lineto
  1502.  Purpose:
  1503.      Draw a Line to a Location
  1504.  
  1505.  Syntax:
  1506.  ┌──────────────────────────────────────────────────────────────────────┐
  1507.  │   lineto <ex>,<ey>                                                   │
  1508.  └──────────────────────────────────────────────────────────────────────┘
  1509.  
  1510.  Description:
  1511.  
  1512.  This command draws a line from the current cursor location to the
  1513.  specified location.  The coordinates can also be mapped units.  Just
  1514.  precede the 'lineto' command by a 'location mapped' command.
  1515.  
  1516.  Entering 'lineto' by itself simply shows the currently defined lines.
  1517.  
  1518.  Example:
  1519.  
  1520.      » moveto 3,4
  1521.      » lineto 6,8.5
  1522.  
  1523.  moves the cursor to a point (3,4) inches away from the origin and
  1524.  draws a line to point (6,8.5).
  1525.  
  1526.  See also LINE and MOVETO.
  1527. ≡load
  1528. ≡batch
  1529.  Purpose:
  1530.      Specify an Input File
  1531.  
  1532.  Syntax:
  1533.  ┌──────────────────────────────────────────────────────────────────────┐
  1534.  │   load <filename>                                                    │
  1535.  └──────────────────────────────────────────────────────────────────────┘
  1536.  
  1537.  Description:
  1538.  
  1539.  The 'load' command executes each command line of the specified input
  1540.  file as if they had been typed in interactively.  Files created by
  1541.  the 'audit' command can later be loaded.  Any text file containing
  1542.  valid commands can be created and then executed by the 'load'
  1543.  command.  Files being loaded may themselves contain 'load' commands.
  1544.  The 'load' command must be the last command on the line.  The name of
  1545.  the input file must be enclosed in single or double quotes if there
  1546.  are any non-character elements in the name, e.g.  file.dat has a dot
  1547.  in it so you must enclose it in quotes.
  1548.  
  1549.  You may also enter a script file directly at the DOS or UNIX command
  1550.  line prompt.  Or, you can enter the name of the script file without
  1551.  the .PLT extension at the Graphica command line.  In general, if you
  1552.  input the name of something to GRAPHICA, for example 'whoa', the
  1553.  GRAPHICA interpreter goes through the following steps:
  1554.  
  1555.      1) looks to see if 'whoa' is a variable
  1556.      2) checks to see if 'whoa' is a function or variable definition
  1557.      3) checks if 'whoa' is a built-in command
  1558.      4) checks to see if 'whoa' is an expression
  1559.      5) looks in the current directory (or search path on DOS systems)
  1560.         for a script file named 'whoa.plt'
  1561.  
  1562.  Note: If you have a script file called 'spline.plt' and simply enter
  1563.  'spline' at the command line, you'll be executing the spline command
  1564.  rather than calling in the 'spline.plt' script file.
  1565.  
  1566.  Examples:
  1567.  
  1568.      » load 'work.plt'
  1569.      » load "function.plt"
  1570.      » my.plt
  1571.      » myplot
  1572.  
  1573.  The 'load' command is performed implicitly on any file names given as
  1574.  arguments to Graphica.  These are loaded in the order specified, and
  1575.  then Graphica switches to interactive mode.  For example,
  1576.  
  1577.      C:\GRAPH\graphica myown.plt
  1578.  
  1579.  will load Graphica, execute the script file myown.plt and, after a key
  1580.  is pressed, switch to the > command line.  To simply exit to the OS,
  1581.  enter q or Q.  Notice how quotes are not needed to specify data files
  1582.  at the OS command line level.  You may specify more than one file as
  1583.  arguments to Graphica,
  1584.  
  1585.      C:\GRAPH\graphica first.plt second.plt
  1586. ≡location
  1587.  Purpose:
  1588.      Specify Mapped Positions
  1589.  
  1590.  Syntax:
  1591.  ┌──────────────────────────────────────────────────────────────────────┐
  1592.  │   location {default,mapped}                                          │
  1593.  └──────────────────────────────────────────────────────────────────────┘
  1594.  
  1595.  Description:
  1596.  
  1597.  This command allows giving mapped (x,y) positions in commands like
  1598.  'arrow', 'circle', 'label', 'legend', 'line', and 'rectangle'.
  1599.  
  1600.  Examples:
  1601.  
  1602.      » location mapped
  1603.  
  1604.  turns a flag on so that the (x,y) location is interpreted as being in
  1605.  mapped units.
  1606.  
  1607.      » location default
  1608.  
  1609.  turns the flag off so that the (x,y) location is interpreted as being
  1610.  in user default units (inches, for example, which is the default.)
  1611.  
  1612.  'location' by itself gives the status of this flag.
  1613. ≡map
  1614. ≡nomap
  1615.  Purpose:
  1616.      Specify the Limits of an Axis
  1617.  
  1618.  Syntax:
  1619.  ┌──────────────────────────────────────────────────────────────────────┐
  1620.  │   map {x,y,y2,x2,t} <min> <max>                                      │
  1621.  │   nomap                                                              │
  1622.  └──────────────────────────────────────────────────────────────────────┘
  1623.  
  1624.  Description:
  1625.  
  1626.  The command 'map' defines the ranges of the data for the generation
  1627.  of axes.  These values determine the numbers that appear along the
  1628.  axes.  The x range specifies a range for the bottom x-axis, the x2
  1629.  range for the top x-axis, the y range is for the left y-axis and the
  1630.  y2 range for the right y-axis.  If this command is not specified the
  1631.  subplot area is mapped automatically from the minimum and maximum
  1632.  (x,y) data values entered with the data command.  (This latter
  1633.  procedure will only map the (x,y) axes, not the (x2,y2) axes.)  The
  1634.  mapping of 't' is used in polar plots only.
  1635.  
  1636.  Mapping can be turned off with the command 'nomap'.
  1637.  
  1638.  Entering 'map' by itself simply shows the currently mapped axes.
  1639.  
  1640.  Examples:
  1641.  
  1642.      » map x 0,10 y 0.0,100.0
  1643.      » map y2 25,-10 x 100,200
  1644.      » map t 0 3*pi
  1645.  
  1646.  See also PARAMETRIC, POLAR, and PLOT.
  1647. ≡mask
  1648.  Purpose:
  1649.      Specify a Masking Area
  1650.  
  1651.  Syntax:
  1652.  ┌──────────────────────────────────────────────────────────────────────┐
  1653.  │   mask {area} {on} {off} {<x1>,<y1>,<x2>,<y2>}                       │
  1654.  │   nomask                                                             │
  1655.  └──────────────────────────────────────────────────────────────────────┘
  1656.  
  1657.  Description:
  1658.  
  1659.  The 'mask' command defines a masking area.  Nothing is drawn over the
  1660.  masked area if it is currently active.  The 'legend' command for
  1661.  example, creates a mask over the specified legend block and no points
  1662.  or lines are drawn over it.  Use 'nomask' to turn masking off or 'mask
  1663.  on'/'mask off' to toggle the mask status.
  1664.  
  1665.  Entering 'mask' by itself simply shows the currently defined mask.
  1666.  
  1667.  Examples:
  1668.  
  1669.      » mask 2,3 5,8
  1670.      » nomask
  1671.      » mask on
  1672.      » mask off
  1673. ≡memory
  1674.  Purpose:
  1675.      Memory Left
  1676.  
  1677.  Syntax:
  1678.  ┌──────────────────────────────────────────────────────────────────────┐
  1679.  │   memory                                                             │
  1680.  └──────────────────────────────────────────────────────────────────────┘
  1681.  
  1682.  Description:
  1683.  
  1684.  The 'memory' command gives the number of bytes left in system RAM in
  1685.  the DOS version of Graphica compiled with Borland C++.  Other versions
  1686.  of Graphica compiled in 32-bit environments (Coherent, WATCOM C, etc.)
  1687.  do not implement this command for obvious reasons (it's not needed).
  1688.  
  1689.  Example:
  1690.  
  1691.      » mem
  1692.  
  1693.  would give you the following message:
  1694.  
  1695.      System RAM available:   378,588 bytes.
  1696. ≡moveto
  1697.  Purpose:
  1698.      Move Cursor To Location
  1699.  
  1700.  Syntax:
  1701.  ┌──────────────────────────────────────────────────────────────────────┐
  1702.  │   moveto <sx>,<sy>                                                   │
  1703.  └──────────────────────────────────────────────────────────────────────┘
  1704.  
  1705.  Description:
  1706.  
  1707.  This command moves the graphics cursor to the specified location.
  1708.  The coordinates can also be mapped units.  Just precede the 'moveto'
  1709.  command by a 'location mapped' command.
  1710.  
  1711.  Entering 'moveto' by itself simply shows the currently defined lines.
  1712.  
  1713.  Example:
  1714.  
  1715.      » moveto 3.3,4
  1716.      » lineto 6.2,8
  1717.  
  1718.  moves the cursor to a point (3.3,4) inches away from the origin and
  1719.  draws a line to point (6.2,8).
  1720.  
  1721.  See also LINE and LINETO.
  1722. ≡origin
  1723. ≡noorigin
  1724.  Purpose:
  1725.      Specify Axis Origin
  1726.  
  1727.  Syntax:
  1728.  ┌──────────────────────────────────────────────────────────────────────┐
  1729.  │   origin {x,y} {axis} <other coordinate value>                       │
  1730.  │   noorigin                                                           │
  1731.  └──────────────────────────────────────────────────────────────────────┘
  1732.  
  1733.  Description:
  1734.  
  1735.  The normal plot style is to have the data plotted in a box.  It is
  1736.  possible to cause either the x or y-axis, or both, to be drawn in such
  1737.  a way that they cross at an arbitrary value.  Unless told otherwise,
  1738.  Graphica will always draw the axes with their origin values at the
  1739.  physical origin (left bottom side of the graph).
  1740.  
  1741.  The origin command specifies the axis origin in user defined coordinates.
  1742.  
  1743.  Entering 'origin' by itself simply shows the currently defined axis origins.
  1744.  
  1745.  Examples:
  1746.  
  1747.      » origin x 0 y 0
  1748.      » origin x axis 0
  1749.      » norigin
  1750. ≡output
  1751.  Purpose:
  1752.      Specify Output Unit
  1753.  
  1754.  Syntax:
  1755.  ┌──────────────────────────────────────────────────────────────────────┐
  1756.  │   output {<filename>} {stdout} {com} {prn}                           │
  1757.  └──────────────────────────────────────────────────────────────────────┘
  1758.  
  1759.  Description:
  1760.  
  1761.  By default, plots are displayed to the standard output (stdout).  The
  1762.  'output' command redirects the display to the specified file or device.
  1763.  The filename must be enclosed in quotes.  If the filename is omitted,
  1764.  output will be sent to the standard output.
  1765.  
  1766.  If you're sending output to the communications port (DOS version), make
  1767.  sure you have configured your serial port with the 'mode' command.  For
  1768.  example,
  1769.  
  1770.      mode com1:96,n,8,1,p
  1771.  
  1772.  configures a serial port for use at 9600-baud, with no parity checking,
  1773.  8 bits per character, one stop bit, and with retries.  Graphica can
  1774.  only use the 'com1:' port for output when using 'output com'.
  1775.  
  1776.  Example:
  1777.  
  1778.      » output 'output.dat'
  1779.  
  1780.  sends output to the file 'output.dat'
  1781.  
  1782.      » output com
  1783.  
  1784.  sends output to comm port 1 (com1:)
  1785.  
  1786.      » output prn
  1787.  
  1788.  sends output to the printer port (prn).
  1789.  
  1790.  Also see DUMP, OUTPUT and TERMINAL.
  1791. ≡paper
  1792. ≡border
  1793. ≡noborder
  1794.  Purpose:
  1795.      Specify Paper Size
  1796.  
  1797.  Syntax:
  1798.  ┌──────────────────────────────────────────────────────────────────────┐
  1799.  │   paper {size} <dx> {by} <dy> {default}                              │
  1800.  │   border                                                             │
  1801.  │   noborder                                                           │
  1802.  └──────────────────────────────────────────────────────────────────────┘
  1803.  
  1804.  Description:
  1805.  
  1806.  The most basic elements of a plot are the paper (or page) and the
  1807.  subplot area.  The paper size usually coincides with the graphics device
  1808.  hardclip limits, that is, no plotting can be done outside this region.
  1809.  
  1810.  The paper command defines the size of the paper.  Graphica sets the
  1811.  page limits to the standard 11.0 by 8.5 inch paper size.  If a raster
  1812.  graphics terminal is being used the page border is also drawn so that the
  1813.  relative size of the plot can be ascertained.  This page border may be
  1814.  turned off by using the command 'noborder' and on also by using 'border'.
  1815.  
  1816.  When paper default is specified, the paper size will be reset to its
  1817.  default value.  The 'paper size ' command is also used to indicate that
  1818.  a new plot is going to be generated.
  1819.  
  1820.  Entering 'paper' by itself simply shows the current paper dimensions.
  1821.  
  1822.  Examples:
  1823.  
  1824.      » paper default
  1825.      » paper 8.5 by 11
  1826.      » pap size 11 8.5
  1827.  
  1828.  Any of these three resets the paper size to the standard size of 11 by 8.5
  1829.  inches.
  1830.  
  1831.      » border
  1832.      » noborder
  1833.  
  1834.  These two commands turn the paper size outline drawing on and off,
  1835.  respectively.
  1836. ≡parametric
  1837.  Purpose:
  1838.      Plot a Parametric Curve
  1839.  
  1840.  Syntax:
  1841.  ┌──────────────────────────────────────────────────────────────────────┐
  1842.  │   parametric {plot} t tmin,tmax fx(t),fy(t)                          │
  1843.  │              {connect {points}} {add {symbols}}                      │
  1844.  │   where                                                              │
  1845.  │     t     = any dummy variable                                       │
  1846.  │     tmin  = minimum value of the dummy variable                      │
  1847.  │     tmax  = maximum value of the dummy variable                      │
  1848.  │     fx(t) = x coordinate of each point in the curve                  │
  1849.  │     fy(t) = y coordinate of each point in the curve                  │
  1850.  └──────────────────────────────────────────────────────────────────────┘
  1851.  
  1852.  Description:
  1853.  
  1854.  The plot command allows plotting curves in Graphica in which you give
  1855.  the y coordinate of each point as a function of the x coordinate.  You
  1856.  can also use Graphica to make parametric plots.  In a parametric plot,
  1857.  you give both the x and y coordinates of each point as a function of a
  1858.  third parameter, say t.  It takes two parametric function
  1859.  specifications in terms of the parametric dummy argument to describe a
  1860.  single graph.  The order the parametric functions is xfunction,
  1861.  yfunction.  Each function operates over the common parametric domain.
  1862.  
  1863.  Examples:
  1864.  
  1865.      » parametric plot t 0,2*pi sin(t) sin(2*t)
  1866.      » parametric t 0,2*pi sin(t) cos(t)
  1867.      » parametric plot x 1,4 log(x) log(x**2+x**6)
  1868.  
  1869.      » r(t) = (3*cos(t)**2-1)/2
  1870.      » parametric plot t 0 2*pi r(t)*cos(t) r(t)*sin(t)
  1871.  
  1872.  See also FUNCTIONS, PLOT and POLAR.
  1873. ≡pause
  1874.  Purpose:
  1875.      Pause and/or Wait for User Response
  1876.  
  1877.  Syntax:
  1878.  ┌──────────────────────────────────────────────────────────────────────┐
  1879.  │   pause {<expression>} {"string"}                                    │
  1880.  └──────────────────────────────────────────────────────────────────────┘
  1881.  
  1882.  Description:
  1883.  
  1884.  Halts execution until a user responds at the keyboard.  'pause' is
  1885.  useful in conjunction with 'load' files.  It displays any text
  1886.  associated with the command and then waits the specified amount of
  1887.  time.  This allows one to build a load file and control the amount of
  1888.  time a finished graph is displayed.  The first argument can be a
  1889.  negative or a positive integer.  Choosing -1 will have Graphica wait
  1890.  until any key is hit.  A positive integer will have Graphica wait for
  1891.  the specified number of seconds.
  1892.  
  1893.  The expression and string are optional.  If a string is present it
  1894.  must be enclosed in quotes.  If no expression is given, 'pause' waits a
  1895.  default time of 3 seconds.
  1896.  
  1897.  Examples:
  1898.  
  1899.      » pause     # Wait a default three seconds
  1900.      » pause 3   # Wait three seconds
  1901.      » pause 10  "Isn't this great?  It's a cubic spline."
  1902.      » pause -1  # Wait until a carriage return is hit
  1903.      » pause -1  "Hit return to continue"
  1904. ≡pen
  1905. ≡color
  1906.  Purpose:
  1907.      Specify a Pen Parameter
  1908.  
  1909.  Syntax:
  1910.  ┌──────────────────────────────────────────────────────────────────────┐
  1911.  │   pen {style} {speed} {width} <value>                                │
  1912.  │   pen {color} <integer>/{name}                                       │
  1913.  └──────────────────────────────────────────────────────────────────────┘
  1914.  
  1915.  Description:
  1916.  
  1917.  With the 'pen' command, several parameters may be specified, as follows:
  1918.  
  1919.  To distinguish between the lines of a multiline plot, 'style' defines
  1920.  the type of the line pattern to use when connecting data points or
  1921.  drawing lines.  The default is 1 (a solid line).  All drawing commands
  1922.  are affected by the 'pen style' command.  In other words, the line type
  1923.  remains in effect until changed.  Issue a new 'pen style' command
  1924.  whenever you wish to respecify the line pattern.  There are 8 (eight)
  1925.  pen styles available.
  1926.  
  1927.  'width' defines the pen width in pixels or points.  There are 8
  1928.  (eight) pen widths available, with 1 being a line 1 pixel thick.
  1929.  This is the default.
  1930.  
  1931.  'speed' defines the pen speed in a pen plotter in cm/sec.  The speed
  1932.  defaults to the output device's default.  On an HP7475 plotter, this
  1933.  is 30 cm/sec.
  1934.  
  1935.  'color' defines the pen color by color code or by color name.
  1936.  Colors are assigned to numbers that in turn correspond to the pen
  1937.  numbers on a hardware device (display screen, plotter, printer,
  1938.  etc.).  There are currently 16 colors defined:
  1939.  
  1940.           0 - black                    8 - lgray
  1941.           1 - blue                     9 - lblue
  1942.           2 - green                   10 - lgreen
  1943.           3 - cyan                    11 - lcyan
  1944.           4 - red                     12 - lred
  1945.           5 - magenta                 13 - lmagenta
  1946.           6 - brown                   14 - yellow
  1947.           7 - gray                    15 - white
  1948.  
  1949.  Entering 'color' by itself simply shows the current drawing specifications.
  1950.  The default color upon Graphica startup is green (2).
  1951.  
  1952.  Examples:
  1953.  
  1954.      » pen style 1, color 3
  1955.      » pen width 3
  1956.      » pen speed 15 (cm/s)
  1957.  
  1958.  Also see DUMP, POSTSCRIPT and TERMINAL.
  1959. ≡plot
  1960. ≡noplot
  1961. ≡nodata
  1962. ≡errorbars
  1963. ≡connect
  1964. ≡add
  1965. ≡needle
  1966. ≡step
  1967. ≡autox
  1968.  Purpose:
  1969.      Plot a Datafile, Curve or Function
  1970.  
  1971.  Syntax:
  1972.  ┌──────────────────────────────────────────────────────────────────────┐
  1973.  │   plot 'data-file' {autox}                                           │
  1974.  │        {connect {points}} {add {symbols}}                            │
  1975.  │        {needle} {step} {errorbars {itype}}                           │
  1976.  │   plot {data} {x,y,x2,y2}                                            │
  1977.  │        {connect {points}} {add {symbols}}                            │
  1978.  │        {needle} {step} {errorbars {itype}}                           │
  1979.  │   plot 'definition' <function>                                       │
  1980.  │        {connect {points}} {add {symbols}}                            │
  1981.  │   plot {p pmin pmax} <function>                                      │
  1982.  │        {connect {points}} {add {symbols}}                            │
  1983.  │   (no)plots                                                          │
  1984.  └──────────────────────────────────────────────────────────────────────┘
  1985.  
  1986.  Definition:
  1987.  
  1988.  This command allows you to plot data, functions and data files.  It is
  1989.  the primary Graphica command.
  1990.  
  1991.  'data-file' the name of a data file enclosed in quotes.  The filename
  1992.  may be followed by the 'autox' keyword as in the data command.  In that
  1993.  case, the x values are assigned automatically starting from data point
  1994.  number 1.
  1995.  
  1996.  If 'data' is specified, previously read-in data is plotted. 'autox'
  1997.  may also be specified.
  1998.  
  1999.  <function> is a mathematical expression and may optionally be preceded
  2000.  by a range specification.
  2001.  
  2002.  'connect' causes the points to be connected by a straight line of
  2003.  the specified default line pattern.
  2004.  
  2005.  For plots with more than one line of data, it may be difficult to tell
  2006.  the difference between the lines.  For this reason, Graphica includes
  2007.  the capability of marking each point in a line with a symbol.  'add'
  2008.  causes the specified symbol to be displayed at each data point.
  2009.  Leaving out the word 'add' just draws a line through the data points.
  2010.  
  2011.  'needle' makes the plot come out such that the y data values are
  2012.  plotted as needles perpendicular to the x axis.
  2013.  
  2014.  'step' makes a step plot, useful, for example, for plotting production
  2015.  data versus years.
  2016.  
  2017.  The 'errorbars' keyword lets you add error bars to the plotted data
  2018.  points.  An optional integer specifies the type: 1 = no tics (dy), 2
  2019.  = tics at end of bar (dy), 3 = no tics (dx), 4 = tics at end of bar
  2020.  (dx).  Error bar values are read in one of two ways: (a) from columns
  2021.  3 and 4 of a data file (these two extra values are read in as (ylow,
  2022.  yhigh) or (xlow, xhigh) values for the y values in column 2) or x
  2023.  values in column (1), (b) from column 3 (this value is a dy or dx).
  2024.  If you're using the 'autox' keyword you need one column less than
  2025.  specified above since the x values will be assigned automatically.
  2026.  
  2027.  Two types of error bars may be drawn:  type 1 is simply a vertical
  2028.  line spanning the error;  type 2 has two tic marks parallel to the
  2029.  x-axis, the size of the symbol, like a bracket.  The default is type 2.
  2030.  
  2031.  For axes specified as logarithmic, the log of the data values is
  2032.  plotted.  The log of absolute values is plotted.  For zero or negative
  2033.  data values, the log of 0.001 is plotted.
  2034.  
  2035.  Optionally, a definition may be given on this line as well, for example,
  2036.  'plot s=2 cos(x/s)'.
  2037.  
  2038.  'noplot' or 'nodata' clears all data points from memory and leaves
  2039.  Graphica as if no data points or functions had been entered.
  2040.  
  2041.  'plots' by itself shows the currently defined plots, including data,
  2042.  functions, smoothed curves, polynomial fits and shaded data.
  2043.  
  2044.  If the 'column' command assigned column 3 of a data file to the x-axis
  2045.  and column 1 to the y-axis, 'plot x y add points' will generate a graph
  2046.  of column 3 versus column 1.
  2047.  
  2048.  Examples:
  2049.  
  2050.      » plot 'exp.dat'                  # plot data in datafile exp.dat
  2051.  
  2052.      » plot 'bar.dat' errorbars 1      # plot error bars
  2053.  
  2054.      » plot 'one-y.dat' autox add      # plot a single column with symbols
  2055.  
  2056.      » plot data                       # equivalent to 'plot x y connect'
  2057.  
  2058.      » data 'oilrate.dat'
  2059.      » draw x y
  2060.      » plot data step                  # draw a step plot of 'oilrate.dat'
  2061.  
  2062.      » map x 0 100 y 0 200             # map the x-axis from 0 to 100
  2063.      » draw x y                        # draw the axes
  2064.      » plot f 20 80 b(f)               # plot b(f) only from 20 to 80
  2065.  
  2066.      » plot sin(x)                     # plot the sine of x
  2067.  
  2068.      » plot sin(x) cos(x)              # plot sin(x) and cos(x)
  2069.  
  2070.      » plot cos(x) add symbols connect points
  2071.  
  2072.      » plot s=0.1, t(x)                # define a variable s, plot t(x)
  2073.  
  2074.  where t(x) has been defined previously and is a function of s.
  2075.  
  2076.      » noplot                          # clear out any plot information
  2077.  
  2078.  Also see COLUMN, FUNCTIONS, MAP, PARAMETRIC, POLAR, SAMPLING and SYMBOLS.
  2079. ≡plotting
  2080.  Purpose:
  2081.      Select a Plotting Sequence
  2082.  
  2083.  Syntax:
  2084.  ┌──────────────────────────────────────────────────────────────────────┐
  2085.  │   plotting sequence <start>,<stop> {{by} <increment>}                │
  2086.  └──────────────────────────────────────────────────────────────────────┘
  2087.  
  2088.  Description:
  2089.  
  2090.  If you want the program to plot the data other than in the normal
  2091.  fashion (start with the first point and plot all points up to the
  2092.  last one), use this command to alter the program's processing loop.
  2093.  Given as integers, <start> indicates the first data point to start
  2094.  at, <stop> is the last data point to plot and <increment> controls
  2095.  which points to pick up within the start-stop range.  The default
  2096.  is to plot all points in increments of 1.
  2097.  
  2098.  'plotting seq' without arguments shows the current plotting sequence.
  2099.  
  2100.  Example:
  2101.  
  2102.      » plotting sequence 2,10,2
  2103.  
  2104.  plots points 2, 4, 6, 8 and 10.
  2105.  
  2106.  Also see MISSING.
  2107. ≡missing
  2108.  Syntax:
  2109.  ┌──────────────────────────────────────────────────────────────────────┐
  2110.  │   missing {value} <value>                                            │
  2111.  └──────────────────────────────────────────────────────────────────────┘
  2112.  
  2113.  Description:
  2114.  
  2115.  'missing value' allows you to insert missing values in a data file and
  2116.  Graphica will skip the value and start plotting another line.  It works
  2117.  just like the blank line feature explained in 'data'.
  2118.  
  2119.  Example:
  2120.  
  2121.        » missing -99999
  2122.  
  2123.  When Graphica encounters a line containing a value of -99999 in a data
  2124.  file, it'll skip that line and continue reading the data file.  When
  2125.  it's time to plot, the graph will be broken at those points where
  2126.  Graphica read a missing value.
  2127.  
  2128.  Also see PLOT and DATA.
  2129. ≡polar
  2130.  Syntax:
  2131.  ┌──────────────────────────────────────────────────────────────────────┐
  2132.  │   polar <function> {connect {points}} {add {symbols}}                │
  2133.  └──────────────────────────────────────────────────────────────────────┘
  2134.  
  2135.  Definition:
  2136.  
  2137.  This command generates polar plots and is similar to the 'plot'
  2138.  command.  You can plot data, functions and data files.  Type PLOT
  2139.  for some more details.  'polar' by itself simply gives a list of plots
  2140.  made so far.
  2141.  
  2142.  There is a dummy variable 't' which can be mapped to specify the range
  2143.  of values that will be covered by the function.  Polar plots are
  2144.  simple transformations of a function y = f(t) where
  2145.  
  2146.        xc = y * cos( t )
  2147.  and
  2148.        yc = y * sin( t )
  2149.  
  2150.  and xc and yc are the transformed values in cartesian coordinates.
  2151.  't' can be mapped as follows:
  2152.  
  2153.        » map t <tmin> <tmax>
  2154.  
  2155.  The default map is 0 to 2*pi.  Polar plots can also be done using the
  2156.  parametric function plotting feature.
  2157.  
  2158.  Examples:
  2159.  
  2160.      » polar .5, 1, 1.5
  2161.  
  2162.  plots three circles of the given radius.
  2163.  
  2164.      » polar cos(2*x)
  2165.  
  2166.  plots a cloverleaf.
  2167.  
  2168.  Also see FUNCTIONS, MAP, PARAMETRIC, PLOT, and SYMBOLS.
  2169. ≡fits
  2170.  Purpose:
  2171.      Generate Curve Fits
  2172.  
  2173.  Syntax:
  2174.  ┌──────────────────────────────────────────────────────────────────────┐
  2175.  │   fits                                                               │
  2176.  └──────────────────────────────────────────────────────────────────────┘
  2177.  
  2178.  Description:
  2179.  
  2180.  Graphica curve fit options currently include polynomial, sigmoid and
  2181.  spline fitting and smoothing.
  2182.  
  2183.  'polyfit' generates an nth degree polynomial least squares fit of the
  2184.  current data.  The coefficients of the polynomial are given by 'fits'.
  2185.  
  2186.  'sigmoid' is used to interpolate the current data using a non-linear
  2187.  sigmoid curve.  The sigmoid will not necessarily go though every data
  2188.  point.  The coefficients of the sigmoid are given by 'fits'.
  2189.  
  2190.  'spline' is used to interpolate the current data using splines under
  2191.  tension.  The spline goes through every data point.
  2192.  
  2193.  'smooth' is simply used to draw a "smooth curve through scattered
  2194.  data points."  The smooth curve does not necessarily go through any
  2195.  data point.
  2196.  
  2197.  Spline fitting and smoothing do not produce an equation (unlike
  2198.  sigmoid and polynomial fitting, which do).
  2199.  
  2200.  Example:
  2201.      » fits
  2202.  
  2203.  Also see POLYFIT, SIGMOID, SMOOTH and SPLINE.
  2204. ≡polyfit
  2205.  Purpose:
  2206.      Generate And Plot a Polynomial Fit
  2207.  
  2208.  Syntax:
  2209.  ┌──────────────────────────────────────────────────────────────────────┐
  2210.  │   polyfit {degree} n {range {min} {max}}                             │
  2211.  └──────────────────────────────────────────────────────────────────────┘
  2212.  
  2213.  Description:
  2214.  
  2215.  The 'polyfit' command generates an nth degree polynomial least squares
  2216.  fit of the current data.  The highest degree possible is 10.  The
  2217.  default degree is 1 (i.e. 'polyfit' by itself.)
  2218.  
  2219.  Optionally, a range of given x values may be provided and Graphica
  2220.  will plot the least squares fit from min to max only.
  2221.  
  2222.  Polynomial fits apply to the LATEST data set, that is, you can't fit a
  2223.  polynomial to the last polynomial, only to a set of previously entered
  2224.  data points or function.
  2225.  
  2226.  'fits' shows the current polynomial fitting and correlation coefficients.
  2227.  
  2228.  The number of points plotted on the polynomial fit can be changed by
  2229.  the 'sampling' command.
  2230.  
  2231.  Examples:
  2232.  
  2233.      » polyfit degree 2
  2234.      » polyfit range 20 30
  2235.      » polyfit 5
  2236.      » polyfit
  2237.      » fits
  2238.  
  2239.  Also see FITS, SAMPLING, SIGMOID, SMOOTH and SPLINE.
  2240. ≡dump postscript
  2241. ≡terminal postscript
  2242. ≡postscript
  2243. ≡eps
  2244. ≡ps
  2245.  Purpose:
  2246.      PostScript Device Driver
  2247.  
  2248.  Syntax:
  2249.  ┌──────────────────────────────────────────────────────────────────────┐
  2250.  │   dump postscript {color} {bw} {font fontname} {level2}              │
  2251.  │   dump epsf                                                          │
  2252.  └──────────────────────────────────────────────────────────────────────┘
  2253.  
  2254.  Description:
  2255.  
  2256.  The PostScript device driver can output color commands.  The default
  2257.  is gray-scale output.  Black & white output can be forced through the
  2258.  'bw' switch.  Color output is forced with 'color'.
  2259.  
  2260.  Although Level 1 PostScript is the default, Level 2 output can also
  2261.  be generated.  (There is only one Level 2 feature active at the moment
  2262.  though, setfont).
  2263.  
  2264.  The same switches ('color', 'bw', 'font' and 'level2') apply to the
  2265.  encapsulated PostScript driver (epsf).
  2266.  
  2267.  Examples:
  2268.  
  2269.      » dump post "graph.ps" color    # used in color postscript printers
  2270.      » dump post "graph.ps" bw       # forces black & white output
  2271.      » term postscript
  2272.  
  2273.  See DUMP, OUTPUT and TERMINAL.
  2274. ≡pwd
  2275.  Purpose:
  2276.      Print Current Working Directory
  2277.  
  2278.  Syntax:
  2279.  ┌──────────────────────────────────────────────────────────────────────┐
  2280.  │   pwd                                                                │
  2281.  └──────────────────────────────────────────────────────────────────────┘
  2282.  
  2283.  Description:
  2284.  
  2285.  The 'pwd' command prints the name of the current working directory.
  2286.  
  2287.  Example:
  2288.  
  2289.      » pwd
  2290.  
  2291.  would print out C:\WORK, for example, on DOS systems or /usr/work in UNIX.
  2292. ≡recall
  2293. ≡editing
  2294.  Purpose:
  2295.      Recall User Input Lines
  2296.  
  2297.  Syntax:
  2298.  ┌──────────────────────────────────────────────────────────────────────┐
  2299.  │   recall                                                             │
  2300.  └──────────────────────────────────────────────────────────────────────┘
  2301.  
  2302.  Description:
  2303.  
  2304.  Graphica is compiled with a feature called last-line editing and
  2305.  recall.  In that case, the arrow keys on the keypad can be used to
  2306.  edit mistyped commands or to recall previous command lines.
  2307.  
  2308.  Instead of retyping an entire line, simply hit the up-arrow or down-
  2309.  arrow keys to recall previous input lines.  Then you can move the
  2310.  cursor over using the left and right-arrow keys and edit the line.
  2311.  The arrow keys on the keypad work on copies of the previous input
  2312.  lines, which have been saved in a moderately sized input buffer.
  2313.  Here is a brief description of the arrow key functions:
  2314.  
  2315.      ^N  or  up arrow          recall previous line
  2316.      ^P  or  down arrow        recall next line
  2317.      ^B  or  left arrow        move left one character
  2318.      ^F  or  right arrow       move right one character
  2319.      ^A  or  home              move to beginning of line
  2320.      ^E  or  end               move to tend of line
  2321.      ^U  or  esc (esc)         cancel current line
  2322.      ^H  or  del               delete character at cursor
  2323.              backspace         delete character left of cursor
  2324.  
  2325.      ^K      kills from current position to the end of line
  2326.      ^D      deletes the current character, or EOF if line is empty
  2327.      ^L/^R   redraw line in case it gets trashed
  2328.      ^W      kills last word
  2329.  
  2330.  RETURN returns the entire line regardless of the cursor position.
  2331.  
  2332.  On systems without the last-line editing and recall feature, the 'recall'
  2333.  command gives a list of the last 10 user input lines for review.
  2334.  
  2335.  Example:
  2336.  
  2337.      » recall
  2338.  
  2339.  would give out a list such as:
  2340.  
  2341.      paper size 11 by 8.5
  2342.      subplot 2 3 6 7
  2343.      frame
  2344.      draw x y
  2345. ≡rectangle
  2346. ≡norectangle
  2347.  Purpose:
  2348.      Draw a Rectangle
  2349.  
  2350.  Syntax:
  2351.  ┌──────────────────────────────────────────────────────────────────────┐
  2352.  │   rectangle {tag} {from <x1>,<y1>} {to <x2>,<y2>} {filled/nofill}    │
  2353.  │   norectangle {tag}                                                  │
  2354.  └──────────────────────────────────────────────────────────────────────┘
  2355.  
  2356.  Description:
  2357.  
  2358.  This command generates a rectangle with its lower left hand corner
  2359.  at <x1>,<y1> and its upper right hand corner at <x2>,<y2>.
  2360.  
  2361.  Entering 'rectangles' by itself simply shows the currently defined
  2362.  rectangles.
  2363.  
  2364.  Examples:
  2365.  
  2366.      » rectangle from 1.0,2.0 to 3.0,4.0
  2367.      » rectangle 2 from 3,2 to 5,4 filled
  2368.      » norectangle 2
  2369.  
  2370.  Also see ARC, ARROW, CIRCLE, LABEL, LEGEND, LINE and SECTOR.
  2371. ≡range
  2372. ≡stats
  2373. ≡statistics
  2374.  Purpose:
  2375.      Generate Input Data Statistics
  2376.  
  2377.  Syntax:
  2378.  ┌──────────────────────────────────────────────────────────────────────┐
  2379.  │   stats                                                              │
  2380.  └──────────────────────────────────────────────────────────────────────┘
  2381.  
  2382.  This command shows the input data range (max and min) of each column and
  2383.  other statistical calculations such as mean, standard deviation, etc.
  2384. ≡sampling
  2385.  Purpose:
  2386.      Specify Sampling Rate
  2387.  
  2388.  Syntax:
  2389.  ┌──────────────────────────────────────────────────────────────────────┐
  2390.  │   sampling <expression>                                              │
  2391.  └──────────────────────────────────────────────────────────────────────┘
  2392.  
  2393.  Description:
  2394.  
  2395.  Graphica always tries to plot functions as smooth curves.  It is
  2396.  impossible to sample the infinite number of points that would be
  2397.  needed to reproduce a given function exactly.  Since the function is
  2398.  only sampled at a limited number of points, Graphica can sometimes
  2399.  miss features of the function.  By increasing the sampling rate, you
  2400.  can make Graphica sample your function at a larger number of points.
  2401.  Of course, the larger the sampling rate, the longer it will take
  2402.  Graphica to plot any function, even a smooth one.
  2403.  
  2404.  The sampling rate is changed by the 'sampling' command.  By default,
  2405.  sampling is set to 150 points.  A higher sampling rate will produce
  2406.  more accurate plots, but will also take longer.
  2407.  
  2408.  For example, the function sin(1/x) wiggles infinitely often when x
  2409.  is near zero.  As a result, there are slight glitches in the plot.
  2410.  Increasing the sampling rate will reduce the number of glitches.
  2411.  
  2412.  Entering 'sampling' by itself simply shows the current sampling rate.
  2413.  
  2414.  'sampling' also affects the number of points plotted when polynomial
  2415.  fitting, sigmoid fitting, spline fitting or smoothing.
  2416.  
  2417.  Example:
  2418.  
  2419.      » sampling 200
  2420.  
  2421.  Also see FITS, FUNCTIONS, PARAMETRIC, PLOT, POLYFIT, SIGMOID, SPLINE
  2422.  and SMOOTH.
  2423. ≡save
  2424.  Purpose:
  2425.      Generate a File with Graphica Commands
  2426.  
  2427.  Syntax:
  2428.  ┌──────────────────────────────────────────────────────────────────────┐
  2429.  │   save                                                               │
  2430.  └──────────────────────────────────────────────────────────────────────┘
  2431.  
  2432.  Description:
  2433.  
  2434.  The 'save' command creates a file called 'session.log' containing a few
  2435.  basic settings of your graphica session.  It will not entirely reproduce
  2436.  complicated graphs.
  2437.  
  2438.  Example:
  2439.  
  2440.      » save
  2441. ≡sector
  2442. ≡nosector
  2443.  Purpose:
  2444.      Draw a Sector
  2445.  
  2446.  Syntax:
  2447.  ┌──────────────────────────────────────────────────────────────────────┐
  2448.  │   sector {tag} {center at <x>,<y>}                                   │
  2449.  │                {radius <value>}                                      │
  2450.  │                {start/end angle <value>}                             │
  2451.  │   nosector {tag}                                                     │
  2452.  └──────────────────────────────────────────────────────────────────────┘
  2453.  
  2454.  Description:
  2455.  
  2456.  This command draws a sector with the given radius starting at angle
  2457.  <start angle> and ending at angle <end angle>.
  2458.  
  2459.  Entering 'sector' by itself simply shows the currently defined sectors.
  2460.  
  2461.  Examples:
  2462.  
  2463.      » sector radius 2.0 center at 3.0 4.0 start angle 10 end 45
  2464.      » sector center at 2 1 start 23 end 90
  2465.      » nosectors
  2466.  
  2467.  Also see ARC, ARROW, CIRCLE, LABEL, LEGEND, LINE, and RECTANGLE.
  2468. ≡shade
  2469.  Purpose:
  2470.      Shade a Specified Set of Data
  2471.  
  2472.  Syntax:
  2473.  ┌──────────────────────────────────────────────────────────────────────┐
  2474.  │   shade {spacing} {angle} <value> {mode} <integer>                   │
  2475.  │         {(no)closure}                                                │
  2476.  └──────────────────────────────────────────────────────────────────────┘
  2477.  
  2478.  Description:
  2479.  
  2480.  The 'shade' command allows the user to shade a specified polygon.
  2481.  'spacing' is the vertical distance between shade lines in default
  2482.  user units.
  2483.  
  2484.  Optionally, a shade 'angle' may be specified.  This angle is measured
  2485.  from the horizontal.  The sign convention for the direction of rotation
  2486.  is as follows:
  2487.  
  2488.      + clockwise
  2489.      - counterclockwise
  2490.  
  2491.  'mode' indicates the following:
  2492.  
  2493.      mode = 1 - shade and outline (this is the default)
  2494.      mode = 2 - shade polygon only
  2495.      mode = 3 - outline polygon only
  2496.  
  2497.  The 'closure/noclosure' keyword is used to specify whether Graphica
  2498.  should draw a line making the polygon a closed one or not.  This
  2499.  keyword is only active when mode is 1 or 3.  The default is 'noclosure'.
  2500.  
  2501.  Example:
  2502.  
  2503.      » shade angle 35.0 mode 1
  2504. ≡shell
  2505.  Purpose:
  2506.      Spawn a Shell
  2507.  
  2508.  Syntax:
  2509.  ┌──────────────────────────────────────────────────────────────────────┐
  2510.  │   shell                                                              │
  2511.  └──────────────────────────────────────────────────────────────────────┘
  2512.  
  2513.  Description:
  2514.  
  2515.  The shell command spawns an interactive shell.  Use this option to
  2516.  access the operating system prompt and execute commands or run other
  2517.  programs.  When shelling out to the operating system, you can execute
  2518.  any command or application.  To return to Graphica: type EXIT at the
  2519.  command line (under DOS);  type control-d (under Coherent);  do
  2520.  stop/id=xxx, where xxx is your subprocess ID (under VAX/VMS).
  2521.  
  2522.  A single shell command may be spawned by preceding it with the $
  2523.  character on the very first position of a command line.  Control will
  2524.  return immediately to Graphica after this command is executed.
  2525.  
  2526.  Examples:
  2527.  
  2528.      » shell
  2529.  
  2530.  spawns a shell to the operating system.  Type EXIT to return to Graphica.
  2531.  
  2532.      » $dir
  2533.  
  2534.  prints a directory listing and then returns to Graphica without waiting.
  2535.  
  2536.  Also see DELETE, DIR, TYPE and WHAT.
  2537. ≡show
  2538.  Purpose:
  2539.      Show Screen
  2540.  
  2541.  Syntax:
  2542.  ┌──────────────────────────────────────────────────────────────────────┐
  2543.  │   show                                                               │
  2544.  └──────────────────────────────────────────────────────────────────────┘
  2545.  
  2546.  Description:
  2547.  
  2548.     The SHOW command redraws your screen.
  2549. ≡smooth
  2550.  Purpose:
  2551.      Draw a Smooth Curve Through Data
  2552.  
  2553.  Syntax:
  2554.  ┌──────────────────────────────────────────────────────────────────────┐
  2555.  │   smooth {n} {range {min} {max}} {(no)spline}                        │
  2556.  └──────────────────────────────────────────────────────────────────────┘
  2557.  
  2558.  Description:
  2559.  
  2560.  Data smoothing is used simply as a graphical technique, to guide the
  2561.  eyes through a forest of scattered data points.  Graphica removes any
  2562.  linear trend, uses a Fast Fourier Transform to low-pass filter the
  2563.  data and reinserts the trend at the end.
  2564.  
  2565.  If the total number of points is smaller than the current sampling
  2566.  rate, Graphica generates a spline curve through the resulting smooth
  2567.  points.  You can force a spline fit anyway, by specifying 'spline'
  2568.  on the command line.  The number of points plotted on the smooth
  2569.  spline curve can be changed by a previous 'sampling' command.  Or,
  2570.  you can prevent Graphica from drawing a spline fit regardless of the
  2571.  total number of points by specifiying 'nospline'.
  2572.  
  2573.  The user-specified constant 'n' gives the number of points over which
  2574.  the data should be smoothed.  A value of zero gives no smoothing at
  2575.  all.  If 'n' is not specified, the default is 5.
  2576.  
  2577.  Optionally, a range of x values may be provided and Graphica will
  2578.  smooth data points from min to max only.
  2579.  
  2580.  Smoothing applies to the LATEST data set, that is, you can't smooth
  2581.  a smoothed curve, only a set of previously entered data points or
  2582.  function.
  2583.  
  2584.  Examples:
  2585.  
  2586.      » smooth 10
  2587.      » smooth range 20 30
  2588.      » smooth 8 spline
  2589.      » smooth nospline
  2590.  
  2591.  Also see FIT, POLYFIT, SAMPLING, SIGMOID and SPLINE.
  2592. ≡sigmoid
  2593.  Purpose:
  2594.      Fit a Set of Data to a Sigmoid and Plot the Sigmoid
  2595.  
  2596.  Syntax:
  2597.  ┌──────────────────────────────────────────────────────────────────────┐
  2598.  │   sigmoid {plot} {range {min} {max}}                                 │
  2599.  └──────────────────────────────────────────────────────────────────────┘
  2600.  
  2601.  Description:
  2602.  
  2603.  The 'sigmoid' command is used to interpolate the current data using
  2604.  a sigmoid curve.  A sigmoid curve is simply an exponential expression
  2605.  of the form: y = a + b / ( exp ( - ( x - c ) ) / d ), where a, b, c,
  2606.  and d are parameters determined by the Levenberg-Marquardt method.
  2607.  This is the standard method for determining non-linear least-squares
  2608.  problems.
  2609.  
  2610.  Optionally, a range of given x values may be provided and Graphica
  2611.  will interpolate from min to max only.
  2612.  
  2613.  Sigmoid fits apply to the LATEST data set, that is, you can't fit a
  2614.  sigmoid to the last sigmoid, only to a set of previously entered data
  2615.  points or function.
  2616.  
  2617.  The number of points plotted on the sigmoid fit can be changed by the
  2618.  'sampling' command.
  2619.  
  2620.  Examples:
  2621.  
  2622.      » sigmoid plot
  2623.      » sigmoid range 20 30
  2624.  
  2625.  Also see FIT, POLYFIT, SAMPLING, SMOOTH and SPLINE.
  2626. ≡spline
  2627.  Purpose:
  2628.      Fit a Set of Data to a Spline and Plot the Spline
  2629.  
  2630.  Syntax:
  2631.  ┌──────────────────────────────────────────────────────────────────────┐
  2632.  │   spline {plot} {tension {value}} {range {min} {max}}                │
  2633.  └──────────────────────────────────────────────────────────────────────┘
  2634.  
  2635.  Description:
  2636.  
  2637.  The 'spline' command is used to interpolate the current data using
  2638.  splines under tension.  The produced data curve is a spline under
  2639.  tension, which is somewhat "tighter" than a cubic spline, and less
  2640.  likely to have spurious inflection points.  The cubic spline
  2641.  interpolator will produce a smooth curve through (x,y) data pairs,
  2642.  even if their variation is quite complicated.
  2643.  
  2644.  The tension factor indicates the curviness desired for the line
  2645.  produced by the cubic spline.  A tension in the interpolating curve
  2646.  of 50 gives almost a polygonal line;  a tension of 0.01 gives almost
  2647.  a cubic spline.  The default of 2.0 will produce a smooth curve in
  2648.  most cases.  For very erratic data it may be necessary to tighten
  2649.  up the tension factor to 5 or 6 to adequately follow the data points.
  2650.  
  2651.  Optionally, a range of given x values may be provided and Graphica
  2652.  will interpolate from min to max only.
  2653.  
  2654.  Spline fits apply to the LATEST data set, that is, you can't fit a
  2655.  spline to the last spline, only to a set of previously entered data
  2656.  points or function.
  2657.  
  2658.  The number of points plotted on the spline fit can be changed by the
  2659.  'sampling' command.
  2660.  
  2661.  Examples:
  2662.  
  2663.      » spline plot tension 10
  2664.      » spline range 20 30
  2665.  
  2666.  Also see FIT, POLYFIT, SAMPLING and SMOOTH.
  2667. ≡subplot
  2668.  Purpose:
  2669.      Specify Area Where Plot Will Go
  2670.  
  2671.  Syntax:
  2672.  ┌──────────────────────────────────────────────────────────────────────┐
  2673.  │   subplot {size/area} <xleft> <ybottom> <xright> <ytop>              │
  2674.  │           {default}                                                  │
  2675.  └──────────────────────────────────────────────────────────────────────┘
  2676.  
  2677.  Description:
  2678.  
  2679.  The subplot area is also referred to as soft clip.  The actual graph
  2680.  resides in the subplot area but other graphic elements can be drawn
  2681.  outside the subplot area.
  2682.  
  2683.  The 'subplot' command defines the region on the paper where the plot
  2684.  is drawn.  By default, the subplot area is set to a rectangle of
  2685.  about 60% of the paper size.  The (xleft,ybottom) pair sets the
  2686.  coordinates of the left bottom corner of the subplot area, while the
  2687.  (xright, ytop) pair sets the coordinates of the top right hand corner
  2688.  of the plotting region.  If subplot default is specified, the subplot
  2689.  area size will be reset to its default size.
  2690.  
  2691.  Data points and curves are drawn or plotted on a grid space formed
  2692.  by Cartesian coordinate axes.  The horizontal line is the x-axis and
  2693.  the vertical line is the y-axis.  These axes are within the subplot
  2694.  area or plotting region.
  2695.  
  2696.  Entering 'subplot' by itself simply shows the current subplot area.
  2697.  
  2698.  Example:
  2699.  
  2700.      » subplot area 2.0,2.0 9.0,7.0
  2701. ≡subscript
  2702. ≡superscript
  2703.  Purpose:
  2704.      Specify Subscript and Superscript Sizes
  2705.  
  2706.  Syntax:
  2707.  ┌──────────────────────────────────────────────────────────────────────┐
  2708.  │   subscript {size} <value>                                           │
  2709.  │   superscript {size} <value>                                         │
  2710.  └──────────────────────────────────────────────────────────────────────┘
  2711.  
  2712.  Description:
  2713.  
  2714.  These commands set the subscript and superscript sizes in default units.
  2715.  The default values are 0.15 inches.
  2716.  
  2717.  Example:
  2718.  
  2719.      » subscript size 0.15
  2720.      » superscript size 0.15
  2721.  
  2722.  Also see CHARACTER FONT, CHARACTER GAP, CHARACTER RATIO, CHARACTER SIZE,
  2723.  CHARACTER SLANT and TEXT.
  2724. ≡symbol
  2725.  Purpose:
  2726.      Select a Plotting Symbol
  2727.  
  2728.  Syntax:
  2729.  ┌──────────────────────────────────────────────────────────────────────┐
  2730.  │   symbol <code>/<name> size <value>                                  │
  2731.  └──────────────────────────────────────────────────────────────────────┘
  2732.  
  2733.  Description:
  2734.  
  2735.  Defines the symbol to use in displaying data points.  Mnemonic codes
  2736.  may be used to specify a symbol.  You have a choice of 16 standard
  2737.  graphics symbols and a dot:
  2738.                                    (filled symbols)
  2739.       0 - dot
  2740.       1 - square                    11 - fsquare
  2741.       2 - circle                    12 - fcircle
  2742.       3 - triangle                  13 - ftriangle
  2743.       4 - diamond                   14 - fdiamond
  2744.       5 - itriangle (inv triangle)  15 - fitriangle
  2745.       6 - hourglass                 16 - fhourglass
  2746.       7 - plus
  2747.       8 - cross
  2748.       9 - star
  2749.      10 - pdiamond (plus within a diamond)
  2750.  
  2751.  The default is a square ('symbol 1' or 'symbol square').  The symbol
  2752.  size is specified as the height of the current symbol in default units.
  2753.  The default symbol size is 0.17 inches.
  2754.  
  2755.  If you specify 'symbol 0' or 'symbol dot', no markers will be plotted
  2756.  at each point location, just a tiny point the size of a pixel, so you
  2757.  can plot lots of data.
  2758.  
  2759.  Entering 'symbol' by itself simply shows the current symbol type and
  2760.  size.
  2761.  
  2762.  (Filled symbols work only on certain hardware devices.  Software symbol
  2763.  fill is under development.)
  2764.  
  2765.  Examples:
  2766.  
  2767.      » symbol square size 0.2
  2768.      » symbol 3
  2769.      » sym 0
  2770. ≡terminal
  2771.  Purpose:
  2772.      Specify Output Terminal
  2773.  
  2774.  Syntax:
  2775.  ┌──────────────────────────────────────────────────────────────────────┐
  2776.  │   terminal {<terminal-type>}                                         │
  2777.  └──────────────────────────────────────────────────────────────────────┘
  2778.  
  2779.  Description:
  2780.  
  2781.  Graphica supports many different graphics devices.  Use this command to
  2782.  select the type of device for which Graphica will produce output.
  2783.  
  2784.  If <terminal-type> is omitted, Graphica will show the currently defined
  2785.  output terminal and list the available terminal types.  <terminal-type>
  2786.  may be abbreviated.
  2787.  
  2788.  Use 'output' to redirect this output to a file, device or port.
  2789.  
  2790.  Examples:
  2791.  
  2792.      » terminal hpgl
  2793.      » terminal
  2794.  
  2795.  would print out the following:
  2796.  
  2797.  available terminal types:
  2798.             unknown  Unknown terminal type - not a plotting device
  2799.                 bgi  IBM PC/Clone with a Hercules/CGA/EGA/VGA graphics card
  2800.                epsf  Encapsulated PostScript Graphics Language
  2801.               epson  Epson LX-800, Star NL-10, NX-1000, etc.
  2802.                 gif  CompuServe's GIF Format, Version 87a
  2803.                hpgl  HPGL Graphics Language and HP7475 plotter
  2804.               hpgl2  HPGL Graphics Language and HP7550 plotter
  2805.                 lj2  LaserJet Series II
  2806.                 lj4  LaserJet 4
  2807.                 pcx  PC Paintbrush PCX Format
  2808.                 pic  Lotus 1-2-3 PIC Graphics Format
  2809.          postscript  PostScript Graphics Language
  2810.                 tif  Tagged Image File Format Revision 6.0
  2811.  
  2812.  and possibly (depending on the version you have) any of the following:
  2813.  
  2814.                 cbm  Coherent Bitmap Graphics
  2815.               latex  LaTeX picture environment
  2816.             windows  IBM PC/Clone running Windows 3.1
  2817.  
  2818.  Notes on some of the graphics formats:
  2819.  --------------------------------------
  2820.  
  2821.  The software fonts will look identically whether you use hpgl, PIC,
  2822.  PostScript or any other driver.  The only difference comes from the
  2823.  slight resolution difference in the formats.  The standard hpgl
  2824.  resolution is 10365 by 7962 pixels.  The Lotus 1-2-3 PIC format has
  2825.  a fixed resolution of 3200 by 2311 pixels.  The PostScript driver
  2826.  outputs graphic information at a resolution of 7920 by 6120 pixels.
  2827.  
  2828.  The hpgl, PIC and PostScript drivers output portrait files by
  2829.  turning the paper around 90 degrees.  An HPGL graph will come out
  2830.  alright on an actual HP plotter (which has its paper always in the
  2831.  landscape orientation).  If you need to import the file into a
  2832.  program that can read any of these formats, you'll have to rotate
  2833.  the plot back a quarter turn.
  2834.  
  2835.  The Lotus 1-2-3 PIC format should not be confused with the PC Paint
  2836.  Plus format, PPIC or with Dr. Halo PIC format.  Some programs only
  2837.  look at the file extension instead of looking inside the file to
  2838.  determine what type of graphics information is in it.  For example,
  2839.  the graphics viever VPIC won't read PIC files generated by Graphica
  2840.  (because it thinks it's something else).  WordPerfect for DOS and
  2841.  Word for Windows will read Graphica PIC files without a hitch.
  2842.  
  2843.  See DUMP and OUTPUT.
  2844. ≡tics
  2845.  Purpose:
  2846.      Specify Tic Mark Size and Direction
  2847.  
  2848.  Syntax:
  2849.  ┌──────────────────────────────────────────────────────────────────────┐
  2850.  │   tic {size} <major value> <minor value> {<direction>}               │
  2851.  └──────────────────────────────────────────────────────────────────────┘
  2852.  
  2853.  Description:
  2854.  
  2855.  All axes are marked off in equal segments with tic marks.  The values
  2856.  major and minor determine the size of the major and minor tic marks.
  2857.  The defaults are 0.16 and 0.09 inches for the major and minor tic marks,
  2858.  respectively.
  2859.  
  2860.  By default, tics are drawn inwards from the border on all four sides.
  2861.  The 'tic' command can be used to change the tics to be drawn outwards.
  2862.  <direction> may be in, out or nothing (which is the same as in).
  2863.  
  2864.  Entering 'tics' by itself simply shows the current tic size and direction.
  2865.  
  2866.  Example:
  2867.  
  2868.      » tic size 0.1 0.06
  2869.      » tics in
  2870. ≡timestamp
  2871. ≡notimestamp
  2872.  Purpose:
  2873.      Toggle Plotter Stamp On/Off
  2874.  
  2875.  Syntax:
  2876.  ┌──────────────────────────────────────────────────────────────────────┐
  2877.  │   timestamp                                                          │
  2878.  │   notimestamp                                                        │
  2879.  └──────────────────────────────────────────────────────────────────────┘
  2880.  
  2881.  Description:
  2882.  
  2883.  This command toggles the timestamp on and off on a non-screen plot
  2884.  (plotter or printer).  The timestamp is simply a message drawn near
  2885.  the bottom of the page as follows:
  2886.  
  2887.      Graphica version 2.5 Thu Mar 3 11:34:14 1994
  2888.  
  2889.  'timestamp' activates printing of the message ; 'notimestamp'
  2890.  deactivates it.  The default is OFF.  You may put a 'timestamp'
  2891.  command in your 'graphica.ini' initialization file if you'd like to
  2892.  generate this message in your hardcopy output.
  2893.  
  2894.  Examples:
  2895.  
  2896.      » timestamp
  2897.      » notimestamp
  2898.  
  2899.  Also see STARTUP.
  2900. ≡type
  2901. ≡more
  2902.  Purpose:
  2903.      Displays a File
  2904.  
  2905.  Syntax:
  2906.  ┌──────────────────────────────────────────────────────────────────────┐
  2907.  │   type <file>                                                        │
  2908.  │   more <file>                                                        │
  2909.  └──────────────────────────────────────────────────────────────────────┘
  2910.  
  2911.  Description:
  2912.  
  2913.  The 'type' command displays the contents of a file.  Pathnames, wildcards,
  2914.  and drive designators may be used in the usual way for your operating
  2915.  system.  Other operating system commands can be issued using the $
  2916.  character on the very first position of a line followed by a command.
  2917.  'more' is the UNIX version of the command.
  2918.  
  2919.  Examples:
  2920.  
  2921.      » type script.plt
  2922.  
  2923.  lists the ASCII file script.plt.
  2924.  
  2925.      » type foo
  2926.  
  2927.  lists the ASCII file foo.
  2928.  
  2929.  Also see DEL, DIR, SHELL and WHAT.
  2930. ≡units
  2931.  Purpose:
  2932.      Specify Drawing Units
  2933.  
  2934.  Syntax:
  2935.  ┌──────────────────────────────────────────────────────────────────────┐
  2936.  │   units <unit type>                                                  │
  2937.  └──────────────────────────────────────────────────────────────────────┘
  2938.  
  2939.  Description:
  2940.  
  2941.  It is sometimes desirable to use units other than inches, i.e., the
  2942.  metric system, with Graphica.  To change the unit of measure for
  2943.  parameters which are usually given in inches use the unit command.
  2944.  This command defines the units to be used in subsequent commands which
  2945.  represent a length or position normally supplied in inches, such as in
  2946.  paper size, subplot area, etc.
  2947.  
  2948.  The <unit type> may be 'in', 'cm' or 'mm'.
  2949.  
  2950.  Entering 'units' by itself simply shows the current units of measure.
  2951.  
  2952.  Changing the units of measure also changes the built-in variable
  2953.  'ufactor'.
  2954.  
  2955.  Example:
  2956.  
  2957.      » units cm
  2958.  
  2959.  See VARIABLES.
  2960. ≡variables
  2961. ≡userdefined
  2962. ≡who
  2963.  User-defined function syntax:
  2964.  ┌──────────────────────────────────────────────────────────────────────┐
  2965.  │   <function-name>( <dummyvar 1> {, <dummyvar 2> } ) = <expression>   │
  2966.  │                                                                      │
  2967.  │   where                                                              │
  2968.  │   <expression> is defined in terms of <dummyvar 1> and <dummyvar 2>  │
  2969.  └──────────────────────────────────────────────────────────────────────┘
  2970.  
  2971.  User-defined variable syntax:
  2972.  ┌──────────────────────────────────────────────────────────────────────┐
  2973.  │   <variable-name> = <constant-expression>                            │
  2974.  │   variables                                                          │
  2975.  └──────────────────────────────────────────────────────────────────────┘
  2976.  
  2977.  Description:
  2978.  
  2979.  You may define your own functions and variables.  User-defined functions
  2980.  and variables may be used anywhere an expression is called for.  A function
  2981.  refers to a general expression and can take one or two arguments (dummy
  2982.  variables).
  2983.  
  2984.  The WHO or VARIABLES command lists all pre-defined and user-defined
  2985.  variables together with their values.
  2986.  
  2987.  The following variables have already been defined for you:
  2988.  
  2989.      pi      = 3.14159
  2990.      e       = 2.71828
  2991.      catalan = 0.91597
  2992.      degree  = 0.01745
  2993.      ufactor = 1.00000
  2994.      gamma   = 0.57721
  2995.      golden  = 1.61803
  2996.  
  2997.  where pi is the mathematical constant π, e is the exponential constant,
  2998.  catalan is Catalan's constant, degree gives the number of radians in one
  2999.  degree (pi/180), ufactor is a conversion factor used to convert from
  3000.  inches to user-defined units (cm and mm), gamma is Euler's constant,
  3001.  and golden is the golden ratio (1+sqrt(5))/2.  These constants have
  3002.  been predefined for you but you may change them (so they are really
  3003.  variables).
  3004.  
  3005.  Examples:
  3006.  
  3007.      » w = 2
  3008.      » q = floor(tan(pi/2 - 0.1))
  3009.      » f(x) = sin(w*x)
  3010.      » sinc(x) = sin(pi*x)/(pi*x)
  3011.      » delta(t) = (t == 0)
  3012.      » ramp(t) = (t > 0) ? t : 0
  3013.      » comb(n,k) = n!/(k!*(n-k)!)
  3014.  
  3015.  Note:  case matters, e.g., 'Alpha' is different from 'alpha'.
  3016.  Also see FUNCTIONS.
  3017. ≡view
  3018.  Purpose:
  3019.      Move Paper to View Plotter Output
  3020.  
  3021.  Syntax:
  3022.  ┌──────────────────────────────────────────────────────────────────────┐
  3023.  │   view                                                               │
  3024.  └──────────────────────────────────────────────────────────────────────┘
  3025.  
  3026.  Description:
  3027.  
  3028.  Retracts the pen and advances the paper on a pen plotter to view the
  3029.  graph fully.  This command is similar to pushing the VIEW button on
  3030.  Hewlett-Packard HP7475 or HP7550 plotters.
  3031.  
  3032.  Example:
  3033.  
  3034.      » view
  3035.  
  3036.  would move the plotting paper outward into view.
  3037. ≡x
  3038. ≡y
  3039. ≡x2
  3040. ≡y2
  3041. ≡logarithmic
  3042. ≡linear
  3043. ≡sqr
  3044.  Purpose:
  3045.      Specify Axis Type
  3046.  
  3047.  Syntax:
  3048.  ┌──────────────────────────────────────────────────────────────────────┐
  3049.  │   {x,y,y2,x2} {linear,logarithmic,probability,sqr}                   │
  3050.  └──────────────────────────────────────────────────────────────────────┘
  3051.  
  3052.  Description:
  3053.  
  3054.  With this command, the kind of axis to be plotted may be specified, as
  3055.  follows:
  3056.  
  3057.  linear - specifies a linear axis.  A linear scale is a standard base 10
  3058.  numeric scale.  This is the default.
  3059.  
  3060.  logarithmic - specifies a log axis.  A log scale is a base 10
  3061.  logarithmic scale.  If a regression has been performed, the values for
  3062.  that particular axis are logarithmic.  Given the mapped range for an
  3063.  axis, the logarithmic range for that axis will be determined
  3064.  automatically.  If an axis is to be logarithmic, there is no need to
  3065.  specify the number of divisions or the format.  If the range is
  3066.  negative as specified in a map command, Graphica automatically converts
  3067.  it to positive.  Zero values for min or max will cause the log axis to
  3068.  begin at 0.001.
  3069.  
  3070.  probability - a probability scale is the inverse of the Gaussian
  3071.  cumulative distribution function.  Thus the graph of the sigmoidally
  3072.  shaped Gaussian cumulative distribution function on a probability scale
  3073.  will be a straight line.
  3074.  
  3075.  Probabilities are expressed as a percentage so that the range of the
  3076.  scale is from 0 to 100.  The minimum and maximum values that a
  3077.  probability axis can take in Graphica are 0.01 and 99.99.  A probability
  3078.  axis label could be specified as something like "cumulative frequency, %".
  3079.  
  3080.  sqr - square-root axis.  Used in some engineering applications.  A square
  3081.  root scale is based on the square root of the axis in question.
  3082.  
  3083.  Examples:
  3084.  
  3085.      » x lin
  3086.      » y log
  3087.      » x2 pro
  3088.      » x sqr
  3089. ≡xlabel
  3090. ≡ylabel
  3091. ≡x2label
  3092. ≡y2label
  3093.  Purpose:
  3094.      Draw an Axis Label
  3095.  
  3096.  Syntax:
  3097.  ┌──────────────────────────────────────────────────────────────────────┐
  3098.  │   {xlabel,x2label,ylabel,y2label} 'string' {rotate}                  │
  3099.  └──────────────────────────────────────────────────────────────────────┘
  3100.  
  3101.  Description:
  3102.  
  3103.  This command draws a centered label for that axis.  The label text must
  3104.  be enclosed in single or double quotes.  All labels are drawn using the
  3105.  current character font and size.  The label bottom command is equivalent
  3106.  to the xlabel command.  Likewise, the 'label top', 'left', and 'right'
  3107.  commands are equivalent to the 'x2label', 'ylabel' and 'y2label' commands.
  3108.  
  3109.  The ROTATE switch turns the labels around 180 degrees.  This may
  3110.  become especially useful when drawing the y2-label (some people prefer
  3111.  the y2-label to "face" left rather than right).
  3112.  
  3113.  Examples:
  3114.  
  3115.      » xlabel 'This is the x-axis label'
  3116.      » ylabel 'This is the y-axis label'
  3117.      » y2label 'rotated y2-label' rotate
  3118. ≡expressions
  3119.  Syntax:
  3120.  ┌──────────────────────────────────────────────────────────────────────┐
  3121.  │   <expression>                                                       │
  3122.  └──────────────────────────────────────────────────────────────────────┘
  3123.  
  3124.  Description:
  3125.  
  3126.  You can determine the value of expressions or variables by just typing
  3127.  the expression or variable at the » prompt.
  3128.  
  3129.  In general, any mathematical expression accepted by C, FORTRAN, Pascal,
  3130.  or BASIC is valid.  The precedence of these operators is determined by
  3131.  the specifications of the C programming language.  White space (spaces
  3132.  and tabs) is ignored inside expressions.
  3133.  
  3134.  Complex variables may be expressed as {<real>,<imag>}, where <real> and
  3135.  <imag> must be numbers.  For example, {3,2} represents 3 + 2i; {0,1}
  3136.  represents 'i' itself.  The curly braces are explicitly required.
  3137.  
  3138.  Examples:
  3139.  
  3140.      » 2*3
  3141.  
  3142.  would print out '2*3 = 6'
  3143.  
  3144.      » 30+2*2
  3145.  
  3146.  would print out '30+2*2 = 34'
  3147. ≡complex
  3148.  Syntax:
  3149.  ┌──────────────────────────────────────────────────────────────────────┐
  3150.  │   Complex Variables                                                  │
  3151.  └──────────────────────────────────────────────────────────────────────┘
  3152.  
  3153.  Complex variables may be expressed as {<real>,<imag>}, where <real> and
  3154.  <imag> must be numbers.  For example, {3,2} represents 3 + 2i; {0,1}
  3155.  represents 'i' itself.  The curly braces are explicitly required.
  3156.  
  3157.  Also see EXPRESSIONS and FUNCTIONS.
  3158. ≡expressions functions
  3159. ≡functions
  3160.  Syntax:
  3161.  ┌──────────────────────────────────────────────────────────────────────┐
  3162.  │   functions                                                          │
  3163.  └──────────────────────────────────────────────────────────────────────┘
  3164.  
  3165.  All functions in Graphica accept integer, real, and complex arguments,
  3166.  unless otherwise noted.
  3167.  
  3168.  The 'functions' command by itself lists all user-defined functions and
  3169.  their definitions.
  3170.  
  3171.  Graphica also supports the following special functions:
  3172.  
  3173.  Gamma function                                     y = gamma( x )
  3174.  Natural logarithm of gamma function                y = lgamma( x )
  3175.  
  3176.  Incomplete gamma integral                          y = igamma( a, x )
  3177.  Complemented incomplete gamma integral             y = igamc( a, x )
  3178.  Inverse of complemented incomplete gamma integral  x = igami( a, y )
  3179.  
  3180.  Incomplete beta integral                           y = ibeta( a, b, x )
  3181.  Inverse of incomplete beta integral                x = ibetai( a, b, y )
  3182.  
  3183.  Error function                                     y = erf( x )
  3184.  Complementary error function                       y = erfc( x )
  3185.  Inverse error function                             x = ierf( y )
  3186.  
  3187.  Also see VARIABLES.
  3188. ≡expressions functions abs
  3189. ≡functions abs
  3190. ≡abs
  3191.  ┌──────────────────────────────────────────────────────────────────────┐
  3192.  │   abs                                                                │
  3193.  └──────────────────────────────────────────────────────────────────────┘
  3194.  
  3195.  abs(z) returns the absolute value of the real or complex number z.
  3196.  The returned value is of the same type as the argument.  For complex
  3197.  arguments, abs(z) returns the complex modulus (magnitude) defined as
  3198.  the length of z in the complex plane:
  3199.  
  3200.      sqrt( real(z)**2 + imag(z)**2 )
  3201. ≡expressions functions acos
  3202. ≡functions acos
  3203. ≡acos
  3204.  ┌──────────────────────────────────────────────────────────────────────┐
  3205.  │   acos                                                               │
  3206.  └──────────────────────────────────────────────────────────────────────┘
  3207.  
  3208.  acos(z) returns the arc cosine (inverse cosine) of z.  All results
  3209.  are given in radians.  For real z, such that abs(z) <= 0.0, the
  3210.  result is in the range 0 to π.  Complex results are obtained if
  3211.  abs(z) > 1.0, or if z is complex.  The complex arc cosine is defined as:
  3212.  
  3213.      acos(z) = -i log( z + i sqrt(1-z**2) )
  3214. ≡expressions functions acosh
  3215. ≡functions acosh
  3216. ≡acosh
  3217.  ┌──────────────────────────────────────────────────────────────────────┐
  3218.  │   acosh                                                              │
  3219.  └──────────────────────────────────────────────────────────────────────┘
  3220.  
  3221.  acosh(z) returns the arc hyperbolic cosine (inverse hyperbolic cosine)
  3222.  of z.  All results are given in radians.  For real z, such that abs(z) <=
  3223.  0.0, the result is in the range 0 to π.  Complex results are obtained if
  3224.  abs(z) > 1.0, or if z is complex.  The complex arc cosine is defined as:
  3225.  
  3226.      acosh(z) = -i log( z + i sqrt(1-z**2) )
  3227. ≡expressions functions arg
  3228. ≡functions arg
  3229. ≡arg
  3230.  ┌──────────────────────────────────────────────────────────────────────┐
  3231.  │   arg                                                                │
  3232.  └──────────────────────────────────────────────────────────────────────┘
  3233.  
  3234.  arg(z) returns the phase angle of a complex number z, in radians.
  3235.  The result is always between -π and π.
  3236.  For complex z = x + iy = r exp(i theta), the magnitude and phase
  3237.  are given by
  3238.  
  3239.      r = abs(z)
  3240.      theta = arg(z)
  3241. ≡expressions functions asin
  3242. ≡functions asin
  3243. ≡asin
  3244.  ┌──────────────────────────────────────────────────────────────────────┐
  3245.  │   asin                                                               │
  3246.  └──────────────────────────────────────────────────────────────────────┘
  3247.  
  3248.  asin(z) returns the arc sine (inverse sine) of z.  All results are
  3249.  given in radians.  For real z, such that abs(z) <= 1.0, the result is
  3250.  in the range -π/2 to π/2.  Complex results are obtained if abs(z) >
  3251.  1.0, or if z is complex.  The complex arc sine is defined as:
  3252.  
  3253.      asin(z) = -i log( iz + sqrt(1-z**2) )
  3254. ≡expressions functions asinh
  3255. ≡functions asinh
  3256. ≡asinh
  3257.  ┌──────────────────────────────────────────────────────────────────────┐
  3258.  │   asinh                                                              │
  3259.  └──────────────────────────────────────────────────────────────────────┘
  3260.  
  3261.  asinh(z) returns the arc hyperbolic sine (inverse hyperbolic sine)
  3262.  of z.  All results are given in radians.  For real z, such that
  3263.  abs(z) <= 1.0, the result is in the range -π/2 to π/2.  Complex
  3264.  results are obtained if abs(z) > 1.0, or if z is complex.  The
  3265.  complex arc sine is defined as:
  3266.  
  3267.      asinh(z) = -i log( iz + sqrt(1-z**2) )
  3268. ≡expressions functions atan
  3269. ≡functions atan
  3270. ≡atan
  3271.  ┌──────────────────────────────────────────────────────────────────────┐
  3272.  │   atan                                                               │
  3273.  └──────────────────────────────────────────────────────────────────────┘
  3274.  
  3275.  atan(z) returns the arc tangent (inverse tangent) of z.  All results
  3276.  are given in radians.  For real z, the result is in the range -π/2 to
  3277.  π/2.  If z is complex, the complex arc tangent is returned:
  3278.  
  3279.      atan(z) = i/2 log( (i+z) / (i-z) )
  3280. ≡expressions functions atanh
  3281. ≡functions atanh
  3282. ≡atanh
  3283.  ┌──────────────────────────────────────────────────────────────────────┐
  3284.  │   atanh                                                              │
  3285.  └──────────────────────────────────────────────────────────────────────┘
  3286.  
  3287.  atanh(z) returns the arc hyperbolic tangent (inverse hyperbolic
  3288.  tangent) of z.  All results are given in radians.  For real z, the
  3289.  result is in the range -π/2 to π/2.  If z is complex, the complex arc
  3290.  tangent is returned:
  3291.  
  3292.      atanh(z) = i/2 log( (i+z) / (i-z) )
  3293. ≡expressions functions ibeta
  3294. ≡functions ibeta
  3295. ≡ibeta
  3296.  ┌──────────────────────────────────────────────────────────────────────┐
  3297.  │   ibeta                                                              │
  3298.  └──────────────────────────────────────────────────────────────────────┘
  3299.  
  3300.  ibeta(p,q,z) returns the incomplete beta function of the real parts of
  3301.  its arguments (p, q>0 and 0<z<1).  If the arguments are complex, the
  3302.  imaginary components are ignored.  The function is defined as
  3303.   
  3304.                     x
  3305.        -            -
  3306.       | (a+b)      | |  a-1     b-1
  3307.     -----------    |   t   (1-t)   dt.
  3308.      -     -     | |
  3309.     | (a) | (b)   -
  3310.                    0
  3311.  
  3312. ≡expressions functions ibetai
  3313. ≡functions ibetai
  3314. ≡ibetai
  3315.  ┌──────────────────────────────────────────────────────────────────────┐
  3316.  │   ibetai                                                             │
  3317.  └──────────────────────────────────────────────────────────────────────┘
  3318.  
  3319.  x = ibetai(a,b,y) returns the inverse of the incomplete beta function
  3320.  of the real parts of its arguments (p, q>0 and 0<z<1).  If the arguments
  3321.  are complex, the imaginary components are ignored.  Given y, the function
  3322.  finds x such that ibeta( a, b, x ) = y.
  3323. ≡expressions functions ceil
  3324. ≡functions ceil
  3325. ≡ceil
  3326.  ┌──────────────────────────────────────────────────────────────────────┐
  3327.  │   ceil                                                               │
  3328.  └──────────────────────────────────────────────────────────────────────┘
  3329.  
  3330.  ceil(z) returns the smallest integer greater than z.  For complex
  3331.  numbers, ceil returns the smallest integer greater than the real part of z.
  3332. ≡expressions functions cos
  3333. ≡functions cos
  3334. ≡cos
  3335.  ┌──────────────────────────────────────────────────────────────────────┐
  3336.  │   cos                                                                │
  3337.  └──────────────────────────────────────────────────────────────────────┘
  3338.  
  3339.  cos(z) returns the cosine of z, where z is in radians.
  3340.  For complex z = x + iy, the complex cosine is returned:
  3341.  
  3342.      cos(z) = cos(x) cosh(y) - u sin(x) sinh(y)
  3343. ≡expressions functions cosh
  3344. ≡functions cosh
  3345. ≡cosh
  3346.  ┌──────────────────────────────────────────────────────────────────────┐
  3347.  │   cosh                                                               │
  3348.  └──────────────────────────────────────────────────────────────────────┘
  3349.  
  3350.  cosh(z) returns the hyperbolic cosine of z, where z is in radians.
  3351. ≡expressions functions exp
  3352. ≡functions exp
  3353. ≡exp
  3354.  ┌──────────────────────────────────────────────────────────────────────┐
  3355.  │   exp                                                                │
  3356.  └──────────────────────────────────────────────────────────────────────┘
  3357.  
  3358.  exp(z) returns the exponential function of z (e raised to the power
  3359.  of z).  For complex z = x + iy, the complex exponential is returned:
  3360.  
  3361.      exp(z) = exp(x) ( cos(y) + i sin(y) )
  3362. ≡expressions functions erf
  3363. ≡functions erf
  3364. ≡erf
  3365.  ┌──────────────────────────────────────────────────────────────────────┐
  3366.  │   erf                                                                │
  3367.  └──────────────────────────────────────────────────────────────────────┘
  3368.  
  3369.  erf(x) returns the error function of x.  erf(x) is the integral of the
  3370.  normal (Gaussian) probability distribution function from 0 to x.  The
  3371.  error function is central to many calculations in statistics.  It is
  3372.  defined as:
  3373.  
  3374.      erf(x) = 2/sqrt(pi) integral(0,x) exp(-t^2)
  3375.  
  3376.  Also see ERFC and IERF.
  3377. ≡expressions functions erfc
  3378. ≡functions erfc
  3379. ≡erfc
  3380.  ┌──────────────────────────────────────────────────────────────────────┐
  3381.  │   erfc                                                               │
  3382.  └──────────────────────────────────────────────────────────────────────┘
  3383.  
  3384.  erfc(x) returns the complementary error function of x.  erfc(x) is
  3385.  simply 1.0 - erf(x), where erf(x) is the integral of the normal
  3386.  (Gaussian) probability distribution function from 0 to x.
  3387.  
  3388.     1 - erf(x) =  
  3389.                              inf 
  3390.                                -
  3391.                     2         | |          2
  3392.      erfc(x)  =  --------     |    exp( - t  ) dt
  3393.                  sqrt(pi)   | |
  3394.                              -
  3395.                               x
  3396.  Also see ERF and IERF.
  3397. ≡expressions functions floor
  3398. ≡functions floor
  3399. ≡floor
  3400.  ┌──────────────────────────────────────────────────────────────────────┐
  3401.  │   floor                                                              │
  3402.  └──────────────────────────────────────────────────────────────────────┘
  3403.  
  3404.  floor(z) returns the greatest integer less than or equal to z.  For
  3405.  complex numbers, floor returns the largest integer not greater than
  3406.  the real part of z.
  3407. ≡expressions functions gamma
  3408. ≡functions gamma
  3409. ≡gamma
  3410.  ┌──────────────────────────────────────────────────────────────────────┐
  3411.  │   gamma                                                              │
  3412.  └──────────────────────────────────────────────────────────────────────┘
  3413.  
  3414.  gamma(z) returns the gamma function of the real part of z.  For
  3415.  integer z, gamma(z+1) = z!.  If z is a complex value, the imaginary
  3416.  component is ignored.
  3417.  
  3418.  Also see IGAMMA, LGAMMA, IGAMC, IGAMI.
  3419. ≡expressions functions lgamma
  3420. ≡functions lgamma
  3421. ≡lgamma
  3422.  ┌──────────────────────────────────────────────────────────────────────┐
  3423.  │   lgamma                                                             │
  3424.  └──────────────────────────────────────────────────────────────────────┘
  3425.  
  3426.  lgamma(z) returns the base e (2.718...) logarithm of the absolute
  3427.  value of the gamma function of the argument.
  3428.  
  3429.  Also see GAMMA, IGAMMA, IGAMC, IGAMI.
  3430. ≡expressions functions igamc
  3431. ≡functions igamc
  3432. ≡igamc
  3433.  ┌──────────────────────────────────────────────────────────────────────┐
  3434.  │   igamc                                                              │
  3435.  └──────────────────────────────────────────────────────────────────────┘
  3436.  
  3437.  igamc(a,x) returns the complemented incomplete gamma integral.  This
  3438.  function is defined by
  3439.   
  3440.     igamc(a,x)   =   1 - igamma(a,x)
  3441.   
  3442.                               inf
  3443.                                 -
  3444.                        1       | |  -t  a-1
  3445.                  =   -----     |   e   t   dt.
  3446.                       -      | |
  3447.                      | (a)    -
  3448.                                x
  3449.  
  3450.  Also see GAMMA, IGAMMA, LGAMMA, IGAMI.
  3451. ≡expressions functions igami
  3452. ≡functions igami
  3453. ≡igami
  3454.  ┌──────────────────────────────────────────────────────────────────────┐
  3455.  │   igami                                                              │
  3456.  └──────────────────────────────────────────────────────────────────────┘
  3457.  
  3458.  igami(a,y) returns the inverse of the complemented incomplete gamma
  3459.  integral.  Given y, the function finds x such that igamc( a, x ) = y.
  3460.  
  3461.  Also see GAMMA, IGAMMA, LGAMMA, IGAMC.
  3462. ≡expressions functions ierf
  3463. ≡functions ierf
  3464. ≡ierf
  3465.  ┌──────────────────────────────────────────────────────────────────────┐
  3466.  │   ierf                                                               │
  3467.  └──────────────────────────────────────────────────────────────────────┘
  3468.  
  3469.  ierf(z) returns the inverse error function of the real part of z.  The
  3470.  error function, erf(x), is the integral of the normal (Gaussian)
  3471.  probability distribution function from 0 to x.
  3472.  
  3473.  Also see ERF and ERFC.
  3474. ≡expressions functions igamma
  3475. ≡functions igamma
  3476. ≡igamma
  3477.  ┌──────────────────────────────────────────────────────────────────────┐
  3478.  │   igamma                                                             │
  3479.  └──────────────────────────────────────────────────────────────────────┘
  3480.  
  3481.  igamma(a,z) returns the incomplete gamma function of the real parts of
  3482.  its arguments (a > 0 and z >= 0).  If the arguments are complex, the
  3483.  imaginary components are ignored.
  3484.  
  3485.  The function is defined by
  3486.                                x
  3487.                                 -
  3488.                        1       | |  -t  a-1
  3489.     igamma(a,x)  =   -----     |   e   t   dt.
  3490.                       -      | |
  3491.                      | (a)    -
  3492.                                0
  3493.  
  3494.  Also see GAMMA and FUNCTIONS.
  3495. ≡expressions functions imag
  3496. ≡functions imag
  3497. ≡imag
  3498.  ┌──────────────────────────────────────────────────────────────────────┐
  3499.  │   imag                                                               │
  3500.  └──────────────────────────────────────────────────────────────────────┘
  3501.  
  3502.  imag(z) returns the imaginary part of z as a real number.
  3503. ≡expressions functions int
  3504. ≡functions int
  3505. ≡int
  3506.  ┌──────────────────────────────────────────────────────────────────────┐
  3507.  │   int                                                                │
  3508.  └──────────────────────────────────────────────────────────────────────┘
  3509.  
  3510.  int(z) returns the integer part of z, truncated toward zero.
  3511. ≡expressions functions ln
  3512. ≡functions ln
  3513. ≡ln
  3514.  ┌──────────────────────────────────────────────────────────────────────┐
  3515.  │   ln                                                                 │
  3516.  └──────────────────────────────────────────────────────────────────────┘
  3517.  
  3518.  ln(z) returns the natural logarithm (base e) of z.  For complex or
  3519.  negative z, the complex logarithm is returned:
  3520.  
  3521.      ln(z) = ln( abs(z) ) + i atan2( y, x )
  3522. ≡expressions functions log
  3523. ≡functions log
  3524. ≡log
  3525.  ┌──────────────────────────────────────────────────────────────────────┐
  3526.  │   log                                                                │
  3527.  └──────────────────────────────────────────────────────────────────────┘
  3528.  
  3529.  log(z) returns the logarithm (base 10) of z.  For complex or
  3530.  negative z, the complex logarithm is returned:
  3531.  
  3532.      log(z) = log( abs(z) ) + i atan2( y, x )
  3533. ≡expressions functions rand
  3534. ≡functions rand
  3535. ≡rand
  3536.  Syntax:
  3537.  ┌──────────────────────────────────────────────────────────────────────┐
  3538.  │   rand                                                               │
  3539.  └──────────────────────────────────────────────────────────────────────┘
  3540.  
  3541.  Syntax:
  3542.  
  3543.      rand
  3544.      rand(0)
  3545.      rand(1)
  3546.  
  3547.  Description:
  3548.  
  3549.  rand(0) returns a pseudorandom number in the interval (0.0,1.0)
  3550.  using a uniform distribution.  rand(1) returns a pseudorandom
  3551.  number using a normal distribution with mean 0.0 and variance 1.0.
  3552.  
  3553.  Entering 'rand' by itself is equivalent to entering 'rand(0)'.
  3554.  
  3555.  When Graphica starts up, it takes the time of day (measured in
  3556.  small fractions of a second) as the seed for the pseudorandom
  3557.  number generator.  Two different Graphica sessions will therefore
  3558.  almost always give different sequences of pseudorandom numbers.
  3559.  
  3560.  If you want to make sure that you always get the same sequence
  3561.  of pseudorandom numbers, you can explicitly give a seed for the
  3562.  pseudorandom number generator, using 'seed'.
  3563.  
  3564.  Examples:
  3565.  
  3566.      » rand(0)
  3567.      » plot rand(0) add
  3568.      » rand
  3569.      » rand(1)
  3570.  
  3571.  Also see FUNCTIONS and SEED.
  3572. ≡seed
  3573.  Purpose:
  3574.      Seed the Random Number Generator
  3575.  
  3576.  Syntax:
  3577.  ┌──────────────────────────────────────────────────────────────────────┐
  3578.  │   seed                                                               │
  3579.  └──────────────────────────────────────────────────────────────────────┘
  3580.  
  3581.  Syntax:
  3582.  
  3583.      seed n
  3584.  
  3585.  Description:
  3586.  
  3587.  'seed' explicitly gives a seed for the pseudorandom number generator.
  3588.  
  3589.  Example:
  3590.  
  3591.      » seed 321
  3592.      » rand
  3593.  rand = 0.27789
  3594.      » rand
  3595.  rand = 0.41721
  3596.  
  3597.  To repeat the sequence exactly, reseed the number generator:
  3598.  
  3599.      » seed 321
  3600.      » rand
  3601.  rand = 0.27789
  3602.      » rand
  3603.  rand = 0.41721
  3604.  
  3605.  Also see RAND.
  3606. ≡expressions functions real
  3607. ≡functions real
  3608. ≡real
  3609.  ┌──────────────────────────────────────────────────────────────────────┐
  3610.  │   real                                                               │
  3611.  └──────────────────────────────────────────────────────────────────────┘
  3612.  
  3613.  real(z) returns the real part of z.
  3614. ≡expressions functions sgn
  3615. ≡functions sgn
  3616. ≡sgn
  3617.  ┌──────────────────────────────────────────────────────────────────────┐
  3618.  │   sgn                                                                │
  3619.  └──────────────────────────────────────────────────────────────────────┘
  3620.  
  3621.  sgn(z) returns 1 if z is positive, -1 if z is negative, and 0 if z is 0.
  3622.  If z is a complex value, the imaginary component is ignored.
  3623. ≡expressions functions sin
  3624. ≡functions sin
  3625. ≡sin
  3626.  ┌──────────────────────────────────────────────────────────────────────┐
  3627.  │   sin                                                                │
  3628.  └──────────────────────────────────────────────────────────────────────┘
  3629.  
  3630.  sin(z) returns the sine of z, where z is in radians.
  3631.  For complex z = x + iy, the complex sine is returned:
  3632.  
  3633.      sin(z) = sin(x) cosh(y) - i cos(x) sinh(y)
  3634. ≡expressions functions sinh
  3635. ≡functions sinh
  3636. ≡sinh
  3637.  ┌──────────────────────────────────────────────────────────────────────┐
  3638.  │   sinh                                                               │
  3639.  └──────────────────────────────────────────────────────────────────────┘
  3640.  
  3641.  sinh(z) returns the hyperbolic sine of z, where z is in radians.
  3642. ≡expressions functions sqrt
  3643. ≡functions sqrt
  3644. ≡sqrt
  3645.  ┌──────────────────────────────────────────────────────────────────────┐
  3646.  │   sqrt                                                               │
  3647.  └──────────────────────────────────────────────────────────────────────┘
  3648.  
  3649.  sqrt(z) returns the square root of z.
  3650. ≡expressions functions tan
  3651. ≡functions tan
  3652. ≡tan
  3653.  ┌──────────────────────────────────────────────────────────────────────┐
  3654.  │   tan                                                                │
  3655.  └──────────────────────────────────────────────────────────────────────┘
  3656.  
  3657.  tan(z) returns the tangent of z, where z is in radians.
  3658.  For complex z, the complex tangent sin(z)/cos(z) is returned.
  3659. ≡expressions functions tanh
  3660. ≡functions tanh
  3661. ≡tanh
  3662.  ┌──────────────────────────────────────────────────────────────────────┐
  3663.  │   tanh                                                               │
  3664.  └──────────────────────────────────────────────────────────────────────┘
  3665.  
  3666.  tanh(z) returns the hyperbolic tangent of z, where z is in radians.
  3667. ≡expressions operators
  3668. ≡operators
  3669.  ┌──────────────────────────────────────────────────────────────────────┐
  3670.  │   Operators                                                          │
  3671.  └──────────────────────────────────────────────────────────────────────┘
  3672.  
  3673.  All operators in Graphica accept integer, real, and complex arguments,
  3674.  unless otherwise noted.  The ** operator (exponentiation) is supported,
  3675.  as in FORTRAN.
  3676.  
  3677.  Parentheses may be used to change the order of evaluation.
  3678. ≡expressions operators binary
  3679. ≡operators binary
  3680. ≡binary
  3681.  ┌──────────────────────────────────────────────────────────────────────┐
  3682.  │   Binary Operators                                                   │
  3683.  └──────────────────────────────────────────────────────────────────────┘
  3684.  
  3685.  The following is a list of all the binary operators and their usage:
  3686.  
  3687.          symbol             example              explanation
  3688.  
  3689.           **                 a**b                 exponentiation
  3690.           *                  a*b                  multiplication
  3691.           /                  a/b                  division
  3692.           \                  a\b                  left division
  3693.           %                  a%b                * modulo
  3694.           +                  a+b                  addition
  3695.           -                  a-b                  subtraction
  3696.           ==                 a==b                 equality
  3697.           !=                 a!=b                 inequality
  3698.           &                  a&b                * bitwise AND
  3699.           ^                  a^b                * bitwise exclusive OR
  3700.           |                  a|b                * bitwise inclusive OR
  3701.           &&                 a&&b               * logical AND
  3702.           ||                 a||b               * logical OR
  3703.  
  3704.           (*) Operator requires integer arguments.
  3705.  
  3706.  Logical AND (&&) and OR (||) short-circuit the way they do in C.  That
  3707.  is, the second && operand is not evaluated if the first is false;  the
  3708.  second || operand is not evaluated if the first is true.
  3709.  
  3710.  Multiplication must be explicitly noted with the asterisk;  adjacent
  3711.  parenthetical terms such as (a+b)(c-4) are not automatically multiplied.
  3712.  
  3713.  The left division a\b is equivalent to b/a.
  3714. ≡expressions operators ternary
  3715. ≡operators ternary
  3716. ≡ternary
  3717.  ┌──────────────────────────────────────────────────────────────────────┐
  3718.  │   Ternary Operators                                                  │
  3719.  └──────────────────────────────────────────────────────────────────────┘
  3720.  
  3721.  The following is a list of the ternary operator and its usage:
  3722.  
  3723.           symbol             example              explanation
  3724.  
  3725.            ≡:                 a≡b:c              * ternary operation
  3726.  
  3727.           (*) Operator requires an integer argument.
  3728.  
  3729.  The ternary operator evaluates its first argument (a).  If it is true
  3730.  (non-zero) the second argument (b) is evaluated and returned, otherwise
  3731.  the third argument (c) is evaluated and returned.
  3732. ≡expressions operators unary
  3733. ≡operators unary
  3734. ≡unary
  3735.  ┌──────────────────────────────────────────────────────────────────────┐
  3736.  │   Unary Operators                                                    │
  3737.  └──────────────────────────────────────────────────────────────────────┘
  3738.  
  3739.      The following is a list of all the unary operators and their usage:
  3740.  
  3741.           symbol             example              explanation
  3742.  
  3743.            -                  -a                   unary minus
  3744.            ~                  ~a                 * one's complement
  3745.            !                  !a                 * logical negation
  3746.            !                  a!                 * factorial
  3747.  
  3748.           (*) Operator requires an integer argument.
  3749.  
  3750.  The factorial operator returns a real number to allow a greater range.
  3751. ≡probability
  3752.  ┌──────────────────────────────────────────────────────────────────────┐
  3753.  │   Probability Distribution Functions                                 │
  3754.  └──────────────────────────────────────────────────────────────────────┘
  3755.  
  3756.  Probability distribution functions are used in the mathematics areas of
  3757.  probability and statistics.  If an experiment can occur in 'n' mutually
  3758.  exclusive and equally likely ways, and if exactly 'm' of these ways
  3759.  correspond to an event 'E', then the probability of 'E' is given by
  3760.  
  3761.             m
  3762.      P(E) = -.
  3763.             n
  3764.  
  3765.  The probability that the value of a random variable 'X' is less than or
  3766.  equal to some real number 'x' is defined as
  3767.  
  3768.      F(x) = P(X ≤ x), -∞ < x < ∞
  3769.           = integral(-∞ to x) f(x) dx
  3770.  
  3771.  where f(x) is called the probability density of the random variable X.
  3772.  
  3773.  Graphica implements 20 probability distribution functions.  Refer to
  3774.  a good statistics textbook for details.  The functions are:
  3775.  
  3776.    Binomial distribution                            y = bdtr( k, n, p )
  3777.    Complemented Binomial distribution               y = bdtrc( k, n, p )
  3778.    Inverse Binomial distribution                    p = bdtri( k, n, y )
  3779.  
  3780.    Negative Binomial distribution                   y = nbdtr( k, n, p )
  3781.    Complemented Negative Binomial distribution      y = nbdtrc( k, n, p )
  3782.  
  3783.    Beta distribution                                y = btdtr( a, b, x )
  3784.  
  3785.    Chi-square distribution                          y = chdtr( df, x )
  3786.    Complemented Chi-square distribution             y = chdtrc( v, x )
  3787.    Inverse of Complemented Chi-square distribution  x = chdtri( df, y )
  3788.  
  3789.    F distribution                                   y = fdtr( df1, df2, x )
  3790.    Complemented F distribution                      y = fdtrc( df1, df2, x )
  3791.    Inverse of Complemented F distribution           x = fdtri( df1, df2, y )
  3792.  
  3793.    Gamma distribution                               y = gdtr( a, b, x )
  3794.    Complemented Gamma distribution                  y = gdtrc( a, b, x )
  3795.  
  3796.    Normal distribution                              y = ndtr( x )
  3797.    Inverse of Normal distribution                   x = ndtri( y )
  3798.  
  3799.    Poisson distribution                             y = pdtr( k, m )
  3800.    Complemented Poisson distribution                y = pdtrc( k, m )
  3801.    Inverse Poisson distribution                     m = pdtri( k, y )
  3802.  
  3803.    Student's t distribution                         y = stdtr( k, t )
  3804.  
  3805.  Also see BDTR, BDTRC, BDTRI, NBDTR, NBDTRC, BTDTR, CHDTR, CHDTRC,
  3806.  CHDTRI, FDTR, FDTRC, FDTRI, GDTR, GDTRC, NDTR, NDTRI, PDTR, PDTRC,
  3807.  PDTRI, and STDTR for more details.
  3808. ≡expressions functions bdtr
  3809. ≡functions bdtr
  3810. ≡bdtr
  3811.  ┌──────────────────────────────────────────────────────────────────────┐
  3812.  │   bdtr                                                               │
  3813.  └──────────────────────────────────────────────────────────────────────┘
  3814.  
  3815.  Description:
  3816.  
  3817.  bdtr(k,n,p) returns the sum of the terms 0 through k of the Binomial
  3818.  probability density:
  3819.  
  3820.      k
  3821.      --  ( n )   j      n-j
  3822.      >   (   )  p  (1-p)
  3823.      --  ( j )
  3824.      j=0
  3825.  
  3826.  The terms are not summed directly;  instead the incomplete beta
  3827.  integral is employed, according to the formula
  3828.  
  3829.      y = bdtr( k, n, p ) = ibeta( n-k, k+1, 1-p ).
  3830.  
  3831.  The arguments must be positive, with p ranging from 0 to 1.
  3832.  
  3833.  Also see FUNCTIONS and PROBABILITY.
  3834. ≡expressions functions bdtrc
  3835. ≡functions bdtrc
  3836. ≡bdtrc
  3837.  ┌──────────────────────────────────────────────────────────────────────┐
  3838.  │   bdtrc                                                              │
  3839.  └──────────────────────────────────────────────────────────────────────┘
  3840.  
  3841.  Description:
  3842.  
  3843.  bdtrc(k,n,p) returns the sum of the terms k+1 through n of the Binomial
  3844.  probability density:
  3845.  
  3846.      n
  3847.      --  ( n )   j      n-j
  3848.      >   (   )  p  (1-p)
  3849.      --  ( j )
  3850.      j=k+1
  3851.  
  3852.  The terms are not summed directly;  instead the incomplete beta integral
  3853.  is employed, according to the formula
  3854.   
  3855.      y = bdtrc( k, n, p ) = ibeta( k+1, n-k, p ).
  3856.   
  3857.  The arguments must be positive, with p ranging from 0 to 1.
  3858.  
  3859.  Also see FUNCTIONS and PROBABILITY.
  3860. ≡expressions functions bdtri
  3861. ≡functions bdtri
  3862. ≡bdtri
  3863.  ┌──────────────────────────────────────────────────────────────────────┐
  3864.  │   bdtri                                                              │
  3865.  └──────────────────────────────────────────────────────────────────────┘
  3866.  
  3867.  Description:
  3868.  
  3869.  bdtri(k,n,y) finds the event probability p such that the sum of the
  3870.  terms 0 through k of the Binomial probability density is equal to the
  3871.  given cumulative probability y.  This is accomplished using the inverse
  3872.  beta integral function and the relation
  3873.  
  3874.      1 - p = ibetai( n-k, k+1, y ).
  3875.  
  3876.  Also see FUNCTIONS and PROBABILITY.
  3877. ≡expressions functions nbdtr
  3878. ≡functions nbdtr
  3879. ≡nbdtr
  3880.  ┌──────────────────────────────────────────────────────────────────────┐
  3881.  │   nbdtr                                                              │
  3882.  └──────────────────────────────────────────────────────────────────────┘
  3883.  
  3884.  Description:
  3885.  
  3886.  nbdtr(k,n,p) returns the sum of the terms 0 through k of the negative
  3887.  binomial distribution:
  3888.  
  3889.      k
  3890.      --  ( n+j-1 )   n      j
  3891.      >   (       )  p  (1-p)
  3892.      --  (   j   )
  3893.      j=0
  3894.  
  3895.  In a sequence of Bernoulli trials, this is the probability that k or
  3896.  fewer failures precede the nth success.
  3897.  
  3898.  The terms are not computed individually;  instead the incomplete beta
  3899.  integral is employed, according to the formula
  3900.  
  3901.      y = nbdtr( k, n, p ) = ibeta( n, k+1, p ).
  3902.  
  3903.  The arguments must be positive, with p ranging from 0 to 1.
  3904.  
  3905.  Also see FUNCTIONS and PROBABILITY.
  3906. ≡expressions functions nbdtrc
  3907. ≡functions nbdtrc
  3908. ≡nbdtrc
  3909.  ┌──────────────────────────────────────────────────────────────────────┐
  3910.  │   nbdtrc                                                             │
  3911.  └──────────────────────────────────────────────────────────────────────┘
  3912.  
  3913.  Description:
  3914.  
  3915.  nbdtrc(k,n,p) returns the sum of the terms k+1 to infinity of the negative
  3916.  binomial distribution:
  3917.  
  3918.      inf
  3919.      --  ( n+j-1 )   n      j
  3920.      >   (       )  p  (1-p)
  3921.      --  (   j   )
  3922.      j=k+1
  3923.   
  3924.  The terms are not computed individually;  instead the incomplete beta
  3925.  integral is employed, according to the formula
  3926.   
  3927.      y = nbdtrc( k, n, p ) = ibeta( k+1, n, 1-p ).
  3928.   
  3929.  The arguments must be positive, with p ranging from 0 to 1.
  3930.  
  3931.  Also see FUNCTIONS and PROBABILITY.
  3932. ≡expressions functions btdtr
  3933. ≡functions btdtr
  3934. ≡btdtr
  3935.  ┌──────────────────────────────────────────────────────────────────────┐
  3936.  │   btdtr                                                              │
  3937.  └──────────────────────────────────────────────────────────────────────┘
  3938.  
  3939.  Description:
  3940.  
  3941.  btdtr(a,b,x) returns the area from zero to x under the beta density
  3942.  function:
  3943.                               x
  3944.                 -             -
  3945.                | (a+b)       | |  a-1      b-1
  3946.      P(x)  =  ----------     |   t    (1-t)    dt
  3947.                -     -     | |
  3948.               | (a) | (b)   -
  3949.                              0
  3950.  
  3951.  This function is identical to the incomplete beta integral function
  3952.  ibeta(a, b, x).
  3953.   
  3954.  The complemented function is
  3955.   
  3956.      1 - P(1-x) = ibeta( b, a, x )
  3957.  
  3958.  Also see FUNCTIONS and PROBABILITY.
  3959. ≡expressions functions chdtr
  3960. ≡functions chdtr
  3961. ≡chdtr
  3962.  ┌──────────────────────────────────────────────────────────────────────┐
  3963.  │   chdtr                                                              │
  3964.  └──────────────────────────────────────────────────────────────────────┘
  3965.  
  3966.  Description:
  3967.  
  3968.  chdtr(df,x) returns the area under the left hand tail (from 0 to x) of
  3969.  the Chi square probability density function with v degrees of freedom.
  3970.   
  3971.                                      inf
  3972.                                        -
  3973.                            1          | |  v/2-1  -t/2
  3974.      P( x | v )   =   -----------     |   t      e     dt
  3975.                        v/2  -       | |
  3976.                       2    | (v/2)   -
  3977.                                       x
  3978.  
  3979.  where x is the Chi-square variable.
  3980.   
  3981.  The incomplete gamma integral is used, according to the formula
  3982.   
  3983.      y = chdtr( v, x ) = igamma( v/2.0, x/2.0 ).
  3984.   
  3985.  The arguments must both be positive.
  3986.  
  3987.  Also see FUNCTIONS and PROBABILITY.
  3988. ≡expressions functions chdtrc
  3989. ≡functions chdtrc
  3990. ≡chdtrc
  3991.  ┌──────────────────────────────────────────────────────────────────────┐
  3992.  │   chdtrc                                                             │
  3993.  └──────────────────────────────────────────────────────────────────────┘
  3994.  
  3995.  Description:
  3996.  
  3997.  chdtrc(v,x) returns the area under the right hand tail (from x to
  3998.  infinity) of the Chi square probability density function with v
  3999.  degrees of freedom:
  4000.                                      inf
  4001.                                        -
  4002.                            1          | |  v/2-1  -t/2
  4003.      P( x | v )   =   -----------     |   t      e     dt
  4004.                        v/2  -       | |
  4005.                       2    | (v/2)   -
  4006.                                       x
  4007.  
  4008.  where x is the Chi-square variable.
  4009.   
  4010.  The incomplete gamma integral is used, according to the formula
  4011.   
  4012.      y = chdtr( v, x ) = igamc( v/2.0, x/2.0 ).
  4013.   
  4014.  The arguments must both be positive.
  4015.  
  4016.  Also see FUNCTIONS and PROBABILITY.
  4017. ≡expressions functions chdtri
  4018. ≡functions chdtri
  4019. ≡chdtri
  4020.  ┌──────────────────────────────────────────────────────────────────────┐
  4021.  │   chdtri                                                             │
  4022.  └──────────────────────────────────────────────────────────────────────┘
  4023.  
  4024.  Description:
  4025.  
  4026.  chdtri(df,y) finds the Chi-square argument x such that the integral
  4027.  from x to infinity of the Chi-square density is equal to the given
  4028.  cumulative probability y.
  4029.  
  4030.  This is accomplished using the inverse gamma integral function and
  4031.  the relation
  4032.  
  4033.      x/2 = igami( df/2, y )
  4034.  
  4035.  Also see FUNCTIONS and PROBABILITY.
  4036. ≡expressions functions fdtr
  4037. ≡functions fdtr
  4038. ≡fdtr
  4039.  ┌──────────────────────────────────────────────────────────────────────┐
  4040.  │   fdtr                                                               │
  4041.  └──────────────────────────────────────────────────────────────────────┘
  4042.  
  4043.  Description:
  4044.  
  4045.  fdtr(df1,df2,x) returns the area from zero to x under the F density
  4046.  function (also known as Snedcor's density or the variance ratio density).
  4047.  This is the density of x = (u1/df1)/(u2/df2), where u1 and u2 are random
  4048.  variables having Chi square distributions with df1 and df2 degrees of
  4049.  freedom, respectively.
  4050.  
  4051.  The incomplete beta integral is used, according to the formula
  4052.  
  4053.      P(x) = ibeta( df1/2, df2/2, (df1*x/(df2 + df1*x) ).
  4054.  
  4055.  The arguments a and b are greater than zero, and x x is nonnegative.
  4056.  
  4057.  Also see FUNCTIONS and PROBABILITY.
  4058. ≡expressions functions fdtrc
  4059. ≡functions fdtrc
  4060. ≡fdtrc
  4061.  ┌──────────────────────────────────────────────────────────────────────┐
  4062.  │   fdtrc                                                              │
  4063.  └──────────────────────────────────────────────────────────────────────┘
  4064.  
  4065.  Description:
  4066.  
  4067.  fdtrc(df1,df2,x) returns the area from x to infinity under the F density
  4068.  function (also known as Snedcor's density or the variance ratio density).
  4069.  
  4070.                         inf
  4071.                          -
  4072.                 1       | |  a-1      b-1
  4073.    1-P(x)  =  ------    |   t    (1-t)    dt
  4074.               B(a,b)  | |
  4075.                        -
  4076.                         x
  4077.   
  4078.  The incomplete beta integral is used, according to the formula
  4079.   
  4080.      P(x) = ibeta( df2/2, df1/2, (df2/(df2 + df1*x) ).
  4081.   
  4082.  Also see FUNCTIONS and PROBABILITY.
  4083. ≡expressions functions fdtri
  4084. ≡functions fdtri
  4085. ≡fdtri
  4086.  ┌──────────────────────────────────────────────────────────────────────┐
  4087.  │   fdtri                                                              │
  4088.  └──────────────────────────────────────────────────────────────────────┘
  4089.  
  4090.  Description:
  4091.  
  4092.  fdtri(df1,df2,y) returns the F density argument x such that the integral
  4093.  from x to infinity of the F density is equal to the given probability y.
  4094.  
  4095.    This is accomplished using the inverse beta integral
  4096.    function and the relations
  4097.   
  4098.         z = ibetai( df2/2, df1/2, y )
  4099.         x = df2 (1-z) / (df1 z).
  4100.   
  4101.    Note: the following relations hold for the inverse of
  4102.    the uncomplemented F distribution:
  4103.   
  4104.         z = ibetai( df1/2, df2/2, y )
  4105.         x = df2 z / (df1 (1-z)).
  4106.  
  4107.  Also see FUNCTIONS and PROBABILITY.
  4108. ≡expressions functions gdtr
  4109. ≡functions gdtr
  4110. ≡gdtr
  4111.  ┌──────────────────────────────────────────────────────────────────────┐
  4112.  │   gdtr                                                               │
  4113.  └──────────────────────────────────────────────────────────────────────┘
  4114.  
  4115.  Description:
  4116.  
  4117.  gdtr(a,b,x) returns the integral from zero to x of the gamma probability
  4118.  density function:
  4119.   
  4120.                   x
  4121.           b       -
  4122.          a       | |   b-1  -at
  4123.    y =  -----    |    t    e    dt
  4124.          -     | |
  4125.         | (b)   -
  4126.                  0
  4127.  
  4128.  The incomplete gamma integral is used, according to the relation
  4129.   
  4130.      y = igamma( b, ax ).
  4131.  
  4132.  Also see FUNCTIONS and PROBABILITY.
  4133. ≡expressions functions gdtrc
  4134. ≡functions gdtrc
  4135. ≡gdtrc
  4136.  ┌──────────────────────────────────────────────────────────────────────┐
  4137.  │   gdtrc                                                              │
  4138.  └──────────────────────────────────────────────────────────────────────┘
  4139.  
  4140.  Description:
  4141.  
  4142.  gdtrc(a,b,x) returns the integral from x to infinity of the gamma
  4143.  probability density function:
  4144.   
  4145.                  inf
  4146.           b       -
  4147.          a       | |   b-1  -at
  4148.    y =  -----    |    t    e    dt
  4149.          -     | |
  4150.         | (b)   -
  4151.                  x
  4152.  
  4153.  The incomplete gamma integral is used, according to the relation
  4154.   
  4155.      y = igamc( b, ax ).
  4156.  
  4157.  Also see FUNCTIONS and PROBABILITY.
  4158. ≡expressions functions ndtr
  4159. ≡functions ndtr
  4160. ≡ndtr
  4161.  ┌──────────────────────────────────────────────────────────────────────┐
  4162.  │   ndtr                                                               │
  4163.  └──────────────────────────────────────────────────────────────────────┘
  4164.  
  4165.  Description:
  4166.  
  4167.  ndtr(x) returns the area under the Gaussian probability density
  4168.  function, integrated from minus infinity to x:
  4169.   
  4170.                               x
  4171.                                -
  4172.                      1        | |          2
  4173.       ndtr(x)  = ---------    |    exp( - t /2 ) dt
  4174.                  sqrt(2pi)  | |
  4175.                              -
  4176.                             -inf
  4177.   
  4178.                =  ( 1 + erf(z) ) / 2
  4179.                =  erfc(z) / 2
  4180.   
  4181.  where z = x/sqrt(2).  Computation is via the functions erf and erfc.
  4182.  
  4183.  Also see FUNCTIONS and PROBABILITY.
  4184. ≡expressions functions ndtri
  4185. ≡functions ndtri
  4186. ≡ndtri
  4187.  ┌──────────────────────────────────────────────────────────────────────┐
  4188.  │   ndtri                                                              │
  4189.  └──────────────────────────────────────────────────────────────────────┘
  4190.  
  4191.  Description:
  4192.  
  4193.  ndtri(y) returns the argument, x, for which the area under the Gaussian
  4194.  probability density function (integrated from minus infinity to x) is
  4195.  equal to y.
  4196.  
  4197.  Also see FUNCTIONS and PROBABILITY.
  4198. ≡expressions functions pdtr
  4199. ≡functions pdtr
  4200. ≡pdtr
  4201.  ┌──────────────────────────────────────────────────────────────────────┐
  4202.  │   pdtr                                                               │
  4203.  └──────────────────────────────────────────────────────────────────────┘
  4204.  
  4205.  Description:
  4206.  
  4207.  pdtr(k,m) returns the sum of the first k terms of the Poisson
  4208.  distribution:
  4209.   
  4210.      k       j
  4211.      --   -m  m
  4212.      >   e    --
  4213.      --     j!
  4214.     j=0
  4215.   
  4216.  The terms are not summed directly;  instead the incomplete gamma integral
  4217.  is employed, according to the relation
  4218.   
  4219.      y = pdtr( k, m ) = igamc( k+1, m ).
  4220.   
  4221.  The arguments must both be positive.
  4222.  
  4223.  Also see FUNCTIONS and PROBABILITY.
  4224. ≡expressions functions pdtrc
  4225. ≡functions pdtrc
  4226. ≡pdtrc
  4227.  ┌──────────────────────────────────────────────────────────────────────┐
  4228.  │   pdtrc                                                              │
  4229.  └──────────────────────────────────────────────────────────────────────┘
  4230.  
  4231.  Description:
  4232.  
  4233.  pdtrc(k,m) returns the sum of the terms k+1 to infinity of the Poisson
  4234.  distribution:
  4235.   
  4236.     inf       j
  4237.      --   -m  m
  4238.      >   e    --
  4239.      --       j!
  4240.     j=k+1
  4241.   
  4242.  The terms are not summed directly;  instead the incomplete gamma integral
  4243.  is employed, according to the formula
  4244.   
  4245.      y = pdtrc( k, m ) = igamma( k+1, m ).
  4246.   
  4247.  The arguments must both be positive.
  4248.  
  4249.  Also see FUNCTIONS and PROBABILITY.
  4250. ≡expressions functions pdtri
  4251. ≡functions pdtri
  4252. ≡pdtri
  4253.  ┌──────────────────────────────────────────────────────────────────────┐
  4254.  │   pdtri                                                              │
  4255.  └──────────────────────────────────────────────────────────────────────┘
  4256.  
  4257.  Description:
  4258.  
  4259.  pdtri(k,y) finds the Poisson variable x such that the integral from
  4260.  0 to x of the Poisson density is equal to the given probability y.
  4261.  
  4262.  This is accomplished using the inverse gamma integral function and
  4263.  the relation m = igami( k+1, y ).
  4264.  
  4265.  Also see FUNCTIONS and PROBABILITY.
  4266. ≡expressions functions stdtr
  4267. ≡functions stdtr
  4268. ≡stdtr
  4269.  ┌──────────────────────────────────────────────────────────────────────┐
  4270.  │   stdtr                                                              │
  4271.  └──────────────────────────────────────────────────────────────────────┘
  4272.  
  4273.  Description:
  4274.  
  4275.  stdtr(k,t) computes the integral from minus infinity to t of the Student
  4276.  t distribution with integer k > 0 degrees of freedom:
  4277.   
  4278.                                         t
  4279.                                         -
  4280.                                        | |
  4281.                 -                      |         2   -(k+1)/2
  4282.                | ( (k+1)/2 )           |  (     x   )
  4283.          ----------------------        |  ( 1 + --- )        dx
  4284.                        -               |  (      k  )
  4285.          sqrt( k pi ) | ( k/2 )        |
  4286.                                      | |
  4287.                                       -
  4288.                                      -inf
  4289.    
  4290.  Relation to incomplete beta integral:
  4291.   
  4292.      1 - stdtr(k,t) = 0.5 * ibeta( k/2, 1/2, z )
  4293.  where
  4294.      z = k/(k + t**2).
  4295.   
  4296.  Also see FUNCTIONS and PROBABILITY.
  4297. ≡bessel
  4298.  ┌──────────────────────────────────────────────────────────────────────┐
  4299.  │   Bessel Functions                                                   │
  4300.  └──────────────────────────────────────────────────────────────────────┘
  4301.  
  4302.  Description:
  4303.  
  4304.  Bessel functions arise in solving differential equations for systems
  4305.  with cylindrical symmetry.
  4306.  
  4307.  Jn(x) is often called the Bessel function of the first kind, or simply
  4308.  the Bessel function.  Yn(x) is referred to as the Bessel function of
  4309.  the second kind, the Weber function, or the Newmann function.  In(x)
  4310.  and Kn(x) are modified Bessel functions.  They are equivalent to the
  4311.  usual Bessel functions Jn and Yn evaluated for purely imaginary
  4312.  arguments.
  4313.  
  4314.  Twelve Bessel functions are provided with Graphica: besi0, besi1,
  4315.  besin, besj0, besj1, besjn, besk0, besk1, beskn, besy0, besy1 and besyn.
  4316.  
  4317.  All Bessel functions expect x to be in radians.
  4318.  
  4319.  besi0(x) returns the 0th (modified) Bessel function I.  besi1(x)
  4320.  returns the 1st (modified) Bessel function I.  besin(n,x) returns the
  4321.  nth (modified) Bessel function I, where n > 1.
  4322.  
  4323.  besj0(x) returns the 0th Bessel function J.  besj1(x) returns
  4324.  the 1st Bessel function J.  besjn(n,x) returns the nth Bessel
  4325.  function J, where n > 1.
  4326.  
  4327.  besk0(x) returns the 0th (modified) Bessel function K.  besk1(x)
  4328.  returns the 1st (modified) Bessel function K.  beskn(n,x) returns the
  4329.  nth (modified) Bessel function K.
  4330.  
  4331.  besy0(x) returns the 0th Bessel function Y.  besy1(x) returns
  4332.  the 1st Bessel function Y.  besyn(n,x) returns the nth (modified)
  4333.  Bessel function Y, where n > 1.
  4334.  
  4335.  Also see BESI0, BESI1, BESIN, BESJ0, BESJ1, BESJN, BESK0, BESK1, BESKN,
  4336.  BESY0, BESY1, and BESYN for more details.
  4337. ≡expressions functions besi0
  4338. ≡functions besi0
  4339. ≡besi0
  4340.  ┌──────────────────────────────────────────────────────────────────────┐
  4341.  │   besi0                                                              │
  4342.  └──────────────────────────────────────────────────────────────────────┘
  4343.  
  4344.  Description:
  4345.  
  4346.  besi0(x) returns the i0th (modified) Bessel function of x, where x
  4347.  is in radians.
  4348.  
  4349.  Also see BESSEL and FUNCTIONS.
  4350. ≡expressions functions besi1
  4351. ≡functions besi1
  4352. ≡besi1
  4353.  ┌──────────────────────────────────────────────────────────────────────┐
  4354.  │   besi1                                                              │
  4355.  └──────────────────────────────────────────────────────────────────────┘
  4356.  
  4357.  Description:
  4358.  
  4359.  besi1(x) returns the i1st (modified) Bessel function of x, where x
  4360.  is in radians.
  4361.  
  4362.  Also see BESSEL and FUNCTIONS.
  4363. ≡expressions functions besin
  4364. ≡functions besin
  4365. ≡besin
  4366.  ┌──────────────────────────────────────────────────────────────────────┐
  4367.  │   besin                                                              │
  4368.  └──────────────────────────────────────────────────────────────────────┘
  4369.  
  4370.  Description:
  4371.  
  4372.  besin(n,x) returns the inth (modified) Bessel function of x, where x
  4373.  is in radians and n > 1.
  4374.  
  4375.  Also see BESSEL and FUNCTIONS.
  4376. ≡expressions functions besj0
  4377. ≡functions besj0
  4378. ≡besj0
  4379.  ┌──────────────────────────────────────────────────────────────────────┐
  4380.  │   besj0                                                              │
  4381.  └──────────────────────────────────────────────────────────────────────┘
  4382.  
  4383.  Description:
  4384.  
  4385.  besj0(x) returns the j0th Bessel function of x, where x is in radians.
  4386.  
  4387.  Also see BESSEL and FUNCTIONS.
  4388. ≡expressions functions besj1
  4389. ≡functions besj1
  4390. ≡besj1
  4391.  ┌──────────────────────────────────────────────────────────────────────┐
  4392.  │   besj1                                                              │
  4393.  └──────────────────────────────────────────────────────────────────────┘
  4394.  
  4395.  Description:
  4396.  
  4397.  besj1(x) returns the j1st Bessel function of x, where x is in radians.
  4398.  
  4399.  Also see BESSEL and FUNCTIONS.
  4400. ≡expressions functions besjn
  4401. ≡functions besjn
  4402. ≡besjn
  4403.  ┌──────────────────────────────────────────────────────────────────────┐
  4404.  │   besjn                                                              │
  4405.  └──────────────────────────────────────────────────────────────────────┘
  4406.  
  4407.  Description:
  4408.  
  4409.  besjn(n,x) returns the jnth Bessel function of x, where x is in
  4410.  radians and n > 1.
  4411.  
  4412.  Also see BESSEL and FUNCTIONS.
  4413. ≡expressions functions besk0
  4414. ≡functions besk0
  4415. ≡besk0
  4416.  ┌──────────────────────────────────────────────────────────────────────┐
  4417.  │   besk0                                                              │
  4418.  └──────────────────────────────────────────────────────────────────────┘
  4419.  
  4420.  Description:
  4421.  
  4422.  besk0(x) returns the k0th (modified) Bessel function of x, where x
  4423.  is in radians.
  4424.  
  4425.  Also see BESSEL and FUNCTIONS.
  4426. ≡expressions functions besk1
  4427. ≡functions besk1
  4428. ≡besk1
  4429.  ┌──────────────────────────────────────────────────────────────────────┐
  4430.  │   besk1                                                              │
  4431.  └──────────────────────────────────────────────────────────────────────┘
  4432.  
  4433.  Description:
  4434.  
  4435.  besk1(x) returns the k1st (modified) Bessel function of x, where x
  4436.  is in radians.
  4437.  
  4438.  Also see BESSEL and FUNCTIONS.
  4439. ≡expressions functions beskn
  4440. ≡functions beskn
  4441. ≡beskn
  4442.  ┌──────────────────────────────────────────────────────────────────────┐
  4443.  │   beskn                                                              │
  4444.  └──────────────────────────────────────────────────────────────────────┘
  4445.  
  4446.  Description:
  4447.  
  4448.  beskn(n,x) returns the knth (modified) Bessel function of x, where x
  4449.  is in radians and n > 1.
  4450.  
  4451.  Also see BESSEL and FUNCTIONS.
  4452. ≡expressions functions besy0
  4453. ≡functions besy0
  4454. ≡besy0
  4455.  ┌──────────────────────────────────────────────────────────────────────┐
  4456.  │   besy0                                                              │
  4457.  └──────────────────────────────────────────────────────────────────────┘
  4458.  
  4459.  Description:
  4460.  
  4461.  besy0(x) returns the y0th Bessel function of x, where x is in radians.
  4462.  
  4463.  Also see BESSEL and FUNCTIONS.
  4464. ≡expressions functions besy1
  4465. ≡functions besy1
  4466. ≡besy1
  4467.  ┌──────────────────────────────────────────────────────────────────────┐
  4468.  │   besy1                                                              │
  4469.  └──────────────────────────────────────────────────────────────────────┘
  4470.  
  4471.  Description:
  4472.  
  4473.  besy1(x) returns the y1st Bessel function of x, where x is in radians.
  4474.  
  4475.  Also see BESSEL and FUNCTIONS.
  4476. ≡expressions functions besyn
  4477. ≡functions besyn
  4478. ≡besyn
  4479.  ┌──────────────────────────────────────────────────────────────────────┐
  4480.  │   besyn                                                              │
  4481.  └──────────────────────────────────────────────────────────────────────┘
  4482.  
  4483.  Description:
  4484.  
  4485.  besyn(n,x) returns the ynth (modified) Bessel function of x, where x
  4486.  is in radians and n > 1.
  4487.  
  4488.  Also see BESSEL and FUNCTIONS.
  4489. ≡environment
  4490.  ┌──────────────────────────────────────────────────────────────────────┐
  4491.  │   Environment Variables                                              │
  4492.  └──────────────────────────────────────────────────────────────────────┘
  4493.  
  4494.  An environment variable is used to specify from the operating system
  4495.  certain parameters of program operation.  The "environment" is really
  4496.  just a common area of memory that programs can write to and read from.
  4497.  Some programs are geared to look specifically at the environment to find
  4498.  particular data important to their operation.  They may ask you to place
  4499.  a variable into the environment equal to a certain value so that they
  4500.  can find support files which could not be found otherwise.
  4501.  
  4502.  A number of shell environment variables are understood by Graphica.
  4503.  None of these are required, but may be useful:
  4504.  
  4505.      - GRAPTERM
  4506.      - GRAPDUMP
  4507.      - GRAPHELP
  4508.      - GRAPHINI
  4509.      - GRAPFONT
  4510.  
  4511.  GRAPTERM may be used as the name of the terminal type to be used.  This
  4512.  overrides any terminal type sensed by Graphica on start up, but is itself
  4513.  overridden by the 'graphica.ini' or other start-up file, and of course by
  4514.  later explicit changes.
  4515.  
  4516.  GRAPDUMP is used as the default terminal type used when dumping graphics
  4517.  to a file.
  4518.  
  4519.  GRAPHELP may be defined to be the pathname of the help file.  If this
  4520.  environment variable is not defined, Graphica will try to look for the
  4521.  help file somewhere in your DOS path.  If the help file can't be found,
  4522.  you have no on-line help available.
  4523.  
  4524.  GRAPHINI may be used as the pathname of a startup-up file.  The default
  4525.  name is 'graphica.ini' on DOS/VAX systems and '.graphica' on UNIX.  The
  4526.  DOS version of Graphica will use the entire search path to look for it.
  4527.  
  4528.  GRAPFONT specifies where Graphica's font files are located.  If the
  4529.  font files are not somewhere in your DOS path, you may specify an
  4530.  environment variable called GRAPFONT containing the font directory.
  4531.  For example, if the fonts are in C:\GRAPHICA\FONTS, then you would
  4532.  specify,
  4533.  
  4534.      SET GRAPFONT=C:\GRAPHICA\FONTS
  4535.  
  4536.  somewhere in your autoexec.bat file or in a batch file just before
  4537.  running Graphica.  Graphica will then find the necessary font file
  4538.  in that directory and load it at runtime.
  4539.  
  4540.  DOS Environment Variables
  4541.  -------------------------
  4542.  
  4543.  If we were to look at the DOS environment (by typing the SET command
  4544.  at the DOS prompt), we might see a listing similar to the one below:
  4545.  
  4546.      COMSPEC=C:\COMMAND.COM
  4547.      PATH=C:\;C:\DOS;C:\UTIL
  4548.  
  4549.  Other values might be present, like PROMPT=$P$G, and more depending
  4550.  on the types and kinds of software you are running.
  4551.  
  4552.  Environment variables are specified before running Graphica.  They
  4553.  can be specified directly from DOS, from within the AUTOEXEC.BAT file,
  4554.  or from within any batch file.
  4555.  
  4556.  The command for setting an environment variable is:
  4557.  
  4558.      SET PARAMETER=PARAMETER VALUE
  4559.  
  4560.  Examples:
  4561.  
  4562.      C:\SET GRAPDUMP=hpgl                   (sets the dump terminal type)
  4563.      C:\SET GRAPHELP=c:\plot\graphica.hlp                 (the help file)
  4564.      C:\SET GRAPHINI=c:\plot\graphica.ini             (the start-up file)
  4565.      C:\SET GRAPFONT=C:\GRAPHICA\FONT                        (font files)
  4566.  
  4567.  In general, you won't have to set the DOS environment variable GRAPTERM if
  4568.  you have any of the commonly available graphics monitors, CGA/EGA/VGA, etc.
  4569.  
  4570.  Unix Shell Variables
  4571.  --------------------
  4572.  
  4573.  In a UNIX environment, things get a little bit confusing because of the
  4574.  different shells that you might be running.  Environment variables can
  4575.  be shown by using the 'printenv' command (Korn-shell or /bin/sh), the
  4576.  'setenv' command (c-shell or /bin/csh) or the 'AEGIS' command (Aegis
  4577.  shell on Apollos).  To set them, do
  4578.  
  4579.      $ GRAPTERM=apollo
  4580.      $ GRAPDUMP=postscript
  4581.      $ export GRAPDUMP
  4582.      $ export GRAPTERM
  4583.  
  4584.  Also see STARTUP.
  4585. ≡startup
  4586.  ┌──────────────────────────────────────────────────────────────────────┐
  4587.  │   Startup File                                                       │
  4588.  └──────────────────────────────────────────────────────────────────────┘
  4589.  
  4590.  When Graphica is run, it looks for an initialization file to load.
  4591.  This file is called 'graphica.ini'.  If this file is not found in the
  4592.  current directory (or entire search path on DOS systems), the program
  4593.  will look for a start-up file pointed to by the environment variable
  4594.  GRAPHINI.
  4595.  
  4596.  If the initialization file is found, Graphica executes the commands
  4597.  in that file.  This is most useful for setting your terminal type and
  4598.  defining any functions or variables which you use often.
  4599.  
  4600.  Also see ENVIRONMENT.
  4601. ≡text
  4602.  ┌──────────────────────────────────────────────────────────────────────┐
  4603.  │   Text Primitives                                                    │
  4604.  └──────────────────────────────────────────────────────────────────────┘
  4605.  
  4606.  Text primitives generate a string of characters on a display device
  4607.  in a specific location in the world coordinate system.  The character
  4608.  string may comprise letters, numerals, and symbols.  Text primitives
  4609.  provide a method for labeling and clarifying a graphical image.
  4610.  
  4611.  This section describes the control sequences which are accessible
  4612.  when specifying a string label.  The control sequences are only available
  4613.  when using a software generated font.  Graphica recognizes \ as a special
  4614.  character used to signal the start of an escape sequence.  There are two
  4615.  kinds of escape sequences, those that take an argument and those that do
  4616.  not.
  4617.  
  4618.  The two escape sequences that do not take an argument are:
  4619.  
  4620.      \U     move up half a character size
  4621.      \D     move down half a character size
  4622.  
  4623.  The following take one integer argument immediately after the escape
  4624.  sequence and a space after it to delineate the end (the space is not
  4625.  printed):
  4626.  
  4627.      \Cn    set color to n
  4628.      \C-1   reset color to the default
  4629.      \Fn    set font to n
  4630.      \F-1   reset font to the default
  4631.      \Sn    set character size to n % of the default size
  4632.      \S-1   reset character size to the default size
  4633.      \Ln    set character slant to n degrees
  4634.      \L-1   reset character slant to the default slant
  4635.      \An    print ascii n
  4636.      \rn    save current position in register n
  4637.      \Rn    restore position from register n
  4638.  
  4639.  Examples:
  4640.  
  4641.  to print greek characters such as in 'beta = x + lambda':
  4642.      » label '\F2 b\F1 = x + \F2 l'
  4643.  
  4644.  to label the x-axis with 'velocity U sub f':
  4645.      » xlabel 'velocity, U\Dsub'
  4646.  
  4647.  to place a top label of 'stress in dynes per cm squared':
  4648.      » top label 'stress (dyn\cm\U2\D)'
  4649.  
  4650.  to get 'x squared plus y squared':
  4651.      » label 'x\U2\D + y\U2'
  4652.  
  4653.  and finally, an advanced example.  To get 'A sub b sup beta':
  4654.      » label 'A\r1 \Db\R1 \U\F2 b'
  4655.  
  4656.  This last example is translated as: do A, save this spot, go down half,
  4657.  do b, restore the saved spot, go up half, switch to font 2 (greek simplex),
  4658.  do beta.  Notice the use of registers to stack characters on top of each
  4659.  other.
  4660.  
  4661.  To get a backslash, simply use one \.
  4662. ≡version
  4663.  Syntax:
  4664.  ┌──────────────────────────────────────────────────────────────────────┐
  4665.  │   version                                                            │
  4666.  └──────────────────────────────────────────────────────────────────────┘
  4667.  
  4668.  Description:
  4669.  
  4670.  The 'version' command displays:
  4671.  
  4672.      - your Graphica version number
  4673.      - pertinent copyright and other information
  4674.  
  4675.  Also on DOS systems:
  4676.  
  4677.      - the amount of system RAM available
  4678.      - the amount of disk space available in the current drive 
  4679. ≡what
  4680.  Syntax:
  4681.  ┌──────────────────────────────────────────────────────────────────────┐
  4682.  │   what                                                               │
  4683.  └──────────────────────────────────────────────────────────────────────┘
  4684.  
  4685.  Description:
  4686.  
  4687.  'what' shows a directory listing of the .plt files on the disk in the
  4688.  current directory.  Files with other extensions are not shown.
  4689.  
  4690.  Also see DEL, DIR, SHELL and TYPE.
  4691. ≡wait
  4692. ≡nowait
  4693.  ┌──────────────────────────────────────────────────────────────────────┐
  4694.  │   wait                                                               │
  4695.  │   nowait                                                             │
  4696.  └──────────────────────────────────────────────────────────────────────┘
  4697.  
  4698.  These commands toggle a flag which, when set, will make Graphica wait
  4699.  until you press any key after the last plot appears on the screen. In
  4700.  batch mode (or when 'term' is not a display mode) this command will not
  4701.  any effect.
  4702. ≡tips
  4703.  ┌──────────────────────────────────────────────────────────────────────┐
  4704.  │   Tips                                                               │
  4705.  └──────────────────────────────────────────────────────────────────────┘
  4706.  
  4707.  Here some tips to help you get started with Graphica:
  4708.  
  4709.  - Pressing any key while the introductory screen is shown will turn
  4710.    it off and take you directly to the command line.
  4711.  
  4712.  - Use the arrow keys (up, down, right, left ) to recall previous
  4713.    commands or edit the current command line.
  4714.  
  4715.  - Type 'what' to get a list of all the *.plt script files you may
  4716.    have in the current directory.
  4717.  
  4718.  - You may put more than one command on a line--just separate each
  4719.    command by a semicolon, for example,
  4720.  
  4721.      » plot x y add ; column 3 is y ; plot x y connect
  4722.  
  4723.  - Pressing F1 calls up the help system.  Pressing F10 displays the
  4724.    graph on the screen.
  4725. ≡errors
  4726.  ┌──────────────────────────────────────────────────────────────────────┐
  4727.  │   Errors                                                             │
  4728.  └──────────────────────────────────────────────────────────────────────┘
  4729.  
  4730.  When Graphica encounters an error caused by an incorrect command in a
  4731.  script file or on the command line it will issue an error message.  If
  4732.  the bad command was in a script file, the line number will be given.
  4733.  
  4734.  You can type SHOW at the command line to see everything you've plotted
  4735.  so far.  You can also correct errors in a script file by "shelling" out
  4736.  to the OS or issue a $edit command (to invoke the editor from within
  4737.  Graphica for example) where 'edit' is the name of your favorite editor.
  4738. ≡bugs
  4739.  ┌──────────────────────────────────────────────────────────────────────┐
  4740.  │   Bug Reports                                                        │
  4741.  └──────────────────────────────────────────────────────────────────────┘
  4742.  
  4743.  Graphica is under constant revision, updating and being given expanded
  4744.  capabilities.  Prior to each release, the developer strives to verify new
  4745.  features and bug fixes through testing.  However, as inevitably happens
  4746.  with any software, some bugs do survive and show up in user runs.  Users
  4747.  can aid in the problem fixing process by following the guidelines below:
  4748.  
  4749.  a) Report any unusual messages, computed results, format overflows,
  4750.  etc.  even though the program appears to have terminated normally.
  4751.  
  4752.  b) For any abnormal program termination, save the input file and all
  4753.  output obtained by running the program.
  4754.  
  4755.  Reported problems will be fixed as quickly as possible.  In most
  4756.  instances, alternate methods or techniques of plot formulation and
  4757.  input are available to permit graphing despite the bug.  All problems
  4758.  encountered with Graphica should be reported to:
  4759.  
  4760.  ┌──────────────────────────────────────────────────────────────────────┐
  4761.  │   Antonio Montes      Internet address: tony@amontes.oss.nl          │
  4762.  │   Postbus 13          CompuServe ID: 71031,1162                      │
  4763.  │   2350 AA Leiderdorp                                                 │
  4764.  │   The Netherlands                                                    │
  4765.  └──────────────────────────────────────────────────────────────────────┘
  4766.