Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Mention more Theia dependencies #262

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions docs/source/building.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,11 +25,17 @@ Theia relies on a number of open source libraries. Luckily, most of the will be

5. `Ceres Solver <https://code.google.com/p/ceres-solver/>`_ is a library for solving non-linear least squares problems. In particular, Theia uses it for Bundle Adjustment.

6. `RocksDB <http://rocksdb.org/>`_ is a persistent key-value store for Flash and RAM storage.

7. `RapidJSON <https://rapidjson.org/>`__ is a fast JSON parser and generator.

Many of these libraries can be installed quickly with ``conda``. It is suggested to install a build of Ceres which uses ``libsuitesparse``.

**NOTE**: Theia also depends on the following libraries, but they are included in the installation of Ceres so it is likely that you do not need to reinstall them.

6. `google-glog <http://code.google.com/p/google-glog>`_ is used for error checking and logging. Ceres needs glog version 0.3.1 or later. Version 0.3 (which ships with Fedora 16) has a namespace bug which prevents Ceres from building.
8. `google-glog <http://code.google.com/p/google-glog>`_ is used for error checking and logging. Ceres needs glog version 0.3.1 or later. Version 0.3 (which ships with Fedora 16) has a namespace bug which prevents Ceres from building.

7. `gflags <http://code.google.com/p/gflags>`_ is a library for processing command line flags. It is used by some of the examples and tests.
9. `gflags <http://code.google.com/p/gflags>`_ is a library for processing command line flags. It is used by some of the examples and tests.

Make sure all of these libraries are installed properly before proceeding. Improperly installing any of these libraries can cause Theia to not build.

Expand Down
14 changes: 12 additions & 2 deletions src/theia/io/read_calibration.h
Original file line number Diff line number Diff line change
Expand Up @@ -41,8 +41,10 @@
namespace theia {
struct CameraIntrinsicsPrior;

// Reads calibration data for images that are to be reconstructed. The
// calibration file should have the following JSON format:
// Reads calibration data for images that are to be reconstructed in
// the JSON format. The calibration file has the image name, dimensions,
// camera model, and intrinsics. Examples are shown below for three types
// of camera models:
//
// {
// "priors" : [
Expand Down Expand Up @@ -70,6 +72,14 @@ struct CameraIntrinsicsPrior;
// "altitude" : 64,
// "camera_intrinsics_type" : "PINHOLE_RADIAL_TANGENTIAL"
// }}
// {"CameraIntrinsicsPrior" : {
// "image_name" : "view_3.jpg",
// "focal_length" : 600,
// "principal_point" : [640, 520],
// "aspect_ratio" : 1.0,
// "radial_distortion_1" : 0.998693
// "camera_intrinsics_type" : "FOV"
// }}
// ]
// }
//
Expand Down