Appion

h1. Xmipp Reference-based Maximum Likelihood Alignment

This method is similar to reference-free maximum likelihood but you select templates first. It uses the Xmipp ml_align2d  program to perform alignments as described in _Scheres et. al. Journal of Molecular Biology v348(1), 139-149 (2005)_.

h2. General Workflow:

# Make sure that appropriate run names and directory trees are specified.  Appion increments names automatically, but users are free to specify proprietary names and directories.

# Enter a description of your run into the description box.

# Select the stack to align from the drop down menu.  Note that stacks can be identified in this menu by stack name, stack ID, and that the number of particles, pixel and box sizes are listed for each.

# Make sure that "Commit to Database" box is checked.  (For test runs in which you do not wish to store results in the database this box can be unchecked).

# Click on "Run Maxlike Alignment" to submit your job to the cluster.  Alternatively, click on "Just Show Command" to obtain a command that can be pasted into a UNIX shell.

!http://emg.nysbc.org/attachments/175/Picture_38.png!

# If your job has been submitted to the cluster, a page will appear with a link "Check status of job", which allows tracking of the job via its log-file.  This link is also accessible from the "1 running" option under the "Run Alignment" submenu in the appion sidebar.

# Once the job is finished, an additional link entitled "1 ready to upload" will appear under the "Run Alignment" tab in the appion sidebar.  Click on this link, and a page will open with a summary of the run output.  Clicking on the link next to "reference stack" will open a new window that shows the class averages obtained via this analysis.

# If you are satisfied with the alignment and want to continue processing its output, click on "Upload Job".  This shouldn't take too long to finish.

!http://emg.nysbc.org/attachments/167/Picture_23.png!

# Now click on the "1 Complete" link under the "Run Alignment" tab.  This opens a summary of all alignments that have been done on this project.    

# Click on the link next to "reference stack" to open a window that shows the class averages and that contains tools for exploring the result.  Such tools include the ability to browse through particles in a given class, create templates for reference based alignment, substack creation,3D reconstruction, etc.

# To perform a feature analysis, click on the grey link entitled "Run Feature Analysis on Align Stack ID xxx".

!http://emg.nysbc.org/attachments/157/Picture_8.png!

h2. Notes, Comments, and Suggestions:

# Still untested as to how much bias the reference gives you, but this may be useful in some cases. 

# When no particles align to a particular template, it goes black and unused in further iterations. 

# Clicking on "Show Composite Page" in the Alignment Stack List page (accessible from the "completed" link under "Run Alignment" in the Appion sidebar) will expand the page to show the relationships between alignment, feature analysis, and clustering runs.

______

[[Run_Alignment|<Run Alignment]] | [[Run Feature Analysis|Run Feature Analysis >]]

______