Logo CalcAlCalcAl utilisation



Lancement de CalcAl

Comme indiqué dans la partie installation : sous Windows ou Mac, double-cliquez sur l'icône de l'application, sous Linux sur le script Calcal.sh.
Attention, sous Mac, l'application démarre parfois en icone (nouveauté depuis Python 3.7).

La page de bienvenue de CalcAl apparait.
Page de bienvenue
Pour le fonctionnement en réseau, voir le chapitre concerné du manuel de maintenance.

Fenêtre à propos

L'option A propos... du menu ? ou un clic sur les bandeaux en haut des fenêtres, vous affichez la fenetre suivante :

La fenetre A Propos
Vous y trouverez des informations concernant le CalcAl, votre système, les adresses mail et photos des concepteurs.

Documentation

La documentation du projet est accessible par le menu ? et son option Documentation de l'interface graphique.
Accès à la doc dans l'IHM
Un onglet s'ouvre alors dans votre navigateur Internet actuel.


Import des bases de données

Par défaut, vous ne disposez que d'une base de données de démonstration appelée "demo". Cette base ne contient que les aliments moyens issus de la base Ciqual 2017.

Pour disposer de données plus récentes et plus nombreuses, importez une base de l'ANSES et/ou de l'USDA.

Cliquez sur Le bouton nouvelle :
Bouton nouvelle base
La fenêtre d'import apparait :
Fenetre nouvelle base
Pour importer la base Ciqual 2017 :
Entrer le nom de votre base, par exemple : Ciqual 2017
Choisissez le Type de base : Ciqual_2017
Cliquez sur le bouton Copier le lien WEB dans le presse-papier
Une fenêtre apparait et vous donne des consignes pour télécharger la base depuis le site de l'ANSES avec votre navigateur WEB :
Popup conseils Ciqual
Télécharger la base comme indiqué avec votre navigateur Internet à l'URL :
https://ciqual.anses.fr/#/cms/telechargement/node/20 :

Ciqual_web_site

Téléchargez le données brutes sous le nom proposé : TableCiqual2017_ExcelFR_2017 11 17.xls

Dans CalcAl, cliquez sur le bouton Fichier pour init de la base (1) pour sélectionner le fichier que vous venez de télécharger, le nom du fichier choisis s'affiche (2) :
Fenetre Init base ok
Cliquez sur le bouton OK (3).

La base apparait alors dans la liste des bases disponibles :
Base Ciqual disponible

Répéter les étapes suivantes pour la base USDA.

Fusion de bases

La fusion de base permet d'ajouter à une base de référence les aliments contenus dans une 2ème base.
Les aliment de la base de référence sont prioritaires sauf en cas de mise à jour explicite.

Importez deux bases et sélectionnez la base de référence et cliquez sur Fusionner :
Fusion de 2 bases
Complétez la fenêtre de fusion et validez :
Définition fusion basesfenetre bases fusionnées
Le bouton Info résume le contenu de la base :
Info_database_fr.png



Utiliser l'onglet calculateur

Dans l'onglet Bienvenue, choisissez la base à utiliser (1) et cliquez le bouton Démarrer (2) :
De la fenetre Bienvenue à la fenètre Calculateur

L'onglet Calculateur apparait :
Onglet calculateur

Le cadre Recherche d'aliment vous permet de trouver facilement des aliments si vous tapez dans la boîte d'entrée Nom :

L'onglet recherche d'aliment
Tous les aliments contenant sou dans leur nom sont affichés.

En cas de recherche infructueuse, le bouton + élargit la recherche.

Cliquez sur un aliment pour l'envoyer dans le Cadre de Définition d'un aliment :
Selection d'un aliment
Remplissez la Quantité en g (1) et appuyez sur Entrée ou sur la flèche verte (2). L'alimant apparait dans la liste (3) :

Mettre l'aliment dans la liste
Vous pouvez sélectionner un ou plusieurs composants (Clic + Shift ou Control) :
Choix des composants à suivre
Selectionnez d'autres aliments :
deux aliments dans le calculateur
Les entêtes du tableau sont des boutons permettant : pour a première Nom sert à sélectionner tout le tableau, les autres servent à trier les lignes selon les valeurs des colonnes.

Le tableau des énergies indique leur répartition par composant :
Table des énergies

Créer un groupe d'aliment

Dans l'onglet Calculateur, créez une liste d'aliments et sélectionnez les lignes correspondant à celle de votre recette (1).
Cliquez sur le bouton grouper... (2) ou le menu Sélection / Grouper :
Liste d'aliment à grouper
Dans la fenêtre Sauvegarder ce groupe d'aliments, dénissez une famille existante ou non. Toutes les zones sont actives. Donner un nom au groupe, puis cliquez sur le bouton OK :
Fenêtre sauver un groupe
Ce nouvel aliment utilisateur est sauvé, il remplace ses constituants dans la liste et peut se trouver facilement dans les boîtes de recherche et de définition.
Legroupe créé
Vous pouvez à tous moments rappeler, dégrouper ou avoir des infos sur un groupe que vous avez créé comme pour les autres aliments :
Info sur un groupe

