10x Genomics
Chromium Single Cell ATAC
Cell Ranger ATAC2.1 (latest), printed on 11/14/2024
Different Ways of Running Cell Ranger ATAC
There are three primary ways to run Cell Ranger ATAC:
- Single Server: Cell Ranger ATAC can run directly on a dedicated server. This is the most straightforward approach and the easiest to troubleshoot.
- Job Submission Mode: Cell Ranger ATAC 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 ATAC 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):
| Cluster Mode | Job Submission Mode | Single Server | |
|---|---|---|---|
| Recommended for | Organizations using an HPC with SGE or LSF for job scheduling | Organizations using an HPC | Users without access to an HPC |
| Compute details | 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 | HPC with SGE or LSF for job scheduling | HPC with most job schedulers | Linux computer with minimum 8 cores & 64 GB RAM |
Single server
The majority of the information on this website uses the single server approach. Follow the instructions below to analyze a 10x Genomics library:
| By default, cellranger-atac uses all available cores and 90% of detected memory. This behavior may be undesirable in a shared environment with multiple concurrent users and tasks. It is strongly recommended to run cellranger-atac with --localcores and --localmem to specify resource usage upper bounds. In practice, there is negligible return in allocating more than 32 cores or 256G to the pipeline. Check the system requirements page for more information on how resource allocations affect pipeline runtime. |
Job submission mode
Cell Ranger ATAC 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.
| 10x Genomics does not officially support Slurm or Torque/PBS. However, many customers have successfully used Cell Ranger ATAC with those job schedulers in job submission mode. |
This mode of operation is what most people have in mind when working with clusters. Typically, a large computational job is submitted to the cluster and there is a single Job ID to track during job execution. To learn more, please go to the job submission mode page.
Cluster mode
Cell Ranger ATAC 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, greatly reducing walltime.
| 10x Genomics does not officially support Slurm or Torque/PBS. While some customers have successfully used Cell Ranger ATAC with those job schedulers in cluster mode, it is unsupported and may require trial and error. |
Instead of submitting one job to the cluster, Cell Ranger ATAC creates hundreds and potentially thousands of small stage jobs. Each of these stage jobs need to be queued, launched, and tracked by the pipeline framework. The necessary coordination between Cell Ranger ATAC and the cluster makes this approach more difficult to set up and troubleshoot, since every cluster configuration is different. To learn more, please go to the cluster mode page.