AutoViz: The One-Line Automatic Data Visualization Library

Unlock the power of AutoViz to visualize any dataset, any size, with just a single line of code! Plus, now you can save these interactive charts as HTML files automatically with the html setting.

With AutoViz, you can easily and quickly generate insightful visualizations for your data. Whether you're a beginner or an expert in data analysis, AutoViz can help you explore your data and uncover valuable insights. Try it out and see the power of automated visualization for yourself!

The purpose and motivation for AutoViz
How to install and setup AutoViz in your environment
How to use AutoViz with various options and settings
The API and available options
Examples to get you started
Maintainers
Contributing to the project
License
Additional Tips before you start
Disclaimer

Motivation

The motivation to create AutoViz stems from the need for a more efficient, user-friendly, and automated approach to data visualization. Visualizing data is a crucial step in the data analysis process, as it helps users understand patterns, trends, and relationships in the data. However, creating insightful visualizations can be time-consuming and require specialized knowledge of various plotting libraries and techniques.

AutoViz addresses these challenges by providing an easy-to-use, automated solution for generating meaningful visualizations with minimal effort. Its key motivation is to:

Save time and effort: AutoViz simplifies the visualization process by requiring just a single line of code to generate multiple insightful plots, eliminating the need to write multiple lines of code for each chart.
Handle large datasets: AutoViz is designed to work with datasets of any size, intelligently sampling the data when necessary to ensure that the visualizations are generated quickly and efficiently, without compromising on the insights.
Accessibility: AutoViz makes data visualization accessible to a broader audience, including non-experts and beginners in data analysis, by abstracting away the complexities of various plotting libraries.
Automate the visualization process: AutoViz intelligently selects the appropriate visualizations for the given data, taking into account the data types and relationships among variables, which helps users quickly gain insights without having to manually decide which plots to create.
Customization and interactivity: AutoViz offers various options for customization, enabling users to tailor the generated visualizations to their specific needs and preferences. Moreover, with interactive chart formats like Bokeh, users can explore the data more dynamically.

In summary, the motivation behind AutoViz is to make data visualization more efficient, accessible, and automated, enabling users to quickly gain valuable insights from their data and focus on making data-driven decisions.

Installation

Prerequisites

Anaconda

Create a new environment and install the required dependencies to clone AutoViz:

From PyPi:

cd <AutoViz_Destination>
git clone [email protected]:AutoViML/AutoViz.git
# or download and unzip https://github.com/AutoViML/AutoViz/archive/master.zip
conda create -n <your_env_name> python=3.7 anaconda
conda activate <your_env_name> # ON WINDOWS: `source activate <your_env_name>`
cd AutoViz
pip install -r requirements.txt

Usage

Discover how to use AutoViz in this Medium article.

In the AutoViz directory, open a Jupyter Notebook or on the command terminal and use this line to instantiate the AutoViz_Class. Note: You no longer need to use from autoviz.AutoViz_Class import AutoViz_Class. Instead, simply run:

from autoviz import AutoViz_Class
AV = AutoViz_Class()
dft = AV.AutoViz(filename)

Feed AutoViz any input filename (in CSV, txt, or JSON format), and set max_rows_analyzed and max_cols_analyzed based on memory limitations in your environment, and watch the magic happen!

AutoViz can now create charts in multiple formats using the chart_format setting:

If chart_format ='png' or 'svg' or 'jpg': Matplotlib charts are plotted inline.
- Can be saved locally (using verbose=2 setting) or displayed (verbose=1) in Jupyter Notebooks.
- This is the default behavior for AutoViz.
If chart_format='bokeh': Interactive Bokeh charts are plotted in Jupyter Notebooks.
If chart_format='server', dashboards will pop up for each kind of chart on your browser.
If chart_format='html', interactive Bokeh charts will be created and silently saved as HTML files under the AutoViz_Plots directory (under working folder) or any other directory that you specify using the save_plot_dir setting (during input).

AV.AutoViz is the main plotting function in AutoViz_Class (AV). Depending on the chart_format you choose, AutoViz will automatically call either the AutoViz_Main function or AutoViz_Holo function.

API

Arguments for AV.AutoViz() method:

filename: Use an empty string ("") if there's no associated filename and you want to use a dataframe; set dfte as the dataframe name. Provide a filename and leave dfte empty to load the dataset.
sep: File separator (comma, semi-colon, tab, or any column-separating value).
depVar: Target variable in your dataset; leave empty if not applicable.
dfte: Input dataframe for plotting charts; leave empty if providing a filename.
header: Row number of the header row in your file (0 for the first row).
verbose: 0 for minimal info and charts, 1 for more info and charts, or 2 for saving charts locally without display.
lowess: Use regression lines for each pair of continuous variables against the target variable in small datasets; avoid using for large datasets (>100,000 rows).
chart_format: 'svg', 'png', 'jpg', 'bokeh', 'server', or 'html' for displaying or saving charts in various formats, depending on the verbose option.
max_rows_analyzed: Limit the max number of rows for chart display, particularly useful for very large datasets (millions of rows) to reduce chart generation time. A statistically valid sample will be used.
max_cols_analyzed: Limit the number of continuous variables to be analyzed.
save_plot_dir: Directory for saving plots. Default is None, which saves plots under the current directory in a subfolder named AutoViz_Plots. If the save_plot_dir doesn't exist, it will be created.

