Wiki

Version 100 (Etienne Pallier, 06/26/2015 04:35 pm)

1 1 Etienne Pallier
h1. Wiki
2 1 Etienne Pallier
3 4 Etienne Pallier
4 37 Etienne Pallier
5 37 Etienne Pallier
6 39 Etienne Pallier
*ChemCam Ground Data Log Book*
7 39 Etienne Pallier
8 40 Etienne Pallier
*This is a Java GUI tool to help building an information context to be associated to an observation (a series of ChemCam shots, FOCUS, LIBS, RMI) done in a laboratory*
9 37 Etienne Pallier
10 37 Etienne Pallier
11 6 Etienne Pallier
{{toc}}
12 6 Etienne Pallier
13 6 Etienne Pallier
14 6 Etienne Pallier
---
15 6 Etienne Pallier
16 4 Etienne Pallier
h2. %{margin-left:0px; font-weight:normal; font-size:150;  display:block; background-color:yellow; color:red}INFORMATIONS TECHNIQUES%
17 4 Etienne Pallier
18 41 Etienne Pallier
Ce logiciel est installé sur le Pc Chemcam, en salle blanche : http://planetowiki.irap.omp.eu/do/view/Computers/PcChemcam2Tour
19 41 Etienne Pallier
20 1 Etienne Pallier
OLD web page for this project : http://planetowiki.irap.omp.eu/do/view/Cgdl/WebHome
21 2 Etienne Pallier
22 3 Etienne Pallier
SVN repository : http://planetoweb2.irap.omp.eu/cgdl_svn/trunk
23 3 Etienne Pallier
24 1 Etienne Pallier
25 1 Etienne Pallier
26 1 Etienne Pallier
---
27 6 Etienne Pallier
28 7 Etienne Pallier
h2. %{margin-left:0px; font-weight:normal; font-size:150;  display:block; background-color:yellow; color:red}Collaboration avec l'outil C-SPEC-HK%
29 1 Etienne Pallier
30 4 Etienne Pallier
Suite aux réunions du 29/4/15 et du 22/5/15 avec OG, WR, AC, PM, et EP,
31 42 Etienne Pallier
le nouveau besoin exprimé passe par une collaboration de cet outil avec l'autre outil [[cspechkanalyser:|C-SPEC-HK]].
32 67 Etienne Pallier
Début juin, nous avons eu une réunion avec le prestataire Richard Hitier qui nous a proposé un devis sur 6 jours,
33 67 Etienne Pallier
pour la réalisation d'une nouvelle version impliquant la refonte de l'IHM en un seul formulaire contenant tous les champs.
34 42 Etienne Pallier
35 42 Etienne Pallier
h3. %{margin-left:30px; font-weight:normal; display:block; background-color:lightgrey; color:black;}JALONS DU DEVELOPPEMENT DES NOUVELLES FONCTIONNALITES PAR LE PRESTATAIRE%
36 1 Etienne Pallier
37 43 Etienne Pallier
Le développement doit se faire en Java 8
38 43 Etienne Pallier
39 65 Etienne Pallier
Calendrier prévisionnel (non contractuel) :
40 65 Etienne Pallier
41 42 Etienne Pallier
1) Mercredi 24/6/15 : Livraison de la version existante adaptée pour qu'elle crée un fichier XML unique par contexte
42 42 Etienne Pallier
43 42 Etienne Pallier
2) Mercredi 1/7/15 : Version avec Formulaire unique (au lieu du formulaire multi-onglets actuel)
44 42 Etienne Pallier
A prévoir : Réunion de validation avec l'équipe Chemcam
45 42 Etienne Pallier
46 44 Etienne Pallier
*3) Mercredi 8/7/15 : Livraison de la version finale*
47 8 Etienne Pallier
48 24 Etienne Pallier
h3. %{margin-left:30px; font-weight:normal; display:block; background-color:lightgrey; color:black;}NOUVEAU WORKFLOW%
49 100 Etienne Pallier
(NOUVELLE IHM)
50 58 Etienne Pallier
51 23 Etienne Pallier
(Note : on change de contexte quand on change la roche, la distance, ou l’atmosphère…)
52 15 Etienne Pallier
53 95 Etienne Pallier
54 13 Etienne Pallier
Le logiciel doit démarrer automatiquement au boot du pc.
55 1 Etienne Pallier
56 99 Etienne Pallier
57 95 Etienne Pallier
h4. ECRAN 1 : START
58 95 Etienne Pallier
59 36 Etienne Pallier
Le premier écran *START* doit proposer les 4 choix suivants :
60 95 Etienne Pallier
61 53 Etienne Pallier
*1) Create a brand new context*
62 53 Etienne Pallier
*2) Create a new context from another one*
63 53 Etienne Pallier
*3) Modify a context*
64 53 Etienne Pallier
*4) Delete a context*
65 52 Etienne Pallier
66 96 Etienne Pallier
Dans tous les cas (sauf le 1), une liste de TOUS les contextes existants est affichée (tous les contextes créés, même ceux du passé), parmi lesquels on doit en sélectionner un.
67 96 Etienne Pallier
68 97 Etienne Pallier
Dans le cas (4), on revient ensuite à l'écran START. 
69 96 Etienne Pallier
70 98 Etienne Pallier
Dans tous les autres cas (1 à 3), on arrive ensuite à l'écran du formulaire unique "CONTEXT DEFINITION".
71 1 Etienne Pallier
72 99 Etienne Pallier
h4. ECRAN 2 : CONTEXT DEFINITION
73 99 Etienne Pallier
74 99 Etienne Pallier
Voici une maquette du nouveau formulaire proposée par AC et OG (voir la dernière diapo) : {{thumbnail(CGDL-idees_v3.pptx, size=300, title=Dashboard_Controller)}}
75 96 Etienne Pallier
76 92 Etienne Pallier
*ATTENTION* : Dans les 3 premiers cas (options 1 à 3), *une fois que le contexte est sauvegardé (clic sur bouton SAVE), il est FERMÉ*
77 1 Etienne Pallier
car on ne doit plus pouvoir le modifier, sauf en l'ouvrant à nouveau en modification (option 3).
78 61 Etienne Pallier
Le bouton "SAVE" devra donc plutôt être nommé *"SAVE CONTEXT (and close)"*.
79 54 Etienne Pallier
80 64 Etienne Pallier
*Différences entre les options 1 à 3* :
81 1 Etienne Pallier
82 84 Etienne Pallier
* *(1) Création d'un tout nouveau contexte :*
83 47 Etienne Pallier
84 57 Etienne Pallier
 * date = date du jour (*modifiable pour pouvoir créer un contexte dans le passé*)
