# massimoaria/bibliometrix architecture

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

- Interactive diagram: https://gitdiagram.com/massimoaria/bibliometrix
- Repository: https://github.com/massimoaria/bibliometrix

## Overview

bibliometrix is an R toolkit and Shiny application for bibliometric/science-mapping research. Its documented user journey follows SAAS: acquire and import records, appraise and refine the collection, analyze descriptive indicators and knowledge structures, then synthesize findings in visualizations and interpretation. The README describes these capabilities and the app at a product level; source excerpts were not provided, so edges represent only documented workflow or capability relationships, not inspected calls.

Main entry points: [`R/biblioAnalysis.R`](https://github.com/massimoaria/bibliometrix/blob/master/R/biblioAnalysis.R) (Descriptive indicators), [`R/completeMetadata.R`](https://github.com/massimoaria/bibliometrix/blob/master/R/completeMetadata.R) (Dataset appraisal), [`R/convert2df.R`](https://github.com/massimoaria/bibliometrix/blob/master/R/convert2df.R) (Import and convert), [`R/plot.bibliometrix.R`](https://github.com/massimoaria/bibliometrix/blob/master/R/plot.bibliometrix.R) (Maps and plots)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Interactive app"]
  node_biblioshiny["Biblioshiny app<br/>[server.R]"]
  node_app_ui["App interface<br/>[ui.R]"]
end

subgraph group_data["Data management"]
  node_import["Import and convert<br/>[convert2df.R]"]
  node_merge["Merge collections<br/>[mergeDbSources.R]"]
  node_matching["Citation matching"]
  node_appraisal["Dataset appraisal<br/>[completeMetadata.R]"]
  node_prisma["PRISMA flow"]
end

subgraph group_analytics["Bibliometric analysis"]
  node_descriptive["Descriptive indicators<br/>[biblioAnalysis.R]"]
  node_source_metrics["Source metrics<br/>[bradford.R]"]
  node_author_metrics["Author metrics<br/>[Hindex.R]"]
  node_document_metrics["Document metrics<br/>[citations.R]"]
end

subgraph group_mapping["Knowledge mapping"]
  node_conceptual["Conceptual structure"]
  node_thematic["Thematic evolution"]
  node_intellectual["Intellectual structure<br/>[biblioNetwork.R]"]
  node_social["Social structure"]
end

subgraph group_synthesis["Synthesis"]
  node_visualization["Maps and plots"]
  node_three_fields["Three-field plot<br/>[threeFieldsPlot.R]"]
  node_ai["Biblio AI<br/>[biblioAI.R]"]
end

node_researcher(("Researcher"))
node_db_sources[("Bibliographic databases")]
node_api_services["OpenAlex / PubMed APIs"]

node_researcher -->|"uses"| node_biblioshiny
node_app_ui -->|"presents workflow"| node_biblioshiny
node_db_sources -->|"provides records"| node_import
node_api_services -->|"retrieves records"| node_import
node_import -->|"precedes"| node_appraisal
node_appraisal -->|"includes matching"| node_matching
node_import -->|"supports merging"| node_merge
node_appraisal -->|"documents selection"| node_prisma
node_appraisal -->|"feeds analysis"| node_descriptive
node_descriptive -->|"includes sources"| node_source_metrics
node_descriptive -->|"includes authors"| node_author_metrics
node_descriptive -->|"includes documents"| node_document_metrics
node_descriptive -->|"analyzes themes"| node_conceptual
node_descriptive -->|"analyzes citations"| node_intellectual
node_descriptive -->|"analyzes collaboration"| node_social
node_conceptual -->|"maps evolution"| node_thematic
node_conceptual -->|"synthesizes as maps"| node_visualization
node_intellectual -->|"synthesizes as networks"| node_visualization
node_social -->|"synthesizes collaboration"| node_visualization
node_descriptive -->|"visualizes relations"| node_three_fields
node_visualization -->|"supports interpretation"| node_ai

click node_biblioshiny "https://github.com/massimoaria/bibliometrix/blob/master/inst/biblioshiny/server.R"
click node_app_ui "https://github.com/massimoaria/bibliometrix/blob/master/inst/biblioshiny/ui.R"
click node_import "https://github.com/massimoaria/bibliometrix/blob/master/R/convert2df.R"
click node_merge "https://github.com/massimoaria/bibliometrix/blob/master/R/mergeDbSources.R"
click node_matching "https://github.com/massimoaria/bibliometrix/blob/master/R/apply_citation_matching.R"
click node_appraisal "https://github.com/massimoaria/bibliometrix/blob/master/R/completeMetadata.R"
click node_prisma "https://github.com/massimoaria/bibliometrix/tree/master/inst/biblioshiny"
click node_descriptive "https://github.com/massimoaria/bibliometrix/blob/master/R/biblioAnalysis.R"
click node_source_metrics "https://github.com/massimoaria/bibliometrix/blob/master/R/bradford.R"
click node_author_metrics "https://github.com/massimoaria/bibliometrix/blob/master/R/Hindex.R"
click node_document_metrics "https://github.com/massimoaria/bibliometrix/blob/master/R/citations.R"
click node_conceptual "https://github.com/massimoaria/bibliometrix/blob/master/R/conceptualStructure.R"
click node_thematic "https://github.com/massimoaria/bibliometrix/blob/master/R/thematicEvolution.R"
click node_intellectual "https://github.com/massimoaria/bibliometrix/blob/master/R/biblioNetwork.R"
click node_social "https://github.com/massimoaria/bibliometrix/blob/master/R/collabByRegionPlot.R"
click node_visualization "https://github.com/massimoaria/bibliometrix/blob/master/R/plot.bibliometrix.R"
click node_three_fields "https://github.com/massimoaria/bibliometrix/blob/master/R/threeFieldsPlot.R"
click node_ai "https://github.com/massimoaria/bibliometrix/blob/master/inst/biblioshiny/biblioAI.R"

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_biblioshiny,node_app_ui toneBlue
class node_import,node_merge,node_matching,node_appraisal,node_prisma,node_db_sources toneAmber
class node_descriptive,node_source_metrics,node_author_metrics,node_document_metrics,node_api_services toneMint
class node_conceptual,node_thematic,node_intellectual,node_social toneRose
class node_visualization,node_three_fields,node_ai,node_researcher toneIndigo
```

## Components

### Interactive app

- [Biblioshiny app](https://github.com/massimoaria/bibliometrix/blob/master/inst/biblioshiny/server.R): `inst/biblioshiny/server.R`
- [App interface](https://github.com/massimoaria/bibliometrix/blob/master/inst/biblioshiny/ui.R): `inst/biblioshiny/ui.R`

### Data management

- [Import and convert](https://github.com/massimoaria/bibliometrix/blob/master/R/convert2df.R): `R/convert2df.R`
- [Merge collections](https://github.com/massimoaria/bibliometrix/blob/master/R/mergeDbSources.R): `R/mergeDbSources.R`
- [Citation matching](https://github.com/massimoaria/bibliometrix/blob/master/R/apply_citation_matching.R): `R/apply_citation_matching.R`
- [Dataset appraisal](https://github.com/massimoaria/bibliometrix/blob/master/R/completeMetadata.R): `R/completeMetadata.R`
- [PRISMA flow](https://github.com/massimoaria/bibliometrix/tree/master/inst/biblioshiny): `inst/biblioshiny`

### Bibliometric analysis

- [Descriptive indicators](https://github.com/massimoaria/bibliometrix/blob/master/R/biblioAnalysis.R): `R/biblioAnalysis.R`
- [Source metrics](https://github.com/massimoaria/bibliometrix/blob/master/R/bradford.R): `R/bradford.R`
- [Author metrics](https://github.com/massimoaria/bibliometrix/blob/master/R/Hindex.R): `R/Hindex.R`
- [Document metrics](https://github.com/massimoaria/bibliometrix/blob/master/R/citations.R): `R/citations.R`

### Knowledge mapping

- [Conceptual structure](https://github.com/massimoaria/bibliometrix/blob/master/R/conceptualStructure.R): `R/conceptualStructure.R`
- [Thematic evolution](https://github.com/massimoaria/bibliometrix/blob/master/R/thematicEvolution.R): `R/thematicEvolution.R`
- [Intellectual structure](https://github.com/massimoaria/bibliometrix/blob/master/R/biblioNetwork.R): `R/biblioNetwork.R`
- [Social structure](https://github.com/massimoaria/bibliometrix/blob/master/R/collabByRegionPlot.R): `R/collabByRegionPlot.R`

### Synthesis

- [Maps and plots](https://github.com/massimoaria/bibliometrix/blob/master/R/plot.bibliometrix.R): `R/plot.bibliometrix.R`
- [Three-field plot](https://github.com/massimoaria/bibliometrix/blob/master/R/threeFieldsPlot.R): `R/threeFieldsPlot.R`
- [Biblio AI](https://github.com/massimoaria/bibliometrix/blob/master/inst/biblioshiny/biblioAI.R): `inst/biblioshiny/biblioAI.R`

### Other components

- **Researcher**
- **Bibliographic databases**
- **OpenAlex / PubMed APIs**

## Connections

- Researcher → Biblioshiny app: uses (evidence: `README.md`)
- App interface → Biblioshiny app: presents workflow (evidence: `README.md`)
- Bibliographic databases → Import and convert: provides records (evidence: `README.md`)
- OpenAlex / PubMed APIs → Import and convert: retrieves records (evidence: `README.md`)
- Import and convert → Dataset appraisal: precedes (evidence: `README.md`)
- Dataset appraisal → Citation matching: includes matching (evidence: `README.md`)
- Import and convert → Merge collections: supports merging (evidence: `README.md`)
- Dataset appraisal → PRISMA flow: documents selection (evidence: `README.md`)
- Dataset appraisal → Descriptive indicators: feeds analysis (evidence: `README.md`)
- Descriptive indicators → Source metrics: includes sources (evidence: `README.md`)
- Descriptive indicators → Author metrics: includes authors (evidence: `README.md`)
- Descriptive indicators → Document metrics: includes documents (evidence: `README.md`)
- Descriptive indicators → Conceptual structure: analyzes themes (evidence: `README.md`)
- Descriptive indicators → Intellectual structure: analyzes citations (evidence: `README.md`)
- Descriptive indicators → Social structure: analyzes collaboration (evidence: `README.md`)
- Conceptual structure → Thematic evolution: maps evolution (evidence: `README.md`)
- Conceptual structure → Maps and plots: synthesizes as maps (evidence: `README.md`)
- Intellectual structure → Maps and plots: synthesizes as networks (evidence: `README.md`)
- Social structure → Maps and plots: synthesizes collaboration (evidence: `README.md`)
- Descriptive indicators → Three-field plot: visualizes relations (evidence: `README.md`)
- Maps and plots → Biblio AI: supports interpretation (evidence: `README.md`)