Rechercher les aliments selon des critères

Vous devez d'abord avoir choisi une base de données active.
L'onglet Recherche vous permet de sélectionner des aliments selon des filtres sur leurs composants :
Fenêtre de recherche
Vous pouvez trier une colonne en cliquant sur son entête.

Définir une pathologie

Vous devez d'abord avoir choisi une base de données active.
L'onglet Pathologies, vous permet de définir ou modifier les pathologies qui peuvent affecter les patients et de définir des composants à suivre pour chaque affection.
Fenêtre pathologies

Définir les données pour un patient

Vous devez d'abord avoir choisi une base de données active.
L'onglet Patients, vous permet de définir ou modifier les données de suivi pour vos patients.
Fenêtre Patients

Sauver une ration ou un ingestat

Déninissez dans l'onglet Calculateur, la liste des aliments composant cette ration ou cet ingestat.
Sauver la ration dans l'onglet calculateur
Et cliquez sur le bouton Sauver la ration... ou choisissez le menu Selection/Sauver la ration...
La fenêtre de définition de ration ou d'ingestat apparait, vous renseignez les champs et vous sauvez.
Popup de définition de ration
A tout moment l'onglet Rations et ingestats vous permet de les gérer, et de les afficher à nouveau dans l'onglet Calculateur.

Exporter des données

Dans plusieurs endroits de CalcAl vous pouvez copier des données dans le Presse-papier avec le menu Selection/Presse-papier ou des boutons Presse_papier.
Copie des données dans le presse-papier
Les données sont prêtes à être collées dans un fichier texte ou dans un tableur par exemple. Elles sont au format CSV :
Après copie dans un éditeur de texte et sauvegarde dans test.csv :
Contenu du presse papier
Après ouverture de ce fichier test.csv dans OpenOffice/Calc :
Donnéees importer dans OpenOffice Calc

Localisation de vos données et des messages de l'application

Vos données sont stokées dans votre répertoire utilisateur dans le sous-dossier CalcAl_data :
Données utilisateur
Extrait d'un fichier de log :
2017-01-22 18:20:12,605 :: INFO :: Démarrage CalcAl.py : CalcAl - version 0.48 du 14/1/2017
2017-01-22 18:20:12,610 :: INFO :: Merci à vous thierry d'utiliser ce logiciel !
2017-01-22 18:20:12,610 :: INFO :: Pour contacter les auteurs : Thierry.Maillard500@orange.fr, Perrine.Maillard2@gmail.com
2017-01-22 18:20:12,610 :: INFO :: Sur : Darwin, 16.3.0, Python : 3.5.1, Tk : 8.5
2017-01-22 18:20:12,610 :: INFO :: Langue et encodage détectés sur cet ordinateur = ('fr_FR', 'UTF-8')
2017-01-22 18:20:13,635 :: INFO :: Démarrage de l'IHM...
2017-01-22 18:20:13,870 :: INFO :: Onglet Bienvenue activé.
2017-01-22 18:22:05,239 :: INFO :: c16.db choisie
2017-01-22 18:22:07,041 :: INFO :: c16.db choisie
2017-01-22 18:22:09,482 :: INFO :: demo.db choisie
2017-01-22 18:22:10,826 :: INFO :: c16.db choisie
2017-01-22 18:22:14,955 :: INFO :: DatabaseManager/deleteDatabase() : database deleted : c16.db
2017-01-22 18:22:14,956 :: INFO :: Base de données : c16.db détruite


Licences des bases de données

Base Ciqual

Lorsque vous utilisez les données de la base Ciqual, vous devez mentionner dans vos rapports et documents :

Les données et les informations présentes sont mises à disposition du public par l'Agence nationale de sécurité sanitaire de l'alimentation, de l'environnement et du travail (Anses). Elles ne peuvent être reproduites de quelque manière que ce soit sans référence explicite à la source :
"Table de composition nutritionnelle des aliments Ciqual (année mentionnée sur le bandeau du site internet au moment de la consultation)" .


Base USDA

US Department of Agriculture, Agricultural, Research Service, Nutrient Data Laboratory.
USDA National Nutrient Database for Standard Reference, Release 28 (Slightly revised).
Version Current:  May 2016.  Internet:  http://www.ars.usda.gov/ba/bhnrc/ndl




Chapitre précédent : Installation - Chapitre suivant : Maintenance


Copyleft (c) 2018 -  Perrine et Thierry Maillard
Vous avez la permission de copier, distribuer ou modifier ce document selon les termes de la licence GNU de documentation libre, dans sa version 1.3 ou dans toute version ultérieure publiée par la Free Software Foundation ; sans Section Invariante, sans Texte De Première De Couverture, et sansTexte De Quatrième De Couverture.
Une copie de cette licence est incluse dans la section intitulée "Licence GNU de documentation libre" : GNU Free Documentation License.
Une copie de cette Licence est incluse dans le fichier gfdl.1.3-js.fr.html