Expand description
Real-time PCR (qPCR) readers: RDML (the open interchange format, read and written),
Applied Biosystems / Thermo Fisher .eds experiment documents (QuantStudio, ViiA 7,
StepOne, 7500), Qiagen Rotor-Gene .rex, Roche LightCycler 480 .ixo (and LightCycler 96
.lc96p, an RDML zip with the vendor’s analysis), and the results exports of Applied
Biosystems and Bio-Rad CFX software; Bio-Rad CFX .pcrd is detected and refused (it is
encrypted).
Every file becomes the same normalized model (docs/formats/qpcr.md): plate runs of
reactions (wells), each with the targets measured in it, the vendor-computed result (Cq,
threshold, baseline window, Tm, amplification status), the amplification curve (raw and
baseline-corrected fluorescence per cycle) and the melt curve. A dataset exposes:
- table 0
results: one row per well × target (well, row, col, cq, target, sample, dye, task, quantity, …); - table 1
amplificationand table 2melt: the curves in long form; - traces: per run and dye, the amplification curves (raw and baseline-corrected), melt curves and their −dF/dT, one channel per well;
qpcr_report: named records and the analyses (our own Cq, ΔΔCq, standard curves).
export_rdml writes any readable file as RDML 1.3 and verifies it by reading it back.
§Example
use openreadout_core::FormatReader;
use openreadout_qpcr::{EdsReader, RdmlReader};
for r in [RdmlReader.descriptor(), EdsReader.descriptor()] {
println!("{} ({}): .{}", r.name, r.id, r.extensions.join(", ."));
}Structs§
- CqComparison
- Our Cq against the vendor’s, over every curve with a vendor result.
- CqCounts
- Cq statuses of a set of records.
- EdsReader
- Applied Biosystems / Thermo Fisher experiment documents (
.eds). - Export
Reader - Results exports of qPCR software: an Applied Biosystems
Resultstable (StepOne, 7500, QuantStudio, ViiA 7 software;.xls,.xlsx, text) or a Bio-Rad CFXQuantification Cq Resultstable (.csv,.txt,.xlsx). - IxoReader
- Roche LightCycler 480 experiment files (
.ixo, an XML object stream). - Pcrd
Reader - Bio-Rad CFX Maestro data files (
.pcrd): recognised and refused (encrypted container). - Qpcr
Assay Record - One well × target, with names resolved.
- Qpcr
Dataset - An opened qPCR file (RDML,
.eds,.rex). - Qpcr
Report - Output of
qpcr_report. - Qpcr
Report Request - What
qpcr_reportreturns: filters, and which analyses to run. - Rdml
Export Report - What
export --format rdmlwrote. - Rdml
Reader - RDML (Real-time PCR Data Markup Language) 1.0-1.4, zipped (
.rdml,.rdm) or bare XML. - Relative
Quantity - ΔΔCq relative quantification of one sample × target.
- RexReader
- Qiagen Rotor-Gene Q / 6000 run files (
.rex, XML). - Standard
Curve Fit - A standard curve fitted to the standard wells of one target.
- Target
CqSummary - Per-target Cq summary over the records that match the filters.
Enums§
- CqMethod
- How our Cq is computed (none of the methods reads the vendor’s Cq or call).
Constants§
- CQ_
DETERMINED cq_statusvalues: the vendor gave a Cq.- CQ_
NO_ RESULT cq_statusvalues: the file holds no result for this well × target (not analysed, setup only).- CQ_
STATUSES - Categories of the
cq_statuscolumn (codes 0, 1, 2). - CQ_
UNDETERMINED cq_statusvalues: the vendor (or our analysis) found no amplification (“Undetermined”, RDML-1,NaN, or an SDS/7500Ctequal to the cycle count).- EDS_
FORMAT_ ID - Format id of Applied Biosystems
.edsexperiment documents. - EXPORT_
FORMAT_ ID - Format id of qPCR results exports (Applied Biosystems
Resultstables, Bio-Rad CFXQuantification Cq Results). - IXO_
FORMAT_ ID - Format id of Roche LightCycler 480
.ixoexperiment files. - PCRD_
FORMAT_ ID - Format id of Bio-Rad CFX
.pcrdfiles (detected, not read). - RDML_
FORMAT_ ID - Format id of RDML files.
- RDML_
WRITE_ VERSION - Version of RDML written.
- RESULT_
COLUMNS - Columns of table 0 (
results), in order: one row per well × target. - REX_
FORMAT_ ID - Format id of Qiagen Rotor-Gene
.rexfiles.
Functions§
- default_
rdml_ output - Default output path: the input with
.rdml(name.eds→name.rdml; an.rdmlinput getsname.export.rdml). - export_
rdml - Write
dsas RDML 1.3 tooutput; the file is verified by reading it back before it is renamed into place.overwritereplaces an existing output. - open_
qpcr - Open a qPCR file through a registry: detection decides, so a
.pcrdgets its own refusal (exit 6 with a hint) and a file of another format says whatanalyze qpcrreads. - qpcr_
report - Records, analyses and notes for one opened file.