Preprocessing an HT-SELEX study

From public reads to a Bioconductor experiment

High-throughput SELEX enriches binding sequences over successive selection rounds. Public deposits commonly provide raw reads without a uniform record of primer layout, trimming decisions, or the relationship between rounds. selexprepR combines these preprocessing steps and returns a sparse SummarizedExperiment: rows represent recovered sequences, columns represent rounds, and the counts assay contains their observed read counts.

The experiment also retains the inferred library layout, extraction yields, quality-control diagnostics and a provenance manifest. Inspect these decisions before supplying the counts to downstream Bioconductor workflows. The existing SELEX package provides a complementary analysis workflow based on its own sample annotation model.

Install with BiocManager::install("selexprepR") in a supported Bioconductor installation. All examples below use bundled files and run without downloading reads or installing software.

library(selexprepR)

Start with your own reads

What you have Where to start
One FASTQ per round Name a vector of paths round_00, round_01, and so on, using the actual round numbers. Pass it to run_selexprep_files().
Paired-end reads or several files per round Pass a table with path, round_number and mate columns to run_selexprep_files(). Give each file its own row and use "R1" and "R2" to identify paired mates.
Reads with inline round barcodes Read the FASTQ with read_selexprep_fastq() and call selexprep_demultiplex() with your barcode-to-round map. Review unassigned reads and pass the result to run_selexprep().

If you know the flanking sequences, supply primer_5p and primer_3p in the orientation of the reads you intend to count. To infer the layout first, load your round-separated reads with read_selexprep_inputs() and inspect the report from selexprep_detect() before relying on the inferred boundaries. The example below shows both layout inspection and explicit primers.

Write primer_5p and primer_3p as they read in the FASTQ from left to right. The 3’ primer is what follows the random region in the read, so a reverse primer as ordered is its reverse complement; extraction warns when a supplied primer is in under 5% of the reads and says so if its reverse complement is there instead. A primer override keeps the inferred extraction_mode. Pass extraction_mode = "BOTH_PRIMERS_SINGLE_READ" with both primers to trim both; the other values are "FIVE_PRIME_ONLY", "THREE_PRIME_ONLY" and "PAIRED_END_SPLIT_PRIMERS".

Check four things on your own data:

  • Reads longer than the construct. If the read length exceeds 5’ constant
    • random region + 3’ constant, the reads run into the sequencing adapter. Detection can then call the adapter as a primer, with a warning, or find one constant only, with a message; the sequences then keep the other constant and the adapter. Compare primer_5p, primer_3p and n_length_mode in the report with your library design, and supply the primers and the mode when they differ.
  • Supplied primers. The report then has status = "LOW" and confidence = 0: nothing was inferred, so there is no inference to rate. This is not a failed run. The evidence for your primers is in match_rate_5p and match_rate_3p.
  • Replicates. Files that share a round number are pooled. To keep replicates apart, run them separately.
  • Run time. Expect roughly a minute per 100,000 reads on a laptop, about evenly split between detection and extraction. For a first look, pass max_reads_per_file = 20000.

A small real-data example

The example reads come from Zibin Zhao’s hydrocortisone DL-SELEX deposit, Zenodo 14272647, associated with Structure-enhanced Deep Learning Accelerates Aptamer Selection for Small Molecule Families like Steroids. The deposit contains paired sequencing of selection rounds 3, 5 and 7. We distribute only the first 600 complete R1 records from each of those rounds, preserving their sequences, read identifiers and quality strings. The files are separately compressed subsets, not copies of the entire original FASTQ files.

Taking the first records is deterministic, but is not random sampling of the selection pools. Such a small sample cannot establish binding affinity or the population’s enrichment trajectory. R2 reads are not included in this single-read example. Source attribution, the data license, original filenames, checksums and the subsetting method are recorded in REAL_DATA_PROVENANCE.md in the installed package.

