Skip to main content

A python library for generating VR-friendly visualization files from pandas dataframes.

Project description

harkness

A python library for generating VR-friendly visualization files from pandas dataframes.

Try it in Binder: Binder

How to Use:

  • Identify an appropriate dataframe. You'll want to make sure that your data makes sense in 3D, and select or add a column that makes sense as a colormap. The colormap column can be categorical or numeric.

  • Generate .ply file. Run create_ply() on your dataframe, identifying the columns X, Y, Z, and C (for color).

  • Visualize on desktop. You can use a program like Autodesk MeshMixer or Cloud Compare.

  • Visualize in VR. You can open the resulting file in a VR viewer like VRifier. Any headset that works with SteamVR should work. I use a Valve Index.

Notes and Acknowledgments

Named for Ruth Harkness, who with Quentin Young and Gerald Russell brought the first live giant panda cub to the United States. (For more on this, read her memoir, The Lady and the Panda.) Name chosen because (1) "harkness" did not appear for related topics on a search of pypi, and (2) it's a library for displaying pandas. Some assistance by Google Bard.

If you use this project in your work, please cite it using the Zenodo DOI: DOI

Project details


Download files

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

Source Distribution

harkness-1.0.5.tar.gz (1.9 MB view hashes)

Uploaded Source

Built Distribution

harkness-1.0.5-py3-none-any.whl (4.2 kB view hashes)

Uploaded Python 3

Supported by

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