Project

General

Profile

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.