Computer Vision @ LEMS

Install LEMSVXL on Windows

1. Make sure you have the following installed:
   • Microsoft Visual Studio C++
   • TortoiseSVN from http://tortoisesvn.tigris.org
   • CMake from http://www.cmake.org/
2. Check out the latest version of LEMSVXL using Tortoise SVN
   • Create a folder for the LEMSVXL project. We will use "c:\projects\lemsvxl" from now on.
   • Create a folder "c:\projects\lemsvxl\src"
   • Right-click inside  "c:\projects\lemsvxl\src" , choose "SVN Checkout"
     • In the "URL of repository" box, type in: "https://visionserver.lems.brown.edu/svn/lemsvxl/trunk"
     • In the "Checkout directory" box, the text should already be "c:\projects\lemsvxl\src"
     • In the "Checkout depth", choose "Fully recursive"
     • In the "Revision" box, choose "Head revision"
     • Click OK
     • Tortoise SVN should now download the souce code. You should see a whole lot of "Added  "c:\projects\lemsvxl\src\..."
3. Prepare Microsoft Visual Studio Solution for LEMSVXL souce code using CMake
   • Create a folder  "c:\projects\lemsvxl\bin"
   • Open CMake program (from Start menu)
   • In the "Where is the source" box, browse to  "c:\projects\lemsvxl\src"
   • In the "Where to build the binaries" box, browse to  "c:\projects\lemsvxl\bin"
   • Click "Configure" (in bottom left of the window)
   • A window will show up, asking for the type of compiler. Choose the version of "Visual Studio" you're using. Stay away from "Win64" option for now.
   • CMake will run a whole bunch of tests to determine the settings of the machine, compilers, packages, etc. The progress is shown in bottom of the window. This may take up to several minutes.
   • Once this is done, a window shows up, with a lot of red rows.
   • Scroll to find "VXL-DIRECTORY"  and fill accordingly
   • Click "OK". CMake will now make all the "Projects" and "Solution" files for Microsoft Visual Studio.
   • CMake will close itself after this is done.
4. Compile VXL code
   • Go to  "c:\projects\lemsvxl\bin"
   • Double-click on "lemsvxl.sln". This will open Microsoft Visual Studio
   • From top menu, View --> Solution Explorer.
   • Right-click on "ALL_BUILD", click on "build". This will build ALL projects in LEMSVXL. You can selectively build individual projects by right-click and "build" that project.
   • This process can take a while, up to a couple hours, depending on how fast the machine is.
   • After this is done, LEMSVXL is ready to use.

Install LEMSVXL on Linux (unix make files)

1. Make sure you have the following installed:
   • GNU C and C++ compiler. 
   • Subversion
   • Make
   • CMake
   • VXL
2. Check out the latest version of LEMSVXL using svn (subversion version control).
   • Create a directory for the LEMSVXL project. e.g. /projects/lemsvxl
   • Open the terminal and cd to you vxl project directory. e.g cd /projects/vxl
   • Checkout the code into a new folder under the lemsvxl-directory. e.g. /projects/vxl/src. You need to be a developer; to checkout, type in the terminal: svn co https://visionserver.lems.brown.edu/svn/lemsvxl/trunk src --username lemsuser.  Checking out the code will take some time, at the end you should have a new directory containing the source code. e.g /projects/lemsvxl/src
3. Build the binaries(using unix make files)
   • Create a directory for your release and debug binaries under the lemsvxl-project. e.g /projects/lemsvxl/bin/Release, /projects/lemsvxl/bin/Debug. This will keep the configurations separate
   • Open Cmake GUI (you could alternatively use cmake through command line)
   • Fill the path for source code e.g /projects/lemsvxl/src
   • Fill the path for binaries e.g. /projects/lemsvxl/bin/Debug
   • Press configure. It will ask you what type of binaries to build. Select Unix Make files.
   • At this point, you can "turn on" different projects of VXL. Fill the path to the VXL binarie folder. Make sure you select "Advanced View". Search for the variable CMAKE_BUILD_TYPE and make sure it matches the current configuration, e.g Debug.  We will try to keep things simple, so stay with the defaults, that is just press configure, until it is done asking you questions. When CMake is done showing variables in red, it will highlight the generate button.
   • Press generate, if no errors occur, the unix make files will be generated in your binaries directory.
   • Build the binaries, by going into the terminal, cd into your just configured binaries e.g. /projects/lemsvxl/bin/Debug, then in the terminal type:
     

     make -j2 -k
     		

     The -j flag is to distrubute jobs, so if you have 8 cores you could use -j8. The -k keeps building after errors. Building will take time, at the end revise errors and look for built libraries and executables. Note that if you don't see a library built, it could be that not all necessary fields were set when configuring in CMake