Python applications for RealSense

.gitignore

@@ -89,3 +89,4 @@ librealsense-log.txt
 *.cxx
 
 .vscode/*
+*.mp4

wrappers/python/applications/README.md

@@ -0,0 +1,72 @@
+# Intel RealSense - Object Camera
+
+Objects are everywhere!
+
+This package supports object data extraction from the intel Realsense camera RGB or Depth streams in real time.
+
+The list of the supported objects, frameworks, platforms and applications are below. Click on each image to find out more.
+
+# Objects
+
+-  Barcodes, QR Codes, Aruco Markers - well defined objects detected by using RGB camera data. 
+
+Barcodes   | QR Codes | Aruco Markers |
+:------------: |  :----------: | :-------------:  |
+[![Barcode](barcode/doc/barcode_camera.gif)](barcode/README.md)  | [![QR Codes](barcode/doc/qrcode_camera.gif)](barcode/README.md)  | [![Aruco](barcode/doc/aruco_camera.gif)](barcode/README.md)  |
+
+-  Planes, Edges, Corners - 3D geometric objects detected using depth camera information. 
+
+Planes | Edges | Corners |
+:------------: |  :----------: | :-------------:  |
+[![Planes](planes/doc/plane_3.gif)](planes/README.md)  | [![Edges](planes/doc/edges-1.gif)](planes/README.md)  | [![Corners](planes/doc/corner-1.gif)](planes/README.md)  |
+
+
+
+
+# Utilities
+
+OpenCV Like Camera Wrapper - controls low level camera features like exposure, gain, laser power, provides access to left and right sensor images and additional features. 
+It can be used to connect to Real Sense camera in real time. It provides a simple UI to store videos and images in different formats.
+
+[![RGB](utils/doc/cam_rgb_d.jpg)](utils/README.md) | [![D16](utils/doc/cam_d_3.jpg)](utils/README.md) | [![SC1](utils/doc/cam_d_5.jpg)](utils/README.md) |
+:------------: |  :----------: | :-------------:  |
+[![IRL](utils/doc/cam_d_9.jpg)](utils/README.md) | [![EXPOSURE](utils/doc/cam_e_2.jpg)](utils/README.md) | [![GAIN](utils/doc/cam_g_5.jpg)](utils/README.md) |
+[![PWR](utils/doc/cam_p_0.jpg)](utils/README.md) | [![SC2](utils/doc/image_sc2_000.png)](utils/README.md) | [![D16](utils/doc/image_d16_000.png)](utils/README.md) |
+
+Depth Noise measurement tool - a simple UI to measure noise in the depth data. It supports measurement of the temporal noise per pixel, spatial noise per image ROI and fitted plane noise. In addition, it reports the number/percent of the non valid pixels. The results are visualized and alo printed in the console window. 
+
+Temporal/Spatial ROI | Plane Fit ROI | 
+:------------: |  :----------: | 
+[![STP](utils/doc/noise_measure_stp.gif)](utils/README.md) | [![PFIT](utils/doc/noise_measure.gif)](utils/README.md) |
+
+
+Logger -  to monitor and print console information, errors and processing time of the applications. 
+
+[![LOG](utils/doc/noise_error_log.jpg)](utils/README.md) 
+
+
+# Request Camera Feature
+If you want to run the application or object detection on the camera hardware - check this [link](https://docs.google.com/forms/d/e/1FAIpQLSdduDbnrRExDGFQqWAn8pX7jSr8KnwBmwuFOR9dgUabEp0F1A/viewform).
+
+# Supported Platforms and Compute Environments
+
+The following is the check list of supported environments and functionality:
+- Windows
+- Ubuntu
+- Jetson (NVIDIA)  - TBD
+- Raspeberry PI    - TBD
+
+# How to Contribute
+
+We greatly appreciate contributions from the community, including examples, applications, and guides. If you'd like to contribute, please follow these guidelines:
+
+1. **Create a pull request (PR)** with the title prefix `[RS]`, adding your new example folder to the `root/` directory within the repository.
+
+2. **Ensure your project adheres to the following standards:**
+   - Makes use of the `vision` package.
+   - Includes a `README.md` with clear instructions for setting up and running the example.
+   - Avoids adding large files or dependencies unless they are absolutely necessary for the example.
+
+
+
+

wrappers/python/applications/barcode/README.md

@@ -0,0 +1,79 @@
+![](doc/show_examples.jpg)
+
+[![image](https://img.shields.io/pypi/v/scikit-spatial.svg)](https://pypi.python.org/pypi/scikit-spatial)
+[![image](https://anaconda.org/conda-forge/scikit-spatial/badges/version.svg)](https://anaconda.org/conda-forge/scikit-spatial)
+[![image](https://img.shields.io/pypi/pyversions/scikit-spatial.svg)](https://pypi.python.org/pypi/scikit-spatial)
+
+
+# Introduction
+
+This code provides examples of how to detect Barcodes, Aruco Markers and QR Codes using RealSense camera in real time.
+The object detection is based on RGB values of the camera. The following objects are supported:
+
+-   Barcodes, QR Codes : detected by using PyZbar external library
+-   Aruco Markers : using OpenCV
+
+These objects could be integrated in your robotics and video processing pipe line.
+Please be aware that /qrcode/aruco detection relies on the libraries in use. 
+Please refer to library limitations if barcode, qrcode or aruco marker are not detected. 
+
+
+# Modules and License
+
+We are using pyzbar and opencv contributed to detect barcodes and aruco markers.
+
+
+# Installation Windows
+
+1. Install python 3.10 from Python Release Python 3.10.0 | <https://www.python.org>
+
+2. Create virtual environment. In Windows PowerShell:
+
+    python -m venv "your path"\Envs\barcode
+
+3. Activate virtual environment. In Windows CMD shell:
+
+    "your path"\Envs\barcode\Scripts\activate.bat
+
+4. Installing realsense python wrapper for librealsense SDK. For example, download pyrealsense2-2.55.10.6089-cp310-cp310-win_amd64.whl (the latest : ![link](https://github.com/IntelRealSense/librealsense/releases/download/v2.56.3/pyrealsense2-2.56.3.7838-cp310-cp310-win_amd64_beta.whl)):
+
+    pip install pyrealsense2-2.55.10.6089-cp310-cp310-win_amd64.whl
+
+5. Install opencv and numpy:
+
+    pip install opencv-contrib-python
+
+6. Instrall PyZbar library:
+
+    pip install pyzbar
+
+7. Install scipy:
+
+    pip install scipy
+
+8. Install matplotlib:
+
+    pip install matplotlib
+
+# Usage
+
+```py
+>>> 
+>>> python barcode_realsense_detector.py
+
+```
+or
+```py
+>>> 
+>>> python aruco_realsense_detector.py  # run the example
+
+```
+
+# Troubleshooting
+
+## During PyZbar installation if the following error happens: 
+
+FileNotFoundError: Could not find module '<your path>\Envs\barcode\lib\site-packages\pyzbar\libzbar-64.dll' (or one of its dependencies). Try using the full path with constructor syntax.
+
+Fix: Install vcredist_x64.exe From <https://www.microsoft.com/en-gb/download/details.aspx?id=40784> 
+Download Visual C++ Redistributable Packages for Visual Studio 2013 from Official Microsoft Download Center