Skip to content

Latest commit

 

History

History
54 lines (40 loc) · 2.91 KB

README.md

File metadata and controls

54 lines (40 loc) · 2.91 KB
Raw

Lumos

DOI:10.1109/TVCG.2021.3114827

Lumos is a visual data analysis tool that captures and shows the interaction history with data to increase awareness of such analytic behaviors. Using in-situ (at the place of interaction) and ex-situ (in an external view) visualization techniques, Lumos provides real-time feedback to users for them to reflect on their activities. For example, Lumos highlights datapoints that have been previously examined in the same visualization (in-situ) and also overlays them on the underlying data distribution (i.e., baseline distribution) in a separate visualization (ex-situ).

This codebase comprises an easy-to-extend Angular frontend and a Python 3.10, SocketIO, AIOHTTP backend with an API for real-time bi-directional communication with the frontend over the HTTP REST and websocket protocols.

Setup

Instructions can be found in the following sub-directories:

Credits

Lumos was created by Arpit Narechania, Adam Coscia, Emily Wall, and Alex Endert.

Citation

@article{narechania2022lumos,
  author={Narechania, Arpit and Coscia, Adam and Wall, Emily and Endert, Alex},
  journal={{IEEE Transactions on Visualization and Computer Graphics}}, 
  title={{Lumos: Increasing Awareness of Analytic Behavior during Visual Data Analysis}}, 
  year={2022},
  volume={28},
  number={1},
  pages={1009-1018},
  doi={10.1109/TVCG.2021.3114827}
}

Deploy on Heroku

  • Build app repository code from inside that repository: ng build
    • This should add/update contents inside the server/public folder.
  • Verify Procfile inside the server folder.
  • heroku login
  • If not added, add git remote: git remote add heroku https://git.heroku.com/lumos-webapp.git
  • Set buildpack for this project: heroku buildpacks:set heroku/python (it might err that the buildpack is already set on your app. Good, nothing to worry then.)
  • Add, commit code via git.
  • Push only the server folder as a subtree (run it from the toplevel of the working tree): git subtree push --prefix server heroku main
  • Hope!
  • Try https://lumos-webapp-4aeadb3bf30d.herokuapp.com in browser.
  • Check logs via heroku logs --tail
  • Restart via heroku restart --app lumos-webapp

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.