Skip to main content

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 is a collaborative project originally created by the Georgia Tech Visualization Lab at Georgia Institute of Technology with subsequent contributions from Ribarsky Center for Visual Analytics at UNC Charlotte and the DataVisards Group at The Hong Kong University of Science and Technology.

We thank the members of the Georgia Tech Visualization Lab for their support and constructive feedback. We also thank @vijaynyaya for the inspiration to support multiple language model providers. Big thanks to Kushall Saraf for contributing the v3 and v4 example applications.

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={{Sah}, Subham and {Mitra}, Rishab and {Narechania}, Arpit and {Endert}, Alex and {Stasko}, John and {Dou}, Wenwen},
    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}
}

2025 IEEE VIS Poster

@misc{ji2025nl4dvstylist,
    title={{NL4DV-Stylist: Styling Data Visualizations Using Natural Language and Example Charts}},
    author={{Ji}, Tenghao and {Narechania}, Arpit},
    year={2025},
    url={osf.io/fs4en_v1},
    DOI={10.31219/osf.io/fs4en_v1},
    publisher={OSF Preprints},
    note={Presented as a poster at IEEE VIS 2025 (Poster Track)}
}

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.

Download files

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

Source Distribution

nl4dv-4.2.0.tar.gz (65.1 kB view details)

Uploaded Source

File details

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

File metadata

  • Download URL: nl4dv-4.2.0.tar.gz
  • Upload date:
  • Size: 65.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.11

File hashes

Hashes for nl4dv-4.2.0.tar.gz
Algorithm Hash digest
SHA256 62fde738b25f9c3cfbe3da939d1a3a1aeea696697acce32e0ede4bc4d2b1e2b5
MD5 bfa1e117c5b3e1e0866a3c3874641cca
BLAKE2b-256 d674d1db33a9db6c79f3c025ad76a3663c835eaa6d294b5a80d6c47dfcc05638

See more details on using hashes here.

Supported by

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