Metadata-Version: 2.1
Name: edvart
Version: 4.0.0
Summary: Effective data visualization and reporting tool
Home-page: https://github.com/datamole-ai/edvart
License: MIT
Author: Michal Belak
Author-email: michal.belak@datamole.ai
Requires-Python: >=3.9,<3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Provides-Extra: all
Provides-Extra: arrow
Provides-Extra: umap
Requires-Dist: colorlover
Requires-Dist: ipykernel
Requires-Dist: ipywidgets (>=7.5,<9)
Requires-Dist: isort (>=5.10.1,<6.0.0)
Requires-Dist: matplotlib (>=3.3,<4.0)
Requires-Dist: nbconvert (>=7.0.0,<8.0.0)
Requires-Dist: nbformat
Requires-Dist: numba (>=0.59,<0.60) ; extra == "umap" or extra == "all"
Requires-Dist: numpy (>=1.26.0,<2.0.0) ; python_version >= "3.12"
Requires-Dist: numpy ; python_version < "3.12"
Requires-Dist: pandas (>=1.5,<2.3)
Requires-Dist: plotly (>=4.0.0,<6)
Requires-Dist: pyarrow (>=14.0.1,<15.0.0) ; extra == "arrow" or extra == "all"
Requires-Dist: scikit-learn (>=0.22.1)
Requires-Dist: scipy (>=1.11,<2.0) ; python_version >= "3.12"
Requires-Dist: seaborn (>=0.13,<0.14)
Requires-Dist: statsmodels (>0.10.2)
Requires-Dist: strenum (>=0.4.15,<0.5.0) ; python_version < "3.11"
Requires-Dist: umap-learn (>=0.5.4,<0.6.0) ; extra == "umap" or extra == "all"
Project-URL: Repository, https://github.com/datamole-ai/edvart
Description-Content-Type: text/markdown

# Edvart

<p align="center">
    <a href="https://pypi.org/project/edvart">
        <img src="https://img.shields.io/pypi/pyversions/edvart.svg?color=%2334D058" alt="Supported Python versions">
    </a>
    <a href="https://pypi.org/project/edvart" target="_blank">
        <img src="https://img.shields.io/pypi/v/edvart?color=%2334D058&label=pypi%20package" alt="Package version">
    </a>
    <a href="https://pypi.org/project/edvart">
        <img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/edvart.svg?label=PyPI%20downloads">
    </a>
    <a href="https://github.com/astral-sh/ruff">
        <img alt="Ruff", src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json">
    </a>
</p>

Edvart is an open-source Python library designed to simplify and streamline
your exploratory data analysis (EDA) process.

## Key Features
* **One-line Reports**: Generate a comprehensive set of pandas DataFrame
visualizations using a single Python statement.
Edvart supports:
    - Data overview,
    - Univariate analysis,
    - Bivariate analysis,
    - Multivariate analysis,
    - Grouped analysis,
    - Time series analysis.
* **Customizable Reports**: Produce, iterate, and style detailed reports
    in Jupyter notebooks and HTML formats.
* **Flexible API**: From high-level simplicity in a single line of code
    to detailed control, choose the API level that fits your needs.
* **Interactive Visualizations**: Many of the visualizations are interactive
    and can be used to explore the data in detail.

## One-line Report

![Edvart report demo](images/edvart-demo.gif)

## Installation

Edvart is available on PyPI and can be installed using pip:

```bash
pip install edvart
```

## Usage


See the notebook
[examples/report-example.ipynb](https://nbviewer.org/github/datamole-ai/edvart/blob/main/examples/report-example.ipynb)
for an example report on a tabular dataset or
[examples/time-series-report-example.ipynb](https://nbviewer.org/github/datamole-ai/edvart/blob/main/examples/time-series-report-example.ipynb)
for an example report on a time-series dataset.

See the [Usage section](https://datamole-ai.github.io/edvart/usage.html) of the documentation
for more information.

### Creating a Default Report

```python
import edvart

# Load a dataset to a pandas DataFrame
dataset = edvart.example_datasets.dataset_titanic()
# Create a default report
report = edvart.DefaultReport(dataset)
# Show the report in the current Jupyter notebook
report.show()
# Export the report to an HTML file
report.export_html("report.html")
# Export the code generating the report to a Jupyter notebook
report.export_notebook("report.ipynb")
```

## User Documentation

The user documentation is available at https://datamole-ai.github.io/edvart/.

## License

Edvart is licensed under the [MIT
license](https://opensource.org/license/mit/). See the LICENSE file for more
details.

## Contact
Edvart has a [Gitter room](https://app.gitter.im/#/room/#edvart:gitter.im)
for development-related and general discussions.

## How to Contribute

See [CONTRIBUTING.md](CONTRIBUTING.md).

