Skip to content
/ Tether Public

TETHER enables the annotation of behavioural data encoded in Rhinoceros with video information.

Notifications You must be signed in to change notification settings

pmavros/Tether

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

91 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tether

Description

TETHER enables the connection of a video playback in Processing and a CAD drawing in Rhinoceros. Behind the scenes, the Processing script relies on the OSC protocol to broadcast the playback position (i.e. the timestamp of the current frame, expressed as milliseconds from start, and as a percentage of the total movie duration). On the Rhinoceros side, a Grasshopper script, receive the timestamp information and allows the user to control the movie playback. When the user adds a new point on the current drawing on Rhino, the timestamp gets appended to the point as the object name as well as a separate attribute.

Why would I want to use Tether?

Tether allows you to manually create trajectories or trace other behaviours in a spatial format that includes timestamps obtained from a video source.

The data are then saved as a Rhino file (.3dm) as points with xyz coordinate and additional attributes (ID, timestamp, behaviour type). Tether helps to then export this point data into a csv file for further processing, e.g. in QGIS or R.

How do I get started?

  1. Download this repository
  2. Read the documentation and tutorial here

Roadmap

  • improve backwords compatibility with Rhino 7 (need to change some components for python in GH)
  • convert into a Rhino Plugin instead of GH script.
  • Implement a version compatible with FOSS sofware such as QGIS (although that is not suitable for modelling 3D environments/behaviours.

We are looking for contributors!