# patwalters/practical_cheminformatics_tutorials architecture

> Architecture diagram of the GitHub repository patwalters/practical_cheminformatics_tutorials, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/patwalters/practical_cheminformatics_tutorials
- Repository: https://github.com/patwalters/practical_cheminformatics_tutorials

## Overview

This repository is a learning resource: users choose a cheminformatics notebook and run it locally or in Google Colab to learn a method and explore its outputs. Its tutorials span molecular representation and manipulation, reaction and SAR analysis, machine learning, structural bioinformatics, active learning, and molecular design. These are mostly independent lessons, not a single application pipeline. The README documents the tutorial capabilities and Colab workflow; sampled helper scripts show selected implementations, but their use by individual notebooks was not established.

Main entry points: [`fundamentals`](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/fundamentals) (Core tutorials), [`ml_models`](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/ml_models) (QSAR model lessons), [`reaction`](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/reaction) (Reaction tutorials), [`datamol/datamol_1.ipynb`](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/datamol/datamol_1.ipynb) (Datamol workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Molecular foundations"]
  node_fundamentals["Core tutorials"]
  node_reaction["Reaction tutorials"]
  node_datamol["Datamol workflows<br/>[datamol_1.ipynb]"]
end

subgraph group_analysis["Chemical analysis"]
  node_clustering["Clustering lessons"]
  node_chembl["ChEMBL analysis"]
  node_sar["SAR analysis"]
  node_patent["Patent analysis"]
  node_bindingdb["BindingDB modeling"]
  node_visualization["Chemical-space maps"]
end

subgraph group_modeling["Modeling and ML"]
  node_ml["QSAR model lessons"]
  node_chemprop["ChemProp lessons"]
  node_active["Active learning"]
  node_gtm["GTM utilities<br/>[gtm_utils.py]"]
  node_bootstrap["Bootstrap intervals<br/>[bootstrap.py]"]
  node_delong["DeLong intervals<br/>[delong_ci.py]"]
end

subgraph group_structure["Structure and design"]
  node_biotite["Structural bioinformatics"]
  node_docking["Docking analysis"]
  node_generative["Molecular generation<br/>[SMILES_RNN.ipynb]"]
  node_qm["Tautomer energies"]
end

subgraph group_helpers["Reusable helpers"]
  node_conformers["Conformer generation<br/>[gen_conformers.py]"]
  node_alignment["3D alignment scores<br/>[align3D_score.py]"]
  node_scaffolds["Scaffold finder<br/>[scaffold_finder.py]"]
  node_tsv["BindingDB TSV import<br/>[fix_tsv.py]"]
  node_pdblookup["PDB identifier lookup"]
end

node_learner(("Learner"))
node_result(("Tutorial learning"))
node_colab(("Google Colab"))

node_learner -->|"selects lessons"| node_fundamentals
node_learner -->|"selects lessons"| node_reaction
node_learner -->|"selects workflow"| node_datamol
node_learner -->|"selects lessons"| node_clustering
node_learner -->|"selects lessons"| node_chembl
node_learner -->|"selects lessons"| node_sar
node_learner -->|"selects lesson"| node_patent
node_learner -->|"selects lesson"| node_bindingdb
node_learner -->|"selects lesson"| node_visualization
node_learner -->|"selects lessons"| node_ml
node_learner -->|"selects lessons"| node_chemprop
node_learner -->|"selects lessons"| node_active
node_learner -->|"selects lessons"| node_biotite
node_learner -.->|"selects analysis"| node_docking
node_learner -->|"selects lesson"| node_generative
node_learner -->|"selects lesson"| node_qm
node_fundamentals -->|"teaches concepts"| node_result
node_reaction -->|"teaches methods"| node_result
node_datamol -->|"teaches workflows"| node_result
node_clustering -->|"teaches methods"| node_result
node_chembl -->|"teaches analysis"| node_result
node_sar -->|"teaches analysis"| node_result
node_patent -->|"teaches analysis"| node_result
node_bindingdb -->|"teaches modeling"| node_result
node_visualization -->|"teaches visualization"| node_result
node_ml -->|"teaches modeling"| node_result
node_chemprop -->|"teaches modeling"| node_result
node_active -->|"teaches modeling"| node_result
node_biotite -->|"teaches methods"| node_result
node_generative -->|"teaches design"| node_result
node_qm -->|"teaches energies"| node_result
node_colab -->|"runs notebook"| node_fundamentals
node_colab -->|"runs notebook"| node_ml

click node_fundamentals "https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/fundamentals"
click node_reaction "https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/reaction"
click node_datamol "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/datamol/datamol_1.ipynb"
click node_clustering "https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/clustering"
click node_chembl "https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/misc"
click node_sar "https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/sar_analysis"
click node_patent "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/patent/patent_analysis.ipynb"
click node_bindingdb "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/bindingdb/binding_db_pxr_tutorial.ipynb"
click node_visualization "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/misc/visualizing_chemical_space.ipynb"
click node_ml "https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/ml_models"
click node_chemprop "https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/chemprop"
click node_active "https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/active_learning"
click node_gtm "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/visualization/gtm_utils.py"
click node_bootstrap "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/ml_models/bootstrap.py"
click node_delong "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/ml_models/delong_ci.py"
click node_biotite "https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/biotite"
click node_docking "https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/docking"
click node_generative "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/generative/SMILES_RNN.ipynb"
click node_qm "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/qm/tautomer_energies.ipynb"
click node_conformers "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/active_learning/gen_conformers.py"
click node_alignment "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/active_learning/align3D_score.py"
click node_scaffolds "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/sar_analysis/scaffold_finder.py"
click node_tsv "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/bindingdb/fix_tsv.py"
click node_pdblookup "https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/bindingdb/download_pdb_ids.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_fundamentals,node_reaction,node_datamol toneBlue
class node_clustering,node_chembl,node_sar,node_patent,node_bindingdb,node_visualization toneAmber
class node_ml,node_chemprop,node_active,node_gtm,node_bootstrap,node_delong toneMint
class node_biotite,node_docking,node_generative,node_qm toneRose
class node_conformers,node_alignment,node_scaffolds,node_tsv,node_pdblookup,node_learner,node_result,node_colab toneIndigo
```

## Components

### Molecular foundations

- [Core tutorials](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/fundamentals): `fundamentals`
- [Reaction tutorials](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/reaction): `reaction`
- [Datamol workflows](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/datamol/datamol_1.ipynb): `datamol/datamol_1.ipynb`

### Chemical analysis

- [Clustering lessons](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/clustering): `clustering`
- [ChEMBL analysis](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/misc): `misc`
- [SAR analysis](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/sar_analysis): `sar_analysis`
- [Patent analysis](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/patent/patent_analysis.ipynb): `patent/patent_analysis.ipynb`
- [BindingDB modeling](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/bindingdb/binding_db_pxr_tutorial.ipynb): `bindingdb/binding_db_pxr_tutorial.ipynb`
- [Chemical-space maps](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/misc/visualizing_chemical_space.ipynb): `misc/visualizing_chemical_space.ipynb`

### Modeling and ML

- [QSAR model lessons](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/ml_models): `ml_models`
- [ChemProp lessons](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/chemprop): `chemprop`
- [Active learning](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/active_learning): `active_learning`
- [GTM utilities](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/visualization/gtm_utils.py): `visualization/gtm_utils.py`
- [Bootstrap intervals](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/ml_models/bootstrap.py): `ml_models/bootstrap.py`
- [DeLong intervals](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/ml_models/delong_ci.py): `ml_models/delong_ci.py`

### Structure and design

- [Structural bioinformatics](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/biotite): `biotite`
- [Docking analysis](https://github.com/patwalters/practical_cheminformatics_tutorials/tree/main/docking): `docking`
- [Molecular generation](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/generative/SMILES_RNN.ipynb): `generative/SMILES_RNN.ipynb`
- [Tautomer energies](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/qm/tautomer_energies.ipynb): `qm/tautomer_energies.ipynb`

### Reusable helpers

- [Conformer generation](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/active_learning/gen_conformers.py): `active_learning/gen_conformers.py`
- [3D alignment scores](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/active_learning/align3D_score.py): `active_learning/align3D_score.py`
- [Scaffold finder](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/sar_analysis/scaffold_finder.py): `sar_analysis/scaffold_finder.py`
- [BindingDB TSV import](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/bindingdb/fix_tsv.py): `bindingdb/fix_tsv.py`
- [PDB identifier lookup](https://github.com/patwalters/practical_cheminformatics_tutorials/blob/main/bindingdb/download_pdb_ids.py): `bindingdb/download_pdb_ids.py`

### Other components

- **Learner**
- **Tutorial learning**
- **Google Colab**

## Connections

- Learner → Core tutorials: selects lessons (evidence: `README.md`)
- Learner → Reaction tutorials: selects lessons (evidence: `README.md`)
- Learner → Datamol workflows: selects workflow (evidence: `README.md`)
- Learner → Clustering lessons: selects lessons (evidence: `README.md`)
- Learner → ChEMBL analysis: selects lessons (evidence: `README.md`)
- Learner → SAR analysis: selects lessons (evidence: `README.md`)
- Learner → Patent analysis: selects lesson (evidence: `README.md`)
- Learner → BindingDB modeling: selects lesson (evidence: `README.md`)
- Learner → Chemical-space maps: selects lesson (evidence: `README.md`)
- Learner → QSAR model lessons: selects lessons (evidence: `README.md`)
- Learner → ChemProp lessons: selects lessons (evidence: `README.md`)
- Learner → Active learning: selects lessons (evidence: `README.md`)
- Learner → Structural bioinformatics: selects lessons (evidence: `README.md`)
- Learner → Docking analysis: selects analysis
- Learner → Molecular generation: selects lesson (evidence: `README.md`)
- Learner → Tautomer energies: selects lesson (evidence: `README.md`)
- Core tutorials → Tutorial learning: teaches concepts (evidence: `README.md`)
- Reaction tutorials → Tutorial learning: teaches methods (evidence: `README.md`)
- Datamol workflows → Tutorial learning: teaches workflows (evidence: `README.md`)
- Clustering lessons → Tutorial learning: teaches methods (evidence: `README.md`)
- ChEMBL analysis → Tutorial learning: teaches analysis (evidence: `README.md`)
- SAR analysis → Tutorial learning: teaches analysis (evidence: `README.md`)
- Patent analysis → Tutorial learning: teaches analysis (evidence: `README.md`)
- BindingDB modeling → Tutorial learning: teaches modeling (evidence: `README.md`)
- Chemical-space maps → Tutorial learning: teaches visualization (evidence: `README.md`)
- QSAR model lessons → Tutorial learning: teaches modeling (evidence: `README.md`)
- ChemProp lessons → Tutorial learning: teaches modeling (evidence: `README.md`)
- Active learning → Tutorial learning: teaches modeling (evidence: `README.md`)
- Structural bioinformatics → Tutorial learning: teaches methods (evidence: `README.md`)
- Molecular generation → Tutorial learning: teaches design (evidence: `README.md`)
- Tautomer energies → Tutorial learning: teaches energies (evidence: `README.md`)
- Google Colab → Core tutorials: runs notebook (evidence: `README.md`)
- Google Colab → QSAR model lessons: runs notebook (evidence: `README.md`)
