Installation Guide - HephaestusVision/hephaestus GitHub Wiki

Compiling the Hephaestus Scanner Application:

0. Install Cmake, On ubuntu, try

   sudo apt-get install cmake

1. Install the QT4 development libraries. On Ubuntu, these will be found in the package libqt4-dev.

   sudo apt-get install libqt4-dev

2. Install the Point Cloud Library (PCL) http://pointclouds.org/downloads/ On Ubuntu, try:

   sudo add-apt-repository ppa:v-launchpad-jochen-sprickerhof-de/pcl sudo apt-get update sudo apt-get install libpcl-all

3. Install the OpenCV library. Download and compile from http://opencv.willowgarage.com/wiki/

4. Install the libfreenect/OpenKinect library. Download and compile. In Cmake, set the BUILD_CV variable to true and OpenCV_DIR to the location of OpenCV.

   git clone https://github.com/OpenKinect/libfreenect.git cmake
   -DBUILD_CV:BOOL="1"
   -DOpenCV_DIR:PATH="...path-to.../build/OpenCV"
   "...path-to-libfreenect-src..."

5. Install the VTK library Download and compile. http://vtk.org/VTK/resources/software.html

6. Download Hephaestus.

   git clone git://github.com/HephaestusVision/hephaestus.git

7. Create a build directory

   $ cd hephaestus/scanner_application $ mkdir build $ cd build $ cmake-gui ..

8. In Cmake, set the variables VTK_DIR, OpenCV_DIR and LIB_FREENECT_BUILD to the build directories of those programs. Set LIB_FREENECT_SRC to the source directory of libfreenect.

9. from within cmake, generate build files.

10. Depending on your development environment, compile the Hephaestus Scanner Application.

Installing and configuring Midas.

1. On your server, install the Apache web server. Be sure that you can connect to the server (installation works, firewalls opened, et cetera).

2. Follow the instructions here: MIDAS Installation. Be sure to use a version that includes commit 66574a1b9e505d8d15754496cf22d731867d6da1.

3. Use the MIDAS web interface to create users and communities. In order to allow a use to upload to a community folder, that user must join the comunity and be given edit permission on that folder.

Compiling the iOS Kiwi-Midas app.

1.  Install [Cmake](http://www.cmake.org/) on a mac
   

2.  Download Kiwi-Midas
   
    git clone -b midas-kiwi https://github.com/HephaestusVision/midas-kiwi.git
   

3.  Enter the follow commands to get to cMakeBuild
   
    cd midas-kiwi/Apps/iOS/cMakeBuild
   

4.  Use the following commands to run the super build (this may take some time to run)
   
    cmake -P configure.cmake
    cd build
    make -j4
   

5.  Make sure you are in the build directory and run
   
    chmod +x /path/to/midas-Kiwi/Cmake/makeFramework.sh
    /path/to/midas-Kiwi/Cmake/makeFramework.sh
   

6.  Open up the KiwiMidas project at
   
    path/to/midas-kiwi/Apps/iOS/KiwiMidas/KiwiMidas.xcodeproj
   

7.  While in xcode change the xcconfig file in kiwi-midas proj. This can be found by clicking on
    KiwiMidas > kiwiMidas > Supporting Files > kiwi.xcconfig
   
    Change the variables to
    ves_src = /path/to/midas-kiwi/src/ves
    ves_build = /path/to/midas-kiwi/apps/ios/cmakebuild/build
   

8.  Press 'Run' while the iPad emulator is selected