edaSol
A Python library for the repetitive first pass of exploratory data analysis (EDA).
edaSol turns the checks you run on every new dataset into single function calls. It covers data types, missing values, duplicates, outliers, and distributions. Each function returns a plain pandas object or a matplotlib figure, so you keep working with the result instead of reformatting it.
Features
- Column summary returns data types, null counts, null percentages, and unique counts in one table.
- Data quality report returns shape, memory use, duplicate count, and a missing-value breakdown in one dictionary.
- IQR outlier detection returns the index labels of outliers, with optional lower and upper bounds.
- Categorical summary returns the count, cardinality, and most frequent value per column.
- Six plotting helpers draw distributions, a correlation heatmap, a missing-value matrix, category bars, boxplots, and pairplots.
Installation
pip install edasol
Naming: PyPI normalizes the distribution name to lowercase
edasol, while the import name keeps its original casing. Installedasol, then writeimport edaSol.
Install from source for development:
git clone https://github.com/SoloWPM23/edaSol.git
cd edaSol
pip install -e ".[dev]"
Quick Start
import pandas as pd
from edaSol import quick_summary, data_quality_report, plot_numerical_dist
df = pd.read_csv('your_data.csv')
# Summarize every column
summary = quick_summary(df)
print(summary)
# Inspect overall quality
report = data_quality_report(df)
print(f"Shape: {report['shape']}")
print(f"Duplicates: {report['duplicates']}")
print(f"Memory: {report['memory_usage']} MB")
# Plot numeric distributions
plot_numerical_dist(df)
API Reference
Core Functions
quick_summary(df, columns=None)
Returns a summary table with the data type, null count, null percentage, unique count, and a sample value for each column.
from edaSol import quick_summary
summary = quick_summary(df)
summary = quick_summary(df, columns=['age', 'salary'])
detect_outliers_iqr(df, column, return_bounds=False)
Detects outliers in a numeric column with the interquartile range (IQR) method. Returns the index labels of the outlier rows, and the bounds when you ask for them.
from edaSol import detect_outliers_iqr
outliers = detect_outliers_iqr(df, 'price')
outliers, lower, upper = detect_outliers_iqr(df, 'price', return_bounds=True)
describe_categorical(df, columns=None)
Returns the count, cardinality, top value, top frequency, and top percentage for each categorical column. With columns=None it picks the object and category columns.
from edaSol import describe_categorical
cat_stats = describe_categorical(df)
detect_duplicates(df, subset=None, keep='first')
Returns the duplicate rows. Limit the comparison to specific columns with subset, and control which copy counts as the original with keep.
from edaSol import detect_duplicates
duplicates = detect_duplicates(df)
duplicates = detect_duplicates(df, subset=['name', 'email'])
data_quality_report(df)
Returns one dictionary with the shape, memory usage, data type counts, missing-value table, duplicate count, numeric summary, and categorical summary.
from edaSol import data_quality_report
report = data_quality_report(df)
# Keys: shape, memory_usage, dtypes, missing, duplicates,
# numeric_summary, categorical_summary
Visualization Functions
Every plotting function accepts show. Leave it at True to display the plot, or set it to False to get the figure object back for saving or further edits.
plot_numerical_dist(df, columns=None, figsize=(12, 4), show=True)
Draws a histogram with a KDE curve for each numeric column.
from edaSol import plot_numerical_dist
plot_numerical_dist(df)
plot_numerical_dist(df, columns=['age', 'salary'])
plot_correlation_heatmap(df, figsize=(10, 8), annot=True, mask_upper=True, show=True)
Draws a correlation heatmap for the numeric columns. Set mask_upper=False to show the full matrix.
from edaSol import plot_correlation_heatmap
plot_correlation_heatmap(df)
plot_correlation_heatmap(df, mask_upper=False)
plot_missing_matrix(df, figsize=(12, 6), show=True)
Draws the missing-value pattern as a matrix and prints the total share of missing cells.
from edaSol import plot_missing_matrix
plot_missing_matrix(df)
plot_categorical_dist(df, columns=None, figsize=(12, 4), top_n=10, show=True)
Draws a bar plot of value counts for each categorical column. Use top_n to cap how many categories appear.
from edaSol import plot_categorical_dist
plot_categorical_dist(df)
plot_categorical_dist(df, top_n=5)
plot_boxplots(df, columns=None, figsize=(12, 4), show=True)
Draws a boxplot for each numeric column to show spread and outliers.
from edaSol import plot_boxplots
plot_boxplots(df)
plot_boxplots(df, columns=['age', 'income'])
plot_pairplot(df, columns=None, hue=None, diag_kind='kde', show=True)
Draws pairwise scatter plots for the numeric columns. With columns=None it uses the first five numeric columns. Pass hue to color the points by a category.
from edaSol import plot_pairplot
plot_pairplot(df)
plot_pairplot(df, hue='category')
Requirements
- Python 3.8 or newer
- pandas 1.5.0 or newer
- numpy 1.20.0 or newer
- matplotlib 3.5.0 or newer
- seaborn 0.11.0 or newer
Contributing
Read CONTRIBUTING.md for the development setup, coding standards, and pull request steps. Report bugs on the issue tracker.
Changelog
See CHANGELOG.md for the release history.
License
edaSol is released under the MIT License. See LICENSE for the full text.
Author
Solo Manurung (solowandika490@gmail.com)
Metadata
Release files for edaSol 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| edasol-1.0.0.tar.gz | 14.2 kB | With provenance | Details for edasol-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| edasol-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for edasol-1.0.0-py3-none-any.whl |
Total release size: 24.9 kB
Release files / edasol-1.0.0.tar.gz
| Download URL | edasol-1.0.0.tar.gz |
|---|---|
| Size | 14.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
515cfed1cb74a510bf22bced17402dfa3793b19515d46d7e0b57ff0c321870b4
|
|
BLAKE2b-256 checksum How to use checksums |
00c024ff7a65ae9196970d954f492669204c3094ea9a096e63268c19f75c6756
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logRelease files / edasol-1.0.0-py3-none-any.whl
| Download URL | edasol-1.0.0-py3-none-any.whl |
|---|---|
| Size | 10.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c9f9abd35578c07c7435888fc7e5c75f72d4552c36f0a6b6742ec01c0f0be79c
|
|
BLAKE2b-256 checksum How to use checksums |
8129bf778911c6784ce89cb804f2cdc9b2d82a9ee12923cadb560d51cb0c2362
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logSecurity for edaSol 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for edasol-1.0.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.