Support homeCell Ranger ARCDownloads

System Requirements

Cell Ranger ARC pipelines run on Linux systems that meet these minimum requirements:

  • 8-core Intel or AMD processor (48 cores recommended)
  • 64GB RAM (320GB recommended)
  • 1TB free disk space
  • 64-bit CentOS/RedHat 6.0 or Ubuntu 12.04; See the 10x Genomics OS Support page for details.

Note: Version 2.0 is the last version that will support CentOS/RedHat 6 or Ubuntu 12.04. Future versions will require CentOS/RedHat 7 or newer, or Ubuntu 14.04 or newer.

In order to run in cluster mode, the cluster needs to meet these additional minimum requirements:

  • Shared file system (e.g. NFS)
  • SGE or LSF batch scheduling system

In order to run cellranger-arc mkfastq, the following software needs to be installed:

  • Cell Ranger ARC runs with --jobmode=local by default, using 90% of available memory and all available cores. To restrict resource usage, please see the --localmem and --localcores flags for cellranger-arc count at the link here for more information.
  • Many Linux systems have default user limits (ulimits) for maximum open files and maximum user processes as low as 1024 or 4096. Because Cell Ranger ARC spawns multiple processes per core, jobs that use a large number of cores can exceed these limits. 10x Genomics recommends higher limits.
LimitRecommendation
user open files16k
system max files10k per GB RAM available to Cell Ranger ARC
user processes64 per core available to Cell Ranger ARC

The following data is based on time trials using Amazon EC2 instances, our PBMC 10k dataset, and version 2.0 of Cell Ranger ARC. Performance is dependent on both the number of cells and the number of reads per cell. These plots will not be updated with every subsequent release of Cell Ranger ARC, unless pipeline performance changes significantly.

InstanceThreadsMemory (GB)Core hoursWall timeStorage HWM (GB)
r3.8xlarge (Ivy Bridge)32642208h 22m428
m5.24xlarge (Skylake)963841983h 15m356
r4.16xlarge (Broadwell)644881964h 26m484

Here is cellranger-arc count walltime as a function of available memory based on the r3.8xlarge Ivy Bridge architecture. In general, you can improve performance by allocating more than the minimum 64GB of memory to the pipeline. There is notable diminishing return beyond 320GB.

Here's cellranger-arc count walltime as a function of threads. If your system has ≫96 logical cores, you may want to run with --localcores=96 since there is diminishing return beyond 96 threads.