# jvianna07/arcbands architecture

> Architecture diagram of the GitHub repository jvianna07/arcbands, 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/jvianna07/arcbands
- Repository: https://github.com/jvianna07/arcbands

## Overview

ArcBands is a small Python visualization library: callers provide values and categories, configure a chart, add annotations, and save the resulting Matplotlib figure. The runtime is concentrated in `arcbands/core.py`; `arcbands/__init__.py` exposes its class as the package API. The README documents support for existing Axes and subplot/dashboard layouts. The sampled source shows chart construction and annotation behavior, but does not show the full plotting or save implementation, so those internal details are not expanded.

Main entry points: [`arcbands/core.py`](https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py) (Chart lifecycle), [`arcbands/__init__.py`](https://github.com/jvianna07/arcbands/blob/main/arcbands/__init__.py) (ArcBands export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Package API"]
  node_export["ArcBands export<br/>[__init__.py]"]
end

subgraph group_chart["Chart Rendering"]
  node_chart["Chart lifecycle<br/>[core.py]"]
  node_mpl["Matplotlib Figure/Axes"]
  node_bands["Radial bands<br/>[core.py]"]
  node_values["Value annotations<br/>[core.py]"]
  node_labels["Category labels<br/>[core.py]"]
  node_text["Titles and text<br/>[core.py]"]
  node_save["Chart export<br/>[core.py]"]
end

node_caller(("Python caller"))

node_caller -->|"imports"| node_export
node_export -->|"exports"| node_chart
node_caller -->|"creates"| node_chart
node_chart -->|"creates or reuses"| node_mpl
node_chart -.->|"plots"| node_bands
node_chart -->|"adds"| node_values
node_chart -->|"adds"| node_labels
node_chart -.->|"adds"| node_text
node_chart -.->|"saves"| node_save
node_bands -.->|"renders on"| node_mpl
node_values -->|"annotates"| node_mpl
node_labels -->|"annotates"| node_mpl
node_text -->|"annotates"| node_mpl

click node_export "https://github.com/jvianna07/arcbands/blob/main/arcbands/__init__.py"
click node_chart "https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py"
click node_bands "https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py"
click node_values "https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py"
click node_labels "https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py"
click node_text "https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py"
click node_save "https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py"

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_export toneBlue
class node_chart,node_mpl,node_bands,node_values,node_labels,node_text,node_save toneAmber
class node_caller toneIndigo
```

## Components

### Package API

- [ArcBands export](https://github.com/jvianna07/arcbands/blob/main/arcbands/__init__.py): `arcbands/__init__.py`

### Chart Rendering

- [Chart lifecycle](https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py): `arcbands/core.py`
- **Matplotlib Figure/Axes**
- [Radial bands](https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py): `arcbands/core.py`
- [Value annotations](https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py): `arcbands/core.py`
- [Category labels](https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py): `arcbands/core.py`
- [Titles and text](https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py): `arcbands/core.py`
- [Chart export](https://github.com/jvianna07/arcbands/blob/main/arcbands/core.py): `arcbands/core.py`

### Other components

- **Python caller**

## Connections

- Python caller → ArcBands export: imports (evidence: `README.md`)
- ArcBands export → Chart lifecycle: exports (evidence: `arcbands/__init__.py`)
- Python caller → Chart lifecycle: creates (evidence: `README.md`)
- Chart lifecycle → Matplotlib Figure/Axes: creates or reuses (evidence: `arcbands/core.py`)
- Chart lifecycle → Radial bands: plots (evidence: `arcbands/core.py`)
- Chart lifecycle → Value annotations: adds (evidence: `arcbands/core.py`)
- Chart lifecycle → Category labels: adds (evidence: `arcbands/core.py`)
- Chart lifecycle → Titles and text: adds (evidence: `arcbands/core.py`)
- Chart lifecycle → Chart export: saves (evidence: `arcbands/core.py`)
- Radial bands → Matplotlib Figure/Axes: renders on
- Value annotations → Matplotlib Figure/Axes: annotates (evidence: `arcbands/core.py`)
- Category labels → Matplotlib Figure/Axes: annotates (evidence: `arcbands/core.py`)
- Titles and text → Matplotlib Figure/Axes: annotates (evidence: `arcbands/core.py`)