rounds <- c(3L, 5L, 7L)
paths <- system.file(
    "extdata", sprintf("cs_round_%02d.fastq.gz", rounds),
    package = "selexprepR", mustWork = TRUE
)
names(paths) <- sprintf("round_%02d", rounds)
reads <- read_selexprep_fastq(paths[[1L]])
length(reads)
#> [1] 600
head(reads)
#> BStringSet object of length 6:
#>     width sequence                                          names               
#> [1]   150 CNAGAATGGAGAACGCAGCACAA...TCTTCTGCTTGAAAAGGGGGGGG C00114:80:HFHY5DS...
#> [2]   150 GNCTCTCGGGACGACGGGGATTT...TCTTCTGCTTGAAAAGGGGGGGG C00114:80:HFHY5DS...
#> [3]   150 CNTCGGCCTTGGCCAGGTCAAGC...TTTCATCGGTGATACCTCAAGGA C00114:80:HFHY5DS...
#> [4]   150 CNGAATGGAGAACGCAGCGCAGG...CTTCTGCTTGGAAAGGGGGGGGG C00114:80:HFHY5DS...
#> [5]   150 CNAGAATGGAGAACGCAGCACAG...TCTTCTGCTTGAAAAGGGGGGGG C00114:80:HFHY5DS...
#> [6]   150 ANCCTGTCGTACCTGGCCAACCA...GCATCATCGCCAAGACCGGTGCG C00114:80:HFHY5DS...

read_selexprep_fastq() accepts plain or compressed FASTQ and returns a Biostrings::BStringSet. This container preserves the input alphabet, including RNA U. This step does not filter by quality; the quality strings remain in the original FASTQ for a separate quality-filtering step.

The path-vector names supply the round numbers. Alternatively, use a table with explicit path, round_number and mate columns. The input bridge pools files belonging to the same round and mate and records their loaded read counts, file sizes and checksums.

inputs <- read_selexprep_inputs(paths)
inputs$files[, c("round_number", "mate", "reads_loaded", "sha256")]
#> DataFrame with 3 rows and 4 columns
#>   round_number        mate reads_loaded                 sha256
#>      <integer> <character>    <integer>            <character>
#> 1            3          R1          600 1a8725235b55866e40c1..
#> 2            5          R1          600 b93a365fd5cd4e52e331..
#> 3            7          R1          600 daa8f6e8f3d76392605b..
vapply(inputs$sequences_by_round, length, integer(1))
#> round_03 round_05 round_07 
#>      600      600      600

Inspect the library layout

Primer inference starts with the earliest supplied round and checks support across the remaining rounds. Here the earliest supplied sample is round 3; an unselected round 0 is not included. Run-specific outer tags may be removed while the inner 12 bases adjacent to the insert remain protected.

report <- selexprep_detect(inputs$sequences_by_round)
report[c(
    "status", "failure_reason", "primer_5p", "primer_3p", "extraction_mode"
)]
#> $status
#> [1] "UNABLE_TO_INFER"
#> 
#> $failure_reason
#> [1] "No candidate 5' or 3' flank found in the earliest round"
#> 
#> $primer_5p
#> NULL
#> 
#> $primer_3p
#> NULL
#> 
#> $extraction_mode
#> [1] "UNABLE_TO_EXTRACT"

Here the detector returns UNABLE_TO_INFER. Its failure_reason reports that no candidate 5’ or 3’ flank was found in the earliest round. The safe failure is useful information; it does not silently count untrimmed reads. When inference fails on your data, take the flanks from the library design or sequencing protocol and supply them as explicit primers, as shown below.

The article’s supplement, Table S8, marks the flanks of its aptamers in lowercase. These provide an external source for explicit primer overrides. We target the R1 orientation opposite to the aptamer sequences printed in that table, so we reverse-complement the two published flanks and exchange their sides:

published_5p <- "GGCTCTCGGGACGAC"
published_3p <- "CTGCGTTCTCCATTCTGG"
primer_5p <- reverse_complement(published_3p)
primer_3p <- reverse_complement(published_5p)

This is an explicit choice to demonstrate one orientation of the raw R1 pool: reads in the published orientation are present in similar numbers, so either choice would be possible here. This example counts only reads containing both primers in the chosen orientation; opposite-orientation reads and other unmatched reads remain excluded and are not added to the counts. The result is therefore a documented subset, not a count of every molecule in the deposit. The counted sequences are the reverse complement of the aptamers printed in Table S8; use reverse_complement(rownames(experiment)) to compare them with that table. Primers are located as cutadapt locates adapters: anywhere in a read, with up to 10% substitutions or indels, and possibly cut short at the read ends (see ?selexprep_extract). The retention and QC warnings below remain part of the interpretation. HIGH and MEDIUM in an inferred report would describe read support, not independent confirmation of a biological constant/random boundary. Review the published library design before interpreting a selected pool, especially when its early unselected round is unavailable.

