Leginon System version 1 6 » History » Version 2
Amber Herold, 04/14/2010 03:25 PM
1 | 1 | Amber Herold | h1. Leginon System version 1.6 |
---|---|---|---|
2 | |||
3 | 2 | Amber Herold | # [[pyScope Change]] |
4 | # [[New User Features]] |
||
5 | # [[Updated Applications (All)]] |
||
6 | # [[New Project Web Tool Features]] |
||
7 | # [[New dbemtool Web Tool Features (1.5.1)]] |
||
8 | # [[Bug Fixes]] |
||
9 | # [[Recommended Application Preference Changes when updated from version 1.5]] |
||
10 | # [[Known Bugs]] |
||
11 | 1 | Amber Herold | |
12 | Version 1.6 contains enhancement that is not available in version 1.5 and release of a |
||
13 | series of Robot Screening application. Most significant changes are the split of Drift Manager |
||
14 | functions to Transform Manager which handles the transformation of targets using any level of |
||
15 | ancestry rather than one in the original Drift Manager. This allows an expansion of method that |
||
16 | is meant to improve targeting accuracy. There are also significant improvement in Tomography |
||
17 | node and its operation. |
||
18 | |||
19 | |||
20 | |||
21 | h2. pyScope Change |
||
22 | |||
23 | |||
24 | |||
25 | With increasing number of instrument conflict, a configuration file is now required to |
||
26 | specify the instrument available on a host. |
||
27 | |||
28 | |||
29 | |||
30 | |||
31 | |||
32 | h2. New User Features |
||
33 | |||
34 | |||
35 | |||
36 | |||
37 | h2. General |
||
38 | |||
39 | |||
40 | |||
41 | |||
42 | |||
43 | * The settings window gui can all fit in 12" laptop display now |
||
44 | |||
45 | |||
46 | |||
47 | |||
48 | |||
49 | |||
50 | |||
51 | |||
52 | |||
53 | h2. Acquisition/Navigator Class |
||
54 | |||
55 | |||
56 | The following applies to an acquisition node that uses the navigator to move to its |
||
57 | target: |
||
58 | * Based on a threshold, Targets can either be aborted or forced to collect when the |
||
59 | multiple move failed to reduce further before reaching the goal. |
||
60 | |||
61 | |||
62 | * It is possible to improve the targeting accuracy with a combination of stage |
||
63 | movement and final image shift. However, this requires specific relationship between |
||
64 | the acquiring presets and parent image presets. It works currently only for tomography |
||
65 | and depth-first traversal MSI scheme. |
||
66 | |||
67 | |||
68 | |||
69 | |||
70 | |||
71 | |||
72 | |||
73 | |||
74 | h2. BeamFixer Class (New) |
||
75 | |||
76 | |||
77 | Simple beam shift adjustment to correct unstable beam position in long runs. |
||
78 | |||
79 | |||
80 | |||
81 | |||
82 | |||
83 | h2. BeamTiltImager Class (New) |
||
84 | |||
85 | |||
86 | Visual aid to coma-tilt alignment. It is used to acquire images of beam tilt |
||
87 | difractogram tableau. The user can then click at the location of the tableau where he/she |
||
88 | considers as the coma-free and therefore adjust the beam tilt. See Node Description Chapter |
||
89 | for details. |
||
90 | |||
91 | |||
92 | |||
93 | |||
94 | |||
95 | h2. Corrector Class |
||
96 | |||
97 | |||
98 | |||
99 | |||
100 | |||
101 | * A bad pixel region can be specified by clicking the corners and added to the bad |
||
102 | pixel plan |
||
103 | |||
104 | |||
105 | * Extreme intensity pixels can be found by a click on this tool!http://emg.nysbc.org/software/leginon/images/icons/stagelocations.png! |
||
106 | |||
107 | |||
108 | * Normalization image of the chosen camera configuration can be displayed. |
||
109 | |||
110 | |||
111 | |||
112 | |||
113 | |||
114 | |||
115 | |||
116 | |||
117 | |||
118 | h2. DriftManager Class |
||
119 | |||
120 | |||
121 | |||
122 | |||
123 | |||
124 | * A timeout for drift monitoring can now be specified so that if the drift is |
||
125 | incorrectly detected due to an empty imaging area, the acquisition of the target will |
||
126 | be aborted. |
||
127 | |||
128 | |||
129 | |||
130 | |||
131 | |||
132 | |||
133 | |||
134 | |||
135 | |||
136 | h2. DTFinder Class (New) |
||
137 | |||
138 | |||
139 | Dynamic template finder is developed for tissue section imaging. An initial template is |
||
140 | defined by the user. The subsequent images it receives are then shifted and rotated against |
||
141 | the template to find the best match to the section so that the target selected on the |
||
142 | template can be transferred on to the new image. |
||
143 | |||
144 | |||
145 | |||
146 | |||
147 | |||
148 | h2. FFTMaker Class |
||
149 | |||
150 | |||
151 | |||
152 | |||
153 | |||
154 | * Power Spectrum is displayed if processed. |
||
155 | |||
156 | |||
157 | * Option for calculating power spectrum but not saved to disk. |
||
158 | |||
159 | |||
160 | * Option for calculate a truncated power spectrum to speed up the calculation for |
||
161 | large images. |
||
162 | |||
163 | |||
164 | |||
165 | |||
166 | |||
167 | |||
168 | |||
169 | |||
170 | |||
171 | h2. GridEntry Class (New) |
||
172 | |||
173 | |||
174 | Direct entry of grid information to Leginon database to organize the data acquired. The |
||
175 | main use is for simple one-pass grid screening of multiple grids when the robot does not |
||
176 | exist. |
||
177 | |||
178 | |||
179 | |||
180 | |||
181 | |||
182 | h2. ImageProcessor Class (New) |
||
183 | |||
184 | |||
185 | Base class for process images of a completed image target list. Mainly used for |
||
186 | development of batch processing of the images acquired such as image stack creation of a |
||
187 | tilt series. An example of its use is in filenames.py. |
||
188 | |||
189 | |||
190 | |||
191 | |||
192 | |||
193 | h2. ManualAcquisition Class |
||
194 | |||
195 | |||
196 | |||
197 | |||
198 | |||
199 | * The acquired image can be sent to FFTMaker. |
||
200 | |||
201 | |||
202 | |||
203 | |||
204 | |||
205 | |||
206 | |||
207 | |||
208 | |||
209 | h2. PresetsManager Class |
||
210 | |||
211 | |||
212 | |||
213 | |||
214 | |||
215 | * Preset Beam Ajustment Tool allows easier semi-automated adjustment of multiple |
||
216 | presets at the same magnification. |
||
217 | |||
218 | |||
219 | |||
220 | |||
221 | |||
222 | |||
223 | |||
224 | |||
225 | |||
226 | h2. PixelSizeCalibrator Class |
||
227 | |||
228 | |||
229 | |||
230 | |||
231 | |||
232 | * Power spectrum calculated from acquired image is displayed. |
||
233 | |||
234 | |||
235 | * Distances measured between diffraction spots are used for an user-interactive |
||
236 | pixel size calculation and averaging. |
||
237 | |||
238 | |||
239 | |||
240 | |||
241 | |||
242 | |||
243 | |||
244 | |||
245 | |||
246 | h2. Robot2 Class (Replacing Robot) |
||
247 | |||
248 | |||
249 | This class replaces Robot Class in all applications. It commnunicates to grid handling |
||
250 | robot(s) through database. A few default settings are changed to reflect it and also the |
||
251 | more general usage |
||
252 | * Simulate Robot Insert/extraction = True |
||
253 | |||
254 | |||
255 | * Default Z Position = 0 |
||
256 | |||
257 | |||
258 | |||
259 | |||
260 | |||
261 | |||
262 | |||
263 | |||
264 | h2. TargetFilter Class |
||
265 | |||
266 | |||
267 | |||
268 | |||
269 | |||
270 | * The images and targets that are filtered are displayed. |
||
271 | |||
272 | |||
273 | * User inspection and editing of the filtered targets are allowed. |
||
274 | |||
275 | |||
276 | |||
277 | |||
278 | |||
279 | |||
280 | |||
281 | |||
282 | |||
283 | h2. Tomography Class |
||
284 | |||
285 | |||
286 | |||
287 | |||
288 | |||
289 | * Allow the model to remain fixed to the initial values. |
||
290 | |||
291 | |||
292 | * Separate goniometer models for positive and negative tilts. |
||
293 | |||
294 | |||
295 | * Options that are not found useful are removed. |
||
296 | |||
297 | |||
298 | |||
299 | |||
300 | |||
301 | |||
302 | |||
303 | |||
304 | |||
305 | h2. TransformManager Class (New) |
||
306 | |||
307 | |||
308 | This class will eventually handle the transformation of an old target to a new one for |
||
309 | reacquisition after shift, tilt, and/or rotation in the grid plane. The current use is to |
||
310 | replace the shift adjustment in Drift Manager. As an option, it can transform targets based |
||
311 | on more than just its parent but all direct ancestors which makes the range of shift it can |
||
312 | handle much larger than the original drift manager implementation. |
||
313 | |||
314 | |||
315 | |||
316 | |||
317 | |||
318 | |||
319 | |||
320 | h2. Updated Applications (All) |
||
321 | |||
322 | |||
323 | |||
324 | |||
325 | h2. Manual |
||
326 | |||
327 | |||
328 | |||
329 | Power spectrum can be automatically calucated from the acquired image and displayed in |
||
330 | its own node to allow easy inspection. |
||
331 | |||
332 | |||
333 | |||
334 | |||
335 | |||
336 | h2. Calibrations |
||
337 | |||
338 | |||
339 | |||
340 | New binding required by Navigation node. |
||
341 | |||
342 | |||
343 | |||
344 | |||
345 | |||
346 | h2. MSI |
||
347 | |||
348 | |||
349 | |||
350 | New binding required by Navigation node. Drift management is divided between Drift |
||
351 | Monitor and Target Adjustment. A Preview and a Beam Fixing node are now standard in all MSI |
||
352 | applications |
||
353 | |||
354 | |||
355 | |||
356 | |||
357 | |||
358 | h2. Robot-related applications |
||
359 | |||
360 | |||
361 | |||
362 | Robot2 class that uses database as midpoint to communicate bettween leginon and the |
||
363 | robot controller replaces Robot class |
||
364 | |||
365 | |||
366 | |||
367 | |||
368 | |||
369 | |||
370 | |||
371 | h2. New Project Web Tool Features |
||
372 | |||
373 | |||
374 | |||
375 | |||
376 | h2. Grid entry for Robot Trays (1.1) |
||
377 | |||
378 | |||
379 | |||
380 | This is used to enter grid information for robot trays. |
||
381 | |||
382 | |||
383 | |||
384 | |||
385 | |||
386 | h2. Appion processing database creation (1.2) |
||
387 | |||
388 | |||
389 | |||
390 | This is used to create and link the project to a new database ready for Appion usage. |
||
391 | |||
392 | |||
393 | |||
394 | |||
395 | |||
396 | |||
397 | |||
398 | |||
399 | h2. New dbemtool Web Tool Features (1.5.1) |
||
400 | |||
401 | |||
402 | |||
403 | |||
404 | h2. Hide or exemplify an image in the viewers |
||
405 | |||
406 | |||
407 | |||
408 | Images can be one of the three status: Normal, Hidden, or Exemplar. Clicking on the hide |
||
409 | button above the displayed image where it is available moves the image from its current |
||
410 | list. In other words, to hide an image from any of the normal preset list, click on "hide" |
||
411 | while display a normal image. This image will now display only if "hidden" is selected from |
||
412 | the preset list. Clicking on "hide" above an image displayed in the hidden list removes it |
||
413 | from the "hidden" list and return it back to the normal list. Images put in the "exemplar" |
||
414 | list will also be shown in the normal list. |
||
415 | |||
416 | |||
417 | |||
418 | |||
419 | |||
420 | h2. The mrc images are cached as jpegs in the viewers |
||
421 | |||
422 | |||
423 | |||
424 | The cache system allows faster access to the same image next time. |
||
425 | |||
426 | |||
427 | |||
428 | |||
429 | |||
430 | h2. More options for image display intensity adjustment |
||
431 | |||
432 | |||
433 | |||
434 | You can manually define min/max of the display range in absolute number or relative |
||
435 | percentage, as well as in standard deviation unit based on the statistics of the image. The |
||
436 | manually determined values are saved for individual image displayed in the same panel until |
||
437 | the page is closed. |
||
438 | |||
439 | |||
440 | |||
441 | |||
442 | |||
443 | h2. Queue counter in LOI |
||
444 | |||
445 | |||
446 | |||
447 | It updates the number of unprocessed queue targets and estimate how much time it will |
||
448 | still take to finish them. |
||
449 | |||
450 | |||
451 | |||
452 | |||
453 | |||
454 | h2. Queue deletion tool in 3-way and LOI viewers |
||
455 | |||
456 | |||
457 | |||
458 | Click on this tool<inlinegraphic |
||
459 | fileref="http://emg.nysbc.org/software/leginon/images/images/deq_bt_off.gif" |
||
460 | format="GIF"/> above a displayed image pops up a window where you can remove targets |
||
461 | derived from that and all its descendent images. In other words. if you have put in the |
||
462 | queue targets from 10 holes, each selected from the same square image, you will delete all |
||
463 | theses targets if you perform queue deletion on the square image. Please use this |
||
464 | carefully. |
||
465 | |||
466 | |||
467 | |||
468 | |||
469 | |||
470 | h2. Hole template and 2-way viewers |
||
471 | |||
472 | |||
473 | |||
474 | You can see your custom hole templates saved and used in the past leginon sessions in |
||
475 | the hole template viewer. 2-way viewer gives you a bigger view of the parent images than the |
||
476 | 3-way viewer. |
||
477 | |||
478 | |||
479 | |||
480 | |||
481 | |||
482 | h2. Model parameter display in the tomography viewer |
||
483 | |||
484 | |||
485 | |||
486 | The model paramters can be displayed for diagnosis by activating the check box. |
||
487 | |||
488 | |||
489 | |||
490 | |||
491 | |||
492 | h2. Deletion candidate marking in the tomography viewer |
||
493 | |||
494 | |||
495 | |||
496 | The "Mark for deletion" button saves the selected tilt series in the leginon database in |
||
497 | a table that the system administrator can look up and delete from the file server in a later |
||
498 | time. |
||
499 | |||
500 | |||
501 | |||
502 | |||
503 | |||
504 | h2. Appion processing function possible with installation |
||
505 | |||
506 | |||
507 | |||
508 | If you install Appion's processing server programs, the processing tag direct you to its |
||
509 | menu page. |
||
510 | |||
511 | |||
512 | |||
513 | |||
514 | |||
515 | |||
516 | |||
517 | h2. Bug Fixes |
||
518 | |||
519 | |||
520 | |||
521 | |||
522 | h2. GUI |
||
523 | |||
524 | |||
525 | |||
526 | |||
527 | * Tomography node settings is set in a scrolled window so that it is possible to fit |
||
528 | it in a smaller display such as 12" screen of laptop computers |
||
529 | |||
530 | |||
531 | * Goniometer Modeler settings are automatically set. |
||
532 | |||
533 | |||
534 | . |
||
535 | |||
536 | |||
537 | |||
538 | |||
539 | |||
540 | |||
541 | |||
542 | h2. Recommended Application Preference Changes when updated from version 1.5 |
||
543 | |||
544 | |||
545 | |||
546 | |||
547 | h2. Adjust Target For Drift Check Box is now a choice |
||
548 | |||
549 | |||
550 | |||
551 | If you checked "adjust target for drift" in any node of Acquisition class, it should be |
||
552 | changed to select "one" ancestor. A python script "update16.py" is provided for a complete |
||
553 | update of such setting in all related nodes. If the drift is so large that the different |
||
554 | versions of the parent images can not be correlated, you should change the choice from "one" |
||
555 | to "all" ancestors. |
||
556 | |||
557 | |||
558 | |||
559 | |||
560 | |||
561 | |||
562 | |||
563 | h2. Known Bugs |
||
564 | |||
565 | |||
566 | |||
567 | |||
568 | |||
569 | * (New for v1.5) Resuming image acquisition from Square Targeting after Leginon |
||
570 | restart may cause reacquisition of children of the unfinished target list on 32-bit |
||
571 | Linux machine. |
||
572 | |||
573 | |||
574 | Dictionary ordering problem of MySQL query, No temporary solution. |
||
575 | |||
576 | |||
577 | * (New for v1.5) DataAccessError may show up when a user starts new application if |
||
578 | default is loaded to an existing database. |
||
579 | |||
580 | |||
581 | Temporary solution: See <link linkend="bad_default_reference">Operation Trouble |
||
582 | Shooting</link> on the subject. |
||
583 | |||
584 | |||
585 | * (New for 1.3) Navigator multiple move option does not work properly in MSI imaging |
||
586 | sequence with image shift as the move type. |
||
587 | |||
588 | |||
589 | Temporary solution: Always use preset manager when move type is image shift. |
||
590 | |||
591 | |||
592 | * Web viewer may not display all targets on the parent image since target is |
||
593 | transferred to a different version. |
||
594 | |||
595 | |||
596 | No temporary solution. |
||
597 | |||
598 | |||
599 | * Kill Application may not kill all process cleanly and may cause problem in |
||
600 | connecting to TEM or camera when a new application is reloaded. |
||
601 | |||
602 | |||
603 | Temporary solution: Close leginon and clients and restart. |
||
604 | |||
605 | |||
606 | * Simulate Target use the current image shift as the target shift on top of its preset |
||
607 | shift. Therefore, the acquired image may carry an additional image shift if there is an |
||
608 | offset created from previouis acquisition. |
||
609 | |||
610 | |||
611 | Temporary solution: Always use Presets Manager to send the preset to be used in |
||
612 | simulation first before usinging Simulate Targets tool. |
||
613 | |||
614 | |||
615 | * Some, although fewer, User Notification "processing " icons do not disappear but |
||
616 | stay pointing up after the node is done. |
||
617 | |||
618 | |||
619 | Temporary solution: None. |
||
620 | |||
621 | |||
622 | * When running on LINUX system, Preset selection in /Presets Manager/Importing Presets |
||
623 | from Another Session/ add a selection when mouse is left-clicked rather than toggle the |
||
624 | selection as in convention. |
||
625 | |||
626 | |||
627 | Temporary solution: Hold down to Ctrl key to select and deselect multiple presets. |
||
628 | Shift key still means selecting all between the two clicks. |
||
629 | |||
630 | |||
631 | Note: This problem is caused by some bug in wxPython for LINUX. |
||
632 | |||
633 | |||
634 | * Web 3way Image viewer does not always show in yellow the revised (i.e. after drift |
||
635 | correction) current target in the parent image. |
||
636 | |||
637 | |||
638 | Temporary solution: None. |
||
639 | |||
640 | |||
641 | * Starting Manual Focus directly by clicking on the tool does not use preset but still |
||
642 | check for the preset assigned for the focuser node. |