/Metamorphosis

Primary LanguageProcessing

Metamorphosis

Metamorphosis is a project that was designed in collaboration with the CU Museum of Natural History (CUMNH) for a class on Ubiquitous Computing. This project was designed in particular for the museum's exhibit called "Becoming Butterflies." We would like to thank Rebecca Coon, CUMNH exhibit director, and Sharon Tinniaow, CUMNH assistant director, for their feedback and willingness to let us design a technology for their space.

Authors: Annie Kelly, Angel Lam, Brielle Nickoloff, Matthew Whitlock.

What you need

  • A Kinect
    • If you are wondering if you can use a Kinect and this project with OSX the answer is YES. See below for a list of instructions for getting this set up.
  • A Kinect AC Adapter/Power Supply
  • Processing (Note: this project has only been built and tested on Processing 3.2.3)
  • The following Processing libraries
    • SimpleOpenNI library
      • This can be installed in Processing by simply going to Sketch --> Import Library... --> Add Library... and then searching for "SimpleOpenNI". Click install.
      • If you are using Processing 3 and above, then the above download will not work. There are 2 ways to fix this:
        • Downgrade your version of Processing
        • Follow the instructions here to get the library working with Processing 3
    • Syphon Processing library
      • This can be installed in Processing by simply going to Sketch --> Import Library... --> Add Library... and then searching for "Syphon". Click install.

How to use

  • Make sure your Kinect is powered on and plugged into a USB port
  • Run this Processing project

Getting your Kinect to work on OSX (instructions based on this guide)

Disable System Integrity Proctection

  • Restart your Mac in Recovery mode (while your Mac is restarting hold Cmd-R)
  • In the Utilities menu select Terminal
  • Type csrutil disable and press ENTER
  • Restart your Mac

Download and install MacPorts

Install dependencies

  • Open Terminal
  • Type sudo port install libtool and press ENTER
  • Restart your Mac
  • Open Terminal
  • Type sudo port install libusb-devel +universal and press ENTER
  • Restart your Mac again...

Download and install OpenNI

  • Open Terminal
  • Type mkdir ~/Kinect and press enter (this creates a folder named Kinect in your Home directory)
  • Download OpenNI SDK (V1.5.7.10)
    • Do not download OpenNI v2 beta, it relies on the Microsoft Kinect SDK which we cannot use
  • Move the zip file you just downloaded into your Kinect folder and uncompress it
  • Rename the uncompressed folder to OpenNI (optional)
  • Open Terminal
  • Type cd ~/Kinect/OpenNI and press ENTER (change filepath names where necessary)
    • TIP: we will be using the cd command several times in this tutorial, if you'd like you can simply drag your folder from finder into your Terminal window and then press ENTER
  • Type sudo ./install.sh and press ENTER

Download and install SensorKinect

  • Open Terminal
  • Type sudo ln -s /usr/local/bin/niReg /usr/bin/niReg and press ENTER
    • If that fails, try sudo ln -s /usr/bin/niReg /usr/local/bin/niReg instead
  • Go to https://github.com/avin2/SensorKinect
    • Click the green Clone or download button and select Download Zip
  • Move the downloaded zip to your Kinect folder and uncompress it
  • Rename the uncompressed folder to SensorKinect (optional)
  • Inside of the SensorKinect folder, open the Bin folder
  • Uncompress the file SensorKinect093-Bin-MacOSX-v5.1.2.1.tar.bz2
  • Open Terminal
  • Type cd ~/Kinect/SensorKinect/SensorKinect093-Bin-MacOSX-v5.1.2.1 (change filepath names where necessary)
  • Type sudo ./install.sh
    • If this step worked properly it should have installed the Primesense sensor as well

Install NiTE

  • Download NITE-Bin-MacOSX-v1.5.2.21.tar.zip
  • Move this file to your Kinect folder and uncompress it
  • Rename the uncompressed folder to NiTE (optional)
  • Open Terminal
  • Type cd ~/Kinect/NiTE and press ENTER (change filepath names where necessary)
  • Type sudo ./install.sh and press ENTER

Test

  • Plug in and power on your Kinect
  • Copy the sample XML files from NiTE/Data over to the Data folder in SensorKinect
  • Open Terminal
  • Type cd ~/Kinect/NiTE/Samples/Bin/x64-Release and press ENTER
  • Type ./Sample-PointViewer and press ENTER to run the demo
    • If every step in this guide was successful you should see a tracking demo

Enable System Integrity Proctection (Optional)

  • Earlier we disabled System Integrity Protection, follow these steps to re-enable it
  • Restart Mac in recovery mode
  • Find Terminal in the Utilies menu
  • Type csrutil enable and press ENTER
  • Restart your Mac