home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / MISC / PETROL / PETROL.TXT < prev    next >
Encoding:
Text File  |  1993-04-25  |  4.0 KB  |  108 lines
  1.                                                         Petrol
  2.  
  3.                                          From Lemon Technology
  4.                                         (c) Graeme Bishko 1993
  5.  
  6. Shareware
  7.  
  8. This program is shareware. You can use it, distribute it (in an
  9. unaltered form) and generally have fun with it. I accept no
  10. responsibility for any loss etc. It took a fair bit of effort to
  11. write it so if you feel you would like to pay something for it
  12. (say £5.00 ?) you are welcome to. At any rate, I would appreciate
  13. any comments you may have about it or just something to tell me
  14. you are using it. If you want to get in touch with me you can
  15. E-mail me at:
  16.     G.B.Bishko@sheffield.ac.uk
  17. Snail mail:
  18.     G.Bishko,
  19.     Flat 5, 9 Whitworth Rd. 
  20.     Sheffield
  21.     ENGLAND 
  22.     S10 3HD
  23.  
  24. Introduction
  25.  
  26. This application represents my first foray into Psion 3 software.
  27. The basic goal was a rudimentary way of tracking petrol
  28. consumption.  As usual it got a little out of hand. The program
  29. works on the assumption that each time you put petrol in your
  30. car, you fill it to the brim and record the number of miles
  31. travelled since the last fill up. If you don't do this, you can
  32. keep track of intermediate top-ups by noting the litres put in.
  33.  
  34. The program expects litres as the unit of petrol volume: all the
  35. pumps in Britain seem to have gone metric. It still gives petrol
  36. consumption in miles per gallon as I can't get used to litres per
  37. 100 k.m. If I get enough demand from the 'States, I'll do a
  38. version for U.S. gallons, as long as someone tells me the
  39. conversion rate!
  40.  
  41. The program presents a scrolling list of "fill-ups" and allows
  42. choices to be made from a menu. There are the usual options for
  43. adding and editing entries as well as a totalling function. Two
  44. graphs can be drawn from the data: an histogram of MPG vs miles
  45. and a line graph of miles per day vs days (this also shows MPG as
  46. grey bars because the correlation is often quite good).
  47.  
  48. Installation Instructions
  49.  
  50. Petrol requires its own directory:
  51.     \petrol
  52. Petrol.opa will run from any drive but its load in module
  53. (grpah.opo) and the icons will want to be in RAM. You may like to
  54. have the application in a sub directory on FLASH with another sub
  55. directory in RAM to hold these extra files. The four files needed
  56. are:
  57.     petrol.opa  Main application
  58.     graph.opo Module to draw graphs
  59.     pump.pic  Icon (should be in RAM)
  60.     lemtec.pic  Icon (should be in RAM)
  61.  
  62. Instructions
  63.  
  64. On first use the program will create an empty file to use. You
  65. can rename this if you want to, and the program can cope with
  66. multiple files.
  67.  
  68. The next thing to do is to add a record to the database: Menu:
  69. Edit/Add provides a dialogue for this to be done. You must enter
  70. a number of miles, the number of litres  and the cost of the
  71. transaction. A short note can also be saved.
  72.  
  73. Once this is done, a box comes up showing statistics for that
  74. fill-up;  killing this box returns to the scrolling list.
  75.  
  76. The rest of the menu items should be self explanatory but I will
  77. give some description of the two forms of graph.
  78.  
  79. Histogram
  80.  
  81. This graph shows the M.P.G. achieved in each fill-up block,
  82. against the miles travelled. The width of each block is scaled by
  83. miles travelled.
  84.  
  85. The initial dialog box allows you to choose which records to
  86. graph and the y axis maximum and minimum. The y axis values are
  87. set automatically. Should you change the records to be shown, the
  88. y max & y min values will be rescaled and the dialog displayed
  89. again.
  90.  
  91. The graph is initially drawn with labels on the axes. The will be
  92. removed by the first key press whilst they can be re-shown by
  93. pressing "L". The next key press returns to the main screen.
  94.  
  95. Line Graph
  96.  
  97. This shows M.P.D. (car usage) vs days. The vertical lines drawn
  98. correspond to the first day of each month. The grey bars show the
  99. M.P.G. achieved on each tank. The line is not really valid in
  100. this case as each point is an average over the previous time
  101. period.
  102.  
  103. The same dialog precedes this graph as the last. It should be
  104. noted, however, that in order to calculate a value for miles per
  105. day, the first entry in the list is passed over.
  106.  
  107.  
  108.