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 |