Skip to content

Releases

CHEMVAULT v0.14.8

Choose a tag to compare

@NanoBiostructuresRG NanoBiostructuresRG released this 27 Oct 18:22
56120b4

CHEMVAULT v0.14.8

This release improves bioactivity dataset curation, MODELABILITY INDEX reporting, application usability, and scientific documentation.

Added

  • Added a Murcko relationships CSV export based on the selected nearest-neighbor assignments, preserving scaffold relationships and analysis provenance.
  • Added official CHEMVAULT SVG branding.
  • Added a Modelability Index application screenshot and a scientific workflow illustration to the documentation.

Changed

  • Organized the four MODELABILITY INDEX downloads into a two-column layout.
  • Displayed MODELABILITY INDEX metrics to four decimal places without reducing exported numerical precision.
  • Reorganized the application into independent cards for Structured Quantitative Activity, Activity Labels Summary, and Modelability Index Result.
  • Improved the presentation of database controls, structured activity summaries, and scientific results.
  • Updated the README, MkDocs overview, usage guide, and API reference.
  • Updated package and citation metadata for v0.14.8.

Fixed

  • Corrected stale stereochemical annotations in generated Bemis–Murcko scaffolds.
  • Preserved literal CSV values, including NULL strings, during import.
  • Resolved an Arrow serialization warning in MODELABILITY INDEX details.
  • Updated CI packaging checks for the SVG branding assets.

Validation

  • Complete test suite: 799 passed.
  • Ruff and mypy checks passed.
  • GitHub Actions CI and Docs passed on main.

Installation

Requires Python 3.12.

python -m pip install --upgrade chemvault
chemvault

Documentation: https://nanobiostructuresrg-lab.github.io/chemvault/

CHEMVAULT v0.14.7

Choose a tag to compare

@NanoBiostructuresRG NanoBiostructuresRG released this 14 Oct 21:23
81bc791

CHEMVAULT v0.14.7

This release introduces Python packaging, a command-line launcher, public documentation, and automated release infrastructure. It also improves provenance presentation, refines application terminology, and removes obsolete components.

Added

  • Added Python 3.12 packaging with Hatchling, supporting wheel and source distributions.
  • Added the chemvault command-line launcher with --help and --version options.
  • Added an AID-level source-correspondence summary to Operation history, displaying the completeness status of persisted PubChem protein-search datasets.
  • Added an About sidebar card with application version information and repository access.
  • Added a MkDocs Material documentation site covering project information, usage, API reference, and changelog.
  • Added GitHub Actions workflows for continuous integration, GitHub Pages deployment, and PyPI Trusted Publishing.
  • Added contributor guidelines, a community code of conduct, and standardized citation metadata through CITATION.cff.

Changed

  • Consolidated project metadata, runtime dependencies, and development-tool configuration in pyproject.toml.
  • Introduced Ruff and mypy checks with corresponding code-quality and typing improvements.
  • Relocated the HARMONSMILE ingestion adapter to the services layer.
  • Updated application identity and scientific terminology.
  • Updated installation instructions for Python package distribution and source development.
  • Relocated application assets to support installed distributions.

Fixed

  • Clarified UI terminology for PubChem datasets, structured quantitative activity, molecular structure processing, and source provenance.
  • Corrected PubChem worker database path resolution for execution outside the source repository.
  • Improved command-line launcher interruption handling.
  • Replaced deprecated Streamlit width arguments.

Removed

  • Removed the obsolete CHAMANP integration and associated components.
  • Removed unused compatibility adapters and legacy database-audit utilities.
  • Removed obsolete experimental scripts, fixtures, and historical reports.
  • Replaced standalone dependency and pytest configuration files with pyproject.toml.

Validation

  • Passed 745 local automated tests.
  • Passed Ruff, mypy, and dependency consistency checks.
  • Validated wheel and source distributions, including isolated installation smoke tests and Twine checks.
  • Passed GitHub Actions CI on the release merge commit 81bc791.
  • Successfully built and deployed the MkDocs documentation through GitHub Actions.

