NAME egraph - a program to graph data AMIGA version Copyright © Laurence E. Turner 1986 Permission is granted to any individual or educational institution to use, copy, or redistribute this program so long as it is not sold and provided that the copyright notice and the UCEE graph logo are retained. SYNOPSIS egraph [-1] [-a] [-g] [-c | -l | -p] [ -h "graph header"] [ -X | -x number ] [ -Y | -y number ] [-w] [ file1 ] [ file2 ] [ file3 ] [ file4 ] [ file5 ] DESCRIPTION Egraph was developed for use by students and staff of the Department of Electrical Engineering at the University of Calgary, Calgary, Alberta, Canada. It is used extensively for both course work and research. The original UNIX based version supports many different output devices including pen plotters, graphics terminals and alphanumeric terminals. The AMIGA version supports only the AMIGA display and printer. Egraph reads pairs of x and y values from a list of files and draws a formated graph. The default graph mode allows multiple curves to appear on the same plot for comparison purposes. Four unique curve fonts are supported: solid curves, dashed curves, dotted curves and long dashed curves. The fonts are sequenced in the above order, if more than four curves are to be drawn the above sequence is repeated as many times as required. For multiple curve plots simply supply up to five file name arguments to egraph. The maximum number of data points is unlimited but faster response time is possible if the number of data points less than 400. OPTIONS -1 one color plot enable (default is multicolor plot) -a delete the labeled axis and inhibit auto scaling -g draw a grid over the plotting region -c pole/zero plot mode, data points of first file are plotted as crosses, of second file as circles, data points of all following files are connected with lines. (default is graph mode) -l connect all data points with lines (default is graph mode) -p plot only data points (default is graph mode) -h "title string in quotes" Places a title at the bottom of the graph. -X plot a standard log scale on the X (horizontal) axis -Y plot a standard log scale on the Y (vertical) axis -x convert X (horizontal) axis data to log scaling. The number following -x is the log multiplier. (used for decibel scaling) ie. -x 20 >-performs-> 20 * log10(X) -y convert Y (vertical) axis data to log scaling. The number following -y is the log multiplier. (used for decibel scaling) ie. -y 10 >-performs-> 10 * log10(Y) -P inhibit messages to standard error (Error messages are not inhibited, info and warnings are). This was used to prevent message text from being sent to an HPplotter. If more than one option is chosen This should be the first option in the option list. -w Load "egraph.opt" file; All of the above options can appear in this special file, plus the following "n" (name axis) and "f" (force scale) options. n label the graphs axis. A prompt for the X axis string will appear, followed by a Y axis string prompt. An axis string is terminated by a carrage return. f force scales to user defined values for the minimum and maximum of the X and Y axis. Prompts will appear for the minimum, maximum, and number of major divisions for both the X and Y axis. if the the number of divisions for either the X or the X axis is zero, then auto scaling for that axis is re-enabled. The format for each option in this file is (each option appears on it's own line): h "title string in quotes" n "X axis label" "Y axis label" l p c x number y number X Y g P 1 a f Xlow Xhigh numb_X_div Ylow Yhigh numb_Y_div (note that `w' may NOT appear in this option file) EXAMPLE OF AN "egraph.opt" FILE (everything between the arrows, not including the arrows, must exist in the file) -> h "Magnitude response of a 10rd order butterworth filter" n "FREQUENCY in Hz" "MAGNITUDE in dB" X y 20 g <- FILES MENU Input data is read and graphed using file names defined by: current files: Data file name(s) previously entered either from the command line or using the "new files" menu. new files: Using a requester, enter or modify the input file name(s). The "save menu" item, when selected saves the current options in the file egraph.opt ( in the current directory). The "about egraph" menu item displays information about egraph. OPTIONS MENU This menu allows all of the options described above for the command line interface to be entered using the menu. PRINTER MENU Two screendump modes are supported: autosize: The aspect ratio is retained while using the complete page width. one-to-one: Each screen pixel is mapped to a printer pixel. The printer preferences should be set to: Threshold 8 Negative Image Black and White VERSIONS There is also a UNIX version of egraph called piped.egraph which does the same thing as egraph but the input file is piped to it ( for use with applications programs). A multiple graph UNIX version of egraph (called mgraph)is also available. AUTHORS K. Jorgensen, L.E. Turner, M.R. Smith Department of Electrical Engineering, The University of Calgary, Calgary, Alberta, Canada T2N 1N4 BUGS For further information on egraph or to report bugs, write to: Laurence Turner Department of Electrical Engineering The University of Calgary Calgary, Alberta, Canada T2N 1N4