How banchaoruan/molecular-research-toolkit works
The Molecular Research Toolkit supports either individual tasks or a traceable paper-to-computation workflow: prepare molecule images, identify and review structures, organize master-table and literature evidence, export selected molecules, and generate Barkla results. The graph preserves the README’s major capabilities and the sampled internal layers. Several subsystems, especially literature extraction, are represented at their documented directory level because implementation excerpts were not provided; documented links use the README as evidence.
Main entry points: master_schema.mjs Master table · run_source_folder_to_smiles.py SMILES workflow · recover_no_g298.py Failed-job recovery · prepare_images_core.py Image preparation
Components 22
Image preparation
- Image preparation
skills/modules/molecule-image-prep/scripts/prepare_images_core.py - Crop review bundle
skills/modules/molecule-image-prep/scripts/build_review.py - Molecule images
Structure identification
- SMILES workflow
skills/modules/image-to-smiles/scripts/run_source_folder_to_smiles.py - Structure prediction
skills/modules/image-to-smiles/scripts/structure_predict.py - Candidate records
skills/modules/image-to-smiles/scripts/smiles_core.py - Structure review
skills/modules/image-to-smiles/scripts/render_smiles.py - ChemDraw fallback
skills/modules/image-to-smiles/scripts/chemdraw_fallback.py - Reviewed structures
Research tables
- Master table
skills/molecular-research-toolkit/scripts/master_schema.mjs - Table operations
skills/molecular-research-toolkit/scripts/data_core.mjs - SMI export
skills/molecular-research-toolkit/scripts/build_smi.mjs - Literature extraction
skills/modules/literature-solvent-extraction - Solvent evidence
Barkla computation
- Barkla preparation
tools/barkla_redox/barkla_redox/scripts/make_com.py - Slurm jobs
tools/barkla_redox/barkla_redox/scripts/make_slurm.py - Failed-job recovery
tools/barkla_redox/barkla_redox/scripts/recover_no_g298.py - G298 extraction
tools/barkla_redox/barkla_redox/scripts/extract_G298_batch.py - G298 results
Other components
- Paper figures
- Researcher
- Barkla HPC
Connections 27
- Paper figures → Image preparation: provides figures
README.md - Image preparation → Crop review bundle: builds review
README.md - Image preparation → Molecule images: produces images
README.md - Molecule images → SMILES workflow: supplies images
README.md - SMILES workflow → Structure prediction: requests predictions
skills/modules/image-to-smiles/scripts/run_source_folder_to_smiles.py - SMILES workflow → Candidate records: uses contracts
skills/modules/image-to-smiles/scripts/run_source_folder_to_smiles.py - SMILES workflow → ChemDraw fallback: uses fallback
skills/modules/image-to-smiles/scripts/run_source_folder_to_smiles.py - Structure prediction → Candidate records: records candidates
skills/modules/image-to-smiles/scripts/structure_predict.py - Researcher → Structure review: reviews candidates
README.md - Structure review → Reviewed structures: produces reviewed data
README.md - ChemDraw fallback → Reviewed structures: prepares MOL inputs
README.md - Reviewed structures → Master table: fills structure pairs
README.md - Researcher → Master table: provides workbook
README.md - Master table → Table operations: reads and updates
skills/molecular-research-toolkit/scripts/master_schema.mjs - Master table → Literature extraction: supplies master
README.md - Literature extraction → Solvent evidence: records evidence
README.md - Researcher → Solvent evidence: reviews evidence
README.md - Master table → SMI export: selects molecules
README.md - Solvent evidence → SMI export: provides solvent choices
README.md - SMI export → Barkla preparation: supplies reviewed SMI
README.md - Barkla preparation → Slurm jobs: prepares job scripts
tools/barkla_redox/barkla_redox/scripts/make_slurm.py - Slurm jobs → Barkla HPC: runs Gaussian jobs
README.md - Barkla HPC → G298 extraction: provides outputs
README.md - G298 extraction → G298 results: writes results
README.md - Failed-job recovery → Barkla preparation: prepares retries
tools/barkla_redox/barkla_redox/scripts/recover_no_g298.py - Failed-job recovery → Slurm jobs: prepares retries
tools/barkla_redox/barkla_redox/scripts/recover_no_g298.py - Failed-job recovery → G298 extraction: uses extraction logic
tools/barkla_redox/barkla_redox/scripts/recover_no_g298.py