# danagomz/simulador_polarizacion architecture

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

- Interactive diagram: https://gitdiagram.com/danagomz/simulador_polarizacion
- Repository: https://github.com/danagomz/simulador_polarizacion

## Overview

This Scala library models influence-driven opinion evolution. The main workflow supplies an influence graph and initial beliefs, repeatedly applies a sequential or parallel belief update, and can evaluate polarization over the resulting beliefs. The README also documents influence-graph construction and visualization. Comete provides the distribution-based polarization measure and normalization; common supplies fork/join scheduling used by parallel updates. Graph construction and visualization are documented capabilities, but their implementation was not sampled, so their internal connections are not inferred.

Main entry points: [`src/main/scala/Comete/package.scala`](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Comete/package.scala) (Generic rho), [`src/main/scala/Opinion`](https://github.com/danagomz/simulador_polarizacion/tree/master/src/main/scala/Opinion) (Influence graph), [`src/main/scala/Opinion/package.scala`](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala) (Parallel update), [`src/main/scala/common/package.scala`](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/common/package.scala) (Task scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_opinion["Opinion dynamics"]
  node_beliefs["Agent beliefs<br/>[package.scala]"]
  node_influence["Influence graph"]
  node_graph_view["Graph display"]
  node_contribution["Influence contribution<br/>[package.scala]"]
  node_sequential_update["Sequential update<br/>[package.scala]"]
  node_parallel_update["Parallel update<br/>[package.scala]"]
  node_simulation["Opinion simulation<br/>[package.scala]"]
end

subgraph group_polarization["Polarization measures"]
  node_belief_distribution["Belief frequencies<br/>[package.scala]"]
  node_polarization_measure["Polarization measure<br/>[package.scala]"]
  node_distribution_types["Distribution types<br/>[package.scala]"]
  node_rho["Generic rho<br/>[package.scala]"]
  node_normalization["Normalization<br/>[package.scala]"]
  node_minimizer["Minimizer<br/>[package.scala]"]
end

subgraph group_parallel["Parallel runtime"]
  node_scheduler["Task scheduler<br/>[package.scala]"]
end

node_user(("Model user"))

node_user -.->|"defines"| node_influence
node_user -.->|"provides"| node_beliefs
node_user -.->|"runs"| node_simulation
node_influence -.->|"visualizes"| node_graph_view
node_simulation -->|"applies"| node_sequential_update
node_sequential_update -->|"computes"| node_contribution
node_influence -->|"supplies weights"| node_sequential_update
node_simulation -.->|"applies"| node_parallel_update
node_parallel_update -->|"computes"| node_contribution
node_parallel_update -->|"dispatches tasks"| node_scheduler
node_beliefs -->|"bins beliefs"| node_belief_distribution
node_belief_distribution -->|"evaluates"| node_polarization_measure
node_polarization_measure -->|"calls"| node_rho
node_rho -->|"normalizes"| node_normalization
node_rho -->|"minimizes"| node_minimizer
node_normalization -->|"uses"| node_distribution_types
node_rho -->|"uses"| node_distribution_types

click node_beliefs "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala"
click node_influence "https://github.com/danagomz/simulador_polarizacion/tree/master/src/main/scala/Opinion"
click node_graph_view "https://github.com/danagomz/simulador_polarizacion/tree/master/src/main/scala/Opinion"
click node_contribution "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala"
click node_sequential_update "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala"
click node_parallel_update "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala"
click node_simulation "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala"
click node_belief_distribution "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala"
click node_polarization_measure "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala"
click node_distribution_types "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Comete/package.scala"
click node_rho "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Comete/package.scala"
click node_normalization "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Comete/package.scala"
click node_minimizer "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Comete/package.scala"
click node_scheduler "https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/common/package.scala"

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_beliefs,node_influence,node_graph_view,node_contribution,node_sequential_update,node_parallel_update,node_simulation,node_user toneBlue
class node_belief_distribution,node_polarization_measure,node_distribution_types,node_rho,node_normalization,node_minimizer toneAmber
class node_scheduler toneMint
```

## Components

### Opinion dynamics

- [Agent beliefs](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala): `src/main/scala/Opinion/package.scala`
- [Influence graph](https://github.com/danagomz/simulador_polarizacion/tree/master/src/main/scala/Opinion): `src/main/scala/Opinion`
- [Graph display](https://github.com/danagomz/simulador_polarizacion/tree/master/src/main/scala/Opinion): `src/main/scala/Opinion`
- [Influence contribution](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala): `src/main/scala/Opinion/package.scala`
- [Sequential update](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala): `src/main/scala/Opinion/package.scala`
- [Parallel update](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala): `src/main/scala/Opinion/package.scala`
- [Opinion simulation](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala): `src/main/scala/Opinion/package.scala`

### Polarization measures

- [Belief frequencies](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala): `src/main/scala/Opinion/package.scala`
- [Polarization measure](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Opinion/package.scala): `src/main/scala/Opinion/package.scala`
- [Distribution types](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Comete/package.scala): `src/main/scala/Comete/package.scala`
- [Generic rho](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Comete/package.scala): `src/main/scala/Comete/package.scala`
- [Normalization](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Comete/package.scala): `src/main/scala/Comete/package.scala`
- [Minimizer](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/Comete/package.scala): `src/main/scala/Comete/package.scala`

### Parallel runtime

- [Task scheduler](https://github.com/danagomz/simulador_polarizacion/blob/master/src/main/scala/common/package.scala): `src/main/scala/common/package.scala`

### Other components

- **Model user**

## Connections

- Model user → Influence graph: defines (evidence: `README.md`)
- Model user → Agent beliefs: provides (evidence: `README.md`)
- Model user → Opinion simulation: runs (evidence: `README.md`)
- Influence graph → Graph display: visualizes (evidence: `README.md`)
- Opinion simulation → Sequential update: applies (evidence: `src/main/scala/Opinion/package.scala`)
- Sequential update → Influence contribution: computes (evidence: `src/main/scala/Opinion/package.scala`)
- Influence graph → Sequential update: supplies weights (evidence: `src/main/scala/Opinion/package.scala`)
- Opinion simulation → Parallel update: applies (evidence: `src/main/scala/Opinion/package.scala`)
- Parallel update → Influence contribution: computes (evidence: `src/main/scala/Opinion/package.scala`)
- Parallel update → Task scheduler: dispatches tasks (evidence: `src/main/scala/Opinion/package.scala`)
- Agent beliefs → Belief frequencies: bins beliefs (evidence: `src/main/scala/Opinion/package.scala`)
- Belief frequencies → Polarization measure: evaluates (evidence: `src/main/scala/Opinion/package.scala`)
- Polarization measure → Generic rho: calls (evidence: `src/main/scala/Opinion/package.scala`)
- Generic rho → Normalization: normalizes (evidence: `src/main/scala/Comete/package.scala`)
- Generic rho → Minimizer: minimizes (evidence: `src/main/scala/Comete/package.scala`)
- Normalization → Distribution types: uses (evidence: `src/main/scala/Comete/package.scala`)
- Generic rho → Distribution types: uses (evidence: `src/main/scala/Comete/package.scala`)
