DEMOGRAPH(6D)							 DEMOGRAPH(6D)

NAME    [Toc]    [Back]

     demograph - graphs	demographic data in 3D over time.

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]
     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 describing
 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	truncated
 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	chronological
 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.





									Page 1






DEMOGRAPH(6D)							 DEMOGRAPH(6D)

NOTE    [Toc]    [Back]

     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    [Toc]    [Back]

     /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    [Toc]    [Back]

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

AUTHOR    [Toc]    [Back]

     David Ligon

HARDWARE REQUIREMENTS    [Toc]    [Back]

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


									PPPPaaaaggggeeee 2222