explainviz 1.0.0__py3-none-any.whl

explainviz/__init__.py

@@ -0,0 +1,30 @@
+__author__ = "Pushkar Kaushalendra Sharma"
+__version__ = "1.0.0"
+__license__ = "MIT"
+
+__about__ = (
+    "ExplainViz is a Python 3.10+ visualization library that not only plots data "
+    "but also explains distribution, stability, relationships, and potential bias "
+    "using rule-based statistical analysis."
+)
+
+from .explain import explain
+from .about import about
+
+from .core.profiler import profile
+from .core.distribution import analyze_distribution
+from .core.changepoints import detect_changes
+from .core.relationships import analyze_relationships
+from .core.auto_plotter import auto_plot
+from .fairness.bias import check_bias
+
+__all__ = [
+    "explain",
+    "about",
+    "profile",
+    "analyze_distribution",
+    "detect_changes",
+    "analyze_relationships",
+    "auto_plot",
+    "check_bias",
+]

explainviz/__main__.py

@@ -0,0 +1,3 @@
+from .about import about
+
+about()

explainviz/about.py

@@ -0,0 +1,13 @@
+def about():
+    print(
+        """
+ExplainViz v1.0.0
+-----------------
+Author  : Pushkar Kaushalendra Sharma
+License : MIT
+Python  : 3.10+
+
+ExplainViz is a visualization-first analytics library that
+automatically explains data behavior alongside plots.
+        """.strip()
+    )

explainviz/core/__init__.py

@@ -0,0 +1,17 @@
+"""
+Core analytical modules for ExplainViz.
+"""
+
+from .profiler import profile
+from .distribution import analyze_distribution
+from .changepoints import detect_changes
+from .relationships import analyze_relationships
+from .auto_plotter import auto_plot
+
+__all__ = [
+    "profile",
+    "analyze_distribution",
+    "detect_changes",
+    "analyze_relationships",
+    "auto_plot",
+]

explainviz/core/auto_plotter.py

@@ -0,0 +1,21 @@
+import matplotlib.pyplot as plt
+
+
+def auto_plot(df, target, group, stats, changes):
+    fig, ax = plt.subplots()
+
+    if group:
+        df.groupby(group)[target].mean().plot(kind="bar", ax=ax)
+    else:
+        df[target].plot(ax=ax)
+
+    ax.axhline(stats["mean"], linestyle="--", label="Mean")
+
+    for i in changes["indices"]:
+        ax.axvline(i, alpha=0.3)
+
+    ax.legend()
+    plt.tight_layout()
+    plt.show()
+
+    return fig

explainviz/core/changepoints.py

@@ -0,0 +1,10 @@
+def detect_changes(series, threshold=2.5):
+    diffs = series.diff().abs()
+    std = series.std()
+
+    points = diffs[diffs > threshold * std].index.tolist()
+
+    return {
+        "count": len(points),
+        "indices": points[:5],
+    }

explainviz/core/distribution.py

@@ -0,0 +1,18 @@
+def analyze_distribution(series):
+    skew = series.skew()
+    kurt = series.kurtosis()
+
+    shape = (
+        "Right-skewed" if skew > 0.5 else
+        "Left-skewed" if skew < -0.5 else
+        "Symmetric"
+    )
+
+    tail = "Heavy-tailed" if kurt > 3 else "Normal-tailed"
+
+    return {
+        "skewness": float(skew),
+        "kurtosis": float(kurt),
+        "shape": shape,
+        "tail": tail,
+    }

explainviz/core/profiler.py

@@ -0,0 +1,18 @@
+def profile(df, target, group=None):
+    s = df[target]
+
+    stats = {
+        "count": int(s.count()),
+        "missing_pct": float(s.isna().mean() * 100),
+        "mean": float(s.mean()),
+        "median": float(s.median()),
+        "std": float(s.std()),
+        "min": float(s.min()),
+        "max": float(s.max()),
+    }
+
+    if group:
+        sizes = df.groupby(group)[target].count()
+        stats["imbalance_ratio"] = float(sizes.max() / sizes.min())
+
+    return stats

explainviz/core/relationships.py

