Skip to content

Commit e548708

Browse files
committed
feat:simple binding of github.com/Kanaries/pygwalker
0 parents  commit e548708

File tree

14 files changed

+20811
-0
lines changed

14 files changed

+20811
-0
lines changed

.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
__pycache__
2+
dist
3+
.DS_Store

.gitmodules

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
[submodule "graphic-walker"]
2+
path = graphic-walker
3+
url = [email protected]:Kanaries/graphic-walker

MANIFEST.in

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
graft templates/

README.md

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
<p align="center"><a href="#"><img width=60% alt="" src="https://docs-us.oss-us-west-1.aliyuncs.com/img/pygwalker/screenshot-top-img.png"></a></p>
2+
<h2 align="center">pygwalker: Combining Jupyter Notebook with a Tableau-like UI</h2>
3+
4+
<p align="center">
5+
<a href="https://badge.fury.io/py/pygwalker">
6+
<img src="https://badge.fury.io/py/pygwalker.svg" alt="PyPI version" height="18" align="center">
7+
</a>
8+
<a href="https://discord.gg/Z4ngFWXz2U">
9+
<img alt="Discord" src="https://img.shields.io/discord/987366424634884096" alt='Discord' align="center"/>
10+
</a>
11+
<a href='https://twitter.com/intent/follow?original_referer=https%3A%2F%2Fpublish.twitter.com%2F&ref_src=twsrc%5Etfw&screen_name=kanaries_data&tw_p=followbutton'>
12+
<img alt="Twitter Follow" src="https://img.shields.io/twitter/follow/kanaries_data?style=social" alt='Twitter' align="center"/>
13+
</a>
14+
</p>
15+
16+
Pygwalker can simplify your Jupyter Notebook data analysis and data visualization workflow. By bringing a lightweight, easy-to-use, Tableau-like interface instead of analyzing data using Python.
17+
18+
Pygwalker intergrates Jupyter Notebook with [Graphic Walker](https://github.com/Kanaries/graphic-walker), a different type of open-source alternative to Tableau. It allows data scientists to analyze data and visualize patterns with simple drag-and-drop operations.
19+
20+
Visit [Graphic Walker Online Demo](https://graphic-walker.kanaries.net/) to test it out!
21+
22+
> Pygwalker will add more support such as R in the future.
23+
24+
# Getting Started
25+
26+
## Setup pygwalker
27+
28+
Before using pygwalker, make sure to install the packages through the command line using pip.
29+
30+
```bash
31+
pip install pygwalker
32+
```
33+
34+
## Use pygwalker in Jupyter Notebook
35+
36+
Import pygwalker and pandas to your Jupyter Notebook to get started.
37+
38+
```python
39+
import pandas as pd
40+
import pygwalker as pyg
41+
```
42+
43+
You can use pygwalker without changing your existing workflow. For example, you can call up Graphic Walker with the dataframe loaded in this way:
44+
45+
```python
46+
df = pd.DataFrame()
47+
gwalker = pyg.GWalker(df)
48+
gwalker.walk()
49+
```
50+
51+
![]()
52+
53+
That's it. Now you have a Tableau-like user interface to analyze and visualize data by dragging and dropping variables.
54+
55+
[![Manually explore your data with a Tableau-like UI](https://docs-us.oss-us-west-1.aliyuncs.com/img/pygwalker/drag-and-drop.gif)](https://docs.kanaries.net/graphic-walker/overview)
56+
57+
Cool things you can do with Graphic Walker:
58+
59+
+ You can change the mark type into others to make different charts, for example, a line chart:
60+
61+
![graphic walker line chart](https://docs-us.oss-us-west-1.aliyuncs.com/images/graphic-walker/gw-line-01.png)
62+
63+
64+
+ To compare different measures, you can create a concat view by adding more than one measure into rows/columns.
65+
66+
![graphic walker area chart](https://docs-us.oss-us-west-1.aliyuncs.com/images/graphic-walker/gw-area-01.png)
67+
68+
+ To make a facet view of several subviews divided by the value in dimension, put dimensions into rows or columns to make a facets view. The rules are similar to Tableau.
69+
70+
![graphic walker scatter chart](https://docs-us.oss-us-west-1.aliyuncs.com/images/graphic-walker/gw-scatter-01.png)
71+
72+
+ You can save the data exploration result to a local file.
73+
74+
For more detailed instructions, visit the [Graphic Walker GitHub page](https://github.com/Kanaries/graphic-walker).
75+
76+
# MIT License
77+
Copyright (c) 2012-2022 Scott Chacon and others
78+
79+
Permission is hereby granted, free of charge, to any person obtaining
80+
a copy of this software and associated documentation files (the
81+
"Software"), to deal in the Software without restriction, including
82+
without limitation the rights to use, copy, modify, merge, publish,
83+
distribute, sublicense, and/or sell copies of the Software, and to
84+
permit persons to whom the Software is furnished to do so, subject to
85+
the following conditions:
86+
87+
The above copyright notice and this permission notice shall be
88+
included in all copies or substantial portions of the Software.
89+
90+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
91+
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
92+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
93+
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
94+
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
95+
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
96+
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
97+
98+
# Resoruces
99+
100+
+ Check out more resources about Graphic Walker on [Graphic Walker GitHub](https://github.com/Kanaries/Rath)
101+
+ We are also working on [RATH](https://kanaries.net): an Open Source, Automate exploratory data analysis tool that redefines the workflow of data wrangling, exploration and visualization with AI-powered automation. Check out the [RATH website](https://kanaries.net) and [RATH GitHub](https://github.com/Kanaries/Rath) for more!
102+
+ If you encounter any issues and need support, join our [Slack](https://join.slack.com/t/kanaries/shared_invite/zt-1k60sgaxu-aGcuS7CwGeJUccE61iGopg) or [Discord](https://discord.gg/Z4ngFWXz2U) channels.
103+
+ Share pygwalker on these social media platforms:
104+
105+
[![GitHub Repo stars](https://img.shields.io/badge/share%20on-reddit-red?style=flat-square&logo=reddit)](https://reddit.com/submit?url=https://github.com/Kanaries/pygwalker&title=Say%20Hello%20to%20pygwalker%3A%20Combining%20Jupyter%20Notebook%20with%20a%20Tableau-like%20UI)
106+
[![GitHub Repo stars](https://img.shields.io/badge/share%20on-hacker%20news-orange?style=flat-square&logo=ycombinator)](https://news.ycombinator.com/submitlink?u=https://github.com/Kanaries/pygwalker)
107+
[![GitHub Repo stars](https://img.shields.io/badge/share%20on-twitter-03A9F4?style=flat-square&logo=twitter)](https://twitter.com/share?url=https://github.com/Kanaries/pygwalker&text=Say%20Hello%20to%20pygwalker%3A%20Combining%20Jupyter%20Notebook%20with%20a%20Tableau-like%20UI)
108+
[![GitHub Repo stars](https://img.shields.io/badge/share%20on-facebook-1976D2?style=flat-square&logo=facebook)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/Kanaries/pygwalker)
109+
[![GitHub Repo stars](https://img.shields.io/badge/share%20on-linkedin-3949AB?style=flat-square&logo=linkedin)](https://www.linkedin.com/shareArticle?url=https://github.com/Kanaries/pygwalker&&title=Say%20Hello%20to%20pygwalker%3A%20Combining%20Jupyter%20Notebook%20with%20a%20Tableau-like%20UI)

graphic-walker

Submodule graphic-walker added at c125ef3

0 commit comments

Comments
 (0)