Additional Notes

AutoViz will visualize any sized file using a statistically valid sample.
COMMA is the default separator in the file, but you can change it.
Assumes the first row as the header in the file, but this can be changed.

Verbose Option

Display minimal information but show charts in your notebook
Print extra information on the notebook and display charts
Do not display charts; save them locally under the AutoViz_Plots directory in your current working folder.

Chart Format Option

'svg', 'jpg' or 'png': Display or save all charts, depending on the verbose option
'bokeh': Plot interactive charts using Bokeh in your Jupyter Notebook
'server': Display charts in your browser, with one chart type per tab
'html': Create interactive Bokeh charts and save them under the AutoViz_Plots directory or the directory specified in the save_plot_dir setting.

Examples

Here are some examples to help you get started with AutoViz:

Example 1: Visualize a CSV file with a target variable

from autoviz import AutoViz_Class
AV = AutoViz_Class()

filename = "your_file.csv"
target_variable = "your_target_variable"

dft = AV.AutoViz(
    filename,
    sep=",",
    depVar=target_variable,
    dfte=None,
    header=0,
    verbose=1,
    lowess=False,
    chart_format="svg",
    max_rows_analyzed=150000,
    max_cols_analyzed=30,
    save_plot_dir=None
)

Example 2: Visualize a Pandas DataFrame without a target variable:

import pandas as pd
from autoviz import AutoViz_Class

AV = AutoViz_Class()

data = {'col1': [1, 2, 3, 4, 5], 'col2': [5, 4, 3, 2, 1]}
df = pd.DataFrame(data)

dft = AV.AutoViz(
    "",
    sep=",",
    depVar="",
    dfte=df,
    header=0,
    verbose=1,
    lowess=False,
    chart_format="svg",
    max_rows_analyzed=150000,
    max_cols_analyzed=30,
    save_plot_dir=None
)

Example 3: Generate interactive Bokeh charts and save them as HTML files in a custom directory

from autoviz import AutoViz_Class
AV = AutoViz_Class()

filename = "your_file.csv"
target_variable = "your_target_variable"
custom_plot_dir = "your_custom_plot_directory"

dft = AV.AutoViz(
    filename,
    sep=",",
    depVar=target_variable,
    dfte=None,
    header=0,
    verbose=2,
    lowess=False,
    chart_format="html",
    max_rows_analyzed=150000,
    max_cols_analyzed=30,
    save_plot_dir=custom_plot_dir
)

These examples should give you an idea of how to use AutoViz with different scenarios and settings. By tailoring the options and settings, you can generate visualizations that best suit your needs, whether you're working with large datasets, interactive charts, or simply exploring the relationships between variables.

Maintainers

AutoViz is actively maintained and improved by a team of dedicated developers. If you have any questions, suggestions or issues, feel free to reach out to the maintainers.

Contributing

We welcome contributions from the community! If you're interested in contributing to AutoViz, please follow these steps:

Fork the repository on GitHub

Clone your fork and create a new branch for your feature or bugfix.
Commit your changes to the new branch, ensuring that you follow coding standards and write appropriate tests.
Push your changes to your fork on GitHub.
Submit a pull request to the main repository, detailing your changes and referencing any related issues.

See the contributing file!

License

AutoViz is released under the Apache License, Version 2.0. By using AutoViz, you agree to the terms and conditions specified in the license.

Tips

That covers the main aspects of AutoViz, but here are some additional tips and reminders to help you make the most of the library:

Make sure to regularly upgrade AutoViz to benefit from the latest features, bug fixes, and improvements. You can update it using pip install --upgrade autoviz.
AutoViz is highly customizable, so don't hesitate to explore and experiment with various settings, such as chart_format, verbose, and max_rows_analyzed. This will allow you to create visualizations that better suit your specific needs and preferences.
Remember to delete the AutoViz_Plots directory (or any custom directory you specified) periodically if you used the verbose=2 option, as it can accumulate a large number of saved charts over time.
For further guidance or inspiration, check out the Medium article on AutoViz, as well as other online resources and tutorials.
If you encounter any issues, have questions, or want to suggest improvements, don't hesitate to engage with the AutoViz community through the GitHub repository or other online platforms.

By leveraging AutoViz's powerful and flexible features, you can streamline your data visualization process and gain valuable insights more efficiently. Happy visualizing!

DISCLAIMER

This project is not an official Google project. It is not supported by Google and Google specifically disclaims all warranties as to its quality, merchantability, or fitness for a particular purpose.

AutoViML/AutoViz

AutoViML

Reviews

Repository Details