BIKLOG5 V 2.3 ******************************************************** * For the Psion Series 5 and 5mx. * ******************************************************** (Copyright, ¸ Jaap Lam‚ris. Januari 2000) INTRODUCTION ============ BIKLOG5 is a program made for bicyclists who like to keep track of their bicycle rides during time. It is not meant to be used during the ride as a cycle computer but as an extension of it to store the cycle computer data and as a tool to analyse the bicycle rides over time. With some renaming of the definitions of the type of bicycles used and riding type, it may be used even for thriathletes by renaming the bicycle names in "swimming", "biking", and "running" and adapting the bicycle ride names into appropriate terms like "training", "race", "intervals" etc. This program is based on the original program Biklog3, which was my first major attempt at programming in OPL. It was then completely developed on my Series 3a with the aid of the S3a emulator. When I later purchased a S5, I ported it to the Series 5 and extended it with the additional capabilities of the S5 (namely, pen operation, printing capabilities and a better database management). In version V2.1 I have included some more options, more statistical output and a way to keep track of the rides ridden versus a goal set for # of rides and bicycle distance set for the year. I have tried to make the program to be user friendly as far as possible, and have released it after a long period of using it myself (during more than a year). This program is freeware, not because I don't need the additional income or fancy the merits of this program, - I spent a large amount of time and effort in creating and debugging this program -, but charging for something I wrote as a hobby and for fun is not my style. Further by making it freeware (or better said postcardware, see the section REGISTERING) I will not be forced to spent considerable time in maintaining and supporting it just for the sake of getting a small additional income. That doesn't mean that I will not support it anymore. As an user of BIKLOG5 myself and as a perfectionist by nature I will keep improving the program and supporting any users of it. Another reason to release it as freeware are some bad experiences in the past with shareware (PSION and PC) programs for which I paid the registration, after which the author did not support it any more, released it as freeware or kept charging for updates despite his earlier promises... . INSTALLATION ============ Below is a list if files supplied in the distribution ZIP file (The file biklg523.ZIP) and the directories they should be placed in after the installation. biklog5.sis SIS installation file biklog5.txt this file If using Psiwin 2.x within windows then just click on the biklog5.sis file. The program will appear in the "normal" Extras Bar after the installation. Alternatively, you may copy the BIKLOG5.SIS to your EPOC machine and double tab it. If installing from somewhere other than Windows then you will need to obtain INS_TE.EXE and install that on your EPOC32 machine. This will enable .SIS files to be decoded using the EPOC32 machine. After installation you should have on your machine the following files: * = C or D *:\system\app\biklog5\biklog5.APP Main application file. *:\system\app\biklog5\biklog5.AIF *:\system\app\biklog5\biklog5.MBM *:\system\app\biklog5\biklog5.HLP BIKLOG help file. c:\system\app\biklog5\bike.ini default configuration file *:\biklog\example example database c:\system\app\biklog5\example.ini example configuration file Except for the *.ini files, all other files may be located on the C or D drive. The database files may be located in any (sub)directory, (from V2.2 on). The directory "*:\biklog\ " is recommended to be the location for the database file. USAGE ===== Most of the information you may need on how to use BIKLOG5 is included on the on-line help. Here is a short description of all hot-key presses Ctl-O Open existing file - Always required, except when creating a new file. Enter filename or use TAB or cursor to cycle through existing files Ctl-N Create a new file - After entering the name and location of the new file, you will be asked to enter the names of up to four bicycles in your household, and the type of bicycle rides you want to tag to your rides (like commute, training, race, clubride). Maximal five ride definitions are possible. Ctl-C Close the current file - Only needed if you want to switch to another database file, or to delete the current file. Shft-Ctl-D Delete a file Shft-Ctl-S Sort current file - This will sort the records according to ascending date. The plotting option assumes that the records are sorted by date! If you get strange effects with the graphs, just do a sort. Ctl-A Add a record - Here you enter the date, bicycle name, bicycle ride type, distance, time or average speed and a short descriptions (max. 40 characters) of the ride. By default the current date and the values of the last entered record will be entered. You may choose to enter average speed or time. Either one is sufficient. Ctl-S scan records - Here you will see a listing of all rides present in the database, according to the filter settings set after entering this mode (time period and bicycle type). All the filtered records will be listed line by line. Use the cursor up, down, and the PgUp or PgDn keys to move or scroll up or down, respectively. HOME or END will move to the first or last record. ESC will exit the scan mode, while "s" will present some statistics of the data in the database. Any other key will invoke a listing of possible actions. Shft-Ctl-A Alter a record Shft-Ctl-E Erase a record Ctl-F Find a string in the records -Use this option to find a string in the memo field of one or more records Ctl-G Plot the (cum.) distances per bicycle or ride type -You will be prompted to enter starting and ending date of the time period, and the time unit along the x-axis (day, week or months). By default the starting date will be January 1th of the year of the first record, and the ending date will be the current date. Cumulative distance plots will be presented for each of the available bicycles (with more than 0 km) in the database plus all bicycles together. Use the up and down cursor keys to cycle through the plots, ESC will return to the menu. Each other key will invoke a listing of possible actions. Ctl-V Preferences settings -use this option to customise the bicycle names, ride definitions, unit of distance (kilometer or mile), and the goals in terms of number of kilometers or miles and the number of rides set in a year. A message wil show up when each goal has been reached. Ctl-I Info on program Shft-Ctl-H Help function Ctl-T Statistical description of rides -Four tables will show you some common statistics (# of rides, cumulative and mean distances and duration for each bicycle and ride type in the database, absolute and relative to the total bike rides. Additionally the total distance ridden per month and bicycle type is shown, while the last table will present some statistics of the rides (longest, shortest, fastes and slowest) Ctl-E Exit Ctl-U UPGRADE from older versions From version 2.3 on the datafile created in BIKLOG5 is an official BIKLOG5 document, enabling to immediately open this file by double tabbing on the icon of the datafile. UPGRADE will convert old datbasefiles, to be recognized by a question mark, to BIKLOG5 documents. A backup file with the extension ".bak" will be created in the original directory. In addition the printing option lets you invoke the regular Psion 5 printing mode. Please note that you must have invoked first the scan mode to be able to print the tabular data. At this moment only the tabular data of the scan option is possible to print. For printing the plots or the other statistics, use the print screen option: (Shft-Ctl-Alt-S) to make a regular MBM file. I do recommend that you use the online help, at least until you become familiar BIKLOG5. Future Improvements =================== -- The scroll bar feature is not really working well and needs some improvement. -- More plotting options. -- Adaption for thriathletes (is already possible in rudimentory form by renaming the bicycle names in "swimming", "biking", and "running" and adapting the bicycle ride names into appropriate terms like "training", "race", "intervals" etc. -- Anything you as user will suggest that is worthwhile and shared at least by one other user! ACKNOWLEDGEMENTS ================ Thanks to Jezar for providing the Help generator, Neil K Bee (neil@bee.net) for the use of one of his icons, and all other PSION programmers, especially Steve Litchfield and Al Richey with their RMREVENT program, who gave me examples of goord working programs. REGISTRATION ============ WHY REGISTER ? Although BIKLOG5 is freeware, I would be very happy if you let me know that you are going to use my programme. First of all to satisfy my curiosity, after putting numerous hours and effort in writing and debugging this program. Secondly it will encourage me to continue further with this program and extend it if you indicate a need for this. Thirdly I will be able to keep you informed on next releases of BIKLOG5, if you registrate it by me. HOW DO I REGISTER ? Preferably you can send your name, adress and/or Email adres by Email to: Jaap Lameris lamerisj@hotmail.com Else you can send a postcard to: Jaap Lameris Richel 10 8303 KX EMMELOORD Netherlands. Please include in your registration note, the version number you got, your postal adress and Email adress. Additional information on BIKLOG5 will be also available on my homepage: http://Jaap_Lameris.tripod.com/mypsion.htm DISCLAIMER ========== Use this software at your own risk. I will not be held responsible for any loss of data and/or any damage caused to users or hardware caused by this software. COPYRIGHT AND CONDITIONS ======================== I reserve copyright on this material, any reproduction in part or whole is strictly prohibited. Additionally, reverse translation of any of files included in the file "BIKLG523.ZIP" is strictly prohibited. You are permitted to distribute the file "BIKLG523.ZIP", as widely as you see fit, under one condition. That condition being; That the file is not in any way altered, and is sent on in an unchanged state. FEEDBACK ======== If you have any comments or suggestions for me I would be pleased to hear from you ! You can mail me at the above address or you can email me at these email addresses; lamerisj@hotmail.com or lameris-molhoek@hetnet.nl Now get on and start bicycling !!! HISTORY ======= Version 2.3 (Jan. 16, 2000): The duration of single rides in the SCAN and STATISTICS modes is now being expressed as hours:minutes format. The datafile generated by BIKLOG5 is now a BIKLOG5 document, e.g. the datafile can be opened automatically in BIKLOG5 by double tabbing on the icon of the database file. An upgrade module is provided in BIKLOG5 to convert databases generated with earlier versions to BIKLOG5 document. A backup file with extension ".bak" will be generated. Version 2.2.1 (Dec. 21, 1999): Minor bugs fixed. It is now possible to use any directory name to place your datafile. Also it is now possible to enter riding time in hours + minutes. Version 2.1 (Nov. '99): Major upgrade from original version. Version 2.0 (Aug. '99), original version, not published in public domain: Based on the original Series 3 version (Biklog3 V 1.1).