Version 0.2

License update to Apache License to allow commercial use.

• Nvidia GPU with compute capability >= 8.0

The framework was tested using Ubuntu 22.04, 64 bit and libraries with the following version number.

• CUDA 12.4.1
• Python 3.10
• sympy 1.12
• Thrust 2.3.2
• CUSP master (07.06.2024)
• numpy 1.24.4
• swig 4.0

If you use OpenOF for your research please cite:

Cornelius Wefelscheid and Olaf Hellwich OpenOF: Framework for sparse non-linear least squares optimization on a gpu. VISAPP 2013 [pdf]

OpenOF - Open Optimization Framework Copyright (C) 2012 C. Wefelscheid

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

OpenOF comes with two examples, similarity transformation and bundle adjustement. To get started we recommend looking into the simpler model of the similarity transformation. To get the similarity transformation example running you need to execute the following commands.

$ git clone https://github.com/OpenOF/OpenOF.git

$ cd OpenOF

$ git submodule init

$ git submodule update

$ cd Example

$ python3 similarityTransform.py

$ cd ..

$ cmake .

$ make

A C++ library as well as a Python library was created.

An example how to use the Python library can be found under ./Example. To run the Example proceed as follows:

$ cd Example

$ python3 runSimilarityTransformObj.py

or

$ python3 runSimilarityTransform.py

A more complex example is under Example/bundle.py (design) and Example/runBundle.py (runtime).

Use the provided docker from inside vscode. Install the remote development extension within vscode.

Inside the docker you can continue from getting startet step: "cd Example"

• In case you have version 0.7.2 of sympy you can downgrade with the following command

$ sudo pip install sympy==0.7.1

or upgrade to version 0.7.3.

• Cuda 5 does not come with Thrust 1.6, please exchange the thrust version usually under /usr/local/cuda/include/thrust.

• Cuda 5 is not working with gcc version 4.7 or higher. Try using an older gcc version.

• Compiler error: /bin/sh: 1: Syntax error: "(" unexpected.

  Make sure the path of the library doesn't contain any brackets.