Data folder
The data folder is the easiest way to store subtomograms.
A correctly formated data folder is the minimal input that the dcp GUI needs in order to create an alignment project.
Contents
Basic Format
The most intuitive way of organizing your data is just to create one file for each particle. Bear in mind that this approach can break down when you have tens of thousands of particles. In those cases, you'll need to use more advanced data containers.
Creating data folders
Data folders with the correct format are automatically created when cropping particles out of tomograms with Dynamo.
Inspecting data folders
Several tools are available for different levels of detail.
Quick check
ddinfo checks if the contents of a folder are files with the correct naming convention, and reports their number and expected sidelength.
Deep check
ddcheck is slower but more exhaustive. It reads each particle in the data folder to check coherence in dimensions or presence of corrupted pixels (NaN values). It also computes the mean and std values of each particle.
Visualization of a individual particles
Easy GUI: ddbrowse
ddbrowse is an easy-to-use browser. Many Dynamo GUIs link to it, and can also be initiated through the command line. Passing a data folder and a table, one can see projections of a selected set of particles and check how they behave when they are aligned with the table. Secondary click on each particle will allow to visualize it through dview or dmapview or linked external tools like Chimera.
A complexer GUI: dgallery
dgallery allows keeping in memory large sets of particles. This allows for quick visualization of the same area of sets of particles very quickly. dgallery is commonly used for [manual alignment]
Typical operations on data folders
Dynamo provides tools for normalization of all the particles inside the data folder, merging different data folders (with their corresponding metadata), converting data folders to other data containing formats.
Normalization
Normalization is not stricitly necessary for operating an alignment, as Dynamo will normalize the particles internally. However, you might want to normalize your data for visualization purposes.