Skip to content

Commit

Permalink
Fix slides and README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
sunglok committed Oct 11, 2023
1 parent 4ed0c3d commit f523bc2
Show file tree
Hide file tree
Showing 5 changed files with 15 additions and 7 deletions.
14 changes: 11 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,20 @@
_An Invitation to 3D Vision_ is an introductory tutorial on _3D computer vision_ (a.k.a. _geometric vision_ or _visual geometry_ or _multiple-view geometry_). It aims to make beginners understand basic theories on 3D vision and implement its applications using [OpenCV](https://opencv.org/).
In addition to tutorial slides, example codes are provided in the purpose of education. They include simple but interesting and practical applications. The example codes are written as short as possible (mostly __less than 100 lines__) to be clear and easy to understand.

* Download [example codes and slides as a ZIP file](https://github.com/mint-lab/3dv_tutorial/archive/master.zip)
* Read [how to run example codes in Python](https://github.com/mint-lab/3dv_tutorial/blob/master/HOWTO_RUN_PYTHON.md)
* Read [how to run example codes in C++](https://github.com/mint-lab/3dv_tutorial/blob/master/HOWTO_RUN_CPP.md)
* To clone this repository (codes and slides): `git clone https://github.com/mint-lab/3dv_tutorial.git`
* To fork this repository to your Github: [Click here](https://github.com/mint-lab/3dv_tutorial/fork)
* To download codes and slides as a ZIP file: [Click here](https://github.com/mint-lab/3dv_tutorial/archive/master.zip)
* :memo: [How to run example codes in Python](https://github.com/mint-lab/3dv_tutorial/blob/master/HOWTO_RUN_PYTHON.md)
* :memo: [How to run example codes in C++](https://github.com/mint-lab/3dv_tutorial/blob/master/HOWTO_RUN_CPP.md)



### What does its name come from?
* The main title, _An Invitation to 3D Vision_, came from [a legendary book by Yi Ma, Stefano Soatto, Jana Kosecka, and Shankar S. Sastry](http://vision.ucla.edu/MASKS/). We wish that our tutorial will be the first gentle invitation card for beginners to 3D vision and its applications.
* The subtitle, _for everyone_, was inspired from [Prof. Kim's online lecture](https://hunkim.github.io/ml/) (in Korean). Our tutorial is also intended not only for students and researchers in academia, but also for hobbyists and developers in industries. We tried to describe important and typical problems and their solutions in [OpenCV](https://opencv.org/). We hope readers understand it easily without serious mathematical background.



### Lecture Slides
* [Section 1. Introduction](https://github.com/mint-lab/3dv_tutorial/blob/master/slides/01_introduction.pdf)
* [Section 2. Single-view Geometry](https://github.com/mint-lab/3dv_tutorial/blob/master/slides/02_single-view_geometry.pdf)
Expand All @@ -20,6 +26,8 @@ In addition to tutorial slides, example codes are provided in the purpose of edu
* Special Topic) [Bayesian Filtering](https://github.com/mint-lab/filtering_tutorial)
* Section 7. Visual SLAM and Odometry



### Example Codes
* **Section 1. Introduction** [[slides]](https://github.com/mint-lab/3dv_tutorial/blob/master/slides/01_introduction.pdf)
* **Section 2. Single-view Geometry** [[slides]](https://github.com/mint-lab/3dv_tutorial/blob/master/slides/02_single-view_geometry.pdf)
Expand Down
8 changes: 4 additions & 4 deletions examples/camera_calibration_implement.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ def fcxcy_to_K(f, cx, cy):
def reproject_error_calib(unknown, Xs, xs):
K = fcxcy_to_K(*unknown[0:3])
err = []
for i in range(len(xs)):
offset = 3 + 6 * i
for j in range(len(xs)):
offset = 3 + 6 * j
rvec, tvec = unknown[offset:offset+3], unknown[offset+3:offset+6]
xp = project_no_distort(Xs[i], rvec, tvec, K)
err.append(xs[i] - xp)
xp = project_no_distort(Xs[j], rvec, tvec, K)
err.append(xs[j] - xp)
return np.vstack(err).ravel()

def calibrateCamera(obj_pts, img_pts, img_size):
Expand Down
Binary file modified slides/01_introduction.pdf
Binary file not shown.
Binary file modified slides/03_two-view_geometry.pdf
Binary file not shown.
Binary file modified slides/04_solving_problems.pdf
Binary file not shown.

0 comments on commit f523bc2

Please sign in to comment.