Structure-from-Motion plugin for CSIRO Workspace

This project is a plugin for the CSIRO Workspace scientific workflow framework. Its purpose is to utilise open source libraries and methods for photogrammetry and point cloud processing. This project relies on [OpenCV] (http://opencv.org) and [pointcloudplugin] (https://github.com/csiro-workspace/pointcloudplugin).

This plugin is still in a development phase, but can be used to perform basic photogrammetry tasks and mesh generation. For more details see the following paper:
Mead, Stuart R., et al. "A Distributed Computing Workflow for Modelling Environmental Flows in Complex Terrain." Environmental Software Systems. Infrastructures, Services and Applications. Springer International Publishing, 2015. 321-332.

Feedback and contributions are more than welcome to help expand its capabilities.

Contributors

• Stuart Mead
  Risk Frontiers, Dept. of Environmental Sciences, Macquarie University, North Ryde NSW
  CSIRO Digital Productivity, Clayton VIC

Compiling and using the plugin

1. Download and install CSIRO Workspace
2. Checkout the fork of the CSIRO pointcloudplugin repository from [here] (https://github.com/stuartmead/pointcloudplugin) and follow the build instructions.
3. Checkout [OpenCV] (https://github.com/Itseez/opencv) and [OpenCV Contrib modules] (https://github.com/Itseez/opencv_contrib) and build them yourself. You will need the opencv_features2d, opencv_xfeatures2d modules and their dependencies, I would recommend turning everything else off (additionally turning off the CUDA modules will save a lot of compilation time).
4. Add the opencv/bin directory to your PATH variable.
5. Check out this repository
6. Launch CMake from Workspace's Development menu to configure and generate the project. This needs to be done from within Workspace rather than running CMake directly as some key environment variables get setup.
7. Make the variable OpenCV_DIR point to your OpenCV build directory (the one with OpenCVConfig.cmake)
8. Make and compile the project
9. Add the plugin to Workspace through Settings>Configure application>Plugins
10. Restart Workspace and a Structure from motion group should be visible in the operation catalogue.

Instructions for plugin usage

Examples and usage instructions are currently being written and will be included in the Wiki.

For bug reporting, questions and feature requests please use the [trello board] (https://trello.com/b/FRgMKmrs/structurefrommotionplugin)

License

Copyright (c) 2015, Stuart Mead - Risk Frontiers, Macquarie University All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright
  notice, this list of conditions and the following disclaimer.
  
* Redistributions in binary form must reproduce the above copyright
  notice, this list of conditions and the following disclaimer in the
  documentation and/or other materials provided with the distribution.
  
* Neither the name of the copyright holder nor the names of its contributors
  may be used to endorse or promote products derived from this software without
  specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

For further information, contact:

  Stuart Mead
  Risk Frontiers
  Dept. of Environmental Sciences
  Macquarie University
  North Ryde NSW 2109

Third Party Components

The following third party components are distributed with the Software. You agree to comply with the license terms for these components as part of accessing the Software. Other third party software may also be identified in separate files distributed with the Software.

This project is designed to be built against [OpenCV] (http://opencv.org), which is currently licensed under a 3-clause BSD License. Note that this plugin uses SIFT feature detection, which is subject to its own licence for non-commercial use only, see [this page] (http://www.cs.ubc.ca/~lowe/keypoints/) for more details on SIFT. A more commercial-friendly feature matching algorithim, [BRISK] (http://www.asl.ethz.ch/people/lestefan/personal/BRISK) is included in the project, which is licensed under a 3-clause BSD licence