Skip to content

Add current RamplotR preprint draft - #20

Open
CedricHermansBIT wants to merge 2 commits into
mainfrom
arxiv-preprint
Open

CedricHermansBIT wants to merge 2 commits into
mainfrom
arxiv-preprint

Conversation

@CedricHermansBIT

@CedricHermansBIT CedricHermansBIT commented Oct 5, 2026 •

Copy link
Copy Markdown
Member

Adds the RamplotR manuscript as a clean paper-only branch rebased onto current main.

The draft is synchronized to software revision 6d1e4e95cdf5df4ae63bdbeccb4a6eeb7af41a1a and describes the current tool rather than older/legacy calculations.

Current scientific/software scope in the manuscript:

  • native RamplotR density exploration kept separate from six-class Rama8000 standard validation;
  • direct validation of 3,718/3,718 backbone angle pairs and 3,718/3,718 Rama8000 categories against the pinned wwPDB corpus;
  • linked residue-centred Ramachandran/sequence/table/3D inspection;
  • prediction confidence for AlphaFold 2/ColabFold, AlphaFold 3 and ESMFold;
  • Conformational Change Explorer with sequence identity/coverage, wrapped delta-phi/delta-psi, paired pLDDT/delta-pLDDT where available, local hetero-residue context and linked dual-3D inspection;
  • multi-file and AlphaFold 3 prediction ensembles with residue-level disagreement linked back to the shared inspector;
  • group-level conformational comparison;
  • discovery of candidate experimental PDB counterparts for predicted models;
  • optional official wwPDB validation XML as independent evidence;
  • batch/reporting and Shinylive/browser deployment.

The paper explicitly positions RamplotR as a focused backbone-conformation workbench rather than a replacement for MolProbity/Phenix/Coot/PDBe or other comprehensive validation/model-building environments.

Only three files differ from current main: paper/main.tex, paper/references.bib, and paper/README.md.

Before submission: review authors/contributions, add funding/acknowledgements, choose a publication release/tag and immutable archive/DOI, and consider whether to expand the five-structure functional validation set or add a dedicated comparison/ensemble workflow figure.

Copilot AI balanced review requested due to automatic review settings October 5, 2026 15:34

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Two manuscript claims about insertion-code handling and ambiguous wwPDB alternates contradict the implementation.

Review effort: Balanced
Findings: 2 Medium severity

Open (2)
What changed in this PR

Adds a software-paper draft documenting RamplotR’s functionality, validation evidence, limitations, and reproducibility.

Changes:

  • Adds the LaTeX manuscript and bibliography.
  • Documents scope, build steps, and pre-submission tasks.
  • Reports Bio3D, wwPDB, and pilot scaling results.
File Description
paper/​main.tex Adds the manuscript.
paper/​references.bib Adds cited references.
paper/​README.md Documents scope, build, and submission preparation.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread paper/main.tex Outdated

\subsection{Independent wwPDB evidence}

For a deposited experimental structure, users can optionally attach the official wwPDB validation XML or compressed XML for the same entry and structural model \citep{Gore2017}. XML support is optional and requires the R package \texttt{xml2}. The parser reads residue records with explicit model, chain, residue number, insertion code, residue name and alternate-conformation information. Unlabelled alternates are preferred over alternate A, and ambiguous identities are not silently assigned.
Comment thread paper/main.tex Outdated

\subsection{Numerical cross-check against Bio3D}

Two real structures were used to cross-check the custom backbone implementation against Bio3D torsion calculations \citep{Grant2006}: the 46-residue crambin structure 1CRN and the SARS-CoV-2 spike structure 6VXX. Residue identifiers were normalized only for surrounding whitespace; insertion-code distinctions were retained and duplicate keys were rejected. Coverage was calculated over \ramplotr-eligible residues and finite angles, rather than every row returned by Bio3D.
@CedricHermansBIT CedricHermansBIT changed the title Add RamplotR preprint draft Add publication-style RamplotR preprint draft Oct 6, 2026
@CedricHermansBIT CedricHermansBIT changed the title Add publication-style RamplotR preprint draft Add current RamplotR preprint draft Oct 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants