Metadata-Version: 2.4
Name: ironbars
Version: 0.1.0a1
Summary: Intelligent Data Visualization & EDA Assistant
Author-email: Sahil Gour <b25bs1304@iitj.ac.in>
License-Expression: Apache-2.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas>=2.0
Requires-Dist: numpy>=1.24
Requires-Dist: matplotlib>=3.10.8
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: mkdocs; extra == "dev"
Requires-Dist: mkdocs-material; extra == "dev"
Requires-Dist: mkdocstrings[python]; extra == "dev"
Dynamic: license-file

# Ironbars
> ⚠️ This is the **Alpha** branch, code here is untested and may break things.

![Python](https://img.shields.io/badge/Python-3.10%2B-blue) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)

**IronBars** is a Python library that automatically analyzes tabular datasets and
suggests the most suitable visualizations and preprocessing ideas. Instead
of manually guessing which plots to use, IronBars guides you with clean,
interpretive visual suggestions tailored to your data types and relationships.

> **Transform raw datasets into meaningful visual insights through automated, intelligent plot selection.**
---
## Scope
**IronBars** focuses on :-
1. Focused on **Auto EDA (Exploratory Data Analysis)**
2. Suggests and generates suitable plots
3. Designed for structured tabular datasets (CSV / pandas DataFrame)
4. Intended for students, analysts, and ML beginners

## Out of Scope
IronBars does not aim to:
1. Replace full business intelligence platforms
2. Perform automated machine learning
3. Provide deep statistical infer
4. Act as a dashboard framework

---

## How IronBars Thinks

IronBars analyzes each column using structural signals:

1. Uniqueness ratio
2. Missing ratio
3. Volatility score (normalized difference)
4. Datatype detection

These signals are combined into deterministic rules to assign a semantic type to each column.
