review.md
48 lines · skills/datamol/references/review.md at 5f2bc03
Review provenance — September 30, 2026
Target: Datamol 0.13.0 / RDKit 2026.03.6, Python 3.13 on macOS. This skill uses a local Python API; it specifies no hosted molecular-service REST endpoints. S3/GCS/HTTPS examples are provider-dependent paths, not verified live access or write operations.
Raw lines 1 to 6Primary sources checked
- PyPI release metadata and artifacts: release September 9, 2026, Python >=3.11. Runtime includes cloud/viz/Excel/SELFIES dependencies.
- Official release and upgrade guide: supported stack, heterocycles descriptor-key spelling, symmetry-aware RMS, binary/JSON interchange.
- Release source tree: checked installed wheel source against signatures/behavior rather than relying on stale prose/type hints (notably reaction return shapes and MMPA fragment strings).
- Molecule API, conversions, fingerprints, similarity, and clustering.
- I/O, descriptors, visualization, and conformers.
- Scaffolds, fragments, reactions, and bundled data.
Runtime scope
The repository's Datamol suite executes the local reference examples and checks parsed failure retention, source-ID/selection correspondence, binary and JSON round trips, descriptor definitions, fingerprint and distance shapes, selection/cluster return contracts, Murcko frameworks, labelled BRICS fragments, MMPA pairs, fuzzy-scaffold DataFrames, reaction product groups, and the full small bundled solubility example. It verifies SDF/SMI/MOL/MOL2/PDB/CSV/Excel/Parquet/JSON paths, genuine PNG/SVG encodings, finite conformer coordinates/energies, RMS cutoff, SASA, and conformer-ID/energy correspondence after selection. Two-worker batches were also exercised. Parallel descriptor batching requires an explicit positive batch_size on this stack; the default None raises in joblib.
The toy regression is an API check, not a validated benchmark. Finite conformer energy is not proof of minimization convergence or population weighting. Notebook widget construction was exercised; interactive browser rendering was not. Remote authentication, cloud writes, Windows FreeSASA, other Python/RDKit combinations and large-library scaling were not tested. Datamol explicitly disables its SASA wrapper on Windows. Source files and original molecular records remain necessary because a parsed table cannot recover text from invalid source records.
Raw lines 31 to 48