Extract, count and inspect provenance

run_selexprep_files() runs detection, extraction, counting and QC from local FASTQ files. The same workflow accepts inputs through run_selexprep(inputs). The source deposit is paired-end. All bundled R1 reads are 150 nucleotides long, enough to cover the expected 72-nucleotide construct (two flanks and a 39-nucleotide variable region), so this example supplies R1 only. Consider the same when your R1 reads are long enough to contain both flanks. For paired inputs, specify both mates in every round. When the primers are split across mates, the trimmed sides remain separate and the experiment has no counted rows; run_selexprep_files() says so in a warning, and S4Vectors::metadata(experiment)$qc is NULL, so there is nothing to plot. In that case, merge the read pairs with an external tool and supply the merged FASTQ as one file per round.

experiment <- run_selexprep_files(
    paths, primer_5p = primer_5p, primer_3p = primer_3p,
    extraction_mode = "BOTH_PRIMERS_SINGLE_READ"
)
#> Warning: Extraction: 3 round(s) kept under half of their reads or under half
#> the best round's yield; the primers may not fit their reads (run-specific outer
#> sequence, a different construct or reads in the opposite orientation):
#> round_03: kept 228 of 600 reads (38.0%; best round 49.5%); round_05: kept 278
#> of 600 reads (46.3%; best round 49.5%); round_07: kept 297 of 600 reads (49.5%;
#> best round 49.5%)
#> Warning: Extraction: 3 input FASTQ(s) kept under half of their reads or under
#> half the best input's yield; the primers may not fit their reads (run-specific
#> outer sequence, a different construct or reads in the opposite orientation):
#> /tmp/RtmpY6ztF1/Rinstd1f7ae39b17/selexprepR/extdata/cs_round_03.fastq.gz: kept
#> 228 of 600 reads (38.0%; best input 49.5%);
#> /tmp/RtmpY6ztF1/Rinstd1f7ae39b17/selexprepR/extdata/cs_round_05.fastq.gz: kept
#> 278 of 600 reads (46.3%; best input 49.5%);
#> /tmp/RtmpY6ztF1/Rinstd1f7ae39b17/selexprepR/extdata/cs_round_07.fastq.gz: kept
#> 297 of 600 reads (49.5%; best input 49.5%)
experiment
#> class: SummarizedExperiment 
#> dim: 689 3 
#> metadata(8): accession schema_version ... counting_skipped input_files
#> assays(1): counts
#> rownames(689): AAACAGTCGATCGCTCCACTTAGTGCACTGAAAATCCCG
#>   AAAGTCCCGAGCGAGCCACGTAGTGCATGAAAAATCCAG ...
#>   TTTACCCGGAACGAGCCACATGGTGCACAAAAAATCCAC
#>   TTTGTCCCGATCGCGCCACCTTGTGCAAGAAAAATCCAG
#> rowData names(1): sequence
#> colnames(3): round_03 round_05 round_07
#> colData names(1): round
counts <- SummarizedExperiment::assay(experiment, "counts")
round_info <- SummarizedExperiment::colData(experiment)
stopifnot(identical(colnames(counts), rownames(round_info)))
data.frame(
    round = round_info$round,
    counted_reads = unname(Matrix::colSums(counts))
)
#>      round counted_reads
#> 1 round_03           228
#> 2 round_05           278
#> 3 round_07           297
head(SummarizedExperiment::rowData(experiment))
#> DataFrame with 6 rows and 1 column
#>                                                        sequence
#>                                                    <BStringSet>
#> AAACAGTCGATCGCTCCACTTAGTGCACTGAAAATCCCG AAACAGTCGA...GAAAATCCCG
#> AAAGTCCCGAGCGAGCCACGTAGTGCATGAAAAATCCAG AAAGTCCCGA...AAAAATCCAG
#> AACAACATGAACGAGCCACGTAGTGCAGGGAAAATCCAC AACAACATGA...GAAAATCCAC
#> AACATCCCGAACGAGCCACGTGGTGCAAAAAAATCCTG  AACATCCCGA...AAAAATCCTG
#> AACCCCGAGAGCGAACCACATAGTGCACATAAAATCCAC AACCCCGAGA...TAAAATCCAC
#> AACGTCCCGAACGCCCCACTTCGTGCAGAGAAAATCCCT AACGTCCCGA...GAAAATCCCT

