1. Download the software from the overview webpage ("Download .zip" or "Download .tar.gz").
2. Start MATLAB and manually add the folder /arFramework3 to the path.
3. Type arInit to add all other functions to the path.

• A recent version of Linux, macOS or Windows
• MATLAB (best R2018b or newer)
• MATLAB Symbolic Math Toolbox
• MATLAB Optimization Toolbox
• Optional: MATLAB Statistics and Machine Learning Toolbox
• Optional: MATLAB Parallel Computing Toolbox

Take care to setup your MATLAB mex compiler correctly. Under Linux you might need to install g++-multilib via Synaptic. If you are tired of the warning about an unsupported gcc version you can suppress them as shown here: http://www.mathworks.com/matlabcentral/answers/92145-how-do-i-disable-the-unsupported-compiler-warning-message-generated-by-the-mex-command-in-matlab-7-1 Note that in newer MATLAB versions the warning code is located in mbuild and mexsh opposed to mexopts.sh.

The parallelization uses the pthread package.

• For Unix type operating system, for instance Linux or Mac OS X, the pthread package is usally installed an can be used immediately.

• On Windows systems the pthread-w32 package can be installed. The two required .dll files pthreadGC2.dll and pthreadVC2.dll can be found in the code subfolder arFramework3\pthreads-w32_2.9.1\dll\ for your convenience. D2D automatically copy these dll files in your working directory. The arCheck.m function will notify you when these files are not available and will disable multi-threading.

The source code of our community based software is stored on a Git server on github ssh://[email protected]:Data2Dynamics/d2d.git and can be reached via SSH. We recommend to use the freely available SourceTree (Mac & Windows) software for managing the repository and for contribution to the software.

The initial steps to fetch the D2D software repository are

1. Install SourceTree
2. Set user name and email
3. Click in "add repository" button in the upper left conner of the window
4. Source URL: ssh://[email protected]:Data2Dynamics/d2d.git or https://github.com/Data2Dynamics/d2d.git without the use of a public key-chain file
5. Destination Path: select our local path for the D2D software repository
6. SourceTree will fetch the most recent version of the software from the server

To upload changes, open SourceTree, select the respective changes that have been automatically detected, click "commit" and "push". Please also give a informative description what you changed.

To download the most recent updates of the software from the D2D server, select the respective updates that have been automatically detected and click "pull".

##Troubleshooting with installation on Mac

Installation of Matlab and the D2D software on new Mac versions might lead to technical problems. Below, you can find a series of hints that proved helpful:

1. Installation of Xcode with "command line tools" component is required.
2. (This step might be optional) Link the gcc command in /usr/bin/gcc to /usr/bin/gcc-4.2 using sudo ln -s /usr/bin/gcc /usr/bin/gcc-4.2
3. (This step might be optional) For saving plots as PDF and generating reports, link the corresponding commands to /bin/, e.g.: sudo ln -s /usr/local/bin/ps2pdf /bin/ps2pdf. Repeat this for all required files.
4. For MacOS 10.7: Edit ~/.matlab/yourmatlabversion/mexopt.sh. The default setting for SDKROOT is wrong for recent versions of MacOS and has to be replaced with: /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.7.sdk
5. For MacOS 10.8 / 10.9: Make mexopt.sh writeable using sudo chmod 755 /Applications/MATLAB_R2013b.app/bin/mexopt.sh. Use find / Cmd+F and replace all '10.7' with '10.8' or '10.9', respectively.
6. For R2013a: Download the patch according to your OSX version from http://www.mathworks.de/support/solutions/en/data/1-FR6LXJ/ at the bottom of the page and follow the instructions to install the patch
7. If you encounter the following error No supported compiler or SDK was found. For options, visit http://www.mathworks.com/support/compilers/R2015b/maci64.html., please check out this link.