Leginon

h1. Falcon raw frame saving

Falcon II base frame (the frame defined by the camera rolling shutter) rate is ~ 18 frames per second.

Raw frame saving can be achieved either with an custom hardware modification as designed at MRC-LMB or directly through FEI "Inermediate Image" tool.  We only have experience in latter.

h2. Intermediate Image Configuration XML file

Falcon Intermediate Image Tool allows base frames to be saved in 7 frame bins.

For raw frame saving using FEI's software, the midpoint time of the starting and ending base frames to be included in saved frame bin is defined by an xml file on Titan as

<pre>

C:\Titan\Data\Falcon\IntermediateConfig.xml

</pre>

To adjust the way the frames are saved in the bins, this file needs to be re-configured.

Leginon handles this configuration file modification required for each image acquisition.  However, if you need to generate your own, you can make a copy of the python script in myami/pyscope/falconframe.py and run it alone.

<pre>

python falconframe.py exposure_time_in_second first_distributed_frame_number

</pre>

h2. Saving raw frame in Leginon

1. Activate "Store intermediate images" option in C:\Titan\Exe\IntermediateImageTool.exe

!FalconIntermediatImageTool.png!

2. Edit the camera configuration of the imaging condition preset that you'd like to save frames like this:

!FalconSaveframe.png!

The most import input is *Use Frames*, explained below.  The rest can be left blank

Activate the checkbox "Save Frames" to use the configuration when the preset is used.

h3. Configure frame saving using "Use Frames" settings

Falcon Intermediate Image Tool allows base frames to be saved in 7 frame bins.

Frame number 0 that started readout as the beam shutter is open is usually discarded.

The format of this input is: (first_frame_number, first_distributed_frame_number, last_frame_number)

Frame number starts from 0 but frame 0 is normally discarded.

|parameter|description|typical value|

|first_frame_number|The base frame number where the frame saving starts|1|

|first_distributed_frame_number|Base frames before this will each occupies one saved frame bin.  Starting from this frame number, Leginon will attempt to put the same number of base frames in each remaining saved frame bin.|2|

|last_frame_number|The last base frame number to be saved.|17|