Use counts and the aligned round_info as inputs for downstream work. The numeric round of each input file is recorded in the round_number column of S4Vectors::metadata(experiment)$input_files; the final section exports one count table per round. Before comparing rounds, check the round assignments against your study design, then review extraction yields and QC. The counts here cover the selected read orientation. A zero means a sequence was not observed among the retained reads for that round.

metadata <- S4Vectors::metadata(experiment)
metadata$extraction$input_reads
#> round_03 round_05 round_07 
#>      600      600      600
metadata$extraction$output_reads
#> round_03 round_05 round_07 
#>      228      278      297
metadata$extraction$input_yields
#> DataFrame with 3 rows and 7 columns
#>                     path round_number        mate run_accession input_reads
#>              <character>    <integer> <character>   <character>   <integer>
#> 1 /tmp/RtmpY6ztF1/Rins..            3          R1            NA         600
#> 2 /tmp/RtmpY6ztF1/Rins..            5          R1            NA         600
#> 3 /tmp/RtmpY6ztF1/Rins..            7          R1            NA         600
#>   output_reads fraction_kept
#>      <integer>     <numeric>
#> 1          228      0.380000
#> 2          278      0.463333
#> 3          297      0.495000
metadata$input_files[, c("round_number", "reads_loaded", "md5")]
#> DataFrame with 3 rows and 3 columns
#>   round_number reads_loaded                    md5
#>      <integer>    <integer>            <character>
#> 1            3          600 b8a6dd1f9a84f91729ba..
#> 2            5          600 1f9c351b3194295da47f..
#> 3            7          600 37515472f4c289e33ebf..
metadata$manifest$manifest_version
#> [1] "selexprep_manifest_v2"

Extraction warns when a round retains less than half its reads or less than half the best round’s retained fraction. Inspect low_yield_rounds and low_yield_inputs in the extraction metadata. File-level checks prevent pooling from hiding one poorly matching input. Retention measures extraction success; it does not assess affinity.

Counting both read orientations

A library prepared by ligation is sequenced from either end of each molecule, so about half of the reads are the reverse complement of the other half, as in this deposit. One run counts one orientation. To count both, run again with the primers of the opposite orientation, reverse-complement its sequences, and add the two tables:

opposite <- run_selexprep_files(
    paths,
    primer_5p = reverse_complement(primer_3p),
    primer_3p = reverse_complement(primer_5p),
    extraction_mode = "BOTH_PRIMERS_SINGLE_READ"
)
other <- SummarizedExperiment::assay(opposite, "counts")
rownames(other) <- reverse_complement(rownames(other))
sequences <- union(rownames(counts), rownames(other))
both <- Matrix::Matrix(
    0, length(sequences), ncol(counts),
    dimnames = list(sequences, colnames(counts)), sparse = TRUE
)
both[rownames(counts), ] <- counts
both[rownames(other), ] <- both[rownames(other), ] + other
rbind(
    chosen = Matrix::colSums(counts), opposite = Matrix::colSums(other),
    both = Matrix::colSums(both)
)
#>          round_03 round_05 round_07
#> chosen        228      278      297
#> opposite      216      291      277
#> both          444      569      574

The retention warnings of the second run are the same kind as those of the first and are not printed again.

Quality control and its plot

The QC report summarizes depth, diversity, sequence lengths, GC content and other diagnostics. We keep the default minimum read-depth threshold, so a low-depth flag is expected for this small example. Flags identify conditions to review; they do not automatically remove samples or reads.

