Frequently Asked Questions
- How do I get started?
- Are CellProfiler and CellProfiler Analyst free?
- What is the difference between CellProfiler and CellProfiler Analyst?
- Do CellProfiler and CellProfiler Analyst have to be used together?
- I'm an image processing expert. Why should I use CellProfiler for development?
- I'm an image processing expert. Can I use CellProfiler modules as part of a larger software package?
- What happened to the CellVisualizer software project?
- I'm not a programmer. How much programming do I need to know?
- I don't have MySql or Oracle. Can I use Microsoft Access?
- I have a small image set (20 images). Should I use CellProfiler Analyst?
Are CellProfiler and CellProfiler Analyst free?
Yes. They are free and open-source (GPL). See the license.
What is the difference between CellProfiler and CellProfiler Analyst?
CellProfiler processes images and produces numerical data, which can exported to Excel (if small) or deposited to a database (if large).
CellProfiler Analyst allows researchers to explore and analyze data in a database. The machine learning-based scoring of complex phenotypes is one example of the analysis tools in CellProfiler Analyst.

Do CellProfiler and CellProfiler Analyst have to be used together?
No – while the two software packages work well together, they can be used individually:
- Tools to explore and analyze data generated by CellProfiler:
- CellProfiler Analyst allows analysis and exploration of data produced by CellProfiler that has been deposited into a MySQL or Oracle database, using CellProfiler's ExportToDatabase module.
- CellProfiler has built-in tools in the "Data Tools" menu in the main window to generate a few types of plots using data from a CellProfiler output file.
- A spreadsheet program like Microsoft Excel or OpenOffice can read the tab-delimited files that are generated by the ExportToExcel Data Tool (in the main CellProfiler window) on a CellProfiler output file. Note that Excel is limited to 256 columns and ~65,536 rows of data.
- MATLAB can be used to directly analyze the data in a CellProfiler output file.
- Any analysis or visualization tools that can query a database (such as R or python+pylab) can be used to analyze data that has been deposited into a MySQL or Oracle database, using CellProfiler's ExportToDatabase module.
- SpotFire is able to import tab-delimited files of data, which can be generated by using the ExportToExcel Data Tool (in the main CellProfiler window) on a CellProfiler output file (for small data sets) or can be generated from data that has been deposited into a MySQL or Oracle database, using CellProfiler's ExportToDatabase module (for large data sets).
- Note that Oracle databases work well with CellProfiler but are not yet fully tested in CellProfiler Analyst.
- Tools to produce CellProfiler Analyst-compatible data:
- CellProfiler Analyst can be used with any database of image-based screening data that follows a simple format: One image table with rows of images and columns of data and one object table with rows of objects (e.g., cells) and columns of data. It is compatible with MySQL and Oracle databases, though MySQL has been tested much more extensively.
I’m an image processing expert. Why should I use CellProfiler for development?
You can take advantage of the existing base of modules for the mundane parts of image processing and focus on developing your own algorithms or complex sequences of modules. When you have developed a solution, you can contribute the code to the open-source CellProfiler project, which saves you from writing your own GUI, compiling for multiple platformsd, and answering basic questions from the public (like installation troubleshooting and basic usage). Your method will be widely available and in a format that biologists can actually use.
CellProfiler is written in Matlab, which is commonly used in image processing, especially for prototyping. Note that many CellProfiler modules are simple wrappers for Matlab functions – the identification and illumination correction modules are where some of the more interesting algorithms reside. Concerned about speed? Matlab allows functions to be written in other languages, compiled, and called from the program.
Within CellProfiler, check out Help > General Help > DeveloperInfo for further information for developers.
I'm an image processing expert. Can I use CellProfiler modules as part of a larger software package?
Sure! As long as you comply with the open-source license, you can use pieces of the source code in your own software. You might particularly be interested in the subfunctions (CPsubfunctions folder), or in following the instructions to run CellProfiler modules “headless” (that is, without the GUI). Within CellProfiler, check out Help > General Help > DeveloperInfo for further information for developers - especially the section “Running CellProfiler without the graphical user interface”.
What happened to the CellVisualizer software project?
It was renamed CellProfiler Analyst.
I'm not a programmer. How much programming do I need to know?
No programming experience is required to use either CellProfiler and CellProfiler Analyst. Setting up databases for data in order to use CellProfiler Analyst might require the help of your local information technology group or database administrator, especially during your initial configuration of the database and software. You can learn more about MySQL databases and commands here: http://dev.mysql.com/doc/refman/5.0/en.
I don't have MySQL or Oracle, can I use Microsoft Access?
We recommend MySQL or Oracle for large datasets and any dataset where you would like to use CellProfiler Analyst. You can use Microsoft Access if you have fewer than 65,536 rows per table, by exporting the data as a CSV file using CellProfiler's ExportToExcel module or data tool. Then, you can create various tables in Access, and use another program (such as Excel) to analyze your data.
I have a small image set (20 images), should I use CellProfiler Analyst?
For simple analyses of small image sets (creating plots or sorting data by one particular measurement), it's probably more convenient to use the built-in CellProfiler data tools or a spreadsheet program like Excel after exporting your data with CellProfiler's ExportToExcel module or data tool. CellProfiler Analyst is more useful for large data sets or sophisticated analyses; it has several built in features that will help you create histograms, scatterplots, classify your data by a particular phenotype, and score your classified results. CellProfiler Analyst is a great tool for data exploration, especially if you need a simple-to-use program to help you view your data in several formats.
