Wiki

Version 161 (Etienne Pallier, 07/02/2015 06:57 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 161 Etienne Pallier
(TODO) 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 153 Etienne Pallier
h3. %{margin-left:30px; font-weight:normal; display:block; background-color:lightgrey; color:black;}1. 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 133 Etienne Pallier
2) Jeudi 2/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 154 Etienne Pallier
h3. %{margin-left:30px; font-weight:normal; display:block; background-color:lightgrey; color:black;}2. NOUVELLE PRESENTATION%
49 103 Etienne Pallier
50 154 Etienne Pallier
(NOUVELLE IHM, NOUVEAU FORMULAIRE, NOUVEAU WORKFLOW)
51 58 Etienne Pallier
52 23 Etienne Pallier
(Note : on change de contexte quand on change la roche, la distance, ou l’atmosphère…)
53 15 Etienne Pallier
54 95 Etienne Pallier
55 13 Etienne Pallier
Le logiciel doit démarrer automatiquement au boot du pc.
56 1 Etienne Pallier
57 135 Etienne Pallier
Il est désormais composé de seulement 2 écrans.
58 135 Etienne Pallier
59 154 Etienne Pallier
h4. 2.1. ECRAN 1 : START
60 95 Etienne Pallier
61 36 Etienne Pallier
Le premier écran *START* doit proposer les 4 choix suivants :
62 95 Etienne Pallier
63 53 Etienne Pallier
*1) Create a brand new context*
64 53 Etienne Pallier
*2) Create a new context from another one*
65 53 Etienne Pallier
*3) Modify a context*
66 53 Etienne Pallier
*4) Delete a context*
67 52 Etienne Pallier
68 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.
69 96 Etienne Pallier
70 125 Etienne Pallier
Dans le cas (4), on demande confirmation avant la suppression ("Do you really want to delete this context ? <OK> <CANCEL>), puis on revient à l'écran START après la suppression. 
71 96 Etienne Pallier
72 1 Etienne Pallier
Dans tous les autres cas (1 à 3), on arrive ensuite à l'écran du formulaire unique "CONTEXT DEFINITION".
73 102 Etienne Pallier
74 102 Etienne Pallier
*Suppression d'un contexte (options 3 et 4)* :
75 102 Etienne Pallier
Afin de faciliter l'interaction avec le logiciel C-Spec-HK, 
76 102 Etienne Pallier
les fichiers de contexte "supprimés" ne doivent pas être physiquement supprimés,
77 102 Etienne Pallier
mais seulement marqués du préfixe "_TO-BE-DELETED_".
78 102 Etienne Pallier
Ces fichiers "supprimés" virtuellement ne doivent plus être visibles dans la liste des contextes affichée par C-GDL.
79 102 Etienne Pallier
Ainsi, C-Spec-HK pourra se rendre compte qu'un contexte (même ancien, dans le passé) a été supprimé,
80 102 Etienne Pallier
et pourra supprimer en conséquence le dossier de contexte associé 
81 102 Etienne Pallier
(suppression virtuelle elle aussi car on préfère ne pas prendre le risque de supprimer un dossier de contexte par erreur...)
82 102 Etienne Pallier
83 154 Etienne Pallier
h4. 2.2. ECRAN 2 : CONTEXT DEFINITION
84 99 Etienne Pallier
85 1 Etienne Pallier
86 154 Etienne Pallier
*2.2.1. Différence de comportement selon l'option choisie (dans l'écran 1)*
87 96 Etienne Pallier
88 142 Etienne Pallier
Dans les 3 premiers cas (options 1 à 3), *une fois que le contexte est sauvegardé (clic sur bouton SAVE), il est FERMÉ* car on ne doit plus pouvoir le modifier, sauf en l'ouvrant à nouveau en modification (option 3). Le bouton "SAVE" devra donc plutôt être nommé *"SAVE CONTEXT (and close)"*.
89 1 Etienne Pallier
90 144 Etienne Pallier
* *1) Create a brand new context (Création d'un tout nouveau contexte) :*
91 47 Etienne Pallier
92 57 Etienne Pallier
 * date = date du jour (*modifiable pour pouvoir créer un contexte dans le passé*)
93 47 Etienne Pallier
 * start time = maintenant (modifiable)
94 47 Etienne Pallier
 * stop time = 23:59 (modifiable)
95 72 Etienne Pallier
 * Autres champs = valeurs par défaut
96 126 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>)"
97 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>",
98 76 Etienne Pallier
et la sauvegarde n'est pas effectuée.
99 1 Etienne Pallier
100 1 Etienne Pallier
* *2) Create a new context from another one (Création d'un nouveau contexte à partir d'un contexte existant) :*
101 1 Etienne Pallier
102 1 Etienne Pallier
 * date = idem (1)
103 1 Etienne Pallier
 * start time = idem (1)
104 1 Etienne Pallier
 * stop time = idem (1)
105 1 Etienne Pallier
 * Autres champs = valeurs du contexte existant
