A pipeline is a sequential set of image analysis modules. The best way to learn how to use CellProfiler is to load an example pipeline from the CellProfiler website's Examples page and try it out, then adapt it for your own images. You can also build a pipeline from scratch. Click the Help button in the main window to get help for a specific module.
Constructing a pipeline involves placing individual modules into a pipeline. The list of modules in the pipeline is shown in the pipeline panel (located on the left-hand side of the CellProfiler window).
Place analysis modules in a new pipeline.
Choose image analysis modules to add to your pipeline by clicking the Add button (located underneath the pipeline panel) or right-clicking in the pipeline panel itself and selecting a module from the pop-up box that appears.
You can learn more about each module by clicking Module Help in the "Add modules" window or the ? button after the module has been placed and selected in the pipeline. Modules are added to the end of the pipeline or after the currently selected module, but you can adjust their order in the main window by dragging and dropping them, or by selecting a module (or modules, using the Shift key) and using the Move Module Up and Move Module Down buttons. The Remove Module button will delete the selected module(s) from the pipeline.
Most pipelines depend on one major step: identifying the objects. In CellProfiler, the objects you identify are called primary, secondary, or tertiary:
Adjust the settings in each module.
In the CellProfiler main window, click a module in the pipeline to see its settings in the settings panel. To learn more about the settings for each module, select the module in the pipeline and click the Help button to the right of each setting, or at the bottom of the pipeline panel for the help for all the settings for that module.
If there is an error with the settings (e.g., a setting refers to an image that doesn't exist yet), a icon will appear next to the module name. If there is a warning (e.g., a special notification attached to a choice of setting), a icon will appear. Errors will cause the pipeline to fail upon running, whereas a warning will not. Once the errors/warnings have been resolved, a icon will appear indicating that the module is ready to run.
Set your Default Input Folder, Default Output Folder and output filename.
For more help, click their nearby Help buttons in the main window.
Click Analyze images to start processing.
All of the images in your selected folder(s) will be analyzed using the modules and settings you have specified. A status window will appear which has the following:
ode to preview results.
You can optimize your pipeline by selecting the Test option from the main menu. Test mode allows you to run the pipeline on a selected image, preview the results, and adjust the module settings on the fly. See Help > Testing Your Pipeline for more details.
Save your project (which includes your pipeline) via File > Save Project.
Saving images in your pipeline: Due to the typically high number of intermediate images produced during processing, images produced during processing are not saved to the hard drive unless you specifically request it, using a SaveImages module.
Saving data in your pipeline: You can include an Export module to automatically export data in a format you prefer. See Help > Using Your Output for more details.