Skip to content

Commit dffe945

Browse files
committed
edit calibration instructions in Readme.md
1 parent 2b690e3 commit dffe945

File tree

1 file changed

+9
-8
lines changed

1 file changed

+9
-8
lines changed

README.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -556,8 +556,8 @@ If you already have a calibration file, set `calibration_type` type to `convert`
556556
> *N.B.:* _Intrinsic parameters:_ camera properties (focal length, optical center, distortion), usually need to be calculated only once in their lifetime. In theory, cameras with same model and same settings will have identical intrinsic parameters.\
557557
> *N.B.:* If you already calculated intrinsic parameters earlier, you can skip this step by setting `overwrite_intrinsics` to false.
558558
559-
- Create a folder for each camera in your `Calibration\intrinsics` folder.
560559
- For each camera, film a checkerboard or a charucoboard. Either the board or the camera can be moved.
560+
- Create a folder for each camera in your `Calibration\intrinsics` folder and copy your images or videos in them.
561561
- Adjust parameters in the [Config.toml](https://github.com/perfanalytics/pose2sim/blob/main/Pose2Sim/Demo_SinglePerson/Config.toml) file.
562562
- Make sure that the board:
563563
- is filmed from different angles, covers a large part of the video frame, and is in focus.
@@ -574,20 +574,21 @@ If you already have a calibration file, set `calibration_type` type to `convert`
574574
> *N.B.:* _Extrinsic parameters:_ camera placement in space (position and orientation), need to be calculated every time a camera is moved. Can be calculated from a board, or from points in the scene with known coordinates.\
575575
> *N.B.:* If there is no measurable item in the scene, you can temporarily bring something in (a table, for example), perform calibration, and then remove it before you start capturing motion.
576576
577-
- Create a folder for each camera in your `Calibration\extrinsics` folder.
578-
- Once your cameras are in place, shortly film either a board laid on the floor, or the raw scene\
579-
(only one frame is needed, but do not just take a photo unless you are sure it does not change the image format).
580-
- Adjust parameters in the [Config.toml](https://github.com/perfanalytics/pose2sim/blob/main/Pose2Sim/Demo_SinglePerson/Config.toml) file.
581-
- Then,
577+
- 3 available methods:
582578
- **With a checkerboard:**\
583579
Make sure that it is seen by all cameras. \
584-
It should preferably be larger than the one used for intrinsics, as results will not be very accurate out of the covered zone.
580+
Can be set horizontally (default) or vertically (set `board_position = 'vertical'` in Config.toml). \
581+
It should preferably be rather large, as results will not be very accurate out of the covered zone.
585582
- **With scene measurements** (more flexible and potentially more accurate if points are spread out):\
586583
Manually measure the 3D coordinates of 10 or more points in the scene (tiles, lines on wall, boxes, treadmill dimensions...). These points should be as spread out as possible. Replace `object_coords_3d` by these coordinates in Config.toml.\
587584
Then you will click on the corresponding image points for each view.
588585
- **With keypoints:**\
589-
For a more automatic calibration, OpenPose keypoints could also be used for calibration.\
586+
For a more automatic calibration, pose keypoints could also be used for calibration.\
590587
**COMING SOON!**
588+
- Once your cameras are in place, make a quicke recording of the checkerboard laid on the floor, or the raw scene (only one frame is needed, but do not just take a photo unless you are sure it does not change the image format). \
589+
You can remove the checkerboard or the calibration object for the actual capture of your participants.
590+
- Copy your files in the èxtrinsics` folder.
591+
- Adjust parameters in the [Config.toml](https://github.com/perfanalytics/pose2sim/blob/main/Pose2Sim/Demo_SinglePerson/Config.toml) file.
591592

592593
<img src="Content/Calib_ext.png" width="920">
593594

0 commit comments

Comments
 (0)