There are four primary ways to run Cell Ranger:
- 10x Genomics Cloud Analysis: a scalable platform for data management, analysis, and collaboration to simplify and accelerate the interpretation of data generated from 10x Genomics assays (currently available for customers in the U.S. and Canada only).
- Single Server: Cell Ranger can run directly on a dedicated server. This is the most straightforward approach and the easiest to troubleshoot.
- Job Submission Mode: Cell Ranger can run using a single node on the cluster. Less cluster coordination is required since all work is done on the same node. This method works well even with job schedulers that are not officially supported.
- Cluster Mode: Cell Ranger can run using multiple nodes on the cluster. This method provides high performance but is difficult to troubleshoot since cluster setup varies among institutions.
Recommendations and requirements, in order of computational speed (left to right):
| Cloud Analysis | Cluster Mode | Job Submission Mode | Single Server | |
|---|---|---|---|---|
| Recommended for | Default option for users in supported countries Organizations using an HPC with SGE or LSF for job scheduling | Organizations using an HPC | Users without access to an HPC, if Cloud Analysis is not an option | |
| Compute details | Splits each analysis across multiple compute nodes to decrease run time | Splits each analysis across multiple compute nodes to decrease run time | Runs each analysis on a single compute node | Runs each analysis directly on a dedicated server |
| Requirements | Any laptop or desktop computer | HPC with SGE or LSF for job scheduling | HPC with most job schedulers | Linux computer with minimum 8 cores & 64 GB RAM |
Cloud Analysis is a scalable platform for data management, analysis, and collaboration to simplify and accelerate the interpretation of data generated from 10x Genomics assays. Cloud Analysis makes it easier than ever to access and run 10x Genomics software, track and manage experimental data, and share that data with collaborators and researchers. At this time, Cloud Analysis is available for customers in the U.S. and Canada only. Learn how to use the 10x Genomics Cloud.
The majority of the information on this website uses the single-server approach. For example, follow the instructions below to analyze a 10x Genomics library:
Cell Ranger can be run in job submission mode, by treating a single node from the cluster like a local server. This leverages existing institutional hardware for pipeline analysis.
This mode of operation is what most people have in mind when it comes to working with clusters; a large computational job is submitted to the cluster, and there is one Job ID to track during job execution. To learn more, please go to the job submission mode page.
Cell Ranger can be run in cluster mode, using SGE or LSF to run the stages on multiple nodes via batch scheduling. This allows highly parallelizable stages to utilize hundreds or thousands of cores concurrently, dramatically reducing time to solution.
Instead of submitting one job to the cluster, Cell Ranger creates hundreds and potentially thousands of small-stage jobs. Each of these stage jobs needs to be queued, launched, and tracked by the pipeline framework. The necessary coordination between Cell Ranger and the cluster makes this approach harder to set up and troubleshoot since every cluster configuration is different. To learn more, please go to the cluster mode page.