85 47 Etienne Pallier
 * start time = maintenant (modifiable)
86 47 Etienne Pallier
 * stop time = 23:59 (modifiable)
87 72 Etienne Pallier
 * Autres champs = valeurs par défaut
88 73 Etienne Pallier
 * Quand on clique sur le bouton SAVE : la confirmation suivante est demandée : "Do you want to save this context with the name <...> ? (ok/cancel)"
89 76 Etienne Pallier
Dans le cas "rare" où on crée un contexte avec un nom qui existe déjà, le message d'avertissement suivant est affiché : ""WARNING : A context already exists with this name <...>. <OK>",
90 76 Etienne Pallier
et la sauvegarde n'est pas effectuée.
91 1 Etienne Pallier
92 84 Etienne Pallier
* *(2) Création d'un nouveau contexte à partir d'un contexte existant :*
93 1 Etienne Pallier
94 79 Etienne Pallier
 * date = idem (1)
95 79 Etienne Pallier
 * start time = idem (1)
96 79 Etienne Pallier
 * stop time = idem (1)
97 1 Etienne Pallier
 * Autres champs = valeurs du contexte existant
98 79 Etienne Pallier
 * Quand on clique sur le bouton SAVE : idem (1)
99 72 Etienne Pallier
100 84 Etienne Pallier
* *(3) Modification d'un contexte existant :*
101 72 Etienne Pallier
102 86 Etienne Pallier
 * date = date du contexte existant (modifiable, bien qu'en théorie, on ne devrait pas l'autoriser, mais ça n'est pas bien grave...)
103 71 Etienne Pallier
 * start time = heure du contexte existant (modifiable)
104 1 Etienne Pallier
 * stop time = heure du contexte existant (modifiable)
105 80 Etienne Pallier
 * Autres champs = valeurs du contexte existant (idem (2))
106 83 Etienne Pallier
 * Quand on clique sur le bouton SAVE : on doit normalement supprimer (ou écraser, si le nom n'a pas changé) le contexte sélectionné au départ. Quand l'utilisateur clique sur le bouton "SAVE", on demande confirmation : "Do you want to update this context (with the name <...>) ? <OK> <CANCEL>"
107 45 Etienne Pallier
108 64 Etienne Pallier
*Suppression d'un contexte (options 3 et 4)* :
109 63 Etienne Pallier
Afin de faciliter l'interaction avec le logiciel C-Spec-HK, 
110 63 Etienne Pallier
les fichiers de contexte "supprimés" ne doivent pas être physiquement supprimés,
111 63 Etienne Pallier
mais seulement marqués du préfixe "_TO-BE-DELETED_".
112 63 Etienne Pallier
Ces fichiers "supprimés" virtuellement ne doivent plus être visibles dans la liste des contextes affichée par C-GDL.
113 63 Etienne Pallier
Ainsi, C-Spec-HK pourra se rendre compte qu'un contexte (même ancien, dans le passé) a été supprimé,
114 1 Etienne Pallier
et pourra supprimer en conséquence le dossier de contexte associé 
115 67 Etienne Pallier
(suppression virtuelle elle aussi car on préfère ne pas prendre le risque de supprimer un dossier de contexte par erreur...)
116 1 Etienne Pallier
117 3 Etienne Pallier
118 1 Etienne Pallier
119 94 Etienne Pallier
Ce formulaire contient tout en bas un champ général (avec le bouton "SAVE CONTEXT (and close)") :
120 94 Etienne Pallier
121 1 Etienne Pallier
- *[CONTEXT NAME]*
122 20 Etienne Pallier
123 94 Etienne Pallier
Ce champ est *READ ONLY* car il est construit automatiquement à partir de la valeur de tous les champs "bleus" de tous les panels (au début, avec des valeurs par défaut)
124 1 Etienne Pallier
125 61 Etienne Pallier
Voici le format de ce champ, YYYYMMDD_HHMM-HHMM_context_<valeurs-des-champs-bleus>, avec :
126 15 Etienne Pallier
127 25 Etienne Pallier
* YYYYMMDD : Date du jour (ex, 20050529)
128 15 Etienne Pallier
129 27 Etienne Pallier
* HHMM-HHMM : temps de début puis temps de fin (ex : 0935-1147)
130 27 Etienne Pallier
Par défaut, temps début = maintenant, et temps fin = 2359 (fin de journée)
131 1 Etienne Pallier
132 1 Etienne Pallier
* <valeurs-des-champs-bleus> : concaténation des valeurs de tous les champs bleus de tous les onglets
133 1 Etienne Pallier
134 1 Etienne Pallier
(Le fichier contexte résultant portera ce nom avec l'extension ".xml", une fois la sauvegarde faite)
135 26 Etienne Pallier
136 26 Etienne Pallier
137 1 Etienne Pallier
Les 2 champs suivants permettent éventuellement de modifier les valeurs par défaut du temps début et temps fin (format HHMM) :
138 18 Etienne Pallier
139 61 Etienne Pallier
- *[Start time]* 
140 61 Etienne Pallier
- *[Stop time]*
141 1 Etienne Pallier
142 28 Etienne Pallier
Après avoir rempli les autres champs de cet écran "Observation", on passe à l'écran suivant ("Target") en cliquant sur le bouton "Next" (sauf si les valeurs remplies ne sont pas correctes), 
143 28 Etienne Pallier
et ainsi de suite, jusqu'au dernier écran "END".
144 28 Etienne Pallier
145 28 Etienne Pallier
L'écran "END" permet d'enregistrer le contexte (à condition que tous les onglets soient valides, et donc au vert) avec un bouton "SAVE CONTEXT"
146 31 Etienne Pallier
Le contexte est ainsi sauvegardé dans un fichier individuel (pas dans un fichier global de tous les contextes)
147 31 Etienne Pallier
(Actuellement, ce fichier n'est pas créé séparément, il est ajouté à un fichier CgdlContextList.xml dans le répertoire du programme, trié par date puis par nom de cible)
148 34 Etienne Pallier
149 28 Etienne Pallier
h3. %{margin-left:30px; font-weight:normal; display:block; background-color:lightgrey; color:black;}AUTRES CHANGEMENTS SUR LE LOGICIEL%
150 1 Etienne Pallier
151 1 Etienne Pallier
Outre le nouveau fonctionnement (workflow) décrit ci-dessus, les *adaptations* suivantes ont été demandées.
152 1 Etienne Pallier
153 1 Etienne Pallier
Supprimer la fonctionnalité du 000, 001, 002 à la fin du nom du contexte
154 30 Etienne Pallier
155 34 Etienne Pallier
Le bouton "Reset it" ne doit pas faire un "Next" après le reset (on peut d'ailleurs appeler ce bouton "Reset" tout simplement). Il remet les valeurs par défaut dans tous les champs de l'écran.
156 1 Etienne Pallier
157 34 Etienne Pallier
Le contenu des écrans (nom des paramètres, paramètre obligatoire ou facultatif, paramètre pris en compte pour le nom du contexte ou pas, type, valeur par défaut...) 
158 34 Etienne Pallier
doit être écrit dans un fichier texte (XML, JSON, ...) afin de faciliter les changements à l'avenir. On pourra nommer ce fichier "SETTINGS" ou "CONFIG"
159 34 Etienne Pallier
160 1 Etienne Pallier
Ajouter un écran (onglet) "Notebook" sur lequel on pourra prendre des notes diverses (juste avant l'écran "END")
161 1 Etienne Pallier
162 34 Etienne Pallier
163 3 Etienne Pallier
*Ecran Observation* :
164 34 Etienne Pallier
- Observation type : Cible LIBS par défaut (d'ailleurs, on peut enlever RMI et FOCUS)
165 3 Etienne Pallier
166 34 Etienne Pallier
*Ecran Target* :
167 34 Etienne Pallier
Valeurs par défaut :
168 3 Etienne Pallier
- granulo : unknown
169 3 Etienne Pallier
- rough : unknown
170 3 Etienne Pallier
- size : 1-5 cm
171 3 Etienne Pallier
- albedo : remplacer 0 par unknown
172 3 Etienne Pallier
- origin : ajouter PELLET
173 3 Etienne Pallier
- composition : unknown
174 3 Etienne Pallier
175 34 Etienne Pallier
*Ecran Environment* :
176 34 Etienne Pallier
- Atmosphere (en bleu car pris en compte pour le nom du contexte) : Mars par défaut
177 34 Etienne Pallier
- pressure : controlled par défaut
178 3 Etienne Pallier
179 34 Etienne Pallier
*Ecran Hardware* :
180 34 Etienne Pallier
Valeurs par défaut :
181 34 Etienne Pallier
- Location (en bleu car pris en compte dans le nom du contexte) : IRAP
182 3 Etienne Pallier
- body unit : + Chemcam EM 2013 (par défaut)
183 3 Etienne Pallier
- Ctrl/cde : LANL/GSE
184 34 Etienne Pallier
- Mast : ChemCam EQM
185 34 Etienne Pallier
- Fiber : ChemCam FM-like
186 3 Etienne Pallier
187 34 Etienne Pallier
*Ecran Distance* :
188 34 Etienne Pallier
- "Distance to target" => "Approximate dist to target"
189 34 Etienne Pallier
- enlever « obtained »
190 34 Etienne Pallier
- "st" => "step"
191 3 Etienne Pallier
192 34 Etienne Pallier
*Ecran Miscellaneous* :
193 34 Etienne Pallier
- "Temperature of laser" => "Instrument chamber temperature"
194 34 Etienne Pallier
- "More comments" => "Description", doit contenir le commentaire suivant par défaut :
195 3 Etienne Pallier
"Sample in Martian chamber
196 3 Etienne Pallier
With folding mirror
197 34 Etienne Pallier
Laser in instrument chamber" 
198 34 Etienne Pallier
- Laser pulse : supprimer
199 34 Etienne Pallier
- SOH : yes par défaut
200 34 Etienne Pallier
- Laser freq : 3 Hz par défaut
201 3 Etienne Pallier
- Existing of laser : désactiver
202 1 Etienne Pallier
203 34 Etienne Pallier
*Ecran END* :
204 34 Etienne Pallier
- ajouter un bouton "RESET ALL" qui remet TOUS les écrans à leurs valeurs par défaut (déclenche une action reset sur chaque écran)