home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / libs / vopl / glvopl.lha / glvopl / docs / vopl.doc < prev   
Encoding:
Text File  |  1993-10-07  |  8.5 KB  |  397 lines
  1.  
  2.  
  3.  
  4. VOPL(3)                C LIBRARY FUNCTIONS                VOPL(3)
  5.  
  6.  
  7.  
  8. NAME
  9.      VOPL - A very ordinary plotting library.
  10.  
  11.  
  12. DESCRIPTION
  13.      VOPL is a library of C routines for doing  graph  plots.  It
  14.      handles  the  a  variety of fits and scalings, together with
  15.      providing  defaults  for  positioning  graph  titles,   axis
  16.      titles, and labels. VOPL may be called from C or FORTRAN.
  17.  
  18.      adjustscale(points, number, axis)
  19.           Adjust the auto scaling on axis axis for the points  in
  20.           points.
  21.  
  22.                Fortran:
  23.                     subroutine adjustscale(points, number, axis)
  24.                     real points(number)
  25.                     integer number
  26.                     character *1 axis
  27.  
  28.                C:
  29.                     adjustscale(points, number, axis)
  30.                          float     points[];
  31.                          int  number;
  32.                          char axis;
  33.  
  34.  
  35.      range(min, max, axis)
  36.           Specify the range min to max for the axis axis.
  37.  
  38.                Fortran:
  39.                     subroutine range(min, max, axis)
  40.                     real min, max
  41.                     character *1 axis
  42.  
  43.                C:
  44.                     range(min, max, axis)
  45.                          float     min, max;
  46.                          char axis;
  47.  
  48.  
  49.      graphtitle(title)
  50.           Specify the title for the graph.
  51.  
  52.                Fortran:
  53.                     subroutine graphtitle(title)
  54.                     character*(*) title
  55.  
  56.                C:
  57.                     graphtitle(title)
  58.                          char *title;
  59.  
  60.  
  61.  
  62.  
  63. glVOPL 1.1        Last change: 07 October 1993                  1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VOPL(3)                C LIBRARY FUNCTIONS                VOPL(3)
  71.  
  72.  
  73.  
  74.      drawtitle()
  75.           Draw the graph title. Note: this is done by  drawaxes2,
  76.           and drawaxes.
  77.  
  78.                Fortran:
  79.                     subroutine drawtitle()
  80.  
  81.                C:
  82.                     drawtitle()
  83.  
  84.  
  85.      axistitle(title, axis)
  86.           Specify the title for the axis axis.
  87.  
  88.                Fortran:
  89.                     subroutine axistitle(title, axis)
  90.                     character*(*) title
  91.                     character *1 axis
  92.  
  93.                C:
  94.                     axistitle(title, axis)
  95.                          char *title, axis;
  96.  
  97.  
  98.      plot2(x, y, n)
  99.           Plot the n points in the array x and y.
  100.  
  101.                Fortran:
  102.                     subroutine plot2(x, y, n)
  103.                     real x(n), y(n)
  104.                     integer n
  105.  
  106.                C:
  107.                     plot2(x, y, n)
  108.                          float     x[], y[];
  109.                          int  n;
  110.  
  111.  
  112.      fit(type)
  113.           Specify the fit type used to  plot  the  data.  Default
  114.           straight line fit.
  115.  
  116.                Fortran:
  117.                     subroutine fit(type)
  118.                     integer type
  119.  
  120.                C:
  121.                     fit(type)
  122.                          int type;
  123.  
  124.                Current fit types are:
  125.  
  126.  
  127.  
  128.  
  129. glVOPL 1.1        Last change: 07 October 1993                  2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. VOPL(3)                C LIBRARY FUNCTIONS                VOPL(3)
  137.  
  138.  
  139.  
  140.                     0    -    No lines at all.
  141.                     1    -    Straight line fit.
  142.                     2    -    Cubic spline fit.
  143.                     3    -    Least squares fit.
  144.                     4    -    Power equation fit.
  145.                     5    -    Saturated growth rate fit.
  146.  
  147.  
  148.      scaling(type, axis)
  149.           Specify the scaling type for axis axis. Default linear.
  150.  
  151.                Fortran:
  152.                     subroutine scaling(type, axis)
  153.                     integer type
  154.                     character *1 axis
  155.  
  156.                C:
  157.                     scaling(type, axis)
  158.                          int  type;
  159.                          char axis;
  160.  
  161.                Current scaling types are 0 for linear scaling,  1
  162.           for logarithmic scaling.
  163.  
  164.  
  165.      endslopes(a, b)
  166.           Specify the endslopes for a cubic spline fit.
  167.  
  168.                Fortran:
  169.                     subroutine endslopes(a, b)
  170.                     real a, b
  171.  
  172.                C:
  173.                     endslopes(a, b)
  174.                          float     a, b;
  175.  
  176.  
  177.      degree(deg)
  178.           Specify the degree for the least-squares  fit.  Default
  179.           3.
  180.  
  181.                Fortran:
  182.                     subroutine degree(deg)
  183.                     integer deg
  184.  
  185.                C:
  186.                     degree(deg)
  187.                          int  deg;
  188.  
  189.  
  190.      gridspacing(n, axis)
  191.           Specify at what n'th tickmarks the grid should be drawn
  192.  
  193.  
  194.  
  195. glVOPL 1.1        Last change: 07 October 1993                  3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. VOPL(3)                C LIBRARY FUNCTIONS                VOPL(3)
  203.  
  204.  
  205.  
  206.           at. Default zero (no grid).
  207.  
  208.                Fortran:
  209.                     subroutine gridspacing(n, axis)
  210.                     integer n
  211.                     character *1 axis
  212.  
  213.                C:
  214.                     gridspacing(n, axis)
  215.                          int  n;
  216.                          char axis;
  217.  
  218.  
  219.      tickmarks(number, axis)
  220.           Specify the number of tickmarks on the axis axis.
  221.  
  222.                Fortran:
  223.                     subroutine tickmarks(number, axis)
  224.                     integer number
  225.                     character *1 axis
  226.  
  227.                C:
  228.                     tickmarks(number, axis)
  229.                          int  number;
  230.                          char axis;
  231.  
  232.  
  233.      minorticks(number, axis)
  234.           Specify the number of minor tickmarks between the major
  235.           ticks on the axis axis.
  236.  
  237.                Fortran:
  238.                     subroutine minorticks(number, axis)
  239.                     integer number
  240.                     character *1 axis
  241.  
  242.                C:
  243.                     minorticks(number, axis)
  244.                          int  number;
  245.                          char axis;
  246.  
  247.  
  248.      drawaxis(axis)
  249.           Draw the axis given by axis.
  250.  
  251.                Fortran:
  252.                     subroutine drawaxis(axis)
  253.                     character *1 axis
  254.  
  255.                C:
  256.                     drawaxis(axis)
  257.                          char *axis;
  258.  
  259.  
  260.  
  261. glVOPL 1.1        Last change: 07 October 1993                  4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. VOPL(3)                C LIBRARY FUNCTIONS                VOPL(3)
  269.  
  270.  
  271.  
  272.      drawaxes()
  273.           Draw the x, y, and z axes.
  274.  
  275.                Fortran:
  276.                     subroutine drawaxes()
  277.  
  278.                C:
  279.                     drawaxes()
  280.  
  281.  
  282.      drawaxes2()
  283.           Draw the x and y axes.
  284.  
  285.                Fortran:
  286.                     subroutine drawaxes2()
  287.  
  288.                C:
  289.                     drawaxes2()
  290.  
  291.  
  292.      annotation(format, axis)
  293.           Specify the format for the labels at the  tickmarks  on
  294.           the  axis. If no annotation is specified the default is
  295.           used. An empty string turns it off.
  296.  
  297.                Fortran:
  298.                     subroutine annotation(format, axis)
  299.                     character*(*) format
  300.                     character *1 axis
  301.  
  302.                C:
  303.                     annotation(format, axis)
  304.                          char *format, axis
  305.  
  306.  
  307.      graphprecision(number)
  308.           Specify the number of line segments making up  a  curve
  309.           in the graph.
  310.  
  311.                Fortran:
  312.                     subroutine graphprecision(number)
  313.                     integer number
  314.  
  315.                C:
  316.                     graphprecision(number)
  317.                          int  number;
  318.  
  319.  
  320.      marker(string)
  321.           Specify the current marker string which will  be  drawn
  322.           centered over data points.
  323.  
  324.  
  325.  
  326.  
  327. glVOPL 1.1        Last change: 07 October 1993                  5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. VOPL(3)                C LIBRARY FUNCTIONS                VOPL(3)
  335.  
  336.  
  337.  
  338.                Fortran:
  339.                     subroutine marker(string)
  340.                     character*(*) string
  341.  
  342.                C:
  343.                     marker(string)
  344.                          char *string;
  345.  
  346.  
  347.      markerspacing(num)
  348.           Specify the marker spacing. Default 1.
  349.  
  350.                Fortran:
  351.                     subroutine markerspacing(num)
  352.                     integer num
  353.  
  354.                C:
  355.                     markerspacing(num)
  356.                          int  num;
  357.  
  358.  
  359.      markerscale(scale)
  360.           Specify a scaling  factor  for  the  size  of  markers.
  361.           Default 1.0.
  362.  
  363.                Fortran:
  364.                     subroutine markscale(x, y)
  365.                     real x, y
  366.  
  367.                C:
  368.                     markscale(x, y)
  369.                          float     x, y;
  370.  
  371.  
  372. SEE ALSO
  373.      VOGLE(3),GPP(3)
  374.  
  375. BUGS
  376.      The manual page isn't finished.  There isn't really  any  Z-
  377.      axis  stuff  yet.   The Whole thing isn't finished and could
  378.      stand a total recode.
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393. glVOPL 1.1        Last change: 07 October 1993                  6
  394.  
  395.  
  396.  
  397.