|
| 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 | +[](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 | + |
| 62 | + |
| 63 | + |
| 64 | ++ To compare different measures, you can create a concat view by adding more than one measure into rows/columns. |
| 65 | + |
| 66 | + |
| 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 | + |
| 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 | +[](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 | +[](https://news.ycombinator.com/submitlink?u=https://github.com/Kanaries/pygwalker) |
| 107 | +[](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 | +[](https://www.facebook.com/sharer/sharer.php?u=https://github.com/Kanaries/pygwalker) |
| 109 | +[](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) |
0 commit comments