Installing and running cedar
Pre-built CEDAR app
The easiest way to get CEDAR to run is to use one of our pre-built apps. You simply have to download the correct version, extract it, and execute the right file.
If you like, you can follow along this video to help you.
If you want to skip the video, follow these simple steps:
- Open the downloads section of the CEDAR website.
- Find the correct version for your operating system (please note that we only support 64-bit operating systems).
- Click the "Download" button and save the file on your hard-drive.
- Extract the file you have downloaded.
- Navigate into the folder that has been extracted and find the executable file (Linux/MacOS:
- Run the executable file. After a few seconds, the graphical user interface of CEDAR should appear.
In case we do not support your operating system, you will not be able to use the pre-built versions of CEDAR. If you do not want to install a different operating system or run one in a virtual machine, the alternative is to compile the source code of CEDAR, which is explained in the next section.
Installing from CEDAR source code
Supported operating systems
CEDAR runs on all major operating systems (Linux, MacOS, and Windows). The following manual for installing CEDAR is based on Ubuntu Linux 18.04 (LTS) and other Debian-based Linux distributions. We are working on making manuals for other operating systems available on this website.
Current issue: On Ubuntu 18.04, compilation works but CEDAR does not run. We are working on updating this installation manual to solve this issue.
Install all dependencies
CEDAR depends on many other libraries that you will have to install before you can compile CEDAR itself. Execute the following code in your terminal:
sudo apt-get update
sudo apt-get install libboost-all-dev libopencv-dev libopencv-contrib-dev libqt4-dev libqwt5-qt4-dev libqglviewer-dev-qt4 cmake build-essential libfftw3-dev
Download the CEDAR source code
There are two ways to get the CEDAR sources.
You can use Git, a distributed version control system; install it through your package manager
sudo apt-get install git
and then clone our official repository.
git clone https://github.com/cedar/cedar
This will download a copy of the entire repository into a directory named
cedar in your current working directory.
If you do not want to use Git, you can download an archive containing the CEDAR sources
and rename the resulting directory.
mv cedar-master cedar
Change into the cedar directory.
Create a copy of cedar.conf.example (in this folder) and name it
cp cedar.conf.example cedar.conf
cedar.conf is set up to work on Ubuntu 18.04. If you are running Ubuntu, skip this step. If you are running a different system, take a look at the file and make any changes for your individual system (e.g., installation prefix, external include paths) with an editor of your choosing.
Create an out-of-source build folder and change into it:
Generate makefiles specific for your platform to be able to compile cedar:
Compile cedar. You can save some time by compiling in multiple threads in parallel. To split the compilation process into
n threads, add the optional parameter
-j n to the following command:
make [-j n]
(optional) Run all unit tests to check whether everything works:
(optional) Create the documentation. It will be generated in the folder
sudo apt-get install doxygen
Note that this may generate some warnings that you can usually ignore safely.
(optional) Install cedar
sudo make install
Go into the binary folder of the cedar repository:
Start the graphical user interface of cedar:
Now, drag and drop elements from the top onto the working area and connect them up.