CHEMVAULT v0.14.6

CHEMVAULT v0.14.6 Pre-release
Pre-release

Choose a tag to compare

@NanoBiostructuresRG NanoBiostructuresRG released this 25 Sep 00:11
8614614

CHEMVAULT v0.14.6

Added

  • Added AID-level source correspondence and completeness certification for
    PubChem protein-search builds, using persisted (protein, AID) identities
    from the source enumeration observed in the same execution.
  • Added an explicit completeness contract that distinguishes terminal AIDs,
    row-level target exclusions, unresolved source AIDs, missing materialization,
    and unexpected persisted identities.
  • Added a summarized AID-completeness projection to Operation history while
    retaining the detailed identity-level evidence in the originating job
    metadata.

Changed

  • Persisted the PubChem source AID enumeration before downstream reduction and
    treated that persisted enumeration as the immutable denominator for later
    completeness assessment.
  • Finalized AID completeness only after compound_assays materialization was
    committed, requiring persisted (protein, AID) identities to correspond to
    the terminal identities derived from the same run.
  • Preserved distinct AID-to-CID acquisition outcomes for successful,
    failed, invalid, and missing responses, including successful responses with
    an explicit empty CID list.
  • Restricted structured-activity retrieval to AIDs with successful, non-empty
    AID-to-CID acquisition; upstream unresolved AIDs are recorded as
    not_attempted for downstream activity retrieval.

Fixed

  • Prevented downstream state or previously persisted assay associations from
    being used to reconstruct a missing or invalid source AID denominator.
  • Prevented unresolved AID acquisition states from being interpreted as valid
    target-level exclusions or silently contributing to a complete population.
  • Prevented stale or unexpected (protein, AID) associations in
    compound_assays from satisfying the current-run completeness contract.

Validation

  • Passed the complete test suite: 714 tests.
  • Confirmed git diff --check reports no whitespace errors.
  • Reconstructed the MC4R / P32245 PubChem protein-search population from a
    same-run source enumeration of 652 AIDs: 650 reached terminal persisted
    representation and 2 remained unresolved.
  • Confirmed that AIDs 540307 and 540319 were returned by the PubChem
    AID-to-CID batch response without a CID field and therefore remained
    unresolved rather than being converted to terminal or target-excluded
    identities; the resulting population was correctly not certified complete.
  • The completeness contract applies only to the PubChem protein-search
    (protein, AID) population observed in that execution. It does not certify
    completeness of source rows, individual CIDs, structured activity records,
    molecular properties, or other downstream content.

CHEMVAULT v0.14.5

CHEMVAULT v0.14.5 Pre-release
Pre-release

Choose a tag to compare

@NanoBiostructuresRG NanoBiostructuresRG released this 24 Sep 16:26

CHEMVAULT v0.14.5

This pre-release corrects PubChem target attribution and molecular acquisition
cache semantics identified during the scientific audit of target-centered
datasets.

Changed

  • Updated HARMONSMILE to version 0.3.4 and adopted explicit PubChem
    acquisition provenance independently of molecular harmonization status.
  • Legacy HARMONSMILE cache records without explicit acquisition provenance are
    no longer assumed to represent successful PubChem acquisition and are
    eligible for reacquisition.
  • Applied row-level PubChem target-accession evidence when available to scope
    target-specific compound-assay associations and structured activity records.

Fixed

  • Prevented PubChem assay rows belonging to other target accessions from being
    attributed to the requested biological target when row-level target evidence
    is available.
  • Prevented failed PubChem molecular acquisitions returned as HARMONSMILE rows
    from being cached as reusable successful acquisitions.
  • Preserved the distinction between PubChem acquisition outcome and subsequent
    molecular harmonization outcome.