qc <- metadata$qc
qc$per_round
#> DataFrame with 3 rows and 14 columns
#>         round   n_reads  n_unique shannon_entropy_bits rarefied_unique
#>   <character> <numeric> <integer>            <numeric>       <integer>
#> 1    round_03       228       208              7.65745             208
#> 2    round_05       278       244              7.85628             208
#> 3    round_07       297       247              7.84636             195
#>   singleton_fraction top_1_coverage top_100_coverage modal_sequence_length
#>            <numeric>      <numeric>        <numeric>             <numeric>
#> 1           0.903846     0.00877193         0.526316                    39
#> 2           0.885246     0.01438849         0.482014                    39
#> 3           0.842105     0.01346801         0.505051                    39
#>     mean_gc     gc_sd nonstandard_alphabet_fraction truseq_reads_fraction
#>   <numeric> <numeric>                     <numeric>             <numeric>
#> 1  0.533690 0.0462081                             0                     0
#> 2  0.536409 0.0432886                             0                     0
#> 3  0.542009 0.0419732                             0                     0
#>   top_kmer_fraction
#>           <numeric>
#> 1         0.0287806
#> 2         0.0286194
#> 3         0.0276817
qc$flags[, c("name", "severity")]
#> DataFrame with 4 rows and 2 columns
#>                     name    severity
#>              <character> <character>
#> 1        low_total_reads        warn
#> 2             strand_mix        warn
#> 3       low_primer_match        warn
#> 4 adapter_contaminatio..        warn

The evidence column holds the values behind each flag. In this example:

  • low_total_reads: every round has fewer than the default 10,000 reads.
  • strand_mix: more than 20% of the reads in each round start with the reverse complement of primer_3p, i.e. the opposite orientation.
  • low_primer_match: with supplied primers, the match rates are measured for those primers on the earliest round (reads containing the primer with at most one substitution). Here they are 0.39 for primer_5p and 0.38 for primer_3p, below the 0.40 threshold, because about half of the reads are in the other orientation.
  • adapter_contamination_high: 489 of the 600 raw reads used for detection contain the TruSeq read-1 adapter. This describes the raw reads; the truseq_reads_fraction of the extracted sequences above is 0.

Supply the experiment as the second argument to plot() so the plots can use extraction provenance and sequence-length distributions.

plot(qc, experiment, which = "retention", cex = 1.2)
Input and retained reads by round.

Input and retained reads by round.

Each round starts with 600 reads. The retained fraction ranges from about 38% to 50%. Extraction targets one orientation in a mixed input, and reads without both matching primers are excluded. On your data, inspect the primer sequences and read orientation if a round has unexpectedly low retention.

plot(qc, experiment, which = "length", cex = 1.2)
Read-weighted lengths of the extracted regions.

Read-weighted lengths of the extracted regions.

Each point shows the fraction of retained reads at an observed length in one round. All three rounds peak at 39 nucleotides (219/228, 258/278 and 270/297 reads). This agrees with the 39-nucleotide variable region reported for CS round 3 in Supplementary Note S8. A few reads extend past 100 nucleotides (2, 2 and 5 reads, respectively). The plot measures the sequences recovered between the chosen flanks. All nine sequences above 100 nucleotides contain a further copy of primer_5p, and eight contain the first 10 nucleotides of primer_3p; these are hints about their structure, not a determined origin. Each is counted as one sequence. Compare the peak with your library design and inspect the original reads and primer matches behind an unexpected tail before interpreting it.

plot(qc, experiment, which = "diversity", mfrow = c(3, 1), cex = 1.15,
    mar = c(5.3, 5.5, 2.5, 1), mgp = c(3.7, 0.7, 0))
Sequence diversity within each retained round.

Sequence diversity within each retained round.

The diversity panels show the number of distinct sequences, Shannon entropy and the fraction of reads contributed by the 100 most abundant sequences in each round. Compare them alongside read depth and retention when assessing how strongly a small set of sequences dominates a pool. In this example each round has only 208 to 247 distinct sequences among 228 to 297 reads, so the 100 most abundant sequences are already a large share of the distinct sequences observed. Read their coverage of about 0.48 to 0.53 in that context.

Inline-barcode demultiplexing

For an R1 stream containing rounds distinguished by inline barcodes, supply a barcode-to-round map to selexprep_demultiplex(). Barcodes must have enough pairwise Hamming distance for the allowed mismatches. They are never inferred. Paired mates, when supplied, follow their R1 assignments.

The deposited files are already separated by round. To demonstrate this step offline, we add artificial teaching barcodes to their real read sequences and append one deliberately unassignable read. These tags and the extra read are not part of the original experiment. Removing them must recover the three input pools exactly.