@@ -0,0 +1,11 @@
+def analyze_relationships(df, target):
+    strong = {}
+
+    for col in df.select_dtypes("number"):
+        if col == target:
+            continue
+        corr = df[target].corr(df[col])
+        if corr and abs(corr) >= 0.6:
+            strong[col] = float(corr)
+
+    return strong

explainviz/explain.py

@@ -0,0 +1,23 @@
+from .utils.validators import validate_inputs
+from .core.profiler import profile
+from .core.distribution import analyze_distribution
+from .core.changepoints import detect_changes
+from .core.relationships import analyze_relationships
+from .fairness.bias import check_bias
+from .core.auto_plotter import auto_plot
+from .explainers.formatter import format_explanations
+
+
+def explain(df, *, target, group=None):
+    validate_inputs(df, target, group)
+
+    stats = profile(df, target, group)
+    dist = analyze_distribution(df[target])
+    changes = detect_changes(df[target])
+    relations = analyze_relationships(df, target)
+    bias = check_bias(df, target, group) if group else None
+
+    fig = auto_plot(df, target, group, stats, changes)
+    print(format_explanations(stats, dist, changes, relations, bias))
+
+    return fig

explainviz/explainers/__init__.py

@@ -0,0 +1,7 @@
+"""
+Explanation and formatting utilities for ExplainViz.
+"""
+
+from .formatter import format_explanations
+
+__all__ = ["format_explanations"]

explainviz/explainers/formatter.py

@@ -0,0 +1,22 @@
+def format_explanations(stats, distribution, changes, relations, bias):
+    lines = ["📊 ExplainViz Analysis\n"]
+
+    lines.append("▶ Summary")
+    lines.append(f"• Mean: {stats['mean']:.2f}, Median: {stats['median']:.2f}")
+
+    lines.append("\n▶ Distribution")
+    lines.append(f"• {distribution['shape']} | {distribution['tail']}")
+
+    lines.append("\n▶ Stability")
+    lines.append(f"• Sudden changes: {changes['count']}")
+
+    if relations:
+        lines.append("\n▶ Relationships")
+        for k, v in relations.items():
+            lines.append(f"• {k}: {v:.2f}")
+
+    if bias:
+        lines.append("\n▶ Fairness")
+        lines.append(f"• Disparity ratio: {bias['disparity_ratio']:.2f}")
+
+    return "\n".join(lines)

explainviz/fairness/__init__.py

@@ -0,0 +1,7 @@
+"""
+Fairness and bias analysis modules for ExplainViz.
+"""
+
+from .bias import check_bias
+
+__all__ = ["check_bias"]

explainviz/fairness/bias.py

@@ -0,0 +1,9 @@
+def check_bias(df, target, group):
+    means = df.groupby(group)[target].mean()
+    ratio = means.max() / means.min()
+
+    return {
+        "means": means.to_dict(),
+        "disparity_ratio": float(ratio),
+        "biased": ratio > 1.5,
+    }

explainviz/utils/__init__.py

@@ -0,0 +1,7 @@
+"""
+Utility and validation helpers for ExplainViz.
+"""
+
+from .validators import validate_inputs
+
+__all__ = ["validate_inputs"]

explainviz/utils/validators.py

@@ -0,0 +1,15 @@
+import pandas as pd
+
+
+def validate_inputs(df, target, group):
+    if not isinstance(df, pd.DataFrame):
+        raise TypeError("df must be a pandas DataFrame")
+
+    if target not in df.columns:
+        raise ValueError(f"Target column '{target}' not found")
+
+    if group and group not in df.columns:
+        raise ValueError(f"Group column '{group}' not found")
+
+    if df[target].dropna().empty:
+        raise ValueError("Target column has no usable values")

