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.

Release files for nl4dv 4.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nl4dv 4.2.0
File Size Uploaded
nl4dv-4.2.0.tar.gz 65.1 kB Details

Release files / nl4dv-4.2.0.tar.gz

Download URL nl4dv-4.2.0.tar.gz
Size 65.1 kB
Tags Source
SHA-256 checksum
How to use checksums
62fde738b25f9c3cfbe3da939d1a3a1aeea696697acce32e0ede4bc4d2b1e2b5
BLAKE2b-256 checksum
How to use checksums
d674d1db33a9db6c79f3c025ad76a3663c835eaa6d294b5a80d6c47dfcc05638
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.11

Release history Release notifications | RSS feed

This release

4.2.0 This release

1 release file

4.1.0

1 release file

4.0.0

1 release file

3.0.0

1 release file

2.1.0

1 release file

2.0.0

1 release file

1.0.0

1 release file

0.0.6

1 release file

0.0.5

1 release file

0.0.4

1 release file

0.0.2

1 release file

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page