106 1 Etienne Pallier
 * Quand on clique sur le bouton SAVE : idem (1)
107 1 Etienne Pallier
108 1 Etienne Pallier
* *3) Modify a context (Modification d'un contexte existant) :*
109 1 Etienne Pallier
110 1 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...)
111 1 Etienne Pallier
 * start time = heure du contexte existant (modifiable)
112 1 Etienne Pallier
 * stop time = heure du contexte existant (modifiable)
113 1 Etienne Pallier
 * Autres champs = valeurs du contexte existant (idem (2))
114 1 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>"
115 147 Etienne Pallier
116 147 Etienne Pallier
117 147 Etienne Pallier
118 152 Etienne Pallier
119 152 Etienne Pallier
120 152 Etienne Pallier
121 154 Etienne Pallier
*2.2.2. Aspect général du formulaire*
122 147 Etienne Pallier
123 147 Etienne Pallier
Voici une maquette (incomplète mais suffisante) du nouveau formulaire proposée par AC et OG (voir surtout les 2 dernières diapos) : 
124 147 Etienne Pallier
125 147 Etienne Pallier
* Document complet (PPT) : {{thumbnail(CGDL-idees_v3.pptx, size=300, title=Dashboard_Controller)}}
126 147 Etienne Pallier
127 147 Etienne Pallier
* Nouvelle IHM proposée :
128 147 Etienne Pallier
 
