# madhavan006/jdat architecture

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

- Interactive diagram: https://gitdiagram.com/madhavan006/jdat
- Repository: https://github.com/madhavan006/jdat

## Overview

JDat is a lightweight Java DataFrame library. A caller uses the public API to load tabular data, inspect and manipulate it, and perform statistics or joins. The core DataFrame implementation owns CSV loading and the documented tabular operations, using Series for column values and Row for row access. The tree contains both `com/dataframe` and `com/jdat` source trees, while excerpts show inconsistent package references; their exact relationship is unclear, so this map follows the documented `com.jdat` API and the matching implementation paths. Unsampled capabilities are included where the README documents them.

Main entry points: [`src/main/java/com/jdat/api/DataFrame.java`](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/api/DataFrame.java) (DataFrame API), [`src/main/java/com/jdat/core/DataFrame.java`](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java) (DataFrame Core), [`src/main/java/com/jdat/api/Series.java`](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/api/Series.java) (Series API), [`src/main/java/com/jdat/api/Row.java`](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/api/Row.java) (Row API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public API"]
  node_api_df["DataFrame API<br/>[DataFrame.java]"]
  node_api_series["Series API<br/>[Series.java]"]
  node_api_row["Row API<br/>[Row.java]"]
end

subgraph group_data["Data Model"]
  node_engine["DataFrame Core<br/>[DataFrame.java]"]
  node_series["Series Core<br/>[Series.java]"]
  node_row["Row Core<br/>[Row.java]"]
end

subgraph group_analysis["Analysis Operations"]
  node_selection["Selection &amp; Sorting<br/>[DataFrame.java]"]
  node_grouping["Grouping &amp; Aggregation<br/>[DataFrame.java]"]
  node_join["DataFrame Joins<br/>[DataFrame.java]"]
  node_summary["Summary &amp; Profile<br/>[DataFrame.java]"]
  node_statistics["Series Statistics<br/>[Series.java]"]
end

node_caller(("Library Caller"))
node_csv["CSV Input"]

node_caller -->|"uses"| node_api_df
node_api_df -->|"delegates"| node_engine
node_api_df -->|"returns"| node_api_series
node_api_df -->|"returns"| node_api_row
node_api_series -->|"delegates"| node_series
node_api_row -->|"delegates"| node_row
node_engine -->|"reads"| node_csv
node_engine -->|"builds columns"| node_series
node_engine -->|"creates rows"| node_row
node_api_df -->|"exposes"| node_selection
node_api_df -->|"exposes"| node_grouping
node_api_df -->|"exposes"| node_join
node_api_df -->|"exposes"| node_summary
node_api_series -->|"exposes"| node_statistics

click node_api_df "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/api/DataFrame.java"
click node_api_series "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/api/Series.java"
click node_api_row "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/api/Row.java"
click node_engine "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java"
click node_series "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/Series.java"
click node_row "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/Row.java"
click node_selection "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java"
click node_grouping "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java"
click node_join "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java"
click node_summary "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java"
click node_statistics "https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/Series.java"

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_api_df,node_api_series,node_api_row toneBlue
class node_engine,node_series,node_row toneAmber
class node_selection,node_grouping,node_join,node_summary,node_statistics toneMint
class node_caller,node_csv toneIndigo
```

## Components

### Public API

- [DataFrame API](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/api/DataFrame.java): `src/main/java/com/jdat/api/DataFrame.java`
- [Series API](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/api/Series.java): `src/main/java/com/jdat/api/Series.java`
- [Row API](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/api/Row.java): `src/main/java/com/jdat/api/Row.java`

### Data Model

- [DataFrame Core](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java): `src/main/java/com/jdat/core/DataFrame.java`
- [Series Core](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/Series.java): `src/main/java/com/jdat/core/Series.java`
- [Row Core](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/Row.java): `src/main/java/com/jdat/core/Row.java`

### Analysis Operations

- [Selection & Sorting](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java): `src/main/java/com/jdat/core/DataFrame.java`
- [Grouping & Aggregation](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java): `src/main/java/com/jdat/core/DataFrame.java`
- [DataFrame Joins](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java): `src/main/java/com/jdat/core/DataFrame.java`
- [Summary & Profile](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/DataFrame.java): `src/main/java/com/jdat/core/DataFrame.java`
- [Series Statistics](https://github.com/madhavan006/jdat/blob/main/src/main/java/com/jdat/core/Series.java): `src/main/java/com/jdat/core/Series.java`

### Other components

- **Library Caller**
- **CSV Input**

## Connections

- Library Caller → DataFrame API: uses (evidence: `README.md`)
- DataFrame API → DataFrame Core: delegates (evidence: `src/main/java/com/jdat/api/DataFrame.java`)
- DataFrame API → Series API: returns (evidence: `src/main/java/com/jdat/api/DataFrame.java`)
- DataFrame API → Row API: returns (evidence: `src/main/java/com/jdat/api/DataFrame.java`)
- Series API → Series Core: delegates (evidence: `src/main/java/com/jdat/api/Series.java`)
- Row API → Row Core: delegates (evidence: `src/main/java/com/jdat/api/Row.java`)
- DataFrame Core → CSV Input: reads (evidence: `src/main/java/com/jdat/core/DataFrame.java`)
- DataFrame Core → Series Core: builds columns (evidence: `src/main/java/com/jdat/core/DataFrame.java`)
- DataFrame Core → Row Core: creates rows (evidence: `src/main/java/com/jdat/core/DataFrame.java`)
- DataFrame API → Selection & Sorting: exposes (evidence: `src/main/java/com/jdat/api/DataFrame.java`)
- DataFrame API → Grouping & Aggregation: exposes (evidence: `src/main/java/com/jdat/api/DataFrame.java`)
- DataFrame API → DataFrame Joins: exposes (evidence: `src/main/java/com/jdat/api/DataFrame.java`)
- DataFrame API → Summary & Profile: exposes (evidence: `src/main/java/com/jdat/api/DataFrame.java`)
- Series API → Series Statistics: exposes (evidence: `src/main/java/com/jdat/api/Series.java`)
