# jayesh-kumar-sundaram/pub-lab-locator architecture

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

- Interactive diagram: https://gitdiagram.com/jayesh-kumar-sundaram/pub-lab-locator
- Repository: https://github.com/jayesh-kumar-sundaram/pub-lab-locator

## Overview

Pub-Lab-Locator turns PubMed abstract-text publications into affiliation records, geocoded research-centre coordinates, and visualizations. The documented user workflow replaces the input file and runs the Python extraction script followed by two R scripts. The README describes the generated results and interactive map; the R implementations were not sampled, so their internal behavior and precise calls are not verified. The bundled browser libraries support the map artifact, but their wiring is not established by the available excerpts.

Main entry points: [`04_plots/visualize_research_centers.html`](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers.html) (Interactive research map), [`04_plots/visualize_research_centers_files/leaflet-binding-2.2.2/leaflet.js`](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/leaflet-binding-2.2.2/leaflet.js) (Leaflet widget binding), [`02_data/abstract-Molecularb-set.txt`](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/02_data/abstract-Molecularb-set.txt) (PubMed abstracts), [`01_code/C1_extract_address_with_PMID.py`](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/01_code/C1_extract_address_with_PMID.py) (Affiliation extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Publication input"]
  node_pubmed["PubMed abstracts"]
end

subgraph group_processing["Data processing"]
  node_extract["Affiliation extraction"]
  node_affiliations["Address and PMID records"]
  node_geocode["Address geocoding"]
  node_coordinates["Coordinate records"]
end

subgraph group_visualization["Map visualization"]
  node_visualize["Centre visualization"]
  node_map["Interactive research map"]
end

subgraph group_browser["Browser runtime"]
  node_htmlwidgets["HTML widget runtime<br/>[htmlwidgets.js]"]
  node_leafletbinding["Leaflet widget binding<br/>[leaflet.js]"]
  node_leaflet["Leaflet maps<br/>[leaflet.js]"]
  node_proj4leaflet["Projection support<br/>[proj4leaflet.js]"]
  node_jquery["jQuery utilities<br/>[jquery-3.6.0.js]"]
end

node_user(("Researcher"))

node_user -->|"supplies input"| node_pubmed
node_pubmed -->|"reads abstracts"| node_extract
node_extract -->|"writes records"| node_affiliations
node_affiliations -->|"geocodes addresses"| node_geocode
node_geocode -->|"writes coordinates"| node_coordinates
node_coordinates -->|"visualizes locations"| node_visualize
node_visualize -->|"generates map"| node_map
node_map -.->|"uses runtime"| node_htmlwidgets
node_map -.->|"uses binding"| node_leafletbinding
node_leafletbinding -.->|"uses maps"| node_leaflet
node_leafletbinding -.->|"uses utilities"| node_jquery
node_leaflet -.->|"optional projection"| node_proj4leaflet

click node_pubmed "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/02_data/abstract-Molecularb-set.txt"
click node_extract "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/01_code/C1_extract_address_with_PMID.py"
click node_affiliations "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/03_results/address_pmid_info.tsv"
click node_geocode "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/01_code/C2_address_to_coordinates.r"
click node_coordinates "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/03_results/coordinate_info.tsv"
click node_visualize "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/01_code/C3_visualize_coordinates.r"
click node_map "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers.html"
click node_htmlwidgets "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/htmlwidgets-1.6.4/htmlwidgets.js"
click node_leafletbinding "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/leaflet-binding-2.2.2/leaflet.js"
click node_leaflet "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/leaflet-1.3.1/leaflet.js"
click node_proj4leaflet "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/Proj4Leaflet-1.0.1/proj4leaflet.js"
click node_jquery "https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/jquery-3.6.0/jquery-3.6.0.js"

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_pubmed toneBlue
class node_extract,node_affiliations,node_geocode,node_coordinates toneAmber
class node_visualize,node_map toneMint
class node_htmlwidgets,node_leafletbinding,node_leaflet,node_proj4leaflet,node_jquery toneRose
class node_user toneIndigo
```

## Components

### Publication input

- [PubMed abstracts](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/02_data/abstract-Molecularb-set.txt): `02_data/abstract-Molecularb-set.txt`

### Data processing

- [Affiliation extraction](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/01_code/C1_extract_address_with_PMID.py): `01_code/C1_extract_address_with_PMID.py`
- [Address and PMID records](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/03_results/address_pmid_info.tsv): `03_results/address_pmid_info.tsv`
- [Address geocoding](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/01_code/C2_address_to_coordinates.r): `01_code/C2_address_to_coordinates.r`
- [Coordinate records](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/03_results/coordinate_info.tsv): `03_results/coordinate_info.tsv`

### Map visualization

- [Centre visualization](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/01_code/C3_visualize_coordinates.r): `01_code/C3_visualize_coordinates.r`
- [Interactive research map](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers.html): `04_plots/visualize_research_centers.html`

### Browser runtime

- [HTML widget runtime](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/htmlwidgets-1.6.4/htmlwidgets.js): `04_plots/visualize_research_centers_files/htmlwidgets-1.6.4/htmlwidgets.js`
- [Leaflet widget binding](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/leaflet-binding-2.2.2/leaflet.js): `04_plots/visualize_research_centers_files/leaflet-binding-2.2.2/leaflet.js`
- [Leaflet maps](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/leaflet-1.3.1/leaflet.js): `04_plots/visualize_research_centers_files/leaflet-1.3.1/leaflet.js`
- [Projection support](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/Proj4Leaflet-1.0.1/proj4leaflet.js): `04_plots/visualize_research_centers_files/Proj4Leaflet-1.0.1/proj4leaflet.js`
- [jQuery utilities](https://github.com/jayesh-kumar-sundaram/pub-lab-locator/blob/main/04_plots/visualize_research_centers_files/jquery-3.6.0/jquery-3.6.0.js): `04_plots/visualize_research_centers_files/jquery-3.6.0/jquery-3.6.0.js`

### Other components

- **Researcher**

## Connections

- Researcher → PubMed abstracts: supplies input (evidence: `README.md`)
- PubMed abstracts → Affiliation extraction: reads abstracts (evidence: `README.md`)
- Affiliation extraction → Address and PMID records: writes records (evidence: `README.md`)
- Address and PMID records → Address geocoding: geocodes addresses (evidence: `README.md`)
- Address geocoding → Coordinate records: writes coordinates (evidence: `README.md`)
- Coordinate records → Centre visualization: visualizes locations (evidence: `README.md`)
- Centre visualization → Interactive research map: generates map (evidence: `README.md`)
- Interactive research map → HTML widget runtime: uses runtime
- Interactive research map → Leaflet widget binding: uses binding
- Leaflet widget binding → Leaflet maps: uses maps
- Leaflet widget binding → jQuery utilities: uses utilities
- Leaflet maps → Projection support: optional projection
