home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / pc / source / fchart.lzh / fchart.inf < prev   
Encoding:
Text File  |  1990-06-09  |  5.9 KB  |  181 lines

  1.  
  2.   I have written a simple interactive chart program called Fchart.
  3. Here is a brief description of its features. This posting is followed
  4. by installation notes (read before you do anything!) and 4 shar files
  5. (smaller than 70KB each) in the alt.sources.
  6.  
  7.   Program is based upon Gnuplot code, and uses a similar language for
  8. the user interface.  Four parts come directly from Gnuplot: help
  9. facility, input scanner, doc maker and terminal drivers. Maybe, if
  10. well tested and approved, program will be a part of Gnuplot in the
  11. future.
  12.  
  13.   Code can be freely redistributed if found useful, as long as the
  14. copyright messages are retained. PLEASE DO NOT REDISTRIBUTE MODIFIED
  15. CODE, rather e-mail me your suggestions.
  16.  
  17.   Gnuplot Copyright (C) 1986, 1987, 1990 Thomas Williams, Colin Kelley
  18.           John Campbell, David Kotz, Russell Lang
  19.  
  20.   Fchart Copyright (C) 1990 Piotr Filip Sawicki
  21.  
  22. ---------------------------------------------
  23.  
  24.   Fchart features:
  25.  
  26.   * Interactive user interface, batch files accepted, on-line help
  27.   * Highly customizable output form (size, position, form, labels)
  28.   * Four main chart styles :
  29.     - normal side-by-side (adjacent) bars
  30.     - stacked bars
  31.     - layer-over-layer bars
  32.     - pies
  33.   * Many adjustable variations of styles:
  34.     - pie charts with slices exploding in any direction, combining
  35.       slices below specified threshold, drawing clockwise or counter-
  36.       clockwise
  37.     - bar charts with any value for base, drawn in any order with any
  38.       gravity (left, right, top, bottom of page)
  39.     - and lots more
  40.   * Drawing down or across several data files (i.e. standard or
  41.     transposed data)
  42.   * Accepted input:
  43.     - Gnuplot files
  44.     - private format
  45.     - columnar data files
  46.   * Missing values supported
  47.   * Partial input (from spec. row to spec. row); in any case, file is 
  48.     read at once
  49.   * Internal vector font (Roman type) for better labeling and for
  50.     terminals that cannot rotate text (courtesy Joe Felsenstein,
  51.     joe@genetics.washington.edu)
  52.   * Smart autolabeling, arrows, lines, labels (drawn in any size and/or 
  53.     direction).
  54.   * Wide range of supported terminals (well, that's a Gnuplot feature)
  55.  
  56.   Faults, caveats, bugs:
  57.  
  58.   * Gnuplot bugs
  59.   * Only 2D graphics by now (3D bars later ... perhaps)
  60.   * Some errors in bar centering (almost unvisible)
  61.   * Not very smart tick marking algorithm
  62.   * Makefile only for *NIX systems (if some poor soul is going to
  63.     write that for VMS or MS-DOS, please send it to me), though due to
  64.     #ifdefs program should work everywhere.
  65.  
  66.   Future (in one month?):
  67.  
  68.   * New, highly independent and expandable graphics kernel
  69.   * More fonts
  70.   * Bar filling algorithm
  71.   * Gnuplot patch 01 update
  72.   * Anything you request
  73.  
  74. ---------------------------------------------
  75.  
  76. fi.
  77. (Piotr Filip Sawicki    fs@uwasa.fi)
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84. From fs Mon Jun  4 16:09:09 EET DST 1990
  85. Article 1384 of alt.sources:
  86. Newsgroups: alt.sources
  87. Path: uwasa.fi!fs
  88. >From: fs@uwasa.fi (Filip Sawicki LAKE)
  89. Subject: Fchart Installation Hints
  90. Message-ID: <1990Jun4.124900.983@uwasa.fi>
  91. Organization: University of Vaasa
  92. Date: Mon, 4 Jun 90 12:49:00 GMT
  93.  
  94.    IMPORTANT!
  95.  
  96.    This program requires some knowledge about Gnuplot 2.0 pl0, and a
  97. part of its code. If you don't have it, ftp from the nearest server,
  98. and at least print and read the documentation.
  99.  
  100. **********************************************************************
  101.  
  102.    DISCLAIMER 1.
  103.  
  104.    This program has never had any claims to be The Ultimate Chart
  105. Maker. It should be treated rather as a previewer before writing
  106. proper SAS program or transmitting data to Lotus 1-2-3.
  107.    And it is no serious work, but effect of several weeks of hacking
  108. well written Gnuplot code.
  109.  
  110. **********************************************************************
  111.  
  112.    HOW TO INSTALL FCHART
  113.  
  114.    Fchart needs the following Gnuplot v2.0 files:
  115.     docs/*.c
  116.     term.o
  117.     plot.h
  118.     help.h
  119.     scanner.o
  120.     help.o
  121.     (or sources and original Makefile)
  122.    so there are two basic ways to make it work. Read carefully.
  123.  
  124. ---------------------------------------------
  125.  
  126. 1. Create new directory, and unshar fchart right there.
  127.    Rename make.fil to Makefile.
  128.    Edit Makefile:
  129.     - set LIBS properly, according to your Gnuplot Makefile.
  130.     - make GNUP point to Gnuplot directory. Path MUST NOT end with "/".
  131.    Cross your fingers.
  132.    Type "make fchart"
  133.    If OK, it's there, named "fchart".
  134.  
  135. 2. Unshar fchart in Gnuplot directory. My files don't have conflicting
  136.      names, so thre should be no harm done.
  137.    Edit make.fil:
  138.     - set LIBS as above.
  139.     - define "GNUP=."
  140.    DO NOT RENAME "make.fil" TO "Makefile" !
  141.    Cross your fingers.
  142.    Type "make -f make.fil fchart".
  143.    If OK, it's there, named "fchart".
  144.  
  145. ---------------------------------------------
  146.  
  147.    To make documentation, choose 'tex', 'dvi', 'troff' or 'nroff'.
  148.    "make install" will install program as well as built-in help, but
  149.    before set properly DEST and HELPDEST in Makefile
  150.    If you'd like to change the code, read the warning in "fgraf.c".
  151.  
  152. **********************************************************************
  153.  
  154.    TERMINALS AND OPTIONS
  155.  
  156.    Fchart takes only one option: type of terminal to produce output
  157. for.  Terminal settings work like in Gnuplot, and also use GNUTERM
  158. environment variable. In addition, you can define TERM within "fcmd.c"
  159. to be your preferred terminal. This overrides GNUTERM, but can be
  160. changed by init file ".fchart". Then the command line option is used,
  161. and makes the final change to the terminal.
  162.    In this release, TERM is set to "tektronix".
  163.  
  164. **********************************************************************
  165.  
  166.    DISCLAIMER 2.
  167.  
  168.    Sorry for the poor quality of the code. I am only a CS student,
  169. working here on the traineeship. I have almost no experience. I don't
  170. like graphics. And you know this side of student life: the only one
  171. place where you have time to sleep are lectures or your work ...
  172.  
  173. **********************************************************************
  174.  
  175.    Please send any suggestions to "fs@uwasa.fi"
  176.  
  177. **********************************************************************
  178.  
  179.  
  180.  
  181.