BIKLOG5 V 3.1 ******************************************************** * Voor de Psion Series 5/5mx /MC218 en REVO(+)/Mako * ******************************************************** (Copyright 2003, ¸ Jaap Laméris. 15 maart, 2003) INHOUD - INTRODUCTIE - ACHTERGROND - INSTALLATIE - OPWAARDEREN VAN OUDERE VERSIES - GEBRUIK - TOEKOMSTIGE VERBETERINGEN - MET DANK AAN: - REGISTRATIE - DISCLAIMER - GESCHIEDENIS INTRODUCTIE ============ BIKLOG5 is een programma voor fietsers die graag hun tochten over een zekere periode willen bij houden. Het is niet bedoeld om tijdens het fietsen te gebruiken als een fiets computer maar als een uitbreiding om de fietstocht gegevens te bewaren en als een middel om deze gegevens grafisch weer te geven en te analyseren. Met enige aanpassing van de definities van de gebruikte fietsnamen en soorten fietstochten of activiteiten, is het zelfs mogelijk voor tri- athleten om Biklog voor hun activiteiten in te schakelen. Dit door in plaats van de namen van de gebruikte fietsen de termen "zwemmen", "fietsen" en rennen" te gebruiken en de fietstochtactiviteiten te hernoemen naar "training", "wedstrijd", "intervals", "duurloop" etc. Versie 3.1 is sterk verbeterd met de toevoeging van 7 extra data velden, waarvan enkele voledig zelf te definieren door de gebruiker. Naast de extra mogelijkheden in de statistieken, kan men ook gebruik maken van een startdatum en van een logboek bestand voor langere aantekeningen bij iedere tocht. BIKLOG5 is echter ook in staat om te werken met bestanden gemaakt met eerdere versies. Echter, om in staat te zijn de nieuwe toevoegingen te kunnen gebruiken, is het noodzakelijk de oude bestand(en) op te waarderen door de upgrade functie in het menu uit te voeren. ACHTERGROND =========== Dit programma is gebaseerd op mijn oorspronkelijke programma Biklog3, welke mijn eerste serieuze poging was om te programmeren in OPL op een PSION organizer. Het is geheel ontwikkeld voor en op een Psion 3a organizer met de hulp van de S3 emulator op mijn PC. Toen ik later de Psion series 5 aanschafte, heb ik het programma overgebracht naar deze meer krachtige handcomputer, gebruikmakend van de extra eigenschappen van de Series 5,(namelijk, touchscreen gebruik, afdruk mogelijkheden en een beter database management systeem.) In versie V2.1 zijn er meer opties toegevoegd, meer statistieken en een wijze om doelstellingen bij te houden in termen van aantal tochten per jaar of aantal kilometers te fietsen in een jaar. In versie, 2.4, is het programma aangepast aan de Revo-Revo+, rekening houdend met het kleinere scherm. Ik heb geprobeerd om het programma zo gebruiksvriendelijk mogelijk te maken en heb het uitgebracht na eerst een lange periode zelf gebruikt te hebben ( meer dan 5 jaar). Het programma is gratis, niet omdat ik geen extra inkomen nodig zou hebben of dat ik de waarden van het programma onderschat, - ik heb een aanzienlijke hoeveelheid tijd en moeite erin gestoken om het te ontwikkelen en het te testen -, maar iets voor vragen wat ik als een hobby ontwikkelde en voor plezier schreef is niet mijn stijl. Door het gratis te houden ben ik overigens niet gedwongen om een aanzienlijke hoeveelheid tijd en moeite te stoppen in het onderhoud en de ondersteuning van mijn klanten juist voor een klein extra "vermogen". Dit betekent niet dat ik BIKLOG5 niet zal onderhouden en verder zal ontwikkelen. Zijnde zelf een gebruiker van BIKLOG5 en een perfectionist van nature, blijf ik bezig om het programma te verbeteren, zo mogelijk uit te breiden en de gebruikers te ondersteunen. Een ander reden om het als freeware uit te brengen zijn enige vervelende ervaringen geweest met andere shareware programma´s (Psion en PC) waarvoor ik eerlijk mijn registratie had betaald, maar de schrijver kort daarna het programma niet meer ondersteunde, het daarna uitbracht als freeware of voor updates opnieuw geld vroeg ondanks eerdere beloften.... INSTALLATIE ============ Hieronder is een lijst met bestanden aanwezig in het distributie ZIP bestand (het bestand Biklg531.zip). bklg531.sis SIS installatie bestand biklog5_leesmij.txt dit bestand biklog5_readme.txt deze tekst in Engels biklog5_liesmich.txt deze tekst in Duits biklog5_lisezmoi.txt deze tekst in Frans editor.zip ZIP file met installatie bestand Symbian editor Indien u Psiwin 2.x gebuikt klik op het Biklog5.sis bestand voor installatie op de Psion/Ericson of Mako. Het programma zal daarna verschijnen in het "extras" venster. Anderszijds kunt u ook dit bestand copieren naar uw EPOC machine en dubbel klikken op het ikoon. Indien u een oude versie van Psiwin gebruikt, zal u eerst het bestand INS_TE.EXE moeten verkrijgen en het op uw EPOC machine installeren. *If you don´t have installed the Symbian Text editor on your machine and you want to use the new diary file function within Biklog5, you have also install the Editor installation file editor.sis, packed in the editor.zip file!* Na installatie moeten de volgende bestanden op de machine aanwezig zijn: * = C of D (of E voor de Series7/netBook eigenaren) *:\system\apps\biklog5\biklog5.APP belangrijkste applicatie bestand. *:\system\apps\biklog5\biklog5.AIF help bestand *:\system\apps\biklog5\biklog5.MBM bestand met BIKLOG5 afbeeldingen *:\system\apps\biklog5\biklog5.HLP BIKLOG help bestand. *:\system\apps\biklog5\biklog5.rsc BIKLOG bestand met de Ned. taalversie c:\system\apps\biklog5\biklog.ini standaard configuratie bestand c:\system\apps\biklog5\biklog5.ini ini bestand met o.a. laatste gebruikt bestandsnaam *:\system\apps\biklog5\efm.mbm graphisch hulp bestand c:\biklog\example voorbeeld gegevensbestand c:\system\apps\biklog5\example.ini voorbeeld configuratie bestand c:\system\apps\biklog5\example_d.txt voorbeeld logboek bestand *:\system\opm\ini.opm ini.opm (hulp bibliotheek bestand) *:\system\opm\iqgrid.opm iqgrid.opm (hulp bibliotheek bestand) *:\system\opx\gprinter.opx OPX hulp bestand voor afdrukken *:\system\opx\nmpd.rsc RSC hulp bestand voor NMPD module *:\system\opl\nmpd.oxh OHX hulp bestand voor NMPD module *:\system\opl\nmpdconstants.oxh OHX hulp bestand voor NMPD module *:\system\opm\readwrite.opm OPM hulp bestand voor READWRITE module Met uitzondering van de *.ini bestanden, kunnen alle bestanden op de C of D schijven worden geinstalleerd. De database bestanden kunnen in iedere folder worden opgeslagen (vanaf versie 2.2), echter de folder "*:\biklog" wordt aanbevolen als de lokatie voor het opslaan van Biklog documenten met tochtgegevens. GEBRUIK ( en referentie toetsaanslagen) ======================================= Alle informatie over het gebruik van BIKLOG5 is ook aanwezig het de beschikbare help bestand te bereiken via het menu of de sneltoets Ctrl-Shft-h). Hier is een korte beschrijving van alle sneltoetsen: Ctrl+N , maakt een nieuw bestand aan. Na opgave van een nieuw bestandsnaam en lokatie, wordt u gevraagd om de namen van max. 4 fietsen in uw bezit op te geven, en de type fietstochten of evenementen die u wilt gebruiken (zoals woonwerk, training, wedstrijd..). Maximaal vijf evenementen zijn mogelijk. De gebruiker kan ook de namen en eenheden van maximaal 4 extra datavelden en een logisch dataveld (type Ja/Nee of Aan/uit) definieren, plus 6 verschillende beschrijvingen om de conditie van de tocht of het weer te beschrijven. Deze gegevens kunnen ook later in het menu Voorkeuren gedefinieerd worden. Ctrl+O , opent een bestaand bestand. Merk op dat bestanden ook geopend kunnen worden door twee keer te klikken op de ikoon van het bestand. Biklog5 zal in eerste instantie het laatst geopende bestand openen, tenzij men op het ikoon van een ander bestand klikt. Ctrl+C , sluit het huidige bestand. Alleen nodig indien u het huidige bestand wilt verwijderen. Shift+Ctrl+D , verwijdert een databestand en het bijbehorende INI bestand. Shift+Ctrl+S , sorteert de tochtgegegevens naar oplopende datum. Indien u ook de startdatum gebruikt, zal de sortering hier ook van gebruik maken. De plot optie neemt aan dat het bestand naar datum is gesorteerd! Indien u vreemde resultaten in de PLOT mode krijgt, sorteer eerst het bestand! Shift+Ctrl+Y , exporteert alle tochtgegevens naar een ASCII tekst bestand, waarbij nog een keuze gemaakt kan worden in het karakter voor de veldscheidingsteken. Verder zijn er twee opties beschikbaar voor de weergave: (1) compleet met datum, fietsnaam, evenement naam en conditie code volledig geschreven of (2) met de EPOC code voor datum, en een ID voor de fietsnaam, evenementnaam en conditie code. De eerste optie is aanbevolen voor verdere analyse in een ander programma zoals een rekenblad of tekstverwerkingsprogramma voor verdere verslaglegging. De tweede optie is beter geschikt als men de data weer wil importeren in een nieuwe of bestaande BIKLOG5 bestand. EPOC datum formaat is het aantal dagen na 1-1-1900, terwijl EPOC tijd is gedefinieerd als het aantal seconden na middernacht. De velden worden door een door de gebruiker gekozen veldafscheidingsteken (, ; of tab) afgebakend. Shft-Ctrl-I importeert een tekst bestand naar een BIKLOG5 database bestand. De gebruiker heeft de mogelijkheid om een nieuwe database bestand te maken of de data toe te voegen aan een ander bestand. De invoer tekst bestand moet bestaan uit een eerste regel met alle veldnamen, gevolgd door de velden van ieder tocht op een regel. Velden moeten voorzien zijn van een veldafscheidingsteken en kunnen gedefinieerd zijn volgens de twee verschillende formaten zoals beschreven in de hier boven export optie (Zie ook de "Help bestand" voor specifieke regels voor het importeren). Shft+Ctrl+E , beeindigt het programma en sluit alle bestanden netjes af. Ctrl+A , voegt de gegevens van een fietstocht toe aan het huidige bestand (datum, fiets naam, tocht evenement, afstand, duur of gemiddelde snelheid bereikt en een korte beschrijving van de tocht (max 40 karakters). U kunt kiezen tussen gemiddelde snelheid (standaard) of tijdsduur in uren en minuten, zoals gedefenieerd in Voorkeuren. * Indien zo bepaald bij de optie Voorkeuren kunnen ook achtereenvolgens de volgende gegevens ingevoerd worden: (1) de starttijd, (2) de inhoud van max. 4 extra datavelden, (3) de inhoud van eenn logisch dataveld (Ja/Nee of Aan/Uit, zoals bij Voorkeuren bepaald), (4) een van de 6 keuzen voor het conditieveld, (5) tekst van maximaal 255 karakters toe te voegen samen met de datum en starttijd in eenlogboek bestand. Dit logboekbestand heeft standaard de volgende naam; xxxxx_d.txt, waar xxxxx de naam van de huidige databestand is. Standaard zijn de huidige datum en de waarden van de laatst ingevoerde tocht ingevoerd. Shift+Ctrl+A , wijzigt de invoer van een tocht in het huidige bestand. Shift+Ctrl+E , verwijdert de gegevens van een tocht in het huidige bestand. Ctrl+F , zoekt een karacterreeks op in het notitieveld van de tochtgegevens in het huidige bestand. Ctrl+T , geeft de inhoud van het bestand in tabel vorm weer. Men kan hierbij eerst nog filters toepassen op het bestand. Zie ook de aparte sectie in het helpbestand voor meer details. Shift+Ctrl+T , stuurt de tabel naar de printer of naar een bestand. Deze keus is alleen zichtbaar en beschikbaar indien men eerst een tabel heeft gegenereerd! Ctrl+G , maakt grafieken van het huidige (gefilterde) bestand met verschillende weergave mogelijkheden. Zie ook de speciale sectie in het helpbestand over Grafieken. Shift+Ctrl+G , stuurt de grafieken naar de printer of naar een bestand. Deze keus is alleen zichtbaar en beschikbaar indien eerst grafieken zijn gemaakt! Ctrl+S , presenteert statistieken van de tochtgegevens in het huidige (gefilterde) bestand. Zie ook de speciale sectie in het helpbestand over Statistieken. Shift+Ctrl+T , stuurt de statistieken naar de printer of naar een bestand. Deze keus is alleen zichtbaar en beschikbaar indien eerst statistieken zijn gemaakt! Ctrl+V , Hier definieert men achtereenvolgens de namen van de verschillende fietsen en fietsevenementen (zoals woonwerk, training, clubtocht, enz.) in het bestand. Ook kan men de eenheid van afstand (km of mi) en het aantal tochten en de afstand die men doel wil stellen voor het jaar. Als laatste geeft men de papiersoort en het nummer van cijfers achter de decimaal op. Kies onbekend indien men niet de papiersoort weet (A4 is het meest gebruikt in het vaste land van europa). Ctrl+U oudere database, converteert bestanden gecreert in versie 2.3 of eerder in BIKLOG5 documents, waardoor deze bestanden meteen door Biklog5 geopend kunnen worden door dubbel te klikken op de ikoon van het bestand. Een backup bestand van het originele bestand zal gemaakt worden in de directorie van het originele bestand. Ctrl+B toont wel of niet de toolbar aan de rechterkant. Ctrl+I , geeft informatie over het huidige bestand. Shift+Ctrl+H , start het HELP bestand op. Niet in menu: Ctrl-h Verandert de standaard definitie van de kop- en voettekst van de TABEL uitvoer. Merk aub op dat voor het afdrukken van de Tabel, de grafieken of de statistieken het eerst nodig is om deze eerst te maken! De menukeuzen voor het afdrukken van de uitvoer zijn in eerste instantie in lichtgrijs uitgevoerd, ten teken dat de uitvoer nog niet is gemaakt! Ik raad aan om de on-line hulp functie te gebruiken, in ieder geval totdat u volledig bekend heb gemaakt met Biklog5. Toekomstige verbeteringen ========================= -- Andere talen -- Aanpassen voor gebruik voor tri-athletes (is reeds in rudimentaire vorm mogelijk door de verschillende fietsnamen te hernoemen in "zwemmen", "fietsen" en "hardlopen" en de fietsevenementen benaming te definieren als "training", "intervals", "wedstrijd", etc. -- alles wat u als gebruiker naar voren schuift, als het de moeite waard is en door minstens een ander gebruiker ook wordt voorgesteld! MET DANK AAN: ============= Veel dank aan: --Neil K Bee (neil@bee.net) voor het gebruik van zijn ikonen, --PocketIQ, en in het bijzonder Mr. Damien Lewis, voor het vrijgeven van de IQGRID OPM routine, wat ik gebruikte voor de TABEL functie, --RMRSoft voor hun gratis programma RMRRSG, waarmee het mogelijk was om internationale versies uit te kunnen brengen, -- alle andere Psion programmeurs, in het bijzonder Al Richey en Steve Litchfield met hun voortreffelijke RMREVENT programma, die mij goede voorbeelden hebben gegeven van goed uitgevoerde EPOC programmas, -- Martin Zeddies voor de Duitse vertaling, -- Philippe Bricka voor zijn Franse vertaling, -- en niet in het minst belangrijk alle gebruikers van Biklog5, die mij waardevolle suggesties, ervaringen, kritiek en aanmoedigingen hebben gegeven!! REGISTRATIE ============ Waarom registreren ? Ofschoon BIKLOG5 gratis is, zou ik het erg prettig vinden om van u te horen dat u mijn programma gebruikt. Ten eerste om mijn nieuwsgierigheid te bedwingen en om mijn ego te strelen ;-), na zoveel uren en moeite in het programmeren en debuggen van het programma gestopt te hebben. Een tweede en belangrijkere reden is het dat het mij aanmoedigt om door te gaan met dit programma en mij in staat stelt om u op de hoogte te houden van verdere ontwikkelingen. Hoe kan ik registreren ? Bij voorkeur door uw naam, adres en/of e-mail adres te sturen per e-mail naar: Jaap Laméris j.lameris@hccnet.nl Of door een briefkaart te sturen naar: Jaap Laméris Richel 10 8303 KX EMMELOORD Netherlands. Voeg bij uw registratie liefst ook de versie nummer, de taal versie en machine type bij uw naam en (e-mail) adres. Verdere informatie over BIKLOG5 en de ontwikkeling ervan treft u ook aan op mijn website: http://home.hccnetnl/j.lameris/mypsion.htm DISCLAIMER ========== Gebruik deze software op eigen risico. Alhoewel ik Biklog5 langdurig heb getest, kan ik niet verantwoordelijk gehouden worden voor elke vorm van verlies van gegevens of schade veroorzaakt aan software of hardware door mijn programma. COPYRIGHT EN CONDITIES ======================== Ik behoud het copyright op dit materiaal, elke copiering van een gedeelte of van het geheel is geheel verboden. Daarnaast is elke poging tot omgekeerde vertaling of "reverse translation" van de bestanden in het ZIP bestand Biklg531.zip strikt verboden. U mag het bestand "BIKLG531.ZIP" onbeperkt verspreiden en copieren onder één voorwaarde. Deze voorwaarde is: dat het bestand in geen enkel opzicht veranderd mag worden en dat het in onveranderde toestand kosteloos wordt verspreid. FEEDBACK ======== Indien u opmerkingen of suggesties over BIKLOG5 heeft en/of ideeen om het te verbeteren, hoor ik het graag van u! U kan mij bereiken op bovengenoemd adres of op mijn e-mail adres: j.lameris@hccnet.nl of lameris-molhoek@hetnet.nl GESCHIEDENIS ============ 3.1 (15 maart 2003) -- franse en duitse versie -- bug voor Series7/netBook gebruikers gerepareerd -- enige kleine bugs in in-/uitvoer formaat verbeterd. 3.0 (Januari, 2003) (Alleen Engelse en Nederlandse versie op dit moment) -- uitgebreide database met 7 extra datavelden: 4 velden te defineren door de gebruiker 1 logisch veld te definieren door de gebruiker (ja/Nee of Aan/Uit) 1 "conditie" veld met 6 keuzen te de definieren door de gebruiker (bijv. om weer of terrein condities te beschrijven) starttijd -- gebruiker kan de aanwezigheid van ieder extra dataveld apart aan/ of uitzetten in uitvoer (via Voorkeuren) -- logboek bestand voor langere annotaties bij tochten (max. 255 karakters) -- ook geschikt voor oudere gegevensbestanden -- voorspellingsfunctie geimplenteerd opgenomen in menu structuur -- import functie -- uitvoer aangepast voor Series 7/netBook schermgrootte -- meer statistische opties -- sorteren nu ool op datum en starttijd -- filter mogelijkheid uitgebreid voor TABEL, Figuren en Statistiek -- enige kleine bugs gerepareerd* 2.8 21 april 2002 -- Nederlandse, Duitse en Franse versie aangeboden, -- Statistieken uitgebreid met meerdere overzichten, -- voorspelling van totaal aantal kilometers en tochten aan het eind van het jaar toegevoegd in statistieken, -- exporteren naar een tekst bestand nu mogelijk, -- enige bugs in de grafieken gerepareerd, -- nomenclature in menu structuur verbeterd. 2.7 12 december 2001 -- Grafiek functies uitgebreid met totale afstand en duur; gemiddelde afstand en duur; en gemiddelde snelheid per tijd periode, -- Grafieken kunnen nu ook weergegeven worden voor iedere fietsevenement naast voor iedere fiets, -- niet-cumulatieve grafieken kunnen nu weergegeven worden als staven of als lijnen, -- maximaal 400 dagen nu mogelijk als tijdsperiode in grafieken uitvoer, -- enige kleine bugs gerepareerd. 2.6 12 august 2001 -- tijd nu in uur:min:sec, -- statistieken kunnen nu afgedrukt worden, -- bug in biklog5.ini gerepareerd, -- kleine bugs gerepareerd (m,n,. "niet een geldig bestand"). 2.5 16 april 2001 -- betere afdruk mogelijkheid voor de tabel uitvoer, -- Juiste papier formaat automatisch gekozen, -- grafieken kunnen nu afgedrukt worden, -- aantal cijfers achter de comma is nu definieerbaar, -- aantal kleine bugs gerepareerd. 2.41 15 november 2000 -- correctie in de uitvoer van de Tabel, -- (laatste) versie van sysram1.opx opgenomen in het SIS bestand. 2.4 1 november 2000 -- TABEL mode verbeterd met een scroll en een zoom optie, -- automatische detectie van schermgrootte, -- REVO compatibel, -- het laatst geopende bestand wordt nu automatisch geopend, tenzij een ander bestand is aangeklikt, -- afdruk formaat verbeterd, -- statistieken van huidig bestand weergegeven in hoofdscherm, -- enige kleine bugs gerepareerd. 2.3 16 januari 2000 -- Uitvoer van de duur van afzonderlijke tochten in TABEL of in STATISTIEKEN is nu in uur:minuten formaat, -- bestand is nu een BIKLOG5 document, m.a.w. het is nu mogelijk om door de ikoon van het bestand dubbel te klikken dit bestand te openen door BIKLOG5. Een UPGRADE module is in het programma aanwezig om oudere bestanden op te waarderen naar BIKLOG5 bestanden, -- enige kleine bugs gerepareerd. 2.21 21 december 1999. -- Enige kleine bugs gerepareerd, -- het is nu mogelijk om elke folder te gebruiken voor opslag van het bestand, -- Invoer van tochtduur is nu in uren en minuten. 2.1 20 november 1999 -- Belangrijke verbetering van origineel, -- Eerste publiek beschikbare versie. 2.0 augustus 1999 -- Originele versie, overgezet van de SIBO (Psion serie 3) versie BIKLOG3 (v1.1) . -- Nooit in publieke domein uitgegeven.