barcodes <- c(AAAAA = 3L, CCCCC = 5L, GGGGG = 7L)
tagged <- Map(function(pool, barcode) {
    paste0(barcode, as.character(pool))
}, inputs$sequences_by_round, names(barcodes))
multiplexed <- c(unlist(tagged, use.names = FALSE), "TTTTTACGT")
demultiplexed <- selexprep_demultiplex(multiplexed, barcodes)
demultiplexed$summary
#> DataFrame with 3 rows and 4 columns
#>         round round_number assigned_reads assigned_fraction
#>   <character>    <integer>      <integer>         <numeric>
#> 1    round_03            3            600          0.333148
#> 2    round_05            5            600          0.333148
#> 3    round_07            7            600          0.333148
length(demultiplexed$unassigned$r1)
#> [1] 1

sequences_only <- function(pools) {
    lapply(pools, function(pool) unname(as.character(pool)))
}
stopifnot(identical(
    sequences_only(demultiplexed$sequences_by_round),
    sequences_only(inputs$sequences_by_round)
))
demultiplexed_experiment <- run_selexprep(
    demultiplexed, primer_5p = primer_5p, primer_3p = primer_3p,
    extraction_mode = "BOTH_PRIMERS_SINGLE_READ"
)
#> Warning: Extraction: 3 round(s) kept under half of their reads or under half
#> the best round's yield; the primers may not fit their reads (run-specific outer
#> sequence, a different construct or reads in the opposite orientation):
#> round_03: kept 228 of 600 reads (38.0%; best round 49.5%); round_05: kept 278
#> of 600 reads (46.3%; best round 49.5%); round_07: kept 297 of 600 reads (49.5%;
#> best round 49.5%)
stopifnot(identical(
    SummarizedExperiment::assay(demultiplexed_experiment, "counts"), counts
))

Save decisions and discover a full study

Save library reports and manifests as JSON alongside downstream results. This example writes them to a temporary directory.

outdir <- tempfile("selexprep_example_")
dir.create(outdir)
write_library_report(metadata$library_report,
    file.path(outdir, "library_report.json"))
write_selexprep_manifest(metadata$manifest,
    file.path(outdir, "selexprep_manifest.json"))
list.files(outdir)
#> [1] "library_report.json"     "selexprep_manifest.json"

Count tables use a stable four-column format (sequence, reads, rank, rpm) and can be written as TSV, CSV, RDS or Parquet. Here we build one table per round from the extracted sequences, check that it matches the count matrix, and write it with its round number in the file name.

round_numbers <- sort(unique(metadata$input_files$round_number))
round_numbers
#> [1] 3 5 7
count_tables <- lapply(metadata$extraction$sequences_by_round, selexprep_count)
stopifnot(identical(
    vapply(count_tables, function(table) sum(table$reads), numeric(1)),
    Matrix::colSums(counts)
))
for (round in names(count_tables)) {
    write_selexprep_counts(count_tables[[round]],
        file.path(outdir, paste0(round, "_counts.tsv")))
}
list.files(outdir)
#> [1] "library_report.json"     "round_03_counts.tsv"    
#> [3] "round_05_counts.tsv"     "round_07_counts.tsv"    
#> [5] "selexprep_manifest.json"
head(read_selexprep_counts(file.path(outdir, "round_03_counts.tsv")), 3)
#> DataFrame with 3 rows and 4 columns
#>                  sequence     reads      rank       rpm
#>              <BStringSet> <numeric> <integer> <numeric>
#> 1 AAAGTCCCGA...AAAAATCCAG         2         1   8771.93
#> 2 ACCAATCGGA...AAAAATCCAC         2         2   8771.93
#> 3 CAACAGACGA...TAAAATCCGT         2         3   8771.93

The bundled catalog is a frozen, offline discovery snapshot from Python selexprep v0.4.6. It contains 240 records with per-field curation status. A discovery entry is not a guarantee of read availability or complete experimental annotation.

