Space Ranger is delivered as a single, self-contained tar file that can be unpacked anywhere on your system. It bundles all of its required software dependencies, which are pre-compiled to run on a wide range of Linux distributions.
For convenience, the reference data package required for Space Ranger is provided as a separate download.
Step 1 – Download and unpack the Space Ranger file in any location. This example uses /opt.
$ cd /opt
[ download file from downloads page ]
$ tar -xzvf spaceranger-3.0.0.tar.gz
This unpacks Space Ranger, its dependencies, and the spaceranger script into a new directory called spaceranger-3.0.0.
Step 2 – Download and unpack any of the reference data files in a convenient location:
[ download file from downloads page ]
$ tar -xzvf refdata-gex-GRCh38-2020-A.tar.gz
This creates a new directory called refdata-gex-GRCh38-2020-A that contains a single reference (in this case, GRCh38). Each reference contains a set of pre-generated indices and other data required by Space Ranger.
Step 3 – Prepend the Space Ranger directory to your $PATH. This allows you to invoke the spaceranger command.
If you unpacked both Space Ranger and the reference data into /opt, then run the following command:
$ export PATH=/opt/spaceranger-3.0.0:$PATH
For convenience, you can add this command to your .bashrc.
Next, run the bundled site check script and send the output to 10x Genomics. If requested, we will review the information to ensure that Space Ranger runs smoothly once you have generated your own Visium data. Assuming you have installed Space Ranger as described above, run the following commands after replacing the code below with your email:
$ spaceranger sitecheck > sitecheck.txt
$ spaceranger upload [your@email.edu] sitecheck.txt
If you plan to run Space Ranger on a cluster, run and send us the output twice, once on a submit host and once on a cluster node.
If your system does not have direct internet connectivity, send the output files as attachments to support@10xgenomics.com.
To ensure that the spaceranger pipeline is installed correctly, use spaceranger testrun. This test can take up to 60 minutes on a sixteen-core workstation. Assuming you have installed Space Ranger into /opt, the command to run the test looks like:
$ export PATH=/opt/spaceranger-3.0.0:$PATH
$ spaceranger testrun --id=tiny
-----------------------------------------------------------------------------
Running preflight checks (please wait)...
Checking sample info...
Checking FASTQ folder...
Checking reference...
...
Pipestance completed successfully!
To work around this, add the --no-internet argument to the testrun command line like this: spaceranger testrun --no-internet --id=tiny
If you plan to run the spaceranger count pipeline in an environment with no internet access, download the spot layout data for your slide from this link and provide this file to the spaceranger count pipeline using the
--slidefile option, for example:
spaceranger count --slidefile V19L01-041.gpr
A tiny.mri.tgz file is created inside the tiny/ folder and contains diagnostic information 10x can use to help resolve any problems. It is generated whether the pipeline succeeds or fails. If the pipeline fails and you need troubleshooting assistance, you can send this file directly to us from the command line. Replace the code with your email:
$ spaceranger upload [your@email.edu] tiny/tiny.mri.tgz
If your system does not have direct internet connectivity, you can also send the file as an attachment to support@10xgenomics.com.