MPRAlib is a Python library and CLI for processing MPRA (Massively Parallel Reporter Assay) data.
Count exports preserve floating-point counts using 17 significant digits, including normalized counts and REF/ALT aggregates. Integer raw-count exports retain integer formatting. This avoids rounding small fractional counts to zero or changing predicted counts before downstream barcode-level analysis.
If you use MPRAlib in your work, please cite:
Rosen JD, Vasanthakumari AD, Salomon K, de Lange N, Dash PM, Keukeleire P, Hassan A, Barrera A, Krupkin B, Oualline G, Kircher M, Love MI, Schubach M. Uniform processing and analysis of IGVF massively parallel reporter assay data with MPRAsnakeflow. Genome Research (2025). doi: 10.1101/gr.281462.125
pip install mpralibFrom the bioconda channel
conda install -c bioconda mpralibUse the mpralib command to access various functionalities.
MPRAlib provides a CLI tool for validating MPRA data files against supported schemas.
mpralib validate-file <schema> --input <input_file><schema>: One ofreporter-sequence-design,reporter-barcode-to-element-mapping,reporter-experiment-barcode,reporter-experiment,reporter-element,reporter-variant,reporter-genomic-element,reporter-genomic-variant<input_file>: Path to your data file (e.g.,.tsv.gz,.bed.gz)
Example:
mpralib validate-file reporter-sequence-design --input data/reporter_sequence_design.example.tsv.gzIn general MPRAlib is ment to be used as a library. Please have a look at our notebook mpralib.ipynb for a more detailed example.
MIT License