Skip to main content

NL4DV is a Python toolkit that takes a natural language (NL) query about a given dataset as input and outputs a structured JSON object containing Data attributes, Analytic tasks, and Visualizations (Vega-Lite specifications).

Project description

NL4DV: Natural Language toolkit for Data Visualization

DOI:10.1109/TVCG.2020.3030418 arxiv badge arxiv badge PyPI license PyPI - Downloads

NL4DV takes a natural language query about a given dataset as input and outputs a structured JSON object containing:

  • Data attributes,
  • Analytic tasks, and
  • Visualizations (Vega-Lite specifications)

With this output, developers can

  • Create visualizations in Python using natural language, and/or
  • Add a natural language interface to their existing visualization systems.

NL4DV Overview

Setup Instructions, API Documentation, and Examples

These can all be found on NL4DV's project website.

Credits

NL4DV was created by Arpit Narechania, Arjun Srinivasan, Rishab Mitra, Alex Endert, and John Stasko of the Georgia Tech Visualization Lab. Along with Subham Sah, and Wenwen Dou of the Ribarsky Center for Visual Analytics at UNC Charlotte.

We thank the members of the Georgia Tech Visualization Lab for their support and constructive feedback.

Citations

2021 IEEE TVCG Journal Full Paper (Proceedings of the 2020 IEEE VIS Conference)

@article{narechania2021nl4dv,
  title = {{NL4DV}: A {Toolkit} for Generating {Analytic Specifications} for {Data Visualization} from {Natural Language} Queries},
  shorttitle = {{NL4DV}},
  author = {{Narechania}, Arpit and {Srinivasan}, Arjun and {Stasko}, John},
  journal = {IEEE Transactions on Visualization and Computer Graphics (TVCG)},
  doi = {10.1109/TVCG.2020.3030378},
  year = {2021},
  publisher = {IEEE}
}

2022 IEEE VIS Conference Short Paper Track

@inproceedings{mitra2022conversationalinteraction,
  title = {{Facilitating Conversational Interaction in Natural Language Interfaces for Visualization}},
  author = {{Mitra}, Rishab and {Narechania}, Arpit and {Endert}, Alex and {Stasko}, John},
  booktitle={2022 IEEE Visualization Conference (VIS)},
  url = {https://doi.org/10.48550/arXiv.2207.00189},
  doi = {10.48550/arXiv.2207.00189},
  year = {2022},
  publisher = {IEEE}
}

2024 IEEE VIS NLVIZ workshop Paper

@misc{sah2024nl4dvllm,
    title={Generating Analytic Specifications for Data Visualization from Natural Language Queries using Large Language Models}, 
    author={Subham Sah and Rishab Mitra and Arpit Narechania and Alex Endert and John Stasko and Wenwen Dou},
    year={2024},
    eprint={2408.13391},
    archivePrefix={arXiv},
    primaryClass={cs.HC},
    url={https://arxiv.org/abs/2408.13391}, 
    howpublished={Presented at the NLVIZ Workshop, IEEE VIS 2024}
}

License

The software is available under the MIT License.

Contact

If you have any questions, feel free to open an issue or contact Arpit Narechania.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nl4dv-3.0.0.tar.gz (57.6 kB view details)

Uploaded Source

File details

Details for the file nl4dv-3.0.0.tar.gz.

File metadata

  • Download URL: nl4dv-3.0.0.tar.gz
  • Upload date:
  • Size: 57.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for nl4dv-3.0.0.tar.gz
Algorithm Hash digest
SHA256 7dadef00aa7ba93a2712ed3d9e859b20cf58487e7929a7eeb90580edc1880ec7
MD5 4678ebe3ca3bd288802007bb778e37bb
BLAKE2b-256 3f6bd8a75120846d91a3082881d3e234a32835b05948d13c271f99664f56badb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page