Repository navigation
Prepare release v.0.0.7
Changelog
Version 0.0.7
Highlights
- Refactored source-code structure into six primary submodules at the root level:
IO,Chem,Graph,Rule,Synthesis, andVis. - Added MØD‐free operation mode: functions requiring MØD now raise clear errors but fall back to pure‐Python implementations where available.
IO Module
^^^^^^^^^
- Exposed core I/O utilities directly in
synkit.IO:
chemical_converter.py,data_io.py, anddebug.py.
Chem Module
^^^^^^^^^^^
- Introduced
CanonRSMIfor atom–atom mapping (AAM) canonicalization. - Moved
AAMValidatorintosynkit.Chem.Reactionfor consistency.
Graph Module
^^^^^^^^^^^^
- Added
SynGraphwrapper for reaction and molecule graphs. - New canonicalisation backends:
- node‐type sort
- Morgan‐prime hashing
- Weisfeiler–Lehman refinement
- Renamed “Cluster” to Matcher; enhanced
GraphMatcherandSubgraphMatch. - Added
SubgraphSearchEnginewith three strategies:component‐awarearbitrarybacktracking
- Introduced
SINGandTURBOISfor mapping multiple patterns in a single host graph. - Extended
GraphClusterandBatchClusteringto support bothnxandmodbackends. - Enhanced
WLHashto hash lists of node/edge attributes. - Added
MTGsubmodule for Mechanistic Transition Graphs (direct rule composition). - New
Hydrogensubmodule for reaction-center H-completion andContextfor radius-based expansion.
Rule Module
^^^^^^^^^^^
- Introduced
SynRulewrapper supporting NetworkX graphs and GML. - Reorganized into three packages:
- Apply (retro-prediction via partial composition)
- Compose (rule composition)
- Modify (rule editing and H-handling)
- Provided non‐MØD fallbacks where possible.
Synthesis Module
^^^^^^^^^^^^^^^^
- Divided into three submodules:
- Reactor (
nxviaSynReactor;modviaMODReactor/MODAAM) - CRN (Chemical Reaction Network builder via
MODCRN) - MSR (multi-step reaction pathfinder)
- Reactor (
SynReactornow supports implicit‐H templates.MODCRNwraps MØD for CRN generation; requires manual re-run for PDF summaries.
Vis Module
^^^^^^^^^^
- Visualization tools organized under
synkit.Vis:RXNVis(reaction visualisation)RuleVis(template/rule visualisation)GraphVisualizer(generic graph editing & display)
Documentation
^^^^^^^^^^^^^
- Added comprehensive examples for each submodule.
- Scaffolding for an API Reference page.