Multiple PS Eye Cameras Calibration - Revision history

Pavel at 10:30, 31 October 2024

2024-10-31T10:30:07Z

Pavel at 10:14, 31 October 2024

2024-10-31T10:14:42Z

Pavel at 10:06, 31 October 2024

2024-10-31T10:06:42Z

Pavel at 09:37, 31 October 2024

2024-10-31T09:37:47Z

Pavel at 09:53, 30 October 2024

2024-10-30T09:53:55Z

Pavel at 08:53, 30 October 2024

2024-10-30T08:53:15Z

Pavel at 08:46, 30 October 2024

2024-10-30T08:46:01Z

Vmaslov: /* Step 8: Set Scene Scale Using Сamera Height as Reference */

2015-12-25T19:48:17Z

‎Step 8: Set Scene Scale Using Сamera Height as Reference

Pavel at 08:21, 6 November 2015

2015-11-06T08:21:58Z

Pavel at 08:20, 6 November 2015

2015-11-06T08:20:59Z

@@ Line 73: / Line 73: @@
 * Create new calibration project in [[iPi Mocap Studio]]:
 ** Press ''New'' button or select '''File > New Project''' menu item or use <tt>Ctrl+N</tt> (2)
-*:[[Image:Calibration_Start.png|center|800px]]
+*:[[Image:Calibration_Start_Flashlight_1.png|center|800px]]
 ** Choose '''Calibration project''' type in '''New Project Wizard'''.
 ** Set the diagonal '''Field of View''' (FOV) for your cameras. If this screen is not shown, this means FOV is already known and you do not need to manually specify it.
@@ Line 84: / Line 84: @@
 </center>
 * Adjust the [[Region-of-Interest]] to cover the part of video that contains the glowing marker (3).
 * Normally, you need to use default calibration settings
 ** Auto-detect initial camera positions turned on

@@ Line 180: / Line 180: @@
 * Click '''Calibrate Based on AI Joints''' button and wait while the system finishes calibration (4).