selexprep_catalog("hydrocortisone")
#> DataFrame with 2 rows and 19 columns
#>     bioproject_id          source            study_title        study_type
#>       <character>     <character>            <character>       <character>
#> 1 zenodo:14272347 zenodo:14272347 Structure-enhanced D.. aptamer_selection
#> 2 zenodo:14272647 zenodo:14272647 Structure-enhanced D.. aptamer_selection
#>   study_type_curation                 target target_curation
#>           <character>            <character>     <character>
#> 1          concordant hydrocortisone (cort..      concordant
#> 2          concordant hydrocortisone (cort..      concordant
#>             target_class target_class_curation   chemistry   chemistry_curation
#>              <character>           <character> <character>          <character>
#> 1 small molecule (ster..            concordant       ssDNA single_source:claude
#> 2 small molecule (ster..            concordant       ssDNA single_source:claude
#>                 n_random    n_random_curation               n_rounds
#>              <character>          <character>            <character>
#> 1 N12 or N8 (loop with.. single_source:claude               8 rounds
#> 2                     NA           not_stated rounds 3, 5, and 7 (..
#>   n_rounds_curation       selection_format selection_format_curation
#>         <character>            <character>               <character>
#> 1        concordant SELEX (DL-SELEX, sim..                concordant
#> 2        concordant DL-SELEX (AptaVAE-gu..                concordant
#>   counter_selection counter_selection_curation
#>         <character>                <character>
#> 1           present       single_source:claude
#> 2           present       single_source:claude
data("selexprep_public_catalog", package = "selexprepR")
S4Vectors::metadata(selexprep_public_catalog)$snapshot_version
#> [1] "selexprep-v0.4.6"

For ENA studies, inspect current metadata with inspect_selexprep_accession("PRJDB19098"), then review the dry-run plan from fetch_selexprep_reads(inspection, outdir) before requesting a download with dry_run = FALSE. These network operations are described here rather than executed during vignette builds: they depend on a live external archive and the complete FASTQ files can be large. ENA inspection uses sample attributes and text metadata for round inference. Ambiguous or conflicting assignments need review, and multiple BioSamples assigned to one round should be checked before merging lanes, replicates or parallel selections.

Session information

sessionInfo()
#> R version 4.6.2 (2026-10-29)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 26.04.1 LTS
#> 
#> Matrix products: default
#> BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3 
#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.32.so;  LAPACK version 3.12.0
#> 
#> locale:
#>  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
#>  [3] LC_TIME=en_US.UTF-8        LC_COLLATE=en_US.UTF-8    
#>  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8   
#>  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C                 
#>  [9] LC_ADDRESS=C               LC_TELEPHONE=C            
#> [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C       
#> 
#> time zone: Etc/UTC
#> tzcode source: system (glibc)
#> 
#> attached base packages:
#> [1] stats     graphics  grDevices utils     datasets  methods   base     
#> 
#> other attached packages:
#> [1] selexprepR_0.99.9 BiocStyle_2.41.0 
#> 
#> loaded via a namespace (and not attached):
#>  [1] Matrix_1.7-6                jsonlite_2.0.0             
#>  [3] compiler_4.6.2              BiocManager_1.30.27        
#>  [5] crayon_1.5.3                SummarizedExperiment_1.43.0
#>  [7] Biobase_2.73.2              GenomicRanges_1.65.4       
#>  [9] Biostrings_2.81.9           jquerylib_0.1.4            
#> [11] IRanges_2.47.5              Seqinfo_1.3.2              
#> [13] yaml_2.3.12                 fastmap_1.2.0              
#> [15] lattice_0.23-1              R6_2.6.1                   
#> [17] XVector_0.53.0              S4Arrays_1.13.3            
#> [19] generics_0.1.4              knitr_1.52                 
#> [21] BiocGenerics_0.59.13        DelayedArray_0.39.8        
#> [23] MatrixGenerics_1.25.0       maketools_1.3.2            
#> [25] bslib_0.12.0                rlang_1.3.0                
#> [27] cachem_1.1.0                xfun_0.62                  
#> [29] sass_0.5.0                  sys_3.4.3                  
#> [31] otel_0.3.0                  SparseArray_1.13.5         
#> [33] cli_3.6.6                   withr_3.0.3                
#> [35] digest_0.6.39               grid_4.6.2                 
#> [37] lifecycle_1.0.5             S4Vectors_0.51.10          
#> [39] evaluate_1.0.5              buildtools_1.0.0           
#> [41] abind_1.4-8                 stats4_4.6.2               
#> [43] rmarkdown_2.32              matrixStats_1.5.0          
#> [45] tools_4.6.2                 htmltools_0.5.9