Validation

  • Complete test suite: 695 passed
  • git diff --check: clean
  • Q01959 / AID 2060761 target-attribution validation:
    • 1,503 scientific source rows
    • 33 matching target-specific activity records
    • 32 target CIDs
    • 1,470 nonmatching rows
    • 0 unattributed rows
  • Historical MC4R acquisition-recovery validation:
    • 7/7 CIDs reacquired successfully
    • 7/7 with explicit PubChem_Acquisition_Status = ok
    • 13/13 corresponding activity_subset_Ki rows updated with corrected
      acquisition provenance
  • Acquisition and harmonization remained independent:
    • 5/7 recovered compounds subsequently reached MaxTautomersReached
    • 2/7 completed harmonization successfully

CHEMVAULT v0.14.4

CHEMVAULT v0.14.4 Pre-release
Pre-release

Choose a tag to compare

@NanoBiostructuresRG NanoBiostructuresRG released this 21 Sep 19:42
da27f9b

CHEMVAULT v0.14.4

This pre-release hardens the PubChem structured activity repair workflow for
existing target-based CHEMVAULT databases.

Added

  • Paginated PubChem assay-activity retrieval for large assays using
    ListKey-based SID pagination.
  • Persisted provenance for Repair activity records, including processed,
    successful, and failed AIDs, failure diagnostics, inserted-row counts,
    retrieval context, and execution parameters.

Changed

  • Optimized reconstruction of activity-repair jobs by streaming
    compound_assays and using set-backed CID deduplication.
  • Applied the shared PubChem rate limiter at individual HTTP-request boundaries.
  • Clarified activity-repair progress and terminal UI states.

Fixed

  • Prevented large PubChem assays from failing solely because direct
    assay-activity CSV retrieval exceeded the supported request size.
  • Treated successfully retrieved assays with unsupported structured-activity
    schemas as successful retrievals producing no structured activity records.
  • Preserved existing structured activity records during repair.

Validation

  • Complete test suite: 682 passed
  • git diff --check: clean
  • MC4R repair validation:
    • 650 protein-AID jobs processed
    • 650 successful
    • 0 failed
    • 0 inserted rows
  • Structured-activity population preserved:
    • 9,451 records
    • 600 distinct AIDs
    • 4,925 distinct CIDs
  • Repair provenance confirmed in operation history.

CHEMVAULT v0.14.3

CHEMVAULT v0.14.3 Pre-release
Pre-release

Choose a tag to compare

@NanoBiostructuresRG NanoBiostructuresRG released this 17 Sep 20:00

CHEMVAULT v0.14.3

This release refines the MODELABILITY INDEX result presentation and updates the public ChemVault identity.

Changed

  • Reorganized structural-context results into:
    • Murcko population context
    • Nearest-neighbor scaffold interface
  • Added same-scaffold and different-scaffold concordances to the result card.
  • Renamed the result provenance caption to Source dataset.
  • Updated the ChemVault tagline to:
    Target-centered bioactivity dataset curation from PubChem.

Validation

  • 660 tests passed.
  • git diff --check clean.
  • Streamlit visual validation completed with PPARG–Morgan.

No MODELABILITY INDEX or Murcko scientific calculations, contracts, analytical identities, persistence behavior, or export schemas were changed.

CHEMVAULT v0.14.2

CHEMVAULT v0.14.2 Pre-release
Pre-release

Choose a tag to compare

@NanoBiostructuresRG NanoBiostructuresRG released this 17 Sep 04:39

CHEMVAULT v0.14.2

Highlights

  • Extended the downloadable MODELABILITY INDEX analysis report to schema
    version 2.
  • Added full-precision export of the existing Murcko population, structural
    metrics, and nearest-neighbor scaffold-interface context.
  • Preserved nearest-neighbor diagnostics at their existing top-level location
    and compatibility with legacy results lacking Murcko structural context.
  • Preserved all MODELABILITY INDEX and Murcko scientific calculations,
    analytical identities, fingerprint artifacts, and existing scientific
    contracts.

Validation

  • 660 tests passed.
  • git diff --check clean.
  • End-to-end MC4R Morgan analysis-report export validated.
  • Confirmed that the MC4R Morgan chemvault_analysis_hash is unchanged from
    v0.14.1.

