| Name | data-formulator JSON |
| Version |
0.1.4
JSON |
| download |
| home_page | None |
| Summary | Data Formulator is research protoype data visualization tool powered by AI. |
| upload_time | 2024-11-07 18:39:53 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | MIT License Copyright (c) Microsoft Corporation. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE |
| keywords |
data visualization
llm
ai
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<h1>
<img src="./public/favicon.ico" alt="Data Formulator icon" width="28"> <b>Data Formulator: Create Rich Visualizations with AI</b>
</h1>
<div>
[](https://arxiv.org/abs/2408.16119) 
[](https://opensource.org/licenses/MIT) 
[](https://youtu.be/3ndlwt0Wi3c) 
[](https://github.com/microsoft/data-formulator/actions/workflows/python-build.yml)
</div>
Transform data and create rich visualizations iteratively with AI 🪄. Try Data Formulator now in GitHub Codespaces!
[](https://codespaces.new/microsoft/data-formulator?quickstart=1)
<kbd>
<a target="_blank" rel="noopener noreferrer" href="https://codespaces.new/microsoft/data-formulator?quickstart=1" title="open Data Formulator in GitHub Codespaces"><img src="public/data-formulator-screenshot.png"></a>
</kbd>
## News 🔥🔥🔥
- [11-07-2024] Minor fun update: data visualization challenges!
- We added a few visualization challenges with the sample datasets. Can you complete them all? [[try them out!]](https://github.com/microsoft/data-formulator/issues/53#issue-2641841252)
- Comment in the issue when you did, or share your results/questions with others! [[comment here]](https://github.com/microsoft/data-formulator/issues/53)
- [10-11-2024] Data Formulator python package released!
- You can now install Data Formulator using Python and run it locally, easily. [[check it out]](#get-started).
- Our Codespaces configuration is also updated for fast start up ⚡️. [[try it now!]](https://codespaces.new/microsoft/data-formulator?quickstart=1)
- New experimental feature: load an image or a messy text, and ask AI to parse and clean it for you(!). [[demo]](https://github.com/microsoft/data-formulator/pull/31#issuecomment-2403652717)
- [10-01-2024] Initial release of Data Formulator, check out our [[blog]](https://www.microsoft.com/en-us/research/blog/data-formulator-exploring-how-ai-can-help-analysts-create-rich-data-visualizations/) and [[video]](https://youtu.be/3ndlwt0Wi3c)!
## Overview
**Data Formulator** is an application from Microsoft Research that uses large language models to transform data, expediting the practice of data visualization.
Data Formulator is an AI-powered tool for analysts to iteratively create rich visualizations. Unlike most chat-based AI tools where users need to describe everything in natural language, Data Formulator combines *user interface interactions (UI)* and *natural language (NL) inputs* for easier interaction. This blended approach makes it easier for users to describe their chart designs while delegating data transformation to AI.
## Get Started
Play with Data Formulator with one of the following options:
- **Option 1: Install via Python PIP**
Use Python PIP for an easy setup experience, running locally (recommend: install it in a virtual environment).
```bash
# install data_formulator
pip install data_formulator
# start data_formulator
data_formulator
# alternatively, you can run data formualtor with this command
python -m data_formulator
```
Data Formulator will be automatically opened in the browser at [http://localhost:5000](http://localhost:5000).
*Update: you can specify the port number (e.g., 8080) by `python -m data_formulator --port 8080` if the default port is occupied.*
- **Option 2: Codespaces (5 minutes)**
You can also run Data Formulator in Codespaces; we have everything pre-configured. For more details, see [CODESPACES.md](CODESPACES.md).
[](https://codespaces.new/microsoft/data-formulator?quickstart=1)
- **Option 3: Working in the developer mode**
You can build Data Formulator locally if you prefer full control over your development environment and the ability to customize the setup to your specific needs. For detailed instructions, refer to [DEVELOPMENT.md](DEVELOPMENT.md).
## Using Data Formulator
Once you’ve completed the setup using either option, follow these steps to start using Data Formulator:
### The basics of data visualization
* Provide OpenAI keys and select a model (GPT-4o suggested) and choose a dataset.
* Choose a chart type, and then drag-and-drop data fields to chart properties (x, y, color, ...) to specify visual encodings.
https://github.com/user-attachments/assets/0fbea012-1d2d-46c3-a923-b1fc5eb5e5b8
### Create visualization beyond the initial dataset (powered by 🤖)
* You can type names of **fields that do not exist in current data** in the encoding shelf:
- this tells Data Formulator that you want to create visualizations that require computation or transformation from existing data,
- you can optionally provide a natural language prompt to explain and clarify your intent (not necessary when field names are self-explanatory).
* Click the **Formulate** button.
- Data Formulator will transform data and instantiate the visualization based on the encoding and prompt.
* Inspect the data, chart and code.
* To create a new chart based on existing ones, follow up in natural language:
- provide a follow up prompt (e.g., *``show only top 5!''*),
- you may also update visual encodings for the new chart.
https://github.com/user-attachments/assets/160c69d2-f42d-435c-9ff3-b1229b5bddba
https://github.com/user-attachments/assets/c93b3e84-8ca8-49ae-80ea-f91ceef34acb
Repeat this process as needed to explore and understand your data. Your explorations are trackable in the **Data Threads** panel.
## Developers' Guide
Follow the [developers' instructions](DEVELOPMENT.md) to build your new data analysis tools on top of Data Formulator.
## Research Papers
* [Data Formulator 2: Iteratively Creating Rich Visualizations with AI](https://arxiv.org/abs/2408.16119)
```
@article{wang2024dataformulator2iteratively,
title={Data Formulator 2: Iteratively Creating Rich Visualizations with AI},
author={Chenglong Wang and Bongshin Lee and Steven Drucker and Dan Marshall and Jianfeng Gao},
year={2024},
booktitle={ArXiv preprint arXiv:2408.16119},
}
```
* [Data Formulator: AI-powered Concept-driven Visualization Authoring](https://arxiv.org/abs/2309.10094)
```
@article{wang2023data,
title={Data Formulator: AI-powered Concept-driven Visualization Authoring},
author={Wang, Chenglong and Thompson, John and Lee, Bongshin},
journal={IEEE Transactions on Visualization and Computer Graphics},
year={2023},
publisher={IEEE}
}
```
## Contributing
This project welcomes contributions and suggestions. Most contributions require you to
agree to a Contributor License Agreement (CLA) declaring that you have the right to,
and actually do, grant us the rights to use your contribution. For details, visit
https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need
to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the
instructions provided by the bot. You will only need to do this once across all repositories using our CLA.
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
## Trademarks
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
trademarks or logos is subject to and must follow
[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.
Raw data
{
"_id": null,
"home_page": null,
"name": "data-formulator",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "data visualization, LLM, AI",
"author": null,
"author_email": "Chenglong Wang <chenglong.wang@microsoft.com>, Dan Marshall <danmar@microsoft.com>",
"download_url": "https://files.pythonhosted.org/packages/2d/10/a3f1468806c9067b5d4d7aadc5a09da9f9474a8fd5fbdefe59c5c8cb7bcc/data_formulator-0.1.4.tar.gz",
"platform": null,
"description": "<h1>\n <img src=\"./public/favicon.ico\" alt=\"Data Formulator icon\" width=\"28\"> <b>Data Formulator: Create Rich Visualizations with AI</b>\n</h1>\n\n<div>\n \n[](https://arxiv.org/abs/2408.16119) \n[](https://opensource.org/licenses/MIT) \n[](https://youtu.be/3ndlwt0Wi3c) \n[](https://github.com/microsoft/data-formulator/actions/workflows/python-build.yml)\n\n</div>\n\nTransform data and create rich visualizations iteratively with AI \ud83e\ude84. Try Data Formulator now in GitHub Codespaces!\n\n[](https://codespaces.new/microsoft/data-formulator?quickstart=1)\n\n<kbd>\n <a target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://codespaces.new/microsoft/data-formulator?quickstart=1\" title=\"open Data Formulator in GitHub Codespaces\"><img src=\"public/data-formulator-screenshot.png\"></a>\n</kbd>\n\n\n## News \ud83d\udd25\ud83d\udd25\ud83d\udd25\n\n- [11-07-2024] Minor fun update: data visualization challenges!\n - We added a few visualization challenges with the sample datasets. Can you complete them all? [[try them out!]](https://github.com/microsoft/data-formulator/issues/53#issue-2641841252)\n - Comment in the issue when you did, or share your results/questions with others! [[comment here]](https://github.com/microsoft/data-formulator/issues/53)\n\n- [10-11-2024] Data Formulator python package released! \n - You can now install Data Formulator using Python and run it locally, easily. [[check it out]](#get-started).\n - Our Codespaces configuration is also updated for fast start up \u26a1\ufe0f. [[try it now!]](https://codespaces.new/microsoft/data-formulator?quickstart=1)\n - New experimental feature: load an image or a messy text, and ask AI to parse and clean it for you(!). [[demo]](https://github.com/microsoft/data-formulator/pull/31#issuecomment-2403652717)\n \n- [10-01-2024] Initial release of Data Formulator, check out our [[blog]](https://www.microsoft.com/en-us/research/blog/data-formulator-exploring-how-ai-can-help-analysts-create-rich-data-visualizations/) and [[video]](https://youtu.be/3ndlwt0Wi3c)!\n\n\n\n## Overview\n\n**Data Formulator** is an application from Microsoft Research that uses large language models to transform data, expediting the practice of data visualization.\n\nData Formulator is an AI-powered tool for analysts to iteratively create rich visualizations. Unlike most chat-based AI tools where users need to describe everything in natural language, Data Formulator combines *user interface interactions (UI)* and *natural language (NL) inputs* for easier interaction. This blended approach makes it easier for users to describe their chart designs while delegating data transformation to AI. \n\n## Get Started\n\nPlay with Data Formulator with one of the following options:\n\n- **Option 1: Install via Python PIP**\n \n Use Python PIP for an easy setup experience, running locally (recommend: install it in a virtual environment).\n \n ```bash\n # install data_formulator\n pip install data_formulator\n\n # start data_formulator\n data_formulator \n \n # alternatively, you can run data formualtor with this command\n python -m data_formulator\n ```\n\n Data Formulator will be automatically opened in the browser at [http://localhost:5000](http://localhost:5000).\n\n *Update: you can specify the port number (e.g., 8080) by `python -m data_formulator --port 8080` if the default port is occupied.*\n\n- **Option 2: Codespaces (5 minutes)**\n \n You can also run Data Formulator in Codespaces; we have everything pre-configured. For more details, see [CODESPACES.md](CODESPACES.md).\n \n [](https://codespaces.new/microsoft/data-formulator?quickstart=1)\n\n- **Option 3: Working in the developer mode**\n \n You can build Data Formulator locally if you prefer full control over your development environment and the ability to customize the setup to your specific needs. For detailed instructions, refer to [DEVELOPMENT.md](DEVELOPMENT.md).\n\n\n## Using Data Formulator\n\nOnce you\u2019ve completed the setup using either option, follow these steps to start using Data Formulator:\n\n### The basics of data visualization\n* Provide OpenAI keys and select a model (GPT-4o suggested) and choose a dataset.\n* Choose a chart type, and then drag-and-drop data fields to chart properties (x, y, color, ...) to specify visual encodings.\n\nhttps://github.com/user-attachments/assets/0fbea012-1d2d-46c3-a923-b1fc5eb5e5b8\n\n\n### Create visualization beyond the initial dataset (powered by \ud83e\udd16)\n* You can type names of **fields that do not exist in current data** in the encoding shelf:\n - this tells Data Formulator that you want to create visualizations that require computation or transformation from existing data,\n - you can optionally provide a natural language prompt to explain and clarify your intent (not necessary when field names are self-explanatory).\n* Click the **Formulate** button.\n - Data Formulator will transform data and instantiate the visualization based on the encoding and prompt.\n* Inspect the data, chart and code.\n* To create a new chart based on existing ones, follow up in natural language:\n - provide a follow up prompt (e.g., *``show only top 5!''*),\n - you may also update visual encodings for the new chart.\n\nhttps://github.com/user-attachments/assets/160c69d2-f42d-435c-9ff3-b1229b5bddba\n\nhttps://github.com/user-attachments/assets/c93b3e84-8ca8-49ae-80ea-f91ceef34acb\n\nRepeat this process as needed to explore and understand your data. Your explorations are trackable in the **Data Threads** panel. \n\n## Developers' Guide\n\nFollow the [developers' instructions](DEVELOPMENT.md) to build your new data analysis tools on top of Data Formulator.\n\n## Research Papers\n* [Data Formulator 2: Iteratively Creating Rich Visualizations with AI](https://arxiv.org/abs/2408.16119)\n\n```\n@article{wang2024dataformulator2iteratively,\n title={Data Formulator 2: Iteratively Creating Rich Visualizations with AI}, \n author={Chenglong Wang and Bongshin Lee and Steven Drucker and Dan Marshall and Jianfeng Gao},\n year={2024},\n booktitle={ArXiv preprint arXiv:2408.16119},\n}\n```\n\n* [Data Formulator: AI-powered Concept-driven Visualization Authoring](https://arxiv.org/abs/2309.10094)\n\n```\n@article{wang2023data,\n title={Data Formulator: AI-powered Concept-driven Visualization Authoring},\n author={Wang, Chenglong and Thompson, John and Lee, Bongshin},\n journal={IEEE Transactions on Visualization and Computer Graphics},\n year={2023},\n publisher={IEEE}\n}\n```\n\n\n## Contributing\n\nThis project welcomes contributions and suggestions. Most contributions require you to\nagree to a Contributor License Agreement (CLA) declaring that you have the right to,\nand actually do, grant us the rights to use your contribution. For details, visit\nhttps://cla.microsoft.com.\n\nWhen you submit a pull request, a CLA-bot will automatically determine whether you need\nto provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the\ninstructions provided by the bot. You will only need to do this once across all repositories using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)\nor contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft \ntrademarks or logos is subject to and must follow \n[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\nAny use of third-party trademarks or logos are subject to those third-party's policies.\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) Microsoft Corporation. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE ",
"summary": "Data Formulator is research protoype data visualization tool powered by AI.",
"version": "0.1.4",
"project_urls": {
"Bug Tracker": "https://github.com/microsoft/data-formulator/issues",
"Homepage": "https://github.com/microsoft/data-formulator",
"Repository": "https://github.com/microsoft/data-formulator.git"
},
"split_keywords": [
"data visualization",
" llm",
" ai"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9d6a8d6a9b18b2a0d36ce7e94de6975712939314faab1a7902dd458dab86229e",
"md5": "00a40127a663866ddf4a5bd55b8b6545",
"sha256": "495b2cddb6d6433ce504b5f22c1eca6cd42dd06554cd70e077dba59d0df2dbdf"
},
"downloads": -1,
"filename": "data_formulator-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "00a40127a663866ddf4a5bd55b8b6545",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6511248,
"upload_time": "2024-11-07T18:39:50",
"upload_time_iso_8601": "2024-11-07T18:39:50.864536Z",
"url": "https://files.pythonhosted.org/packages/9d/6a/8d6a9b18b2a0d36ce7e94de6975712939314faab1a7902dd458dab86229e/data_formulator-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2d10a3f1468806c9067b5d4d7aadc5a09da9f9474a8fd5fbdefe59c5c8cb7bcc",
"md5": "50223fedcf06c2de269d2315da9e7631",
"sha256": "f6622ff8e05c93e27bd0397ffb2256110d24209d0c7a484f79b90dea3c0e85e7"
},
"downloads": -1,
"filename": "data_formulator-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "50223fedcf06c2de269d2315da9e7631",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 6482106,
"upload_time": "2024-11-07T18:39:53",
"upload_time_iso_8601": "2024-11-07T18:39:53.101804Z",
"url": "https://files.pythonhosted.org/packages/2d/10/a3f1468806c9067b5d4d7aadc5a09da9f9474a8fd5fbdefe59c5c8cb7bcc/data_formulator-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-07 18:39:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "microsoft",
"github_project": "data-formulator",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "data-formulator"
}
