# nf-core/rnastructurome
**nf-core/rnastructurome** is a bioinformatics pipeline for analysing chemical RNA structure
probing data. It takes sequencing reads from SHAPE or DMS experiments, measures how reactive each
nucleotide is to the chemical probe, and uses those reactivities to predict RNA secondary
structures. It is developed by the RNAcentral team at EMBL-EBI as part of the
[nf-core](https://nf-co.re) community of curated [Nextflow](https://www.nextflow.io/) pipelines,
and its first stable release, [1.0.0](https://nf-co.re/rnastructurome/1.0.0/), came out in
September 2026.
Anyone can run the pipeline on their own data. It is intended as a common standard for processing
chemical probing data, so that results from different studies and laboratories are produced in the
same way and can be compared directly. RNAcentral uses it to process the datasets described on the
[Chemical probing](chemical-probing.md) page.
If you work with an AI agent, the
[`nfcore-rnastructurome-wrapper`](https://github.com/ClawBio/ClawBio/tree/main/skills/nfcore-rnastructurome-wrapper)
skill in the [ClawBio](https://github.com/ClawBio/ClawBio) skill library can help you create the
samplesheet and the command to run the pipeline. The skill is written around how the pipeline
actually behaves, including the samplesheet rules, how the reference is chosen and known gotchas,
so the agent can set up a correct run.
## What the pipeline does
1. Checks and trims the reads, with optional UMI extraction and deduplication
2. Uses a local reference, or downloads one from Ensembl or NCBI for the sample's organism
3. Aligns the reads to the genome, or to a set of transcripts
4. Counts the reactivity of each nucleotide and normalises it against the untreated or denatured
controls
5. Predicts secondary structures from the reactivities and draws 2D diagrams with ViennaRNA, and
with [R2DT](r2dt-software.md) where a template exists for the RNA type
6. Exports reactivity, Shannon entropy and base-pair tracks, and RMDB-compatible RDAT files
7. Summarises the run, including how well replicates agree, in a [MultiQC](https://multiqc.info/)
report
## Usage
The pipeline takes a samplesheet with one row per sample, giving its FASTQ files, sample group,
condition (treated, untreated or denatured) and replicate. Many parameters are chosen automatically
from what the samplesheet contains, such as the probing method, readout principle and controls
present, so the pipeline is suitable for beginners and runs with sensible defaults:
```bash
nextflow run nf-core/rnastructurome -r 1.0.0 \
-profile \
--input samplesheet.csv \
--outdir
```
For the samplesheet columns, all options and a description of the output files, see the
[usage](https://nf-co.re/rnastructurome/docs/usage/),
[parameter](https://nf-co.re/rnastructurome/parameters/) and
[output](https://nf-co.re/rnastructurome/docs/output/) documentation.
## Credits and support
nf-core/rnastructurome was originally written by Victoria Begley and Pedro Madrigal from RNAcentral
at EMBL-EBI, with extensive assistance from Danny Incarnato and Yiliang Ding.
Contributions are welcome: open a pull request on GitHub following the
[contributing guidelines](https://github.com/nf-core/rnastructurome/blob/master/docs/CONTRIBUTING.md)
and the [nf-core conventions](https://nf-co.re/docs/guidelines/pipelines/overview).
- Source code:
- Get help on the
[`#rnastructurome` Slack channel](https://nfcore.slack.com/channels/rnastructurome)
(join with [this invite](https://nf-co.re/join/slack))