# agusnieto77/acep architecture

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

- Interactive diagram: https://gitdiagram.com/agusnieto77/acep
- Repository: https://github.com/agusnieto77/acep

## Overview

ACEP is an R package for detecting and analyzing protest events in journalistic text corpora, with bundled protest-note data and topic dictionaries. Users can apply text preparation and NLP capabilities, analyze mentions and conflict intensity over time, and visualize results; separate functions connect to hosted or local language models. The README documents capabilities and optional dependencies, but no source excerpts were provided, so internal call relationships and a specific processing sequence cannot be verified and are omitted.

Main entry points: [`R/acep_claude.R`](https://github.com/agusnieto77/acep/blob/master/R/acep_claude.R) (Claude client), [`R/acep_gemini.R`](https://github.com/agusnieto77/acep/blob/master/R/acep_gemini.R) (Gemini client), [`R/acep_gpt.R`](https://github.com/agusnieto77/acep/blob/master/R/acep_gpt.R) (GPT client), [`R/acep_ollama.R`](https://github.com/agusnieto77/acep/blob/master/R/acep_ollama.R) (Ollama client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_text["Text processing"]
  node_clean["Clean text<br/>[acep_clean.R]"]
  node_case["Case conversion<br/>[acep_may.R]"]
  node_lower["Lowercase text<br/>[acep_min.R]"]
  node_extract["Word extraction<br/>[acep_extract.R]"]
  node_context["Context extraction<br/>[acep_context.R]"]
  node_token["Tokenization<br/>[acep_token.R]"]
  node_postag["POS and entities<br/>[acep_postag.R]"]
  node_hybrid["Hybrid POS"]
  node_upos["UPOS tagging<br/>[acep_upos.R]"]
  node_svo["SVO extraction<br/>[acep_svo.R]"]
  node_chunks["Chunk processing"]
  node_pipeline["Text pipeline<br/>[acep_pipeline.R]"]
end

subgraph group_analysis["Protest analysis"]
  node_detect["Mention detection<br/>[acep_detect.R]"]
  node_count["Mention frequency<br/>[acep_count.R]"]
  node_frec["Word frequency<br/>[acep_frec.R]"]
  node_db["Conflict analysis<br/>[acep_db.R]"]
  node_intensity["Intensity index<br/>[acep_int.R]"]
  node_timeseries["Conflict time series<br/>[acep_sst.R]"]
  node_plotrst["Series summary plot<br/>[acep_plot_rst.R]"]
  node_plotst["Series bar plot<br/>[acep_plot_st.R]"]
end

subgraph group_language["Language models"]
  node_claude["Claude client<br/>[acep_claude.R]"]
  node_gemini["Gemini client<br/>[acep_gemini.R]"]
  node_gpt["GPT client<br/>[acep_gpt.R]"]
  node_ollama["Ollama client<br/>[acep_ollama.R]"]
  node_openrouter["OpenRouter client<br/>[acep_openrouter.R]"]
  node_together["TogetherAI client<br/>[acep_together.R]"]
end

subgraph group_resources["Data resources"]
  node_loadbase["Load base data<br/>[acep_load_base.R]"]
end

node_user(("Analyst"))
node_anthropic{{"Anthropic Claude"}}
node_google{{"Google Gemini"}}
node_openai{{"OpenAI GPT"}}
node_localmodels{{"Local Ollama"}}
node_openrouter_service{{"OpenRouter models"}}
node_together_service{{"TogetherAI models"}}

node_user -->|"uses"| node_clean
node_user -->|"uses"| node_detect
node_user -->|"uses"| node_count
node_user -->|"uses"| node_timeseries
node_user -->|"uses"| node_pipeline
node_user -->|"loads"| node_loadbase
node_user -->|"uses"| node_postag
node_user -->|"uses"| node_hybrid
node_user -->|"uses"| node_upos
node_user -->|"uses"| node_svo
node_user -->|"uses"| node_claude
node_user -->|"uses"| node_gemini
node_user -->|"uses"| node_gpt
node_user -->|"uses"| node_ollama
node_user -->|"uses"| node_openrouter
node_user -->|"uses"| node_together
node_claude -.->|"interacts"| node_anthropic
node_gemini -.->|"interacts"| node_google
node_gpt -.->|"interacts"| node_openai
node_ollama -.->|"interacts"| node_localmodels
node_openrouter -.->|"interacts"| node_openrouter_service
node_together -.->|"interacts"| node_together_service

click node_clean "https://github.com/agusnieto77/acep/blob/master/R/acep_clean.R"
click node_case "https://github.com/agusnieto77/acep/blob/master/R/acep_may.R"
click node_lower "https://github.com/agusnieto77/acep/blob/master/R/acep_min.R"
click node_extract "https://github.com/agusnieto77/acep/blob/master/R/acep_extract.R"
click node_context "https://github.com/agusnieto77/acep/blob/master/R/acep_context.R"
click node_token "https://github.com/agusnieto77/acep/blob/master/R/acep_token.R"
click node_postag "https://github.com/agusnieto77/acep/blob/master/R/acep_postag.R"
click node_hybrid "https://github.com/agusnieto77/acep/blob/master/R/acep_postag_hibrido.R"
click node_upos "https://github.com/agusnieto77/acep/blob/master/R/acep_upos.R"
click node_svo "https://github.com/agusnieto77/acep/blob/master/R/acep_svo.R"
click node_chunks "https://github.com/agusnieto77/acep/blob/master/R/acep_process_chunks.R"
click node_pipeline "https://github.com/agusnieto77/acep/blob/master/R/acep_pipeline.R"
click node_detect "https://github.com/agusnieto77/acep/blob/master/R/acep_detect.R"
click node_count "https://github.com/agusnieto77/acep/blob/master/R/acep_count.R"
click node_frec "https://github.com/agusnieto77/acep/blob/master/R/acep_frec.R"
click node_db "https://github.com/agusnieto77/acep/blob/master/R/acep_db.R"
click node_intensity "https://github.com/agusnieto77/acep/blob/master/R/acep_int.R"
click node_timeseries "https://github.com/agusnieto77/acep/blob/master/R/acep_sst.R"
click node_plotrst "https://github.com/agusnieto77/acep/blob/master/R/acep_plot_rst.R"
click node_plotst "https://github.com/agusnieto77/acep/blob/master/R/acep_plot_st.R"
click node_claude "https://github.com/agusnieto77/acep/blob/master/R/acep_claude.R"
click node_gemini "https://github.com/agusnieto77/acep/blob/master/R/acep_gemini.R"
click node_gpt "https://github.com/agusnieto77/acep/blob/master/R/acep_gpt.R"
click node_ollama "https://github.com/agusnieto77/acep/blob/master/R/acep_ollama.R"
click node_openrouter "https://github.com/agusnieto77/acep/blob/master/R/acep_openrouter.R"
click node_together "https://github.com/agusnieto77/acep/blob/master/R/acep_together.R"
click node_loadbase "https://github.com/agusnieto77/acep/blob/master/R/acep_load_base.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_clean,node_case,node_lower,node_extract,node_context,node_token,node_postag,node_hybrid,node_upos,node_svo,node_chunks,node_pipeline toneBlue
class node_detect,node_count,node_frec,node_db,node_intensity,node_timeseries,node_plotrst,node_plotst toneAmber
class node_claude,node_gemini,node_gpt,node_ollama,node_openrouter,node_together,node_openrouter_service toneMint
class node_loadbase toneRose
class node_user,node_anthropic,node_google,node_openai,node_localmodels,node_together_service toneIndigo
```

## Components

### Text processing

- [Clean text](https://github.com/agusnieto77/acep/blob/master/R/acep_clean.R): `R/acep_clean.R`
- [Case conversion](https://github.com/agusnieto77/acep/blob/master/R/acep_may.R): `R/acep_may.R`
- [Lowercase text](https://github.com/agusnieto77/acep/blob/master/R/acep_min.R): `R/acep_min.R`
- [Word extraction](https://github.com/agusnieto77/acep/blob/master/R/acep_extract.R): `R/acep_extract.R`
- [Context extraction](https://github.com/agusnieto77/acep/blob/master/R/acep_context.R): `R/acep_context.R`
- [Tokenization](https://github.com/agusnieto77/acep/blob/master/R/acep_token.R): `R/acep_token.R`
- [POS and entities](https://github.com/agusnieto77/acep/blob/master/R/acep_postag.R): `R/acep_postag.R`
- [Hybrid POS](https://github.com/agusnieto77/acep/blob/master/R/acep_postag_hibrido.R): `R/acep_postag_hibrido.R`
- [UPOS tagging](https://github.com/agusnieto77/acep/blob/master/R/acep_upos.R): `R/acep_upos.R`
- [SVO extraction](https://github.com/agusnieto77/acep/blob/master/R/acep_svo.R): `R/acep_svo.R`
- [Chunk processing](https://github.com/agusnieto77/acep/blob/master/R/acep_process_chunks.R): `R/acep_process_chunks.R`
- [Text pipeline](https://github.com/agusnieto77/acep/blob/master/R/acep_pipeline.R): `R/acep_pipeline.R`

### Protest analysis

- [Mention detection](https://github.com/agusnieto77/acep/blob/master/R/acep_detect.R): `R/acep_detect.R`
- [Mention frequency](https://github.com/agusnieto77/acep/blob/master/R/acep_count.R): `R/acep_count.R`
- [Word frequency](https://github.com/agusnieto77/acep/blob/master/R/acep_frec.R): `R/acep_frec.R`
- [Conflict analysis](https://github.com/agusnieto77/acep/blob/master/R/acep_db.R): `R/acep_db.R`
- [Intensity index](https://github.com/agusnieto77/acep/blob/master/R/acep_int.R): `R/acep_int.R`
- [Conflict time series](https://github.com/agusnieto77/acep/blob/master/R/acep_sst.R): `R/acep_sst.R`
- [Series summary plot](https://github.com/agusnieto77/acep/blob/master/R/acep_plot_rst.R): `R/acep_plot_rst.R`
- [Series bar plot](https://github.com/agusnieto77/acep/blob/master/R/acep_plot_st.R): `R/acep_plot_st.R`

### Language models

- [Claude client](https://github.com/agusnieto77/acep/blob/master/R/acep_claude.R): `R/acep_claude.R`
- [Gemini client](https://github.com/agusnieto77/acep/blob/master/R/acep_gemini.R): `R/acep_gemini.R`
- [GPT client](https://github.com/agusnieto77/acep/blob/master/R/acep_gpt.R): `R/acep_gpt.R`
- [Ollama client](https://github.com/agusnieto77/acep/blob/master/R/acep_ollama.R): `R/acep_ollama.R`
- [OpenRouter client](https://github.com/agusnieto77/acep/blob/master/R/acep_openrouter.R): `R/acep_openrouter.R`
- [TogetherAI client](https://github.com/agusnieto77/acep/blob/master/R/acep_together.R): `R/acep_together.R`

### Data resources

- [Load base data](https://github.com/agusnieto77/acep/blob/master/R/acep_load_base.R): `R/acep_load_base.R`

### Other components

- **Analyst**
- **Anthropic Claude**
- **Google Gemini**
- **OpenAI GPT**
- **Local Ollama**
- **OpenRouter models**
- **TogetherAI models**

## Connections

- Analyst → Clean text: uses (evidence: `README.md`)
- Analyst → Mention detection: uses (evidence: `README.md`)
- Analyst → Mention frequency: uses (evidence: `README.md`)
- Analyst → Conflict time series: uses (evidence: `README.md`)
- Analyst → Text pipeline: uses (evidence: `README.md`)
- Analyst → Load base data: loads (evidence: `README.md`)
- Analyst → POS and entities: uses (evidence: `README.md`)
- Analyst → Hybrid POS: uses (evidence: `README.md`)
- Analyst → UPOS tagging: uses (evidence: `README.md`)
- Analyst → SVO extraction: uses (evidence: `README.md`)
- Analyst → Claude client: uses (evidence: `README.md`)
- Analyst → Gemini client: uses (evidence: `README.md`)
- Analyst → GPT client: uses (evidence: `README.md`)
- Analyst → Ollama client: uses (evidence: `README.md`)
- Analyst → OpenRouter client: uses (evidence: `README.md`)
- Analyst → TogetherAI client: uses (evidence: `README.md`)
- Claude client → Anthropic Claude: interacts (evidence: `README.md`)
- Gemini client → Google Gemini: interacts (evidence: `README.md`)
- GPT client → OpenAI GPT: interacts (evidence: `README.md`)
- Ollama client → Local Ollama: interacts (evidence: `README.md`)
- OpenRouter client → OpenRouter models: interacts (evidence: `README.md`)
- TogetherAI client → TogetherAI models: interacts (evidence: `README.md`)