CHEMVAULT v0.14.1

CHEMVAULT v0.14.1 Pre-release
Pre-release

Choose a tag to compare

@NanoBiostructuresRG NanoBiostructuresRG released this 15 Sep 21:12

CHEMVAULT v0.14.1

Highlights

  • Added a downloadable JSON analysis report for completed MODELABILITY INDEX analyses.
  • Added explicit analysis identity fields to nearest-neighbor CSV exports.
  • Added fingerprint- and analysis-specific filenames for MODELABILITY INDEX outputs.
  • Preserved the existing fingerprint .npz contract and all scientific calculations.

Validation

  • 658 tests passed.
  • git diff --check clean.
  • No changes to MODELABILITY INDEX mathematics, fingerprint generation,
    nearest-neighbor selection, tie policy, Murcko analysis, or NPZ schema.

CHEMVAULT v0.14.0

CHEMVAULT v0.14.0 Pre-release
Pre-release

Choose a tag to compare

@NanoBiostructuresRG NanoBiostructuresRG released this 09 Sep 07:24

CHEMVAULT v0.14.0

This pre-release adds Bemis-Murcko structural context to the existing
MODELABILITY INDEX workflow without changing the historical index calculation.

Highlights

  • canonical atom- and bond-aware Bemis-Murcko scaffold context;
  • cyclic/acyclic population coverage and scaffold organization metrics;
  • adjusted scaffold-effect analysis;
  • exact nearest-neighbor tie diagnostics;
  • Murcko characterization of selected nearest-neighbor relationships;
  • compact Structural context summary in MODELABILITY INDEX results;
  • Murcko provenance in Analysis details;
  • versioned completed-job reuse through murcko_modelability_context/v1;
  • preserved fingerprint artifact reuse and existing chemvault_analysis_hash;
  • preserved local and HTTP backend compatibility.

Validation

  • 656 tests passed;
  • git diff --check clean;
  • local Streamlit smoke validation completed with two real MODELABILITY INDEX
    datasets.

CHEMVAULT v0.13.1

CHEMVAULT v0.13.1 Pre-release
Pre-release

Choose a tag to compare

@NanoBiostructuresRG NanoBiostructuresRG released this 31 Jul 16:30

CHEMVAULT v0.13.1

CHEMVAULT v0.13.1 expands the curated organism catalog available for strict
single-target gene-symbol resolution.

Added organisms

  • Homo sapiens — Human — NCBI taxonomy ID 9606
  • Mus musculus — Mouse — NCBI taxonomy ID 10090
  • Rattus norvegicus — Rat — NCBI taxonomy ID 10116
  • Oryctolagus cuniculus — Rabbit — NCBI taxonomy ID 9986
  • Mesocricetus auratus — Golden hamster — NCBI taxonomy ID 10036

Behavior preserved

  • Homo sapiens remains the default organism.
  • The selector uses an explicit curated order independent of taxonomy-ID
    sorting.
  • One gene symbol and one organism must resolve to exactly one reviewed
    UniProt accession.
  • Direct UniProt-accession input remains supported.
  • UniProt accession remains the canonical identifier for PubChem retrieval and
    downstream CHEMVAULT workflows.
  • No batch resolution, target panels, or multiple-target launches were added.
  • Local and HTTP backend contracts remain unchanged.

Documentation

  • Documents the supported organism catalog and strict resolution contract.
  • Updates installation and citation examples to version 0.13.1.
  • Clarifies CHEMVAULT's emphasis on provenance, traceability, and
    reproducibility.
  • Clarifies that fingerprint generation is provided by MOLRAPTOR.

Validation

  • 633 automated tests passed.
  • 135 related tests passed across protein identifiers, FastAPI, API client,
    backend gateway, and the Streamlit target dialog.
  • Live reviewed UniProt resolution passed for all five supported organisms.
  • The curated selector order and default Human selection were validated
    visually.