更新Datasheet和标定文档
This commit is contained in:
JimmyLee05
parent
fb37635a72
commit
2184c3ce9e
BIN
docs/images/calibration001.png
Normal file
BIN
docs/images/calibration001.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 306 KiB |
BIN
docs/images/calibration002.png
Normal file
BIN
docs/images/calibration002.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 470 KiB |
BIN
docs/images/calibration003.png
Normal file
BIN
docs/images/calibration003.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 484 KiB |
BIN
docs/images/calibration004.png
Normal file
BIN
docs/images/calibration004.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 489 KiB |
BIN
docs/images/calibration005.png
Normal file
BIN
docs/images/calibration005.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 467 KiB |
BIN
docs/images/calibration006.png
Normal file
BIN
docs/images/calibration006.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 492 KiB |
BIN
docs/images/calibration007.png
Normal file
BIN
docs/images/calibration007.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 382 KiB |
BIN
docs/images/calibration008.png
Normal file
BIN
docs/images/calibration008.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 496 KiB |
BIN
docs/images/tripod.png
Normal file
BIN
docs/images/tripod.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 210 KiB |
|
|
@ -15,6 +15,7 @@ MYNT® EYE S SDK
|
|||
src/firmware/contents
|
||||
src/data/contents
|
||||
src/analytics/contents
|
||||
src/tools/contents
|
||||
src/slam/contents
|
||||
api/contents
|
||||
src/support/contents
|
||||
|
|
|
|||
|
|
@ -7,4 +7,5 @@ Product Introduction
|
|||
:maxdepth: 2
|
||||
|
||||
spec_s1030
|
||||
spec_s1030_ir
|
||||
spec_s2100
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
.. _mynteye_spec_s1030:
|
||||
|
||||
S1030-IR-120/Mono Product Specification
|
||||
S1030-120/Mono Product Specification
|
||||
=========================================
|
||||
|
||||
Product Specification:
|
||||
|
|
@ -8,16 +8,15 @@ Product Specification:
|
|||
|
||||
|
||||
========================== =======================================
|
||||
Model S1030-IR-120/Mono
|
||||
Model S1030-120/Mono
|
||||
-------------------------- ---------------------------------------
|
||||
Size PCB dimension:149x24mm,
|
||||
Total dimension:165x31.5x29.6mm
|
||||
Size 165x31.5x31.23mm
|
||||
-------------------------- ---------------------------------------
|
||||
Frame Rate 10/15/20/25/30/35/40/45/50/55/60FPS
|
||||
-------------------------- ---------------------------------------
|
||||
Resolution 752*480,376*240
|
||||
Resolution 752*480; 376*240
|
||||
-------------------------- ---------------------------------------
|
||||
Depth Resolution Base on CPU/GPU Up to 752*480@60FPS
|
||||
Depth Resolution Based on CPU/GPU Up to 752*480@60FPS
|
||||
-------------------------- ---------------------------------------
|
||||
Pixel Size 6.0*6.0μm
|
||||
-------------------------- ---------------------------------------
|
||||
|
|
@ -29,38 +28,54 @@ Product Specification:
|
|||
-------------------------- ---------------------------------------
|
||||
Focal Length 2.1mm
|
||||
-------------------------- ---------------------------------------
|
||||
IR Support Yes
|
||||
IR Support No
|
||||
-------------------------- ---------------------------------------
|
||||
IR detectable range 3m
|
||||
IR detectable range -
|
||||
-------------------------- ---------------------------------------
|
||||
Color Mode Monochrome
|
||||
-------------------------- ---------------------------------------
|
||||
Working Distance 0.7-2m
|
||||
Working Distance 0.8-5m+
|
||||
-------------------------- ---------------------------------------
|
||||
Scanning Mode Global Shutter
|
||||
-------------------------- ---------------------------------------
|
||||
Power 1~2.7W@5V DC from USB
|
||||
Power 1W@5V DC from USB
|
||||
-------------------------- ---------------------------------------
|
||||
Output data format Raw data
|
||||
-------------------------- ---------------------------------------
|
||||
Data transfer Interface USB3.0
|
||||
-------------------------- ---------------------------------------
|
||||
Weight 184g
|
||||
Weight 160g
|
||||
-------------------------- ---------------------------------------
|
||||
UVC MODE Yes
|
||||
========================== =======================================
|
||||
|
||||
|
||||
|
||||
Work Environment
|
||||
-----------------
|
||||
Software
|
||||
--------
|
||||
|
||||
|
||||
========================= ================
|
||||
Operating Temperature 50°C
|
||||
------------------------- ----------------
|
||||
Storage Temperature -20°C
|
||||
========================= ================
|
||||
================ =================================================================================
|
||||
Support system Windows 10、Ubuntu 16.04/18.04、ROS kinetic/melodic、Android 5.x ~ Android 8.x
|
||||
---------------- ---------------------------------------------------------------------------------
|
||||
SDK http://www.myntai.com/dev/mynteye_depth
|
||||
---------------- ---------------------------------------------------------------------------------
|
||||
Support ORB_SLAM2、OKVIS、Vins-Mono、Vins-Fusion、VIORB
|
||||
================ ==================================================================================
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
-------------
|
||||
|
||||
|
||||
=========================== ================================
|
||||
Operating Temperature 10°C~50°C
|
||||
--------------------------- --------------------------------
|
||||
Storage Temperature -20°C~60°C
|
||||
--------------------------- --------------------------------
|
||||
Humidity 10% to 90% non-condensing
|
||||
=========================== ================================
|
||||
|
||||
|
||||
Package:
|
||||
|
|
|
|||
102
docs/src/mynteye/spec_s1030_ir.rst
Normal file
102
docs/src/mynteye/spec_s1030_ir.rst
Normal file
|
|
@ -0,0 +1,102 @@
|
|||
.. _mynteye_spec_s1030_ir:
|
||||
|
||||
S1030-IR-120/Mono Product Specification
|
||||
=========================================
|
||||
|
||||
Product Specification:
|
||||
-----------------------
|
||||
|
||||
|
||||
========================== =======================================
|
||||
Model S1030-IR-120/Mono
|
||||
-------------------------- ---------------------------------------
|
||||
Size 165x31.5x31.23mm
|
||||
-------------------------- ---------------------------------------
|
||||
Frame Rate 10/15/20/25/30/35/40/45/50/55/60FPS
|
||||
-------------------------- ---------------------------------------
|
||||
Resolution 752*480; 376*240
|
||||
-------------------------- ---------------------------------------
|
||||
Depth Resolution Based on CPU/GPU Up to 752*480@60FPS
|
||||
-------------------------- ---------------------------------------
|
||||
Pixel Size 6.0*6.0μm
|
||||
-------------------------- ---------------------------------------
|
||||
Baseline 120.0mm
|
||||
-------------------------- ---------------------------------------
|
||||
Camera Lens Replacable Standard M12
|
||||
-------------------------- ---------------------------------------
|
||||
Visual Angle D:146° H:122° V:76°
|
||||
-------------------------- ---------------------------------------
|
||||
Focal Length 2.1mm
|
||||
-------------------------- ---------------------------------------
|
||||
IR Support Yes
|
||||
-------------------------- ---------------------------------------
|
||||
IR detectable range Up to 3m
|
||||
-------------------------- ---------------------------------------
|
||||
Color Mode Monochrome
|
||||
-------------------------- ---------------------------------------
|
||||
Working Distance 0.8-5m+
|
||||
-------------------------- ---------------------------------------
|
||||
Scanning Mode Global Shutter
|
||||
-------------------------- ---------------------------------------
|
||||
Power 1~2.7W@5V DC from USB
|
||||
-------------------------- ---------------------------------------
|
||||
Output data format Raw data
|
||||
-------------------------- ---------------------------------------
|
||||
Data transfer Interface USB3.0
|
||||
-------------------------- ---------------------------------------
|
||||
Weight 184g
|
||||
-------------------------- ---------------------------------------
|
||||
UVC MODE Yes
|
||||
========================== =======================================
|
||||
|
||||
|
||||
|
||||
Software
|
||||
--------
|
||||
|
||||
|
||||
================ =================================================================================
|
||||
Support system Windows 10、Ubuntu 16.04/18.04、ROS kinetic/melodic、Android 5.x ~ Android 8.x
|
||||
---------------- ---------------------------------------------------------------------------------
|
||||
SDK http://www.myntai.com/dev/mynteye_depth
|
||||
---------------- ---------------------------------------------------------------------------------
|
||||
Support ORB_SLAM2、OKVIS、Vins-Mono、Vins-Fusion、VIORB
|
||||
================ ==================================================================================
|
||||
|
||||
|
||||
|
||||
Environment
|
||||
-------------
|
||||
|
||||
|
||||
=========================== ================================
|
||||
Operating Temperature 10°C~50°C
|
||||
--------------------------- --------------------------------
|
||||
Storage Temperature -20°C~60°C
|
||||
--------------------------- --------------------------------
|
||||
Humidity 10% to 90% non-condensing
|
||||
=========================== ================================
|
||||
|
||||
|
||||
Package:
|
||||
---------
|
||||
|
||||
=================== =======================================
|
||||
Package Contents MYNT EYE x1 USB Micro-B Cable x1
|
||||
=================== =======================================
|
||||
|
||||
Warranty：
|
||||
----------
|
||||
|
||||
==================== ============================================
|
||||
Product Warranty 12 Months Limited Manufacturer's Warranty
|
||||
==================== ============================================
|
||||
|
||||
Accuracy
|
||||
---------
|
||||
|
||||
============================ ============================================
|
||||
Depth Distance Deviation Less than 4%
|
||||
============================ ============================================
|
||||
|
||||
|
||||
265
docs/src/tools/calibration_tool.rst
Normal file
265
docs/src/tools/calibration_tool.rst
Normal file
|
|
@ -0,0 +1,265 @@
|
|||
.. _calibration_tool:
|
||||
|
||||
MYNT EYE S Manual Calibration Tool
|
||||
==========
|
||||
|
||||
|
||||
Introduction
|
||||
--------
|
||||
|
||||
1.1 Support Platform
|
||||
--------
|
||||
|
||||
Currently the calibration tool only supports Ubuntu 16.04 LTS, but support the official, ROS multiple version of OpenCV dependencies.
|
||||
|
||||
==================== ==================== ====================== ====================
|
||||
Platform Architecture Different dependence Description
|
||||
==================== ==================== ====================== ====================
|
||||
Ubuntu 16.04 LTS x64(amd64) libopencv-dev
|
||||
ros-kinetic-opencv3
|
||||
==================== ==================== ====================== ====================
|
||||
|
||||
|
||||
|
||||
1.2 Tools description
|
||||
--------
|
||||
|
||||
Deb/ppa installation package is available on Ubuntu. The architecture, dependencies, and versions will be distinguished from the name:
|
||||
|
||||
* mynteye-s-calibrator-opencv-official-1.0.0_amd64.deb
|
||||
* mynteye-s-calibrator-opencv-ros-kinetic-1.0.0_amd64.deb
|
||||
|
||||
======================= ==================== ============================================================
|
||||
Dependency identifier Dependency package Detailed description
|
||||
======================= ==================== ============================================================
|
||||
opencv-official libopencv-dev https://packages.ubuntu.com/xenial/libopencv-dev
|
||||
opencv-ros-kinetic ros-kinetic-opencv3 http://wiki.ros.org/opencv3
|
||||
======================= ==================== ============================================================
|
||||
|
||||
|
||||
1.3 Deb Toolkit Get
|
||||
--------
|
||||
|
||||
==================== ========================================================================
|
||||
Method of Obtaining Get address
|
||||
==================== ========================================================================
|
||||
Baidu Cloud https://pan.baidu.com/s/19rW0fPKUlQj6eldZpZFoAA Extraction code: a6ps
|
||||
Google Drive https://drive.google.com/open?id=1RsV2WEKAsfxbn-Z5nGjk5g3ml1UDEsDc
|
||||
==================== ========================================================================
|
||||
|
||||
|
||||
Installation
|
||||
--------
|
||||
|
||||
2.1 Installation Preparation
|
||||
--------
|
||||
* Ubuntu 16.04 LTS environment, x64 architecture
|
||||
* Deb package for the calibration tool, select OpenCV dependencies as needed
|
||||
(this step is not required for PPA installation)
|
||||
|
||||
2.2 Install ppa Package
|
||||
--------
|
||||
$ sudo add-apt-repository ppa:slightech/mynt-eye-s-sdk
|
||||
$ sudo apt-get update
|
||||
$ sudo apt-get install mynteye-s-calibrator
|
||||
$ sudo ln -sf /opt/myntai/mynteye-s-calibrator/mynteye-s-calibrator /usr/local/bin/ mynteye-s-calibrator
|
||||
|
||||
|
||||
2.3 Install deb Package
|
||||
--------
|
||||
Install the deb package with udo dpkg -i:
|
||||
|
||||
$ sudo dpkg -i mynteye-s-calibrator-opencv-official-1.0.0_amd64.deb
|
||||
...
|
||||
(Reading database ... 359020 files and directories currently installed.)
|
||||
Preparing to unpack mynteye-s-calibrator-opencv-official-1.0.0_amd64.deb ...
|
||||
Unpacking mynteye-s-calibrator (1.0.0) over (1.0.0) ...
|
||||
Setting up mynteye-s-calibrator (1.0.0) ...
|
||||
|
||||
If you encounter an error that the dependency package is not installed, for example:
|
||||
--------
|
||||
|
||||
$ sudo dpkg -i mynteye-s-calibrator-opencv-official-1.0.0_amd64.deb
|
||||
Selecting previously unselected package mynteye-s-calibrator.
|
||||
(Reading database ... 358987 files and directories currently installed.)
|
||||
Preparing to unpack mynteye-s-calibrator-opencv-official-1.0.0_amd64.deb ...
|
||||
Unpacking mynteye-s-calibrator (1.0.0) ...
|
||||
dpkg: dependency problems prevent configuration of mynteye-s-calibrator:
|
||||
mynteye-s-calibrator depends on libatlas-base-dev; however:
|
||||
Package libatlas-base-dev is not installed.
|
||||
|
||||
dpkg: error processing package mynteye-s-calibrator (--install):
|
||||
dependency problems - leaving unconfigured
|
||||
Errors were encountered while processing:
|
||||
mynteye-s-calibrator
|
||||
|
||||
You can continue use sudo apt-get -f install to finished install
|
||||
--------
|
||||
|
||||
$ sudo apt-get -f install
|
||||
Reading package lists... Done
|
||||
Building dependency tree
|
||||
Reading state information... Done
|
||||
|
||||
Correcting dependencies... Done
|
||||
The following additional packages will be installed:
|
||||
libatlas-base-dev
|
||||
Suggested packages:
|
||||
libblas-doc liblapack-doc
|
||||
The following NEW packages will be installed:
|
||||
libatlas-base-dev
|
||||
0 upgraded, 1 newly installed, 0 to remove and 0 not upgraded.
|
||||
1 not fully installed or removed.
|
||||
Need to get 3,596 kB of archives.
|
||||
After this operation, 30.8 MB of additional disk space will be used.
|
||||
Do you want to continue? [Y/n]
|
||||
Get:1 http://cn.archive.ubuntu.com/ubuntu xenial/universe amd64 libatlas-base-dev amd64 3.10.2-9 [3,596 kB]
|
||||
Fetched 3,596 kB in 3s (1,013 kB/s)
|
||||
Selecting previously unselected package libatlas-base-dev.
|
||||
(Reading database ... 358993 files and directories currently installed.)
|
||||
Preparing to unpack .../libatlas-base-dev_3.10.2-9_amd64.deb ...
|
||||
Unpacking libatlas-base-dev (3.10.2-9) ...
|
||||
Setting up libatlas-base-dev (3.10.2-9) ...
|
||||
update-alternatives: using /usr/lib/atlas-base/atlas/libblas.so to provide /usr/lib/libblas.so (libblas.so) in auto mode
|
||||
update-alternatives: using /usr/lib/atlas-base/atlas/liblapack.so to provide /usr/lib/liblapack.so (liblapack.so) in auto mode
|
||||
Setting up mynteye-s-calibrator (1.0.0) ...
|
||||
|
||||
|
||||
How To Use
|
||||
--------
|
||||
|
||||
3.1 Preparation For Use
|
||||
--------
|
||||
* MYNT EYE S Camera
|
||||
* Checkerboard
|
||||
* Evenly illuminated scene
|
||||
|
||||
3.2 Use Command
|
||||
--------
|
||||
|
||||
* After installing the calibration tool, you can run the mynteye-s-calibrator command directly on the terminal to calibrate.。 -h can see its options：
|
||||
|
||||
$ mynteye-s-calibrator -h
|
||||
Usage: mynteye-s-calibrator [options]
|
||||
help: mynteye-s-calibrator -h
|
||||
calibrate: mynteye-s-calibrator -x 11 -y 7 -s 0.036
|
||||
|
||||
Calibrate MYNT EYE S device.
|
||||
|
||||
Options:
|
||||
|
||||
-h, --help show this help message and exit
|
||||
-x WIDTH, --width=WIDTH The chessboard width, default: 11
|
||||
-y HEIGHT, --height=HEIGHT The chessboard height, default: 7
|
||||
-s METERS, --square=METERS The chessboard square size in meters, default: 0.036
|
||||
-n NUMBER, --number=NUMBER The number of images to use for calibration, default: 11
|
||||
-p PATH, --path=PATH The path to save the result, default: SN?
|
||||
|
||||
* -x -y -s Used to set the width, height, and grid size of the calibration plate. Width and height refer to the number of black and white intersections in the horizontal and vertical directions of the checkerboard. Lattice size in m
|
||||
|
||||
|
||||
3.3 Steps For Usage
|
||||
--------
|
||||
|
||||
* First, connect the MYNT EYE S camera.
|
||||
|
||||
* Then, run the mynteye-s-calibrator <calibration board parameter> command in the terminal.
|
||||
|
||||
.. image:: ../../images/calibration001.png
|
||||
:width: 60%
|
||||
|
||||
* Follow the prompts to select an index for the camera's resolution, perform image calibration at this resolution
|
||||
|
||||
* The S1030 camera only needs to be calibrated to 752*480 resolution. The S2100 camera needs to be calibrated to 2560*800 and 1280*400 resolutions.
|
||||
|
||||
* As far as possible, let the calibration plate cover the left and right eye images of the camera,
|
||||
and take care of the surroundings (maximum distortion). The calibration tool will automatically
|
||||
evaluate the qualified image for the calibration calculation and will indicate on the terminal how many have been selected.
|
||||
|
||||
Reference acquisition image, as follows:
|
||||
|
||||
.. image:: ../../images/calibration002.png
|
||||
:width: 60%
|
||||
|
||||
.. image:: ../../images/calibration003.png
|
||||
:width: 60%
|
||||
|
||||
.. image:: ../../images/calibration004.png
|
||||
:width: 60%
|
||||
|
||||
.. image:: ../../images/calibration005.png
|
||||
:width: 60%
|
||||
|
||||
.. image:: ../../images/calibration006.png
|
||||
:width: 60%
|
||||
|
||||
|
||||
* Note: p_x, p_y, size, skew respectively indicate the scale of the calibration plate on the x-axis, y-axis,
|
||||
zoom, and tilt when the image is acquired. Make a point for reference.
|
||||
|
||||
* Once the number of images acquired by the calibration needs is reached,
|
||||
the calibration calculation will be performed. The output is as follows:
|
||||
|
||||
|
||||
.. image:: ../../images/calibration007.png
|
||||
:width: 60%
|
||||
|
||||
|
||||
* 1. The terminal will print out the left and right purpose calibration results.
|
||||
|
||||
* 2. The calibration results are written into the file in the SNXXX directory.
|
||||
|
||||
a) camera_left.yaml: Left eye parameter
|
||||
b) camera_right.yaml: Right eye parameter
|
||||
c) extrinsics.yaml: Binocular external parameter
|
||||
d) img.params.equidistant: Camera parameters, which can be used for S SDK writing
|
||||
e) stereo_reprojection_error.yaml: Reprojection error
|
||||
|
||||
* Finally, you will also be asked if you want to write to the camera device. Enter or `y` to confirm
|
||||
|
||||
.. image:: ../../images/calibration008.png
|
||||
:width: 60%
|
||||
|
||||
* After writing to the device, you will be prompted with "Write to device done".
|
||||
|
||||
|
||||
|
||||
3.4 Calibration result
|
||||
--------
|
||||
Calibration result，It is desirable to have a reprojection error of 0.2 or less. If it exceeds 1, it needs to be recalibrated.
|
||||
|
||||
Reprojection error, visible output after calibration completion "Final reprojection error: 0.201
|
||||
|
||||
Pixels", or see the calibration result file "stereo_reprojection_error.yaml".
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
8
docs/src/tools/contents.rst
Normal file
8
docs/src/tools/contents.rst
Normal file
|
|
@ -0,0 +1,8 @@
|
|||
.. _tools:
|
||||
|
||||
TOOLS SUPPORT
|
||||
========
|
||||
|
||||
.. toctree::
|
||||
|
||||
calibration_tool
|
||||
Loading…
Reference in New Issue
Block a user