Skip to content

urban-toolkit/curio

Repository files navigation

Curio Discord Docs Full stack build PyPI version Contributors

Curio Logo
[Paper] | [Website]

Curio is a framework for collaborative urban visual analytics that uses a dataflow model with multiple abstraction levels (code, grammar, GUI elements) to facilitate collaboration across the design and implementation of visual analytics components. The framework allows experts to intertwine preprocessing, managing, and visualization stages while tracking provenance of code and visualizations.

What's New

Curio v0.5 introduces a number of improvements and fixes thanks to the efforts of new contributors. Highlights include:

  • 📦 Pip Installation Support: Curio can now be installed via pip install utk-curio, making it easier to get started. Check the usage document for details.
  • 🚀 Performance Improvements: Enhanced computation execution speed in the backend.
  • 🧪 Initial End-to-End Testing: Integrated test for backend/sandbox testing.
  • 🧭 New Examples Added: Included new dataflows like "Complaints by Zip Code" and "Accessibility Analysis".
  • 🐳 Docker Enhancements: Fixed Docker build issues by enforcing platform and fixing dependency installation errors.
  • 🧹 General Bug Fixes: Resolved issues with icons, route definitions, upload status tracking, and environment variable references.

See the full Release notes for more. To get started with installation and setup, see the usage guide. For a quick hands-on walkthrough, try the quick start tutorial. If you'd like to contribute, read the contribution guide.

Roadmap

  • 🔌 UTK-Serverless Integration: UTK and Curio's integration is being improved. A new UTK serverless version will be integrated soon.
  • 🧪 Expanded Testing Suite: A more comprehensive testing framework is being extended to also cover frontend scenarios.
  • 🧠 Enhanced Learning Resources: More example dataflows and revised documentation are being created.
  • 🧩 Modular Node Architecture: A refactor is in progress to support a plug-in architecture, allowing programmers to define and register custom dataflow nodes more easily.
  • 📓 Notebook Interoperability: We are building support for importing/exporting dataflows to and from Jupyter notebooks.
  • 🧾 Advanced Provenance Tracking: We are improving how Curio tracks and visualizes the history of user actions.
  • 📋 Improved Logging System: Curio's logging is being updated with clearer diagnostics, better error tracking, and improved debugging support.

Overview

Curio: A Dataflow-Based Framework for Collaborative Urban Visual Analytics
Gustavo Moreira, Maryam Hosseini, Carolina Veiga, Lucas Alexandre, Nico Colaninno, Daniel de Oliveira, Nivan Ferreira, Marcos Lage, Fabio Miranda
IEEE Transactions on Visualization and Computer Graphics ( Volume: 31, Issue: 1, January 2025)
Paper: [DOI], [Arxiv]

curio_compressed_720.mp4

Curio Use Cases

This project is part of the Urban Toolkit ecosystem, which includes Curio and UTK. Curio is a framework for collaborative urban visual analytics that uses a dataflow model with multiple abstraction levels to facilitate collaboration across the design and implementation of visual analytics components. UTK is a flexible and extensible visualization framework that enables the easy authoring of web-based visualizations through a new high-level grammar specifically built with common urban use cases in mind.

Key features

  • Provenance-aware dataflow
  • Modularized and collaborative visual analytics
  • Support for 2D and 3D maps
  • Linked data-driven interactions
  • Integration with UTK and Vega-Lite

Usage and contributions

For detailed instructions on how to use the project, please see the usage document. A set of examples can be found here.

🚀 Curio now supports a Docker-based setup for easier installation and orchestration of all components. See the usage guide for instructions on running Curio with Docker.

If you'd like to contribute, see the contributions document for guidelines. For questions, join UTK's Discord server.


Citation

@ARTICLE{moreira2025curio,
  author={Moreira, Gustavo and Hosseini, Maryam and Veiga, Carolina and Alexandre, Lucas and Colaninno, Nicola and de Oliveira, Daniel and Ferreira, Nivan and Lage, Marcos and Miranda, Fabio},
  journal={IEEE Transactions on Visualization and Computer Graphics}, 
  title={Curio: A Dataflow-Based Framework for Collaborative Urban Visual Analytics}, 
  year={2025},
  volume={31},
  number={1},
  pages={1224-1234},
  doi={10.1109/TVCG.2024.3456353}
}

License

Curio is MIT Licensed. Free for both commercial and research use.

Acknowledgements

Curio and the Urban Toolkit have been supported by the National Science Foundation (NSF) (Awards #2320261, #2330565, and #2411223), Discovery Partners Institute (DPI), and IDOT.