explainviz-1.0.0.dist-info/METADATA

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: explainviz
+Version: 1.0.0
+Summary: ExplainViz: Visualization that explains data behavior and bias
+Author: Pushkar Kaushalendra Sharma
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: pandas
+Requires-Dist: numpy
+Requires-Dist: matplotlib
+Dynamic: license-file
+
+# ExplainViz
+
+ExplainViz is a Python 3.10+ visualization library that not only plots data,
+but also explains what is happening inside the data using clear,
+rule-based statistical insights.
+
+It is designed to sit on top of Matplotlib and provide:
+- Automatic plots
+- Distribution explanations
+- Stability and change detection
+- Relationship analysis
+- Group bias and fairness checks
+
+ExplainViz focuses on **clarity, reliability, and real-world usability** —
+no black-box AI, no hidden magic.
+
+---
+
+## ✨ Key Features
+
+- 📊 Automatic plot selection (numeric, grouped data)
+- 📈 Distribution analysis (skewness, tails)
+- ⚡ Sudden change detection in data
+- 🔗 Strong relationship detection between variables
+- ⚖️ Group bias and imbalance checks
+- 🧠 Human-readable explanations alongside plots
+- 🐍 Python 3.10+ compatible
+
+---
+
+## 📦 Installation
+
+```bash
+pip install explainviz

explainviz-1.0.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+explainviz/__init__.py,sha256=HFdA9_QfwUPYMXFzTsXruKXUzyAX9-fyyfHLtTsnS3E,838
+explainviz/__main__.py,sha256=HmdqchkdvqgbZpsEJ88ahzj9Zvy1aJ7-HhwLqSbRzhI,37
+explainviz/about.py,sha256=KtoRFyfDf_NfGzf2E197gHYvZJAfwmxKFyYvCbzZT8I,293
+explainviz/explain.py,sha256=srkKMWS_8knIBWN-N3t5TlSBF_iFUrMBcYXOpQvpZa8,847
+explainviz/core/__init__.py,sha256=q3blkuKeGm51FG7IfCsPH70xZV9LVH_xmHrEa-Y-z80,395
+explainviz/core/auto_plotter.py,sha256=AO9c_8aibAqj9NwQYhiYtPUe9UCEtR4Awh7QYTrZ4qE,454
+explainviz/core/changepoints.py,sha256=3UVWFbzIsc_KE9uRAkORneUP5qh1pk97VLz6K89wY6c,249
+explainviz/core/distribution.py,sha256=AlXumejEgqN0TPt0avS9UPGCa_LpNffkxGYw_Mdo2Zc,423
+explainviz/core/profiler.py,sha256=j0BNa3bNDheYUlyYvWhAjjAYJUfOfa6g_UZE_yQXALw,495
+explainviz/core/relationships.py,sha256=NE1myug-4vOiy3k4Tdv4jEjTAZcz1id55YithpI3jwI,292
+explainviz/explainers/__init__.py,sha256=sYmD26LEV6MeAPibW2ATcksa8QQl2v8AnD5ljQg1Ccc,147
+explainviz/explainers/formatter.py,sha256=b9Nd_5ZMOz3fdRAqSATl9h3VbreBP2dlbVjgKw8YqrQ,769
+explainviz/fairness/__init__.py,sha256=wGZD7euJHu3rY6WmOVT-RLDLHQjWDfA59OBMcqrDsIE,122
+explainviz/fairness/bias.py,sha256=FNXBrBJ-CqTRRRZSfauaXdu7BogoxM4XdvNVJ04F3Ss,253
+explainviz/utils/__init__.py,sha256=hgWKC-NutcjP7vW1jPiogGqpjDLW0Iy0jG741bjoWPw,134
+explainviz/utils/validators.py,sha256=KVARKPJpBGtFxnPyOU6HY-Qc83Msm9-RMba65xvJYs8,476
+explainviz-1.0.0.dist-info/licenses/LICENSE.txt,sha256=VnFjhFGqkC33Nm6EmAnWL0VTc9A1Q76E1y8OguGby1I,1230
+explainviz-1.0.0.dist-info/METADATA,sha256=3zCcxy_pbXQqk9L-NO52eGlIVDuyoso8DG_1byVZj-E,1304
+explainviz-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+explainviz-1.0.0.dist-info/top_level.txt,sha256=CiE1TkaKU_az8yTz8AJglQr9B27hBo17gx06F5He0ck,11
+explainviz-1.0.0.dist-info/RECORD,,

explainviz-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

explainviz-1.0.0.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 Pushkar Kaushalendra Sharma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+1. The above copyright notice and this permission notice shall be included in
+   all copies or substantial portions of the Software.
+
+2. Any modifications or derivative works must clearly indicate that changes
+   were made to the original software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

explainviz-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+explainviz