# osome-iu/coordination-detection architecture

> Architecture diagram of the GitHub repository osome-iu/coordination-detection, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/osome-iu/coordination-detection
- Repository: https://github.com/osome-iu/coordination-detection

## Overview

This repository reproduces four social-media coordination case studies from a research paper; it does not include Case Study 2. Each notebook represents a distinct method for identifying links between accounts: shared handles, hashtag sequences, co-retweets, or synchronized activity intervals. The README documents these methods and some data origins, but no notebook source was available to verify its internal execution, exact inputs, or output handling. The diagram therefore shows the documented analyses without inferring internal calls.

Main entry points: [`CS1/Account_Handle_Sharing.ipynb`](https://github.com/osome-iu/coordination-detection/blob/main/CS1/Account_Handle_Sharing.ipynb) (Handle sharing), [`CS4/co_retweet.ipynb`](https://github.com/osome-iu/coordination-detection/blob/main/CS4/co_retweet.ipynb) (Co-retweet analysis), [`CS3/hashtag_sequence_coordination.ipynb`](https://github.com/osome-iu/coordination-detection/blob/main/CS3/hashtag_sequence_coordination.ipynb) (Hashtag sequences), [`CS5/activity_synchronization.ipynb`](https://github.com/osome-iu/coordination-detection/blob/main/CS5/activity_synchronization.ipynb) (Activity synchronization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cs1["Case Study 1"]
  node_cs1_notebook["Handle sharing"]
  node_cs1_data["Tweet data<br/>[tweets.json]"]
  node_cs1_network["Shared-handle links"]
end

subgraph group_cs3["Case Study 3"]
  node_cs3_notebook["Hashtag sequences"]
  node_cs3_network["Shared-sequence links"]
end

subgraph group_cs4["Case Study 4"]
  node_cs4_notebook["Co-retweet analysis<br/>[co_retweet.ipynb]"]
  node_cs4_data["Sample tweets<br/>[sample.json]"]
  node_cs4_network["Co-retweet links"]
end

subgraph group_cs5["Case Study 5"]
  node_cs5_notebook["Activity synchronization"]
  node_cs5_network["Synchronized-activity links"]
end

node_researcher(("Researcher"))

node_researcher -->|"runs"| node_cs1_notebook
node_cs1_notebook -->|"reads"| node_cs1_data
node_cs1_notebook -->|"identifies"| node_cs1_network
node_researcher -->|"runs"| node_cs3_notebook
node_cs3_notebook -->|"identifies"| node_cs3_network
node_researcher -->|"runs"| node_cs4_notebook
node_cs4_notebook -->|"reads"| node_cs4_data
node_cs4_notebook -->|"identifies"| node_cs4_network
node_researcher -->|"runs"| node_cs5_notebook
node_cs5_notebook -->|"identifies"| node_cs5_network

click node_cs1_notebook "https://github.com/osome-iu/coordination-detection/blob/main/CS1/Account_Handle_Sharing.ipynb"
click node_cs1_data "https://github.com/osome-iu/coordination-detection/blob/main/CS1/tweets.json"
click node_cs3_notebook "https://github.com/osome-iu/coordination-detection/blob/main/CS3/hashtag_sequence_coordination.ipynb"
click node_cs4_notebook "https://github.com/osome-iu/coordination-detection/blob/main/CS4/co_retweet.ipynb"
click node_cs4_data "https://github.com/osome-iu/coordination-detection/blob/main/CS4/data/sample.json"
click node_cs5_notebook "https://github.com/osome-iu/coordination-detection/blob/main/CS5/activity_synchronization.ipynb"

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_cs1_notebook,node_cs1_data,node_cs1_network toneBlue
class node_cs3_notebook,node_cs3_network toneAmber
class node_cs4_notebook,node_cs4_data,node_cs4_network toneMint
class node_cs5_notebook,node_cs5_network toneRose
class node_researcher toneIndigo
```

## Components

### Case Study 1

- [Handle sharing](https://github.com/osome-iu/coordination-detection/blob/main/CS1/Account_Handle_Sharing.ipynb): `CS1/Account_Handle_Sharing.ipynb`
- [Tweet data](https://github.com/osome-iu/coordination-detection/blob/main/CS1/tweets.json): `CS1/tweets.json`
- **Shared-handle links**

### Case Study 3

- [Hashtag sequences](https://github.com/osome-iu/coordination-detection/blob/main/CS3/hashtag_sequence_coordination.ipynb): `CS3/hashtag_sequence_coordination.ipynb`
- **Shared-sequence links**

### Case Study 4

- [Co-retweet analysis](https://github.com/osome-iu/coordination-detection/blob/main/CS4/co_retweet.ipynb): `CS4/co_retweet.ipynb`
- [Sample tweets](https://github.com/osome-iu/coordination-detection/blob/main/CS4/data/sample.json): `CS4/data/sample.json`
- **Co-retweet links**

### Case Study 5

- [Activity synchronization](https://github.com/osome-iu/coordination-detection/blob/main/CS5/activity_synchronization.ipynb): `CS5/activity_synchronization.ipynb`
- **Synchronized-activity links**

### Other components

- **Researcher**

## Connections

- Researcher → Handle sharing: runs
- Handle sharing → Tweet data: reads
- Handle sharing → Shared-handle links: identifies
- Researcher → Hashtag sequences: runs
- Hashtag sequences → Shared-sequence links: identifies
- Researcher → Co-retweet analysis: runs
- Co-retweet analysis → Sample tweets: reads
- Co-retweet analysis → Co-retweet links: identifies
- Researcher → Activity synchronization: runs
- Activity synchronization → Synchronized-activity links: identifies