AutoGraf Autolog Graphing program by Joel Swank Version 2.0 March 1991 Quick Start: Two sample data files are provided so you can see what the program does. If you click the Icon, one of these is automatically loaded. You can then see the graphs and other information that are available. When you are ready to enter your own data, you can use the "Clear Data" menu item and the "Edit Data" item. When you have your own data saved in a file, you can use the "INFO" workbench utility to edit the tooltypes array in the Icon to have your file automatically loaded at startup. Complete Instructions: AutoGraf allows entry and graphing of automobile gasoline purchase log. AutoGraf constructs 3 types of graphs: Cost per mile in cents per mile, Price per gallon in dollars per gallon, and fuel milage in miles per gallon. AutoGraf can be started by clicking its icon or by CLI command. AutoGraf has a 6 item Project menu: Read File, Write File, Clear Data, About, Help, and Quit. o Read File will request the name of a data file with a file requester and then read the selected file into memory. o Write File will request the name of a data file with a file requester and then write the data to the selected file. o Clear Data will erase any data currently in memory. o About gives version information. o Help displays a portion of this text. o Quit ends the program. You can also quit using the close gadget on the main window. AutoGraph also has a 6 item Action menu: Edit Data, Graph MPG, Graph $/MI, Graph $/Gal, Averages, List Data, and Print Window. o Edit Data will allow you to enter and modify the data. See edit window below. o Graph MPG draws a graph of fuel milage versus time. o Graph $/MI draws a graph of cost per mile for fuel versus time. o Graph $/GAL draws a graph of cost fuel versus time. o Averages displays a set of averages for all the selected data. o List Data prints a formatted list of the data file on the printer. The current preferences printer settings are used. o Print Window does a graphics dump of the contents of the main window to the printer. AutoGraph also has a 3 item options menu: Select Years, Metric, and English. o Select years allows you to select a subset of the data to be graphed or averaged. Years can be entered as 2 digits (0-99) meaning 1900-1999, or as full 4 digit numbers. years between 1900 and 2199 are allowed. o Metric and English are mutually exclusive options that select the units to be used for the data. When in Metric Gallons and miles become Liters and kilometers. If there is data in memory when you select one of these options, you will be given the option of converting the data. The odometer reading, gallons/liters, and the price will be converted. Autograf cannot detect whether a data file is metric or english. By default it starts in English mode. If you are using metric data, you can have it start in metric mode by setting the METRIC= tooltype in the Icon, or using the -m CLI flag. The graphs display a running average of the most recent 10 transactions. When a graph is on the screen, the mouse can be used to display the numeric value of any point on the graph. Click the 'DONE' gadget or the close window gadget to erase the graph and return to the main menu. The edit window allows you to enter, modify and delete records in memory. Each record has 5 items of data. The date of the transaction is used to annotate the X axis of the graph. The date may be entered in a variety of formats. Some examples: mm-dd-yy, MMM dd yyyy, mm/dd/yy. 'mm' is the numeric month fron 1 to 12. 'MMM' is the character month, the first three letters of the month. 'dd' is the numeric day of the month from 1 to 31. 'yy' and 'yyyy' are the year. If only 2 digits are specified, 1900 is added to the year. Combination formats like MMM/dd yyyy are also OK. The odometer reading is the reading of the vehicles odometer at the time of the transaction. You may enter up to 999999.9 for the odometer reading. The decimal point and tenths are optional. The Gallons, Price and Dollars define the ammount of the purchase. Any two of these may be entered and the third will be calculated. If you enter all three and the values don't match, Price and Dollars will take precedence, since they are the most likely to be accurate. Gallons may be entered with one or zero decimal places. Price is in dollars per gallon and may be entered with 3 decimal places. Dollars is the total cost of the transaction and may be entered with 2 decimal places. The Enter gadget will enter the current data into memory if it is correct. If an error in the data is detected, you will be informed with a requester. The odometer reading is the key of the data. It will determine the order of the records. If you enter an odometer reading identical to one already in the data, the old record will be replaced. If you have a record with an incorrect odometer reading in the data, you will have to first delete it with the Delete gadget and then enter the corrected data. Pressing RETURN after typing data in a string gadget will take the cursor to the next string gadget if the entered data is correct. Pressing RETURN in the last string gadget (Dollars) will automatically enter the current data if it is all correct. The Clear gadget may be used to erase all data from the string gadgets. It does not affect any data currently in memory. The arrow gadgets at the bottom of the window can be used to scan through the data. One click moves up or down one record. Holding down the left button over one of these gadgets will roll through the data records. The Top gadget will move to the first record and the Bottom gadget will move to the last record. AutoGraf accepts 3 parameters at startup. They may be entered as flags on the command line, or as tooltypes in the ICON. The command line options are: >autograf [-r#] [-m] [file] -r# The roll speed in the edit window. 1 to 5 are allowed. 2 is the default. -m Selects metric mode. English is the default. file Is the name of a data file to be read at startup. The Tooltypes are: ROLL=# The roll speed. METRIC= Select metric mode. FILE=file The file to be read at startup. All must be entered in upper case. The '=' is required. Two sample data files are provided: 84olds, and 77pont. Error messages in Alphabetical Order Most error messages appear in requesters. A few appear highlited in the window. Most are information only, so you just click "OK" after you have read them. A few give you an option which is explained below. All data in Memory will be Cleared: ARE YOU SURE? This message is to verify that you want to erase all data from memory. Click "Yes" to clear data, "Cancel" to preserve the data. Do You Wish to Convert the Data to English? If you select the "English" option with data in memory you will get this message. Click "YES" to convert, "NO" to skip the conversion. Do You Wish to Convert the Data to Metric? If you select the "Metric" option with data in memory you will get this message. Click "YES" to convert, "NO" to skip the conversion. Edit Window Failed to Open Cannot open the edit window. Most likely reason is lack of memory. If you have any other applications running, close them and try again. End less than Start You have entered a range of years that is invaled. The ending year must be greater than or equal to the start year. I/O error reading directory The file requester has encountered an error on the disk. Invalid Date Specified The format of the date you entered in the Date gadget is invalid. See the text for valid date formats. Invalid End Year The end year entered is invalid. Years between 0 and 99 are accepted as 1900 to 1999. Years betweem 1900 and 2199 are also accepted. Invalid Float Specified An invalid floating point number was entered. A floating point number may have any number of digits and one decimal point with no spaces. Scientific notation is not allowed. Invalid Start Year The start year entered is invalid. Years between 0 and 99 are accepted as 1900 to 1999. Years betweem 1900 and 2199 are also accepted. Modified Data not saved Exit anyway, or Cancel? If you modify data using the edit window and try to exit AutoGraf before writing the data to a file you will get this message. If you want to save the data, click "Cancel" and use the "Write File" menu item to save it. If you do not want to save the data just click "Exit". No data selected - check options Some operations cannot proceed with out sufficient data. To graph, at least 2 records are required. If you are sure that there are records in memory, check the "Select Years" option to be sure that there is data that matches the year range specified. Odometer Reading not Specified An odometer reading must be entered before a record can be stored in memory. Out of Data Space: Maximum of 1000 records allowed You have tried to enter the 1001th record. Sorry only 1000 are allowed. Out of Memory An operation cannot proceed for lack of memory. If you have any other applications running, close them and try again. Printer Error Encountered An error has occured while listing data on the printer. Check the printer and try the operation again. Printer failed to open An error has occured while opening the printer device. Check the printer and try the operation again. Ready Paper in Printer This message occurs when you list the data file, and single sheet mode is selected in preferences. AutoGraf pauses with this message before every page. Two of the following must be Specified: Price, Gallons, Dollars To enter a record into memory at least two of the above must be entered in the gadgets. The third will be calculated. Unable to find requested path The file requester has attempted to log a path that does not exist. Window failed to open Cannot open A window. Most likely reason is lack of memory. If you have any other applications running, close them and try again. Year Out of Numerical order The records in memory must have the year of the date in numerical order. You have probably entered a date incorrectly. Format of the Data file: Individual fields separated by commas. * date - character format - MMM DD YYYY * odometer reading - 999999.9 * price per gallon - $9.999 * Total cost of purchase - $9999.99 * gallons - 999.9 Registration: You can register AutoGraf by sending $10 to the address below. Registration makes you eligible for automatic update with any future versions and guaranteed response to any bug reports. Send bugs, complaints, accolades, and registration to: Joel Swank 205 NW Meadow Dr. Beaverton, OR 97006 (503) 641-6203