Difference between revisions of "Download"

From BoofCV
Jump to navigationJump to search
m
(clarified and expanded on how to build the bleeding edge)
Line 13: Line 13:
= Bleeding Edge =  
= Bleeding Edge =  


BoofCV uses github for its central repositoryAfter you clone the github repository, don't forget to also clone the data submodule!  See example below for how to handle the data submodule.
BoofCV is being developed in parallel with several other librariesIf you plan on using the latest source code you will need to check out all of their repositories too.


git repository: https://github.com/lessthanoptimal/BoofCV
* [https://github.com/lessthanoptimal/GeoRegression GeoRegression]
* [http://ddogleg.org/ DDogleg]
* [http://code.google.com/p/efficient-java-matrix-library/ EJML]
 
Below is a commandline sequence for checking all of those libraries and BoofCV.  It also shows you how to place everything in the correct location relative to each other.  This is helpful if you plan on using the provided IntelliJ files.


To checkout the latest source code type the following:
<pre>
<pre>
git clone git://github.com/lessthanoptimal/BoofCV.git boofcv
git clone git://github.com/lessthanoptimal/BoofCV.git boofcv
Line 23: Line 26:
git submodule init
git submodule init
git submodule update
git submodule update
cd ..
git clone git://ithub.com/lessthanoptimal/GeoRegression.git georegression
git clone git://github.com/lessthanoptimal/ddogleg.git ddogleg
mkdir -p ejml/trunk
svn checkout https://efficient-java-matrix-library.googlecode.com/svn/trunk/ ejml/trunk
</pre>
</pre>


Larger data files have been put into a separate git repository and the submodule related lines are required to download themThose data files
Just after BoofCV is checked out it sets up a submodule for the dataThe submodule contains data files used in the example codeSo most people will want to check that out too.
will appear inside the BoofCV/data directory.   
 
'''WARNING''' If you are using the git code, make sure you check out the latest REPOSITORY source code from [https://github.com/lessthanoptimal/GeoRegression GeoRegression], [http://code.google.com/p/efficient-java-matrix-library/ EJML], and [http://ddogleg.org/ DDogleg].  Otherwise there is a good chance that you get compiler errors complaining about missing classes/functions.


= Maven =
= Maven =

Revision as of 21:45, 2 December 2013

BoofCV is available from its central repository at Github or through periodic releases. Below are links to the latest stable release hosted on SourceForge.

Latest Stable Release:

If you encounter any problems getting BoofCV up and running, please let us know! A bug might have slipped through testing or if the instructions are not clear we would like to know.

Android users, if these jars give you trouble it's probably because they were compiled with JDK 7. See the Android support page for a work around.

Bleeding Edge

BoofCV is being developed in parallel with several other libraries. If you plan on using the latest source code you will need to check out all of their repositories too.

Below is a commandline sequence for checking all of those libraries and BoofCV. It also shows you how to place everything in the correct location relative to each other. This is helpful if you plan on using the provided IntelliJ files.

git clone git://github.com/lessthanoptimal/BoofCV.git boofcv
cd boofcv
git submodule init
git submodule update
cd ..
git clone git://ithub.com/lessthanoptimal/GeoRegression.git georegression
git clone git://github.com/lessthanoptimal/ddogleg.git ddogleg
mkdir -p ejml/trunk
svn checkout https://efficient-java-matrix-library.googlecode.com/svn/trunk/ ejml/trunk

Just after BoofCV is checked out it sets up a submodule for the data. The submodule contains data files used in the example code. So most people will want to check that out too.

Maven

BoofCV is on Maven central repository. To add it to your project add the following to your project's pom file:

<dependency>
  <groupId>org.boofcv</groupId>
  <artifactId>boofcv</artifactId>
  <version>XXX</version>
</dependency>

Replace XXX with the latest version of BoofCV.

Past Releases

Version Link Description
Alpha v0.15 Link Kinect, visual odometry, ground plane, bugs
Alpha v0.14 Link Improved 2D image processing
Alpha v0.13 Link Feature API changes, VO, many changes
Alpha v0.12 Link SIFT, combined tracker, API changes
Alpha v0.11 Link Stereo Visual Odometry, trifocal tensor
Alpha v0.10 Link 5-pt Essential, Template, Improved performance/API.
Alpha v0.9 Link Android and Xuggler support, Refactorings
Alpha v0.8 Link Stereo disparity, tweaked calibration
Alpha v0.7 Link Stereo calibration, rectification, improved API
Alpha v0.6 Link Camera calibration, 3D Vision, Performance, and more
Alpha v0.5 Link Improvements to SURF and non-linear optimization
Alpha v0.4 Link Fixed bugs in SURF and MultiSpectral images
Alpha v0.3 Link More color and camera calibration support
Alpha v0.2 Link API improvements and geometric vision
Alpha v0.1 Link First formal publish release