Skip to content
JeanWen-LabPublic

About

RNPLens: Reproducible evaluation and reference-free comparison of predicted protein–RNA complexes.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

RNPLens logo

RNPLens

Reproducible assessment of predicted protein–RNA complexes: interface accuracy against experiment, and agreement among predictions when no experimental structure exists.

Python 3.10–3.12 Licence: MIT Release 0.4.1

Overview

Structure-prediction engines such as AlphaFold 3, Boltz-2, Chai-1 and the RoseTTAFold family now produce protein–RNA complexes routinely. Deciding what those models actually support is harder. RNPLens evaluates and interprets existing predictions in two ways:

  • With an experimental structure, it measures interface accuracy (DockQ, fnat, iRMSD, LRMSD) under an explicit, construct-position residue correspondence.
  • Without one, it measures how closely several predictions agree on the protein binding surface, the exact residue–nucleotide contacts and the RNA pose, and groups them into interface hypotheses.

Every result is machine-readable and records the SHA-256 of its inputs, and the bundled data reproduce the reference values. RNPLens is intended for structural and RNA biologists comparing predicted complexes, for developers benchmarking prediction engines, and for anyone who needs a documented record of what a set of predictions does and does not support.

RNPLens does not predict structures, does not choose a "best" model, and gives no calibrated probability that a structure or an interface is correct. Agreement among predictions is descriptive: engines can agree and still be wrong.

Features

Capability What it provides
Evaluate Reference-based interface accuracy (DockQ, DockQ class, fnat, iRMSD, LRMSD) under an explicit construct-position residue correspondence, over all admissible chain mappings
Report Reference-free agreement among predictions of one complex: binding surfaces, residue–nucleotide contacts and RNA poses, with engines grouped into interface hypotheses (descriptive, not a probability)
Structure viewer rnplens view: an offline Mol* page that highlights Report's contacts, with a nucleotide contact explorer
Analysis workflows import, analyse and compare engine output folders; contacts in an RNA region; binding-proposal grouping (never an accuracy selector); evidence lookup and Methods export
RNPLens Assistant (optional) An experimental natural-language interface that plans RNPLens tool calls (below)

What each capability does and does not establish is set out in docs/capabilities.md.

Installation and quick start

Requirements: CPython 3.10, 3.11 or 3.12 on Linux x86-64 or macOS arm64; no GPU. RNPLens is not yet on PyPI and is installed from this repository:

git clone https://github.com/JeanWen-Lab/RNPLens.git
cd RNPLens
python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[html]"
rnplens selftest          # checks the installation against the bundled reference values; prints PASS

Worked example. Score the bundled Boltz-2 prediction of PDB 7K9D against the deposited structure:

cd examples/reference_based
rnplens evaluate run --input example_input.json --out ../../out_evaluate_7K9D
cat ../../out_evaluate_7K9D/summary.txt
DockQ (frozen RNPLens scoring configuration, construct-position correspondence)
  DockQ 0.936  [high]   fnat 0.927   iRMSD 0.434 A   LRMSD 1.780 A
  chain mapping AB:AB (best of 1 admissible); residue pairs in frame 148, out of frame 0, indeterminate 0

bash examples/run_examples.sh OUT runs this example and the reference-free one in a single step. The quick start explains every output field and lists the expected values.

Example outputs

Report: agreement between two Boltz-2 runs of 7K9D Viewer: nucleotide contact explorer (Boltz-2 prediction of PDB 2JEA)
RNPLens Report page RNPLens viewer

Both images are genuine RNPLens 0.4 outputs, cropped but otherwise unedited; their provenance is in docs/images/README.md.

Documentation

Topic Pages
Getting started Which analysis should I use? · Installation (Linux, macOS) · Quick start
Reference-based evaluation Evaluate · Input contract · Output formats
Reference-free analysis Report · Engine-folder workflow · RNA regions · Grouping · Evidence and Methods export
Viewer Viewer guide · Question menu and viewer commands
Assistant Assistant README · Setup and privacy · Model use and privacy · Platforms
Interpreting results Interpretation · Limitations · Capabilities
Reproducibility and provenance Reproducibility · Software versus study · Example data provenance · Dependencies · Release status · Code availability

The full index, including development and qualification records, is in docs/README.md.

RNPLens Assistant

RNPLens Assistant is an optional AI-assisted interface (python -m pip install -e ./assistant). It plans supported structural analyses, checks each execution plan deterministically, writes evidence-linked answers and replays recorded workflows. Every capability above works without it and without any language model. The current release includes automated software tests; live model operation and native security qualification remain under evaluation.

Its model-dependent operation is therefore experimental research functionality. A question sent to a hosted model leaves your computer.

Read the Assistant README and Setup and privacy before using it.

Scope of this release

RNPLens v0.4.1 supports reference-based interface evaluation and reference-free structural comparison. Four-axis geometry assessment and Diagnose are not available in this release; their scientific qualification is ongoing. See Limitations for details.

Citation

If you use RNPLens, please cite this software release; its metadata are in CITATION.cff. A citation for the accompanying article will be added when it is published. No DOI has yet been issued for the software.

Licence and data terms

MIT License — Copyright © 2026 The RNPLens authors. The licence covers the RNPLens source code: the core toolkit and the optional Assistant (LICENSE, assistant/LICENSE).

Research data and third-party components keep their own terms, which are recorded in NOTICE and examples/DATA_PROVENANCE.tsv:

  • The bundled experimental structures are wwPDB entries (CC0 1.0).
  • The bundled predictions were generated by the authors with Boltz-2 (MIT); please cite Boltz-2 when reusing them.
  • The vendored Mol* viewer keeps its MIT notices.
  • Runtime dependencies keep their licences (docs/dependencies.md).

The MIT licence does not extend to third-party datasets or to the outputs of other prediction engines. The study's benchmark dataset is not part of this repository.

Contributions: CONTRIBUTING.md. Security issues: SECURITY.md.

About

RNPLens: Reproducible evaluation and reference-free comparison of predicted protein–RNA complexes.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages