BIKLOG5 V 3.2 ************************************************************ * Pour le Psion Series 5/5mx/7/netBook et le REVO(+) * ************************************************************ (Copyright, Jaap Laméris. March 15, 2003) CONTENU - INTRODUCTION - CONTEXTE - INSTALLATION - MISE A JOUR DEPUIS VERSION ULTERIEURE - UTILISATION - AMELIORATIONS A VENIR - REMERCIEMENTS - ENREGISTREMENT - MISE EN GARDE - HISTORIQUE INTRODUCTION ============ BIKLOG5 est un programme destiné aux cyclistes qui désirent garder une trace de leurs sorties à vélo. Il n'est pas conçu pour être utilisé pendant les sorties comme un compteur de vélo mais comme un complément à ce dernier pour enregistrer les données du compteur et comme un outil permettant l'analyse des sorties dans le temps. Les triathlètes pourront même utiliser le programme en changeant les définitions des types de vélos et des sorties et en rebaptisant les noms de vélos en "natation", "vélo", et "course" et en donnant aux sorties des noms appropriés tels que "entraînement", "course", "fractionné", etc. La version 3.1 est une évolution majeure, rajoutant 7 champs, dont certains sont paramétrables par l'utilisateur. BIKLOG 5 est cependant capable de de gérer des fichiers de données des versions précédentes. Pour pouvoir utiliser ces nouvelles possibilités il faut mettre à jour les fichiers de données en utilisant l'option de mise à jour du menu. CONTEXTE ======== Ce programme est issu du programme original Biklog3, qui a été mon galop d'essai à la programmation en OPL. Il a ensuite été complètement développé sur mon Série 3a en m'aidant de l'émulateur S3a. Après l'acquisition de mon Série 5 j'ai transposé le programme sur cette machine et l'ai amélioré en utilisant les possibilités supplémentaires offertes par le S5 (utilisation du stylet, capacités d'impression et meilleure gestion de la base de données). Dans la version V2.1 j'ai inclus quelques options supplémentaires, davantage de données statistiques, et la possibilité de comparer les sorties effectuées à un objectif annuel fixé en nombre de sorties et en distance. Dans la version 2.4 je l'ai adapté au REVO(+) en prenant en compte la taille réduite de l'écran. J'ai essayé de rendre le programme le plus facile à utiliser possible et je ne l'ai diffusé qu'après l'avoir utilisé moi-même pendant plus de cinque ans. Ce programme est en freeware, non parce que je n'ai pas besoin d'argent ni parce que j'en minimise l'intérêt. J'ai passé beaucoup de temps et dépensé beaucoup d'énergie pour le développer et le mettre au point, mais faire payer pour quelque chose que j'ai écrit pendant mes loisirs et pour mon plaisir ne correspond pas à mon style. De plus en en faisant un freeware ( ou plus exactement un " carte postale ware ", voir la rubrique ENREGISTREMENT} je n'aurai pas à passer un temps considérable à en assurer la maintenance et le support technique simplement pour une petit revenu complémentaire. Ce qui ne veut pas dire que je vais plus en assurer le support. Utilisateur de BILKLOG5 moi-même, et perfectionniste par nature, je continuerai à améliorer le programme et à aider tous ses utilisateurs. Une autre raison de sa diffusion en freeware est relative aux mauvaises expériences passées avec des programmes en shareware pour PC ou pour PSION pour lesquels après que j'ai payé la licence, les auteurs ont cessé d'en assurer le soutien, l'ont transformé en freeware ou ont continué à faire payer les mises à jour contrairement à leurs promesses originelles... INSTALLATION ============ Ci dessous vous trouverez la liste des fichiers fournis dans le fichier ZIP de distribution (fichier biklg532.ZIP) ainsi que les répertoires dans lesquels il faut les placer à l'issue de l'installation. biklog5.sis fichier d'installation SIS Biklog5_lisezmoi.txt présent fichier editor.ZIP Fichier d'installation de l'éditeur Symbian sous forme SIS zippée Biklog5_readme.txt ce fichier en anglais Biklog5_leesmij.txt ce fichier en hollandais Biklog5_liesmich txt ce fichier en allemand Si vous utilisez Psiwin 2.x avec Windows, cliquez simplement sur le fichier biklog5.sis. Le programme sera visible après installation dans la barre des "extras". Vous pouvez également copier le fichier BIKLOG5.SIS sur votre machine EPOC et taper deux fois sur son icône. Si vous installez à partir d'autre chose que Windows vous devez vous procurer INS_TE.EXE et l'installer sur votre machine EPOC32. Ceci permettra a votre machine EPOC32 de décoder les fichiers SIS. Si vous n'avez pas installé l'éditeur de texte Symbian sur votre machine et voulez utiliser la nouvelle fonction journal de Biklog5, vous avez aussi le fichier d'installation de l'éditeur : editor.sis inclus dans le fichier editor.zip A l'issue de l'installation vous devriez avoir sur votre machine les fichiers suivants : * = C ou D *:\system\app\biklog5\biklog5.APP fichier principal de l'application. *:\system\app\biklog5\biklog5.AIF fichier principal de l'application. *:\system\app\biklog5\biklog5.MBM fichier graphiques *:\system\app\biklog5\biklog5.HLP fichier aide BIKLOG. *:\system\app\biklog5\biklog5.rsc fichier des ressources BIKLOG c:\system\app\biklog5\biklog.ini fichier de configuration par défaut c:\system\app\biklog5\biklog5.ini fichier ini avec dernier nom de fichier utilisé c:\biklog\example base de données exemple c:\system\app\biklog5\example.ini exemple de fichier de configuration c:\system\app\biklog5\example_d.txt example fichier de journal *:\system\opm\ini.opm fichier support *:\system\opm\iqgrid.opm fichier support *:\system\app\biklog5\efm.mbm fichier support graphiques *:\system\opx\gprinter.opx fichier de support OPX pour impression *:\system\opx\nmpd.rsc fichier de support RSC pour NMPD module *:\system\opl\nmpd.oxh fichier de support OHX pour NMPD module *:\system\opl\nmpdconstants.oxh fichier de support OHX pour NMPD module *:\system\opm\readwrite.opm fichier de support OPM pour READWRITE module A l'exception des fichiers *.ini files, tous les autres fichiers peuvent se trouver sur les disques C ou D. Les fichiers de données peuvent se trouver dans n'importe quel (sous) répertoire, (depuis la version V2.2). Il est recommandé de mettre le fichier base de données dans le répertoire "*:\biklog\ ". MiSE A JOUR DEPUIS LES VERSIONS PRECEDENTES =========================================== Cette option met à jour les fichiers des bases de données existantes, générées avec des versions précédentes de Biklog5 et les transforme au format de bases de données utilisées dans la version V3.0. Cette transformation ajoute 7 nouveaux champs dans la base de données ainsi que de nouveaux champs dans le fichier INI correspondant. Après quoi l'utilisateur pourra ajouter des valeurs dans les nouveaux champs grâce à la fonction d'édition. Pour les nouveaux enregistrements l'utilisateur pourra renseigner directement les champs supplémentaires. Cependant il n'est pas nécessaire de mettre à jour le fichier de base de données ancienne si l'on ne souhaite pas utiliser les champs supplémentaires. Un fichier de sauvegarde avec extension .bak sera créé dans le répertoire original. UTILISATION =========== La plupart des informations nécessaires à l'utilisation de BIKLOG5 se trouvent sur l'aide en ligne. Ci dessous vous trouverez une description succincte des raccourcis clavier. Ctrl-O - Toujours nécessaire sauf pour la création d'un nouveau fichier. Entrez le nom du fichier ou utiliser TAB ou le curseur pour passer d'un fichier à l'autre. Ctrl-N - Après avoir entré le nom et la localisation du nouveau fichier il vous sera demandé de rentrer le nom des vélos que vous utilisez (jusqu'à 4) ainsi que le type de sorties que vous souhaitez effectuer ( comme entraînement, course, club). Possibilité de 5 définitions maximum. L'utilisateur peut également renseigner les noms et les unités de 4 champs de données supplémentaires définis par l'utilisateur et un champ logique du type (oui/Non ou On/Off) ainsi que jusqu'à 6 conditions différentes dans des champs conditionnels (par ex pour caractériser les conditions météo ou du terrain). Ces valeurs peuvent être définies dans l'option préférence. Ctrl-C . - Nécessaire seulement pour anuller le fichier courant. Shft-Ctrl-D Shft-Ctrl-S - Trie les enregistrements par ordre croissant de date. Si le champ heure de début a été sélectionné dans les préférences l'heure de début sera utilisé comme deuxième champ de tri L'option de production de courbes suppose que les enregistrements sont triés par dates! Si la courbe est bizarre, effectuez un tri. Shft+Ctrl+Y exporte la base de données en fichier texte. -On peut choisir deux formats différents: (1) Utiliser le format EPOC pour les champs date et heure de départ, ou (2) Date et heure de départ en valeur littérales (15/10/2002,7 :45 ou 7.75) La deuxième solution est recommandée si vous souhaitez importer les données dans d'autres programmes tels que feuilles ou base de données pour une analyse plus poussée. La première option convient mieux si vous souhaitez importer les données après modification dans une (nouvelle) base biklog. Le format de date EPOC est le nombre de jour après le 1-1-1900 et le temps EPOC est le nombre de secondes après minuit. Les champs sont séparés par un signe de séparation au choix de l'utilisateur (, ; ou tab) Shft Ctrl-I importe un fichier texte vers un fichier de données BIKLOG5. L'utilisateur peut créer un nouvelle base de données ou peut fusionner les données avec celles d'un fichier existant. Le fichier à entrer doit être un fichier texte avec des champs séparés par un signe de séparation défini par l´utilisateur dans l'un des deux formats définis pour 'l'option exportation Ctrl-E Ctrl-A - Entrez ici la date, le nom du vélo, le type de sortie, la distance le temps ou la vitesse moyenne et une courte description de la sortie (max. 40 caractères). Par défaut apparaîtront la date courante et les valeurs du dernier enregistrement. Vous pouvez choisir de rentrer le temps ou la vitesse moyenne. Un seul suffit Si on le choisit dans les préférences l'utilisateur peut également définir : (1) l'heure de départ (2) le contenu de 4 champs supplémentaires (à définir dans les préférences) (3) un champ logique (oui/non) (à définir dans les préférences) (4) un des 6 choix du champ conditionnel (à définir dans les préférences) (5) un texte pouvant comporter jusqu'à 255 caractères à inclure dans un fichier journal Shft-Ctrl-A - modifie un enregistrement L'utilisateur pourra par la suite modifier une saisie Shft-Ctrl-E - efface un enregistrement Ctrl-F - trouves une chaîne de caractères dans les enregistrements. - Utilisez cette option pour retrouver un ou plusieurs enregistrements contenant une chaîne de charactère dans la rubrique memo. Ctrl-t - Visualise une liste de toutes les sorties présentes dans la base de données, répondant aux critères définis après être rentré dans ce mode (période et type de vélo/sortie/condition/champ logique). Les enregistrements trouvés apparaîtront ligne par ligne. Utilisez les touches flèches Haut ou Bas et Page Haut ou Page Bas pour vous déplacer vers le haut ou le bas de la liste. Home ou Fin vous amèneront vers le premier ou dernier enregistrement EXIT vous permettra de sortir de ce mode et " s " vous donnera accès aux statistiques enregistrement. Et " n " vous donnera accès aux toutes les données de la sortie dans une fenêtre séparée associés à cet enregistrement. L'appui sur n'importe quelle autre touche présentera une liste des actions possibles. Ctrl-G - Trace jusqu'à 10 points différents graphiques par vélo ou type de sortie - Il vous sera demandé d'entrer les dates de début et de fin de la période, ainsi que l'unité de temps de l'axe des x jour, semaine, ou mois). Des filtres supplémentaires sont possibles en fonction des conditions et du champ logique défini. Par défaut tous les enregistrements sont inclus Par défaut la date de début sera le 1 Janvier de l'année du premier enregistrement, et la date de fin celle de la date du jour. Pour les bases de données débutant dans les années précédentes, la date de départ sera soit la date de départ du fichier ou la date du dernier enregistrement moins 400 jours pour des raisons de mémoire interne) La courbe représentant les distances cumulées sera présentée pour chacun des vélos de la base de données (avec plus de 0 km) ainsi que pour la somme de tous les vélos. Utilisez les touches haut bas pour passer d'une courbe à l'autre ESC vous raménera au menu. Toutes les autres touches présentent une liste des actions possibles. Shft-Ctrl-G le graphique selon les options d'impression standard du Psion. - Cette option ne sera fonctionnelle qu'après avoir tracé les courbes. Ctrl-s - Description des statistiques sur les sorties. - Huit tableaux présentent quelques statistiques générales: Nombre de sorties, distances moyennes et cumulées ainsi que la durée et la vitesse moyenne pour chaque vélo et type de sortie de la base de données, en valeur absolue et en pourcentage du total. Le tableau suivant présente également la distance totale mensuelle par vélo. Le dernier tableau montre les statistiques des sorties (plus longue, Plus courte, plus rapide et plus lente). De plus quelques informations sur l'avancement par rapport au but fixé pour l'année sont présentées. Les filters que l'on peut appliquer sont : la période, le type de vélo, les conditions logiques et de type. Pour ces deux derniers paramètres, il est également possible de sélectionner toutes les conditions (oui +non). Cette dernière option est l'option par défaut. Shft-Ctrl-T utilisant les réglages standard du Psion. Possible uniquement si la fonction statistique a été demandée. Ctrl-d Utiliser léditeur Symbian pour modifier le contenu du fichier journal. Sht-Ctrl-F Prévisions Calcule le nombre attendu de sorties et la distance totale pour une date définie par l'utilisateur. Ctrl-K - Utilisez cette option pour définir les noms des vélos, les définition des sorties, les unités de mesure (Kms ou Miles) et les objectifs en terme de nombre de kilomètres ou miles et nombre de sorties dans l'année. Un message préviendra lorsque chacun des objectifs sera atteint. De plus, en fonction de la version de la base de données en cours, les noms et unités des champs paramétrables, le nom du champ logique conditionnel et les six définitions du champ " conditionnel " peuvent être définis. Sous la page " Miscellaneous " l'utilisateur peut définir la visibilité de l'heure de départ, des champs paramétrables et du champ logique conditionnel. Ctrl-U à partir d'une version ancienne. - Cette option permet de convertir une base de données existante au nouveau format de base de données étendu dans lequel 7 nouveaux champs sont ajoutés à chaque enregistrement. Un fichier de sauvegarde reconnaissable par son extension "bak" sera créé dans le répertoire d'origine. Ctrl-B bascule la barre d'outils. Ctrl-I Information sur le programme. Shft-Ctrl-H Fonction aide Pas dans le menu : Ctrl-h Change les définitions des entêtes et pied de page dans le résultat de la recherche.. De plus l'option d'impression des tableaux vous permet d'avoir accès au mode normal d'impression des tableaux du Psion. Notez bien qu'il faut avoir fait appel aux modes Tableau, graphique ou statistique pour être capable d'imprimer les données sous la forme correspondante.. Je recommande d'utiliser l'aide en ligne, au moins jusqu'à ce que vous deveniez à l 'aise avec le programme BIKLOG5. Améliorations à venir ===================== -- Option d'importation -- Pluri linguisme -- Extension de la base de données avec davantage de rubriques paramétrables -- Adaptation pour les triatlètes (déjà possible sous forme rudimentaire en rebaptisant les noms de vélos en "natation" "vélo" et "course" et en donnant aux types de sorties des noms adaptés comme "entraînement", "course" et "fractionné" etc. -- Tout ce que vous, les utilisateurs allez suggérer et dont l'intérêt sera partagé par au moins un autre utilisateur. REMERCIEMENTS ============= Merci à Jezar pour m'avoir fourni le générateur d'aide, à Neil K Bee (neil@bee.net) pour l'utilisation d'une de ses icônes, à Damien Lewis et à Pocket IQ pour l'utilisation de IQGRID, à RMRsoft pour leur programme RMRRSG et à tous les autres programmeurs PSION, spécialement à Steve Litchfield et à Al Richey pour leur programme RMREVENT qui m'ont donné l'exemple de bons programmes. Un merci spécial à Martin Zeddies et à Philippe Bricka, sans l'aide de qui les versions allemande et française n'auraient pu exister. Finalement, et non des moindres, merci aux utilisateurs du programme pour leurs conseils et leur expériences. ENREGISTREMENT ============ POURQUOI S'ENREGISTRER ? Bien que BIKLOG5 soit un freeware, je serai très heureux si vous me faites savoir que vous allez utiliser mon programme. Tout d'abord cela satisfera ma curiosité après toutes ces heures et tout cet effort pour écrire et déboguer le programme. De plus cela m'encouragera à continuer et à l'améliorer si vous m'en exprimez le besoin. Enfin, si vous vous enregistrez chez moi, je pourrai vous tenir informé de la diffusion des versions suivantes de BIKLOG5. COMMENT S'ENREGISTRER ? Envoyez votre nom adresse et/ou Email, de préférence par Email à: Jaap Laméris j.lameris@hccnet.nl Vous pouvez aussi envoyer une carte postale à : Jaap Laméris Richel 10 8303 KX EMMELOORD Netherlands. Precisez dans votre note d'enregistrement la version que vous avez ainsi que votre adresse postale et Email Des renseignements complémentaires sur BIKLOG5 seront aussi disponibles sur ma page personnelle: http://home.hccnet.nl/j.lameris/mypsion.htm DECHARGE ========== L'utilisation de ce logiciel se fait à vos propres risques. Je ne puis en aucune façon être tenu pour responsable de pertes de données ou de dommages aux personnes ou aux matériels survenus suite son utilisation. COPYRIGHT ET CONDITIONS ======================== Je me réserve le copyright de ce logiciel, toute reproduction en partie ou en totalité est strictement interdite. De plus, la traduction inverse de tout fichier contenu dans le fichier "BIKLG532.ZIP" est Strictement interdite. Vous pouvez distribuer le fichier "BIKLG532.ZIP", autant que vous le souhaitez, à condition de ne le modifier en aucune façon et qu'il soit transmis sous sa forme originale. COMMENTAIRES ============ Si vous avez des suggestions ou commentaires, je serai très heureux que vous m'en fassiez part.! Vous pouvez m'écrire à l'adresse ci dessus ou m'envoyer un E mail à l'une de ces adresses j.lameris@hccnet.nl or lameris-molhoek@hetnet.nl et maintenant à vos vélos!!! HISTORY ======= Version 3.2 (May 15, 2003) -- amélioration mineure pour permettre une pleine utilisation de la couleur pour les possesseurs de Séries7 et netBook. Version 3.1 (March 2003) * base de données étendue avec 7 champs supplémentaires : * 4 champs paramétrables par l'utilisateur * 1 champ logique à définir par l'utilisateur (Oui/Non ou On/Off) * 1 champ conditionnel avec 6 choix à définir par l'utilisateur (pour caractériser les conditions du terrain ou de la météo). * l'heure de départ * l'utilisateur peut bloquer la présence de champs supplémentaires à définir dans les préférences) * système de fichier journalier pour des notes sur les sorties plus importantes (max 255 caractères par sortie)compatible avec les fichiers de données pré version 3.0. * fonctions de prévisions maintenant incluses dans le menu * fonctions d'importation * sortie pour serie 7 /netbook adapté au format d'écran * davantage d'ptions statistiques * tri possible sur les dates et eles heures de départ * filtre étendu sur le tableau les graphiques et les statistiques * petits bogues résolus Version 2.8 (Avril 15, 2002): -- Versions allemande, hollandaise et française -- davantage de statistiques -- ajout d'une option d'exportation -- meilleure structure du menu -- réparation de petits bogues Version 2.7 (12 Decembre, 2001): -- ajout de plusieurs options d'entrées: distance cumulée, distance ou temps total, distance ou temps moyen et vitesse moyenne; -- entrée pour les sorties ou les vélos, -- pour les entrées non cumulatives choix de courbes (barres ou camenberts), -- solution de petits bogues à l'ouverture et la fermeture des fichiers Version 2.6 (14 Aout , 2001): -- Entrée des durées des sorties en secondes (hh:mm:ss au lieu de hh:mm). Etendu aux présentations du mode recherche -- résolution de petits bogues (e.g. "le fichier xxxx n'est pas un fichier valide ") -- Définition des derniers objectifs en # of km/mi et # de sorties dans les préférences. -- Possibilité d'imprimer les statistiques -- Résolution de petits bogues du mode impression. Version 2.5 (16 Avril , 2001): --Meilleures possibilités d'impression, sélection automatique du format du papier -- Impression des graphiques. -- possibilité de choisir le nombre de décimales. --suppression de petits bogues -- meilleure protection contre les erreurs de saisies. Version 2.41 (16 Nov , 2000): -- changement mineur du format. Ajout du dernier Sysmal.opx dans le dossier d'installation. Version 2.4 (5 Novembre , 2000): --Mode graphique amélioré avec capacité de Zoom --Compatibilité avec le REVO --Meilleur format d'impression --Dernier enregistrement mis en mémoire. --Statistiques du fichier courant dans l'écran par défaut. Version 2.3 (16 Jan., 2000): La durée des sorties dans les modes recherche et statistiques est exprimée en Format heures minutes. Le fichier données généré par BIKLOG5 est un document BIKLOG5 ce qui veut dire que le fichier données peut être ouvert automatiquement Dans BIKLOG5 en double tapant sur l'icône du fichier données. Un module de mise à jour Est fourni avec BIKLOG5 pour convertir au format BIKLOG5 les données générées Un fichier de sauvegarde avec au format ".bak" est produit. Version 2.2.1 (21 Dec., 1999): Suppression de petits bogues. Possibilité d'utiliser tous les répertoires pour enregistrer votre Base de données. Possibilité d'entrer les temps en heures + minutes Version 2.1 (Nov. '99): Amélioration majeure de la version d'origine. Version 2.0 (Aou. '99), version originale, non publiée au domaine public: Basée sur la version Séries 3 d'origine (Biklog3 V 1.1).