demograph(6D)

NAME
     demograph - graphs demographic data in 3D over time.

SYNOPSIS
     demograph [ -s states.ascii ] datafile [ datafile, ... ]

DESCRIPTION
     The demograph demo graphs actual U.S. census data in three dimensions
     over time. Two sets of data are available:  Population Distribution or
     Per Capita Income by state.

   Demograph operation
     Moving the time bar at the bottom of the window will interactively update
     the date and the graph of the data according to the date.  Earlier dates
     are to the left.  The middle mouse rotates the graph and the left mouse
     translates the graph.  The right mouse brings up a menu which allows
     changing the data set and changing the display method.

     The -s option allows specifying the location of the binary file describ-
     ing the U.S.  map.  If this option is not given demograph will look only
     in the local directory. One or more data files must be included in the
     command line.


     The demograph data file is an ascii file format which allows the user to
     display his/her own data using the demograph display program.  The first
     line of the data file contains an id number of 19971989 to identify it as
     a demographic data file.  The second line contains a title which is
     displayed as the menu selection for this data.  The title will get trun-
     cated to 16 characters.  The third line contains three integers seperated
     by spaces:  the first year of data, the total number of entrys per state,
     and the number of months between data entries.  The next 48 lines contain
     the data for each of the 48 continental United States in alphabetical
     order.  Data for each state is contained on one continuous line in chro-
     nological order, starting with the earliest entry.  Data entries are
     seperated by space.  Lines starting with a data files are read and the
     numbers of lines with errors are reported.


     The demograph command has the following options:

   Specifics:
     *  Population has 19 data points for each state from 1790 to 1970

     * Income has 23 data points for each state ranging from 1948 to 1970

     * The graph contains about 800 polygons or about 4000 vectors.

     * Software dithered color map mode is used on the eight bitplane Personal
     IRIS.  Flat shaded concave polygons are used on all other machines.
NOTE
     It is interesting to see peaks of activity during certain time periods
     and speculate on the cause.  Also note the obvious westward migration of
     population before the mid 1800s and the 1900's growth in California.

FILES
     /usr/demos/General_Demos/demograph/demograph
          demograph display program

     /usr/demos/General_Demos/demograph/data/population
          Population Distribution data file

     /usr/demos/General_Demos/demograph/data/income
          Per Capita Income data file

     /usr/demos/General_Demos/demograph/data/democratevote
          Democratic vote data file

     /usr/demos/General_Demos/demograph/data/republicanvote
          Republican vote data file

BUGS
     There should be a black line surrounding the inside frame.  Sometimes
     this does not show up I believe due to rounding error.

AUTHOR
     David Ligon

HARDWARE REQUIREMENTS
     Eight bitplanes displays software dithered / double buffered color map.
     24 bitplanes displays RGB.