Skip to content
This repository was archived by the owner on Apr 26, 2023. It is now read-only.

Scipion GUIs

Jose Miguel de la Rosa Trevin edited this page Nov 17, 2015 · 7 revisions
Scipion Logo

Background does not work

This page aims to introduce you in the usage of Scipion GUI. To start image processing in Scipion we need to run scipion from the command line. At first projects manager is displayed and we can create a new project or select one previously registered (Fig. 1). For this tutorial we registered projects TestSpiderWorkflow and TestXmippWorkflow for illustrative purposes (running scipion tests tests.em.workflows.test_workflow_spiderMDA and tests.em.workflows.test_workflow_xmipp).

new project

Figure1. Create a new project

Spider Workflow

If we open TestSpiderWorkflow project GUI is loaded(Fig 2). To the left different reconstruction tasks related to Single Particle Analysis (SPA) are listed. The tree menu is loaded from a configuration file where protocols are grouped according to base classes, eg: Micrographs Preprocess category displays ProtPreprocessMicrographs protocols. A protocol is a processing task that involves the execution of several steps and can be associated to different workflows, eg: SPA or Random Conical Tilt (RCT).

To the right the sequence of protocols executed by the user and its state (running, finished, aborted) is listed. We can visualize it using list or tree views. Also we can edit or copy a protocol (to rerun it), delete it, see steps or access execution database.

Bottom right panel displays information for the selected run, such as inputs and outputs, execution logs or documentation - also provides "Analyze Results" button to visualize outputs.

project

Fig2. - Project GUI in Protocols Mode.

If we switch to Data mode left panel displays EM objects registered for each type and right panel displays project data tree, with protocol output objects as nodes and edges towards objects used as input. Bottom right panel displays information for the selected item, that can be opened using double click. This mode allows us to track image processing emphasizing on data handling.

datamode

Fig2. - Project GUI in Data Mode.

TestSpiderWorkflow project imports a set of particles, preprocess and aligns them to finally use it as input for different 2D classification algorithms. If we open filter particles protocol (using edit) the following form is displayed:

#SpiderAnchor <figure> <img src="https://github.com/biocompwebs/scipion/wiki/images/guis/filter.png"/> <figcaption>Fig3. - Filter Particles Protocol Form .</figcaption> </figure>

Protocol provides cite references and help util to introduce user on the subject (Fig. 4-5). Form possess two sections: Run and Input. Run section is common to all protocols and allows the user to configure run label and comments (to personalize runs, Fig. 4); execution mode (restart or resume), host, queue and threads or MPI. Many image processing tasks are computer expensive so they need to be run on specific hosts, using queue system and parallel processing. Parallelization can be supported by underneath algorithm or enabled for protocols with independent steps.

Input section allows to specify input parameters for the task, like input particles or filter type. A brief description is provided for all of them (using help button) and for some a Search GUI to select input object (Fig. 6) or a wizard GUI (through eye button). Parameters are showed considering expert level selected (Normal, Advanced or Expert).

<figure> <img src="https://github.com/biocompwebs/scipion/wiki/images/guis/cite.png" width="600" /> <figcaption>Fig4. - Protocol Cite </figcaption> </figure>

<figure> <img src="https://github.com/biocompwebs/scipion/wiki/images/guis/protocol_help.png" width="600" /> <figcaption>Fig5. - Protocol Help</figcaption> </figure>

<figure> <img src="https://github.com/biocompwebs/scipion/wiki/images/guis/inputlist.png" width="600" /> <figcaption>Fig6. - List of SetOfParticles objects registered.</figcaption> </figure>

We can visualize filtered particles using "Analyze Results" (Fig. 7). ShowJ viewer is the default viewer for most of Scipion objects, like images, volumes, sets of images, classes, etc. It can display data in gallery and table modes and navigate trough different blocks of data. Also load single images, create subsets, etc. See ShowJ for more detail. In this project we use it to refine output from a 2D classification algorithm.

<figure> <img src="https://github.com/biocompwebs/scipion/wiki/images/guis/particles.png" width="700" /> <figcaption>Fig7. - ShowJ displaying filtered particles .</figcaption> </figure>

If we select 2D classification protocol spider-classify kmeans and open output classes, we can see representative particle for each class (Fig. 8). Third and fourth items seemed very similar so we can disable fourth item and create a subset containing only remaining classes. This operation registers a subset protocol with this classes as input and the set of classes with enabled items as output.

<figure> <img src="https://github.com/biocompwebs/scipion/wiki/images/guis/classes.png" width="700" /> <figcaption>Fig. 8. - ShowJ displaying a SetOfClasses</figcaption> </figure>

  • Xmipp Workflow*

If you open TestXmippWorkflow the following project GUI is displayed (Fig. 9):

<figure> <img src="https://github.com/biocompwebs/scipion/wiki/images/guis/xmipp-project.png" width="800" /> <figcaption>Fig. 9. - TestXmippWorkflow Project GUI </figcaption> </figure>

This project imports a set of micrographs (eg: Fig. 10), reduce its image size using downsample and estimates their CTF. Then, picks particles from micrographs and extracts particles to use it as input for alignnment and classification algorithms like cl2d, ml2d, kendersom or rotational spectra. We use it to illustrate CTF and particle picking GUIs.

<figure> <img src="https://github.com/biocompwebs/scipion/wiki/images/guis/micrograph.png" width="700" /> <figcaption>Fig 10. - ShowJ displaying input micrograph with "gaussian blur" filter applied </figcaption> </figure>

ShowJ GUI for single images is displayed above (see Showj)

Screen micrographs produces this output:

<figure> <img src="https://github.com/biocompwebs/scipion/wiki/images/guis/ctf.png" width="700" /> <figcaption>Fig 11. - CTF Recalculate Wizard </figcaption> </figure>

We can use CTF wizard to redefine input parameters to recalculate CTF on specific micrographs. Recalculate CTFs will register a new protocol that receives this SetOfCTF as input and creates an output set with CTFs updated.

Particle picking can be done in Scipion using Xmipp, Eman, Bsoft, etc. In this tutorial we choosed Xmipp Particle Picker, see Fig. 12.

<figure> <img src="https://github.com/biocompwebs/scipion/wiki/images/guis/picking.png" width="1000" /> <figcaption>Fig 12. - Xmipp Particle Picker GUI </figcaption> </figure>

The Xmipp picker allows us to iterate over the micrographs to pick particles, see Xmipp Particle Picker. After we have done some manual/supervised picking and feel confident with the results we register output coordinates into Scipion using Add Coordinates button.

Clone this wiki locally