RadViz-Plotly 0.0.5
2D RadViz and 3D RadViz library, using plotly 2D and 3D scatter plot
Requires Python: >=3.6

# RadViz-Plotly

<table>
    <tr>
        <td>Latest Release</td>
        <td>
            <a href="https://pypi.org/project/RadViz-Plotly/"/>
            <img src="https://badge.fury.io/py/RadViz-Plotly.svg"/>
        </td>
    </tr>
    <tr>
        <td>Examples</td>
        <td>
            <a href="https://mybinder.org/v2/gh/elewah/RadViz-Plotly-Examples/master"/>
            <img src="https://img.shields.io/badge/Jupyter--Lab-Examples-orange"/>
        </td>
    </tr>
    <tr>
        <td>PyPI Downloads</td>
        <td>
            <a href="https://pepy.tech/project/RadViz-Plotly"/>
            <img src="https://pepy.tech/badge/RadViz-Plotly"/>
        </td>
    </tr>
    <tr>
        <td>License</td>
        <td>
            <a href="https://opensource.org/licenses/MIT"/>
            <img src="https://img.shields.io/badge/License-MIT-yellow.svg"/>
        </td>
    </tr>
</table>

## Short Description 
The Radviz-Plotly package has two functions, 2DRadViz that plots the 2D Radial visualization and 3DRadViz that plots Radial visualization, using the powerful interactive tools in Plotly library.


## Quickstart 
### Without Locally Installation
Try the RadViz-Plotly package **without locally Installation
Follow these steps**</br>
1- Click this link [here](https://mybinder.org/v2/gh/elewah/RadViz-Plotly-Examples/master). It's a collection of interactive Jupyter notebooks  that contains three folders. Each folder contains Dataset and a Jupyter file that use RadViz-Plotly.</br>
**Hint:**  sometimes this link takes a long time to open as jupyter's environment.</br>
2- After the jupyter environment comes out, open Car Evaluation Dataset, Election Dataset, or Iris Dataset folder.  </br>
3- Open file with extension **.ipynb** (the jupyter file)</br>
4- After the jypyter file loading, from the **cell** list on the toolbar click **Run All** </br>
**Hints:**  </br>
A- At the first running time, it takes time to install the dependences.</br>
B- This is an interactive RadViz package where you can make zoom, fillter lables, and rotate the 3D graph </br>
C- This packge depends on the [plotly.py](https://plot.ly/python) packge</br>
### With Locally Installation
 
1- Install **RadViz Plotly** using this command</br>
```pip install RadViz-Plotly```
</br>
2- Download examples repository using this command </br>
```git clone  https://github.com/elewah/RadViz-Plotly-Examples.git``` </br>
or Download by clicking [here](https://github.com/elewah/RadViz-Plotly-Examples/archive/master.zip) </br>
3- Run these examples using jupyter labs to understand how to use RadViz-Plotly package

---
## Gallary
<p align="center">
  <img src="https://elewah.github.io/images/ReadmePicture/3D-1.gif" width="400" title="3D RadViz">
  <img src="https://elewah.github.io/images/ReadmePicture/3D-2.gif" width="400" title="3D RadViz">
  <img src="https://elewah.github.io/images/ReadmePicture/Slide3.PNG" width="400" title="2D RadViz">
  <img src="https://elewah.github.io/images/ReadmePicture/Slide2.PNG" width="400" title="3D RadViz">
</p>

## About
The RadViz-Plotly package has two functions, 2DRadViz for plotting the 2D Radial visualization, and 3DRadViz for drawing the 3D Radial visualization, using the powerful interactive tools in the Plotly library. A research group on the IoT lab at Ontario tech university developed it.

## Citations
Kindly cite this paper in your research if it helps your work.</br>
[A. Elewah, A. A. Badawi, H. Khalil, S. Rahnamayan and K. Elgazzar, "3D-RadViz: Three Dimensional Radial Visualization for Large-Scale Data Visualization," 2021 IEEE Congress on Evolutionary Computation (CEC), 2021, pp. 1037-1046, doi: 10.1109/CEC45853.2021.9504983.](https://ieeexplore.ieee.org/document/9504983) 

## Contact Us
 **Email:** abdelrahman.elewah@ontariotechu.ca
 
## Copyright and Licenses

Code released under the [MIT license](LICENSE).