thoughtworksarts / concat

A tool for visualizing robotic movement alongside human movement

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

concat

A tool for visualizing robot movements alongside human movements. The concat system displays a depth skeleton from Kinect2 alongside a 3D rendering of data from an ABB IRB 6700 industrial robot arm.

The depth skeleton can optionally be rendered as a 3D figure made of cylinders via a toggle (press 3 while Concat is running) for a more life-like presentation of the human figure.

The team working with the robot arm

Catie Cuan performing with the concat tool. Still from video by Kevin Barry

Still from video by Kevin Barry Stills from video of Catie Cuan's performance with the concat tool. Video by Kevin Barry at ThoughtWorks.

This codebase was developed to support artist Catie Cuan as part of her residency at ThoughtWorks Arts. It runs on openFrameworks and requires a KinectV2 depth sensor.

A shot of concat running

How to Set Up Concat to Play

(Follow along with this video)

You will need: A Kinect V2, a Windows machine. Follow these steps after cloning the repository into your machine, and following the Installation instructions below.

  1. Testing the Kinect: This is a good first debugging step to ensure that your Kinect is working properly before trying to run the whole app. Open the SDK Browser v2.0 (Kinect for Windows). Go to Samples: C++ >> Body Basics-D2D (at the bottom) and click Run You should now arrange the Kinect until you see the dot-and-line skeleton on the screen. Then you can close the SDK.

  2. Preparing the app: Open Visual Studio 2017 and open concat.sln. Make sure the app is in Debug and x64 bit mode. You should see a green button in the top bar that says Local Windows Debugger. Click on that to run the app.

  3. Connecting app to Kinect: The app will now have opened in full screen. Click the F key to get out of full screen. Now run the BodyBasicsWPF executable that you should bookmark on the bottom of the Windows bar for easy access. This is the bridge that will allow the Kinect stream to go into the concat app. Another black screen should pop up, have someone move around in front of the Kinect until you see the skeleton in the app. Leave this app open, go back to the concat window and toggle the F key again to go back to full screen.

  4. Making the figure 3D: Now you should see the skeleton on the screen of the app. Toggle the 3 key to turn it into 3D.

  5. Starting and Stopping the dance sequence: Use the Space bar to start the choreographed moves. Space will also pause/play. Toggle the R key to restart.

Installation

For now, concat must be run on Windows due to the dependencies of the Kinect V2. See dependencies below. You must

  1. Install openFrameworks for Visual Studio 2017
  2. Follow these steps to setup Visual Studio
  3. Add ofxOSC and ofxAnimatable to your addons from the dependencies below. Put the addon in the addons folder in your openFrameworks root folder.
  4. Install Kinect for Windows SDK following these instructions and test that you can run the executable. Follow the first instruction from here
  5. Clone this repo

Project dependencies

About

A tool for visualizing robotic movement alongside human movement


Languages

Language:C++ 83.4%Language:Makefile 16.6%