physvis

A command line interface (CLI) to reconstruct, visualise and analyse data from physicalisations (physical visualisations) from .csv files, using plotly and pandas.

This is a tool originally written for a single use case - so bear with me on the sloppiness. I intend to transfer this tool to colleagues in a modular fashion - this process is a work-in-progress.

Example reconstruction of a physicalisation

Installing

Poetry is used for dependency management and pyenv to manage python installations.

With Poetry and pyenv installed, clone this repository and install dependencies via:

poetry install --no-dev

To setup a virtual environment with your local pyenv version run:

poetry shell

CLI usage

The tool is split in 5 methods:

poetry run vis      # provides a CLI to select one trial, and 3D visualises this in an HTML page
poetry run collect  # gathers separate .csv files from trials and collates them in one
poetry run calc     # analyses the collected .csv - various calculations are provided
poetry run print    # takes a list of trials and reconstructs a 3D visual (.jpg) for each
poetry run heatmap  # a special case for the 'print' command, incorporates heatmap data

Prepare your .csv data files

...