129 147 Etienne Pallier
{{thumbnail(Diapositive10.jpg, size=300, title=Nouvelle_IHM)}}
130 147 Etienne Pallier
131 156 Etienne Pallier
* Liste des options pour les champs à liste déroulante : 
132 147 Etienne Pallier
133 147 Etienne Pallier
{{thumbnail(Diapositive11.jpg, size=300, title=Liste_des_champs)}}
134 45 Etienne Pallier
135 1 Etienne Pallier
136 3 Etienne Pallier
137 154 Etienne Pallier
*2.2.3. Description détaillée des champs du formulaire*
138 146 Etienne Pallier
139 152 Etienne Pallier
Afin de faciliter les changements à l'avenir, la *configuration du formulaire* unique (noms des labels, valeurs par défaut, paramètre obligatoire ou facultatif) doit être *écrite dans un fichier texte* (XML, JSON, ...). 
140 152 Etienne Pallier
On pourra nommer ce fichier "SETTINGS" ou "CONFIG"*
141 152 Etienne Pallier
142 152 Etienne Pallier
143 154 Etienne Pallier
*2.2.3.1. Panel OBSERVATION*
144 151 Etienne Pallier
145 111 Etienne Pallier
Au tout début de ce formulaire, on trouve le panel "OBSERVATION", qui contient notamment les 3 champs donnant les date et période de couverture du contexte (pris en compte pour le champ CONTEXT NAME tout en bas) :
146 1 Etienne Pallier
147 112 Etienne Pallier
*Date and time of acquisition:*
148 132 Etienne Pallier
- *[Date]* (format YYYYMMDD)
149 110 Etienne Pallier
- *[Start time]* (format HHMM)
150 110 Etienne Pallier
- *[Stop time]* (format HHMM)
151 1 Etienne Pallier
152 154 Etienne Pallier
*2.2.3.2. Panel CONTEXT NAME*
153 151 Etienne Pallier
154 113 Etienne Pallier
Tout en bas, on a le panel "CONTEXT NAME" (avec le bouton "SAVE CONTEXT (and close)"), qui contient le nom courant du contexte.
155 20 Etienne Pallier
156 110 Etienne Pallier
Ce champ est *READ ONLY* car il est construit automatiquement à partir de la valeur des 3 champs temporels du début, et de tous les champs "bleus" de tous les panels.
157 1 Etienne Pallier
158 108 Etienne Pallier
Voici le format de ce champ : *<YYYYMMDD>_<HHMM>-<HHMM>_CONTEXT_<valeurs-des-champs-bleus>.xml* (ou .json si on fait du JSON à la place du XML, option ouverte)
159 105 Etienne Pallier
avec :
160 15 Etienne Pallier
161 109 Etienne Pallier
* YYYYMMDD : Date du jour (ex, 20050529)
162 1 Etienne Pallier
163 109 Etienne Pallier
* HHMM-HHMM : temps de début puis temps de fin (ex : 0935-1147)
164 1 Etienne Pallier
Par défaut, temps début = maintenant, et temps fin = 2359 (fin de journée)
165 109 Etienne Pallier
166 109 Etienne Pallier
* <valeurs-des-champs-bleus> : concaténation des valeurs de tous les champs bleus de tous les panels
167 1 Etienne Pallier
168 152 Etienne Pallier
(Supprimer la fonctionnalité du 000, 001, 002 à la fin du nom du contexte)
169 113 Etienne Pallier
170 152 Etienne Pallier
171 152 Etienne Pallier
172 154 Etienne Pallier
*2.2.3.3. Validation du formulaire*
173 1 Etienne Pallier
174 1 Etienne Pallier
En mode "Creation from scratch (1)", au début, tous les titres de tous les panels sont ROUGE car non remplis (ils peuvent être verts si les valeurs par défaut sont suffisantes),
175 151 Etienne Pallier
sauf les panels facultatifs tels que "NOTES"... qui sont VERT, et le bouton "SAVE CONTEXT (and close)" est désactivé.
176 136 Etienne Pallier
Le titre d'un panel passe au VERT quand son contenu est suffisemment rempli.
177 136 Etienne Pallier
Quand tous les panels sont VERT, le panel "CONTEXT NAME" passe lui aussi au VERT, et son bouton "SAVE CONTEXT (and close)" devient disponible.
178 136 Etienne Pallier
179 154 Etienne Pallier
*2.2.3.4. Autres remarques*
180 136 Etienne Pallier
181 136 Etienne Pallier
Prévoir un bouton "RESET" permettant de remettre toutes les valeurs par défaut. Ce bouton ne sera présent que dans l'option (1) "Creation of a new Context".
182 136 Etienne Pallier
183 136 Etienne Pallier
Ajouter un *panel "Notebook"* sur lequel on pourra prendre des notes diverses.
184 136 Etienne Pallier
185 136 Etienne Pallier
186 136 Etienne Pallier
187 136 Etienne Pallier
188 113 Etienne Pallier
189 113 Etienne Pallier
190 114 Etienne Pallier
(NB: Dans la version précédente de C-GDL, le contexte n'était pas créé séparément, mais il était ajouté à un fichier CgdlContextList.xml dans le répertoire du programme, trié par date puis par nom de cible)
191 28 Etienne Pallier
192 159 Etienne Pallier
h4. 2.3. AUTRES CHANGEMENTS SUR LE LOGICIEL
193 1 Etienne Pallier
194 160 Etienne Pallier
_*ATTENTION, CETTE SECTION N'EST PAS FORCEMENT TRES A JOUR CAR ELLE PART DE LA PHILO DE L'ANCIEN FORMULAIRE (multi-onglets), mais à consulter quand même*_
195 134 Etienne Pallier
196 119 Etienne Pallier
Outre le nouveau fonctionnement décrit ci-dessus, les *adaptations* suivantes ont été demandées.
197 116 Etienne Pallier
198 123 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.)_
199 3 Etienne Pallier
200 117 Etienne Pallier
*Panel Observation* :
201 3 Etienne Pallier
- Observation type : Cible LIBS par défaut (d'ailleurs, on peut enlever RMI et FOCUS)
202 34 Etienne Pallier
203 117 Etienne Pallier
*Panel Target* :
204 3 Etienne Pallier
Valeurs par défaut :
205 3 Etienne Pallier
- granulo : unknown
206 3 Etienne Pallier
- rough : unknown
207 3 Etienne Pallier
- size : 1-5 cm
208 3 Etienne Pallier
- albedo : remplacer 0 par unknown
209 3 Etienne Pallier
- origin : ajouter PELLET
210 3 Etienne Pallier
- composition : unknown
211 34 Etienne Pallier
212 117 Etienne Pallier
*Panel Environment* :
213 34 Etienne Pallier
- Atmosphere (en bleu car pris en compte pour le nom du contexte) : Mars par défaut
214 3 Etienne Pallier
- pressure : controlled par défaut
215 34 Etienne Pallier
216 117 Etienne Pallier
*Panel Hardware* :
217 34 Etienne Pallier
Valeurs par défaut :
218 3 Etienne Pallier
- Location (en bleu car pris en compte dans le nom du contexte) : IRAP
219 3 Etienne Pallier
- body unit : + Chemcam EM 2013 (par défaut)
220 34 Etienne Pallier
- Ctrl/cde : LANL/GSE
221 34 Etienne Pallier
- Mast : ChemCam EQM
222 3 Etienne Pallier
- Fiber : ChemCam FM-like
223 34 Etienne Pallier
224 117 Etienne Pallier
*Panel Distance* :
225 34 Etienne Pallier
- "Distance to target" => "Approximate dist to target"
226 34 Etienne Pallier
- enlever « obtained »
227 3 Etienne Pallier
- "st" => "step"
228 34 Etienne Pallier
229 117 Etienne Pallier
*Panel Miscellaneous* :
230 34 Etienne Pallier
- "Temperature of laser" => "Instrument chamber temperature"
231 3 Etienne Pallier
- "More comments" => "Description", doit contenir le commentaire suivant par défaut :
232 3 Etienne Pallier
"Sample in Martian chamber
233 34 Etienne Pallier
With folding mirror
234 34 Etienne Pallier
Laser in instrument chamber" 
235 34 Etienne Pallier
- Laser pulse : supprimer
236 34 Etienne Pallier
- SOH : yes par défaut
237 3 Etienne Pallier
- Laser freq : 3 Hz par défaut
238 1 Etienne Pallier
- Existing of laser : désactiver