-==== Step 6: Check Calibration Quality ====
+==== Complete Calibration ====
-Resulting scene should look like this:
+Follow the same [[User_Guide_for_Multiple_PS_Eye_Cameras_Configuration#Step_6:_Check_Calibration_Quality|Steps 6-8]] described for flashlight calibration
-−
-[[File:Calibration_result1.png|center|800px]]
-−
-Make sure you have <span style="color:white; background:#ffd700; padding:5px;">Good</span> or <span style="color:white; background:#8cbf26; padding:5px;">Perfect</span> calibration result.
-{{Important|1=<span style="color:white; background:#e93f3f; padding:5px;">Failed</span> calibration is not recommended to use, as you will not be able to get accurate tracking results. However, sometimes '''Failed''' status can be misdetected. If detected marker positions are close to marker image on video in all frames for all sensors, you can use this calibration for tracking.}}
-−
-==== Step 7: Check Ground Plane ====
-[[Image:Floor-Detection-1.png|thumb|334px|Manual Floor Detection]]
-Ground plane should be detected automatically. Ground points are marked by <span style="color:white; background:#ffd700; padding:5px;">yellow</span> color.
-* Make sure that ground points are actually near the ground plane.
-* If ground plane is detected incorrectly, select ground points manually.
-** Expand '''Manual Calibration Adjustment''' expander.
-** First, unmark all ground points by pressing '''Clear all points''' button.
-** For each ground point, click on it in 3D view and press '''Mark as ground''' button.
-** You can cancel marking point as ground point by pressing '''Unmark ground''' button.
-−
-{{Important|If you do not mark ground points then the ground plane is incorrect and there is no sense in using Foot tracking option and camera heights values.}}
-−
-==== Step 8: Set Scene Scale Using Camera Height as Reference ====
-−
-Now cameras in your scene are properly oriented relative to other cameras and relative to ground plane. But you still need to find one more parameter: scene scale.
-−
-Use '''Сamera #1''' height over ground to set correct scene scale.
-−
-[[File:Calibration_scale1.png|center|800px]]
-−
-* Save results to calibration project file or using '''Save scene...''' button on '''Scene''' tab (6).
-[[Image:Depth_Project_Scene_Tab.png|center|link=]]

@@ Line 162: / Line 162: @@
 * Create new calibration project in [[iPi Mocap Studio]]:
 ** Press ''New'' button or select '''File > New Project''' menu item or use <tt>Ctrl+N</tt> (2)
-*:[[Image:Calibration_Start.png|center|800px]]
+*:[[Image:Calibration_Start_AI_1.png|center|800px]]
 ** Choose '''Calibration project''' type in '''New Project Wizard'''.
 ** Set the diagonal '''Field of View''' (FOV) for your cameras. If this screen is not shown, this means FOV is already known and you do not need to manually specify it.

@@ Line 75: / Line 75: @@
 *:[[Image:Calibration_Start.png|center|800px]]
 ** Choose '''Calibration project''' type in '''New Project Wizard'''.
-** Set the diagonal '''Field of View''' (FOV) for your cameras.
+** Set the diagonal '''Field of View''' (FOV) for your cameras. If this screen is not shown, this means FOV is already known and you do not need to manually specify it.
 *:{{Note|If you use Sony PS Eye or Logitech QuickCam 9000 cameras, leave the FOV value at the default 75 degrees.}}
 <center>
@@ Line 88: / Line 88: @@
 *** If calibration fails to detect initial camera positions correctly, you can turn this checkbox off and set camera positions manually. But in most cases it will be easier to re-record calibration sequence.
 ** Auto-adjust camera FOV turned off
-*** Use this mode only if you do not use Sony PS3 Eye camera and do not know camera field of view
+*** Use this mode only if you did not know camera field of view requested during project creation (if it was requested) or if it was set by default (this may be recommended for particular camera models).
-** '''Regular''' calibration mode
-*** In rare cases when '''Regular''' mode fails to calibrate, you can use '''Extended''' and '''Extreme''' calibration modes. It will take much more time, but may help to calibrate correctly if you have high percent of marker misdetections. Usually this is caused by incorrect camera positioning or poor lighting conditions
 * Click '''Calibrate Based on Flashlight Marker''' button and wait while the system finishes calibration (4).
@@ Line 149: / Line 147: @@
 {{Tip|The exact movement is not so important, just try to cover the whole capture volume by arms and legs movement, or at least its perimeter.}}
-{{Tip|You can use your action videos for calibration, if the body movement conver the whole capture area. Videos when you stand at the same place will not allow for accurate calibration. }}
+{{Tip|You can use your action videos for calibration, if the body movement cover the whole capture area. Videos when you stand at the same place all the time will not allow for accurate calibration. }}
-{{Tip|For successful calibration, several hundred frames are sufficient. Much more frames (like several thousands) will not produce more accurate results, but instead will increase the processing time and possible number of marker detection errors. So generally it is not recommended to record calibration videos of more than 1 minute length.}}
+{{Tip|For successful calibration, 1000 frames shoud be enough. Recording long videos over 1 minute length does not make much sense, but you still can use them for calibration. }}
 ==== Step 3: Take Note of Height of Your First Camera Over the Ground. ====
@@ Line 166: / Line 164: @@
 *:[[Image:Calibration_Start.png|center|800px]]
 ** Choose '''Calibration project''' type in '''New Project Wizard'''.
-** Set the diagonal '''Field of View''' (FOV) for your cameras.
+** Set the diagonal '''Field of View''' (FOV) for your cameras. If this screen is not shown, this means FOV is already known and you do not need to manually specify it.
 *:{{Note|If you use Sony PS Eye or Logitech QuickCam 9000 cameras, leave the FOV value at the default 75 degrees.}}
 <center>
@@ Line 179: / Line 177: @@
 *** If calibration fails to detect initial camera positions correctly, you can turn this checkbox off and set camera positions manually. But in most cases it will be easier to re-record calibration sequence.
 ** Auto-adjust camera FOV turned off
-*** Use this mode only if you do not use Sony PS3 Eye camera and do not know camera field of view
+*** Use this mode only if you did not know camera field of view requested during project creation (if it was requested) or if it was set by default (this may be recommended for particular camera models).
 * Click '''Calibrate Based on AI Joints''' button and wait while the system finishes calibration (4).

@@ Line 68: / Line 68: @@
 ==== Step 5: Process Calibration Video in [[iPi Mocap Studio]] ====
-{{Tip|You can postpone processing calibration video until after you finished recording other videos (e.g. your action videos). However, it is a good idea to process your calibration video as soon as it was recorded because it helps you ensure that you have good calibration. Use '''Regular''' calibration mode (1) if you want to be 100% sure that calibration sequence is fine. Also you can use '''Fast''' calibration mode to save time. But in this case you will need to re-process calibration video later to get maximum calibration quality. I certain cases '''Fast''' calibration mode can fail to calibrate even if calibration sequence is fine and can be calibrated successfully in '''Regular''' calibration mode.}}
+{{Tip|You can postpone processing calibration video until after you finished recording other videos (e.g. your action videos). However, it is a good idea to process your calibration video as soon as it was recorded because it helps you ensure that you have good calibration.}}
 To process calibration video please do the following:
@@ Line 91: / Line 91: @@
 ** '''Regular''' calibration mode
 *** In rare cases when '''Regular''' mode fails to calibrate, you can use '''Extended''' and '''Extreme''' calibration modes. It will take much more time, but may help to calibrate correctly if you have high percent of marker misdetections. Usually this is caused by incorrect camera positioning or poor lighting conditions
-* Click '''Calibrate''' button and wait while the system finishes calibration (4).
+* Click '''Calibrate Based on Flashlight Marker''' button and wait while the system finishes calibration (4).
 ==== Step 6: Check Calibration Quality ====

← Older revision		Revision as of 08:53, 30 October 2024
Line 1:		Line 1:
−	~~{{:Calibration Definition}}~~
−
	=== Flashlight Calibration ===		=== Flashlight Calibration ===
		+
		+	{{:Calibration Definition}}

	==== Importance of high frame rate ====		==== Importance of high frame rate ====

@@ Line 1: / Line 1: @@
 {{:Calibration Definition}}
-=== Importance of high frame rate ===
+=== Flashlight Calibration ===
 You should record calibration video at the same resolution as your action video and at the same (or higher) frame rate.
@@ Line 9: / Line 11: @@
 Calibration at low frame rate may lead to reduced accuracy because of increased synchronization errors.
-=== Glowing Marker ===
+==== Glowing Marker ====
 {{:Glowing Marker}}
-=== Step 1: Running [[iPi Recorder]] in Calibration Mode ===
+==== Step 1: Running [[iPi Recorder]] in Calibration Mode ====
 Run [[iPi Recorder]] and choose one of the darkening modes in "darkening for calibration" list (for Sony PS Eye cameras)
@@ Line 27: / Line 29: @@
 {{Important|Do not turn off the light in the room during calibration! This will not help the software but will make it harder for you to see what is happening on recorded video when you view it later.}}
-=== Step 2: Record Calibration Video ===
+==== Step 2: Record Calibration Video ====
 Start video recording.
@@ Line 53: / Line 55: @@
 </center>
-=== Step 3: Stop Recording and Check Recorded Video ===
+==== Step 3: Stop Recording and Check Recorded Video ====
 Check the video and make sure that:
@@ Line 60: / Line 62: @@
 * Most of the time (80%-90% of all recording time) marker is visible in all cameras
-=== Step 4: Take Note of Height of Your First Camera Over the Ground. ===
+==== Step 4: Take Note of Height of Your First Camera Over the Ground. ====
 Take note of height of your first camera over the ground. You will need this parameter later.
-=== Step 5: Process Calibration Video in [[iPi Mocap Studio]] ===
+==== Step 5: Process Calibration Video in [[iPi Mocap Studio]] ====
 {{Tip|You can postpone processing calibration video until after you finished recording other videos (e.g. your action videos). However, it is a good idea to process your calibration video as soon as it was recorded because it helps you ensure that you have good calibration. Use '''Regular''' calibration mode (1) if you want to be 100% sure that calibration sequence is fine. Also you can use '''Fast''' calibration mode to save time. But in this case you will need to re-process calibration video later to get maximum calibration quality. I certain cases '''Fast''' calibration mode can fail to calibrate even if calibration sequence is fine and can be calibrated successfully in '''Regular''' calibration mode.}}
@@ Line 91: / Line 93: @@
 * Click '''Calibrate''' button and wait while the system finishes calibration (4).
-=== Step 6: Check Calibration Quality ===
+==== Step 6: Check Calibration Quality ====
 Resulting scene should look like this:
@@ Line 100: / Line 102: @@
 {{Important|1=<span style="color:white; background:#e93f3f; padding:5px;">Failed</span> calibration is not recommended to use, as you will not be able to get accurate tracking results. However, sometimes '''Failed''' status can be misdetected. If detected marker positions are close to marker image on video in all frames for all sensors, you can use this calibration for tracking.}}
-=== Step 7: Check Ground Plane ===
+==== Step 7: Check Ground Plane ====
 [[Image:Floor-Detection-1.png|thumb|334px|Manual Floor Detection]]
 Ground plane should be detected automatically. Ground points are marked by <span style="color:white; background:#ffd700; padding:5px;">yellow</span> color.
@@ Line 112: / Line 114: @@
 {{Important|If you do not mark ground points then the ground plane is incorrect and there is no sense in using Foot tracking option and camera heights values.}}
-=== Step 8: Set Scene Scale Using Camera Height as Reference ===
+==== Step 8: Set Scene Scale Using Camera Height as Reference ====
 Now cameras in your scene are properly oriented relative to other cameras and relative to ground plane. But you still need to find one more parameter: scene scale.