SPADE Manual.

Contents.

1. Introduction

SPADE is a front end for ethan. Ethan is a program that identifies circular particles of certain size in an electron micrograph and extracts them into separate files of given size. All ethan parameters are given at command line. To facilitate the use of ethan we have created SPADE, a graphical user interface. SPADE augments ethan with few other functions, like projects that allow work to be stopped, saved and continued later. Ethan and SPADE accept MRC and PGM file formats as input. Output is written in MRC format.

Quick reference cards [1| 2| 3]

2. Project structure.

A project consists of groups. Groups contain micrographs with similar parameter values: approximate virus size, and cutout box. A group can have zero or more micrograph files. A project can have several groups, each of which should have their own parameter values. Thw user can select the peremeter values of the group either from previous experience or by inspecting one of the micrographs on the screen. When processing the group, SPADE extracts each particle from a micrograph to its own file. The user can examine the particle files and delete unacceptible ones. It is helpful to think of a project as of a tree, where groups are branches of project, micrographs are branches of groups and finally individual virus particle files are branches of micrographs.

3. Project Window.

Project menu.

  • New Starts a new project, by clearing all fields and variables.
  • Open... Open a previously saved project file (.cse).
  • Save Saves the project to a file. Use this when a project already has a name.
  • Save as ... First prompts for a name and path for the project file then writes it. Use this function when saving a project for the first time, or when a copy of a project with a different name is desired.
  • Configure ethan Brings up ethan configuration window.
  • Autosave Checkbox. If this function is turned on (checkbox it ticked) SPADE will save the project automatically at certain critical points. If this function is not turned on, user should decide when exactly does he want to save the project, usually, SPADE will ask before exiting whether to save the project.
  • Exit Exits the program. If Autosave function is off, user is prompted to save the project.

Left side panel. (Functions related to unprocessed groups only.) Middle panel. (Functions related to both processed and unprocessed groups.)

  • Large '+' button Prompts user for Group name then adds group to to the project. This button is alway active.
  • Small '+' button Adds a micrograph file to selected group. This button is only active when a group is selected. This button will open window with a list of data (.mrc .pgm) files that are located in current data directory.
  • Small '-' button This button removes a single selected micrograph file. It is only active when a such file is selected.
  • Process '->' button Processes a selected unprocessed group and moves it from unprocessed tree to processed. This function can only be used when
    • an unprocessed group is selected
    • ethan parameters (particle radius and box size) for this group are set
    • the group contains at least 1 micrograph
  • Visualize 'eye' button Opens up a micrograph window to visualize a micrograph. This function can only be used when a micrograph file is selected in either processed or unprocessed tree.
  • Large '-' button Removes a group, from either of two trees, when removing a processed group, all output files are deleted. This function can only be used when a group is selected.

Right side panel.
Mosaic view button opens up a mosaic window with all output virus files created by ethan from selected input file. This function can only be used when a micrograph file from a processed group is selected.

Directory tabs.