librealsense

Intel® RealSense™ SDK

https://github.com/intelrealsense/librealsense

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    19 of 365 committers (5.2%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.2%) to scientific vocabulary

Keywords

camera-api computer-vision developer-kits hardware library librealsense sdk

Keywords from Contributors

deep-neural-networks distributed tensors oneapi systemd system services init xe-architecture x86-64
Last synced: 6 months ago · JSON representation

Repository

Intel® RealSense™ SDK

Basic Info
Statistics
  • Stars: 8,118
  • Watchers: 283
  • Forks: 4,891
  • Open Issues: 379
  • Releases: 82
Topics
camera-api computer-vision developer-kits hardware library librealsense sdk
Created over 10 years ago · Last pushed 6 months ago
Metadata Files
Readme Contributing License Code of conduct Security

readme.md




License Release Commits Issues GitHub CI Forks

Overview

Intel® RealSense™ SDK 2.0 is a cross-platform library for Intel® RealSense™ depth cameras.

:pushpin: For other Intel® RealSense™ devices (F200, R200, LR200 and ZR300), please refer to the latest legacy release.

The SDK allows depth and color streaming, and provides intrinsic and extrinsic calibration information. The library also offers synthetic streams (pointcloud, depth aligned to color and vise-versa), and a built-in support for record and playback of streaming sessions.

Developer kits containing the necessary hardware to use this library are available for purchase at store.intelrealsense.com. Information about the Intel® RealSense™ technology at www.intelrealsense.com

:openfilefolder: Don't have access to a RealSense camera? Check-out sample data

Update on Recent Changes to the RealSense Product Line

Please visit this link for product updates - https://www.intelrealsense.com/message-to-customers/

Building librealsense - Using vcpkg

You can download and install librealsense using the vcpkg dependency manager:

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
./vcpkg install realsense2

The librealsense port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please create an issue or pull request on the vcpkg repository.

Download and Install

  • Download - The latest releases including the Intel RealSense SDK, Viewer and Depth Quality tools are available at: latest releases. Please check the release notes for the supported platforms, new features and capabilities, known issues, how to upgrade the Firmware and more.

  • Install - You can also install or build from source the SDK (on Linux \ Windows \ Mac OS \ Android \ Docker), connect your D400 depth camera and you are ready to start writing your first application.

Support & Issues: If you need product support (e.g. ask a question about / are having problems with the device), please check the FAQ & Troubleshooting section. If not covered there, please search our Closed GitHub Issues page, Community and Support sites. If you still cannot find an answer to your question, please open a new issue.

What’s included in the SDK:

| What | Description | Download link| | ------- | ------- | ------- | | Intel® RealSense™ Viewer | With this application, you can quickly access your Intel® RealSense™ Depth Camera to view the depth stream, visualize point clouds, record and playback streams, configure your camera settings, modify advanced controls, enable depth visualization and post processing and much more. | Intel.RealSense.Viewer.exe | | Depth Quality Tool | This application allows you to test the camera’s depth quality, including: standard deviation from plane fit, normalized RMS – the subpixel accuracy, distance accuracy and fill rate. You should be able to easily get and interpret several of the depth quality metrics and record and save the data for offline analysis. |Depth.Quality.Tool.exe | | Debug Tools | Device enumeration, FW logger, etc as can be seen at the tools directory | Included in Intel.RealSense.SDK.exe| | Code Samples |These simple examples demonstrate how to easily use the SDK to include code snippets that access the camera into your applications. Check some of the C++ examples including capture, pointcloud and more and basic C examples | Included in Intel.RealSense.SDK.exe | | Wrappers | Python, C#/.NET API, as well as integration with the following 3rd-party technologies: ROS1, ROS2, LabVIEW, OpenCV, PCL, Unity, Matlab, OpenNI, UnrealEngine4 and more to come. | |

Ready to Hack!

Our library offers a high level API for using Intel RealSense depth cameras (in addition to lower level ones). The following snippet shows how to start streaming frames and extracting the depth value of a pixel:

```cpp // Create a Pipeline - this serves as a top-level API for streaming and processing frames rs2::pipeline p;

// Configure and start the pipeline p.start();

while (true) { // Block program until frames arrive rs2::frameset frames = p.waitforframes();

// Try to get a frame of a depth image
rs2::depth_frame depth = frames.get_depth_frame();

// Get the depth frame's dimensions
float width = depth.get_width();
float height = depth.get_height();

// Query the distance from the camera to the object in the center of the image
float dist_to_center = depth.get_distance(width / 2, height / 2);

// Print the distance
std::cout << "The camera is facing an object " << dist_to_center << " meters away \r";

} ``` For more information on the library, please follow our examples, and read the documentation to learn more.

Contributing

In order to contribute to Intel RealSense SDK, please follow our contribution guidelines.

License

This project is licensed under the Apache License, Version 2.0. Copyright 2018 Intel Corporation

Owner

  • Name: Intel® RealSense™
  • Login: IntelRealSense
  • Kind: organization
  • Location: Santa Clara, CA

Open Source software from the Intel® RealSense™ team

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 13,140
  • Total Committers: 365
  • Avg Commits per committer: 36.0
  • Development Distribution Score (DDS): 0.842
Past Year
  • Commits: 3
  • Committers: 3
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.667
Top Committers
Name Email Commits
Eran l****n@g****m 2,074
Evgeni Raikhel e****l@i****m 1,214
Dorodnicov, Sergey s****v@i****m 1,047
Nir Azkiel n****l@i****m 824
aangerma a****n@i****m 751
Sterling Orsten s****n@i****m 667
Noha Yassin 3****n 514
Remi Bettan r****n@g****m 453
Dimitri Diakopoulos d****s@g****m 416
Ziv Shahaf z****f@i****m 378
ohadmeir o****r@i****m 330
remibettan r****n@i****m 297
Katz, Matan m****z@i****m 269
Lior Ramati l****i@i****m 260
icarpis i****s@i****m 215
MMirbach m****3@g****m 207
Tamir t****y@i****m 207
doronhi d****g@i****m 179
AnnaRomnov a****v@i****m 165
icarpis 7****8@g****m 131
Jim Radford j****d@i****m 111
gwen2018 g****n@i****m 110
noacoohen n****n@i****m 108
aseelegbaria a****a@i****m 100
Ariel Lowenstein a****n@i****m 96
mmirbach m****3@g****m 96
daversintel d****g@i****m 89
Brian Fulkerson b****n@i****m 81
Shao,Ting t****o@i****m 73
Dmitry Perchanov d****v@i****m 70
and 335 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 1,626
  • Total pull requests: 1,499
  • Average time to close issues: 2 months
  • Average time to close pull requests: about 2 months
  • Total issue authors: 1,231
  • Total pull request authors: 100
  • Average comments per issue: 7.71
  • Average comments per pull request: 0.7
  • Merged pull requests: 1,158
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 518
  • Pull requests: 626
  • Average time to close issues: 16 days
  • Average time to close pull requests: 5 days
  • Issue authors: 410
  • Pull request authors: 44
  • Average comments per issue: 4.66
  • Average comments per pull request: 0.53
  • Merged pull requests: 470
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • MartyG-RealSense (32)
  • monajalal (19)
  • pgswag (12)
  • Nimaro76 (11)
  • wenmingxiaohuo (9)
  • diplomatist (7)
  • mrortach (7)
  • jrecasens (6)
  • milan-r-shah (6)
  • ffreality (6)
  • ky047 (6)
  • zhanglepy (5)
  • nathanieltagg (5)
  • nataliesettles (5)
  • monson-li (5)
Pull Request Authors
  • maloel (255)
  • Nir-Az (232)
  • OhadMeir (195)
  • remibettan (158)
  • AviaAv (117)
  • noacoohen (73)
  • Noy-Zini (69)
  • dmipx (53)
  • Tamir91 (35)
  • Arun-Prasad-V (30)
  • gwen2018 (28)
  • SamerKhshiboun (27)
  • gilpazintel (23)
  • ashrafk93 (16)
  • alexk1976 (7)
Top Labels
Issue Labels
D400 Series (428) Linux (360) Windows (288) python (217) d435i (157) d455 (134) jetson (114) question (99) l500 (79) installation (72) raspberry pi (41) ros (33) calibration (33) announcement (31) android (24) MacOS (17) SR300 (17) unity (16) T260 series (14) enhancement (11) matlab (10) unreal (9) multicam (8) firmware (8) d435e (7) documentation (7) multicamera (6) labview (5) ethernet (5) bug (4)
Pull Request Labels
dds (49) bug (37) enhancement (27) ai-assist (11) ci (6) android (4) tools (4) python (3) GUI (2) openni (2) MacOS (2) documentation (2) T260 series (2) fw update (2) .NET (1) jetson (1) cmake (1)

Packages

  • Total packages: 13
  • Total downloads:
    • nuget 53,727 total
    • pypi 89,427 last-month
    • npm 1,064 last-month
    • homebrew 293 last-month
  • Total docker downloads: 468
  • Total dependent packages: 37
    (may contain duplicates)
  • Total dependent repositories: 200
    (may contain duplicates)
  • Total versions: 377
  • Total maintainers: 11
pypi.org: pyrealsense2

Python Wrapper for Intel Realsense SDK 2.0.

  • Versions: 67
  • Dependent Packages: 27
  • Dependent Repositories: 158
  • Downloads: 88,790 Last month
  • Docker Downloads: 224
Rankings
Forks count: 0.1%
Stargazers count: 0.3%
Dependent packages count: 0.7%
Average: 1.2%
Dependent repos count: 1.2%
Downloads: 1.8%
Docker downloads count: 2.9%
Last synced: 6 months ago
npmjs.org: node-librealsense

Node.js API for Intel® RealSense™ SDK 2.0

  • Versions: 15
  • Dependent Packages: 2
  • Dependent Repositories: 37
  • Downloads: 133 Last month
  • Docker Downloads: 244
Rankings
Forks count: 0.5%
Docker downloads count: 1.2%
Stargazers count: 1.2%
Dependent repos count: 2.2%
Average: 4.2%
Dependent packages count: 8.7%
Downloads: 11.5%
Maintainers (1)
Last synced: 6 months ago
nuget.org: librealsense.x64

Intel® RealSense™ cross-platform C# wrapper.

  • Versions: 2
  • Dependent Packages: 1
  • Dependent Repositories: 2
  • Downloads: 14,925 Total
Rankings
Forks count: 0.0%
Stargazers count: 0.2%
Dependent repos count: 5.2%
Average: 7.4%
Dependent packages count: 10.6%
Downloads: 21.0%
Maintainers (1)
Last synced: 6 months ago
proxy.golang.org: github.com/IntelRealSense/librealsense
  • Versions: 126
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 7.0%
Average: 8.2%
Dependent repos count: 9.3%
Last synced: 6 months ago
proxy.golang.org: github.com/intelrealsense/librealsense
  • Versions: 126
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 7.0%
Average: 8.2%
Dependent repos count: 9.3%
Last synced: 6 months ago
nuget.org: intel.realsensewithnativedll

Intel® RealSense™ SDK 2.0 is a cross-platform library for Intel® RealSense™ depth cameras (D400 series and the SR300) and the T265 tracking camera. This version automatically copies the required native realsense2.dll from Intel® RealSense™ SDK 2.0 (latest build 2.51.1 from April 21, 2021, build for .NET 5.0, .NET 6 and .NET 7 works fine as well)

  • Versions: 6
  • Dependent Packages: 4
  • Dependent Repositories: 0
  • Downloads: 38,802 Total
Rankings
Downloads: 10.0%
Dependent repos count: 10.2%
Average: 11.3%
Dependent packages count: 13.9%
Maintainers (1)
Last synced: 6 months ago
pypi.org: pyrealsense2-aarch64

Python Wrapper for Intel Realsense SDK 2.0.

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 9 Last month
Rankings
Forks count: 0.1%
Stargazers count: 0.3%
Dependent packages count: 7.3%
Average: 13.6%
Dependent repos count: 22.1%
Downloads: 38.3%
Maintainers (1)
Last synced: 6 months ago
conda-forge.org: librealsense

This feedstock packages the C++ library `librealsense` and the Python library `pyrealsense2`. The packages are built enabling the `FORCE_RSUSB_BACKEND` CMake option, and they are available for all the Linux and macOS platforms supported by conda-forge, including `linux-aarch64` that can be used on Nvidia Jetson boards. If your platform is `cuda` capable, a `cuda` enabled package should be installed automatically. If that does not happen, you can force the installation of the `cuda` variant with `conda create -n rsenv librealsense=*=*cuda*` or the command in your preferred conda-based package manager. If for any reason you want to force the installation of librealsense without cuda support, you can do that with `conda create -n rsenv librealsense=*=*cpu*`.

  • Versions: 10
  • Dependent Packages: 1
  • Dependent Repositories: 1
Rankings
Forks count: 1.5%
Stargazers count: 4.1%
Average: 14.7%
Dependent repos count: 24.1%
Dependent packages count: 29.0%
Last synced: 6 months ago
nuget.org: librealsense

My package description.

  • License: apache-2.0
  • Latest release: 0.9.2
    published about 126 years ago
  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 12.7%
Average: 16.1%
Dependent packages count: 19.5%
Last synced: 6 months ago
npmjs.org: @cza_li/node-librealsense

Node.js API for Intel® RealSense™ SDK 2.0 [2.51.1]

  • Versions: 1
  • Dependent Packages: 1
  • Dependent Repositories: 0
  • Downloads: 931 Last month
Rankings
Forks count: 0.7%
Stargazers count: 1.5%
Dependent packages count: 16.2%
Average: 17.5%
Dependent repos count: 25.3%
Downloads: 43.6%
Maintainers (1)
Last synced: 6 months ago
pypi.org: pip_tester

NA

  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 3 Last month
Rankings
Forks count: 0.1%
Stargazers count: 0.3%
Dependent packages count: 6.6%
Average: 17.5%
Dependent repos count: 30.6%
Downloads: 49.8%
Maintainers (1)
Last synced: 6 months ago
formulae.brew.sh: librealsense

Intel RealSense D400 series and SR300 capture

  • Versions: 12
  • Dependent Packages: 1
  • Dependent Repositories: 1
  • Downloads: 293 Last month
Rankings
Forks count: 0.3%
Stargazers count: 3.8%
Average: 17.6%
Dependent packages count: 18.4%
Dependent repos count: 29.3%
Downloads: 36.2%
Last synced: 6 months ago
pypi.org: pyrealsense2-beta

Python Wrapper for Intel Realsense SDK 2.0.

  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 625 Last month
Rankings
Dependent packages count: 9.8%
Average: 32.5%
Dependent repos count: 55.3%
Maintainers (2)
Last synced: 6 months ago

Dependencies

.github/workflows/build-ROS2-package-CI.yaml actions
  • ros-tooling/action-ros-ci v0.2 composite
  • ros-tooling/setup-ros v0.4 composite
.github/workflows/buildsCI.yaml actions
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
  • actions/upload-artifact v3 composite
.github/workflows/static_analysis.yaml actions
  • actions/checkout v3 composite
  • actions/upload-artifact v3 composite
scripts/Docker/Dockerfile docker
  • $BASE_IMAGE latest build
  • ${BASE_IMAGE} latest build
wrappers/android/build.gradle maven
wrappers/android/examples/capture/build.gradle maven
  • androidx.appcompat:appcompat 1.2.0 implementation
  • androidx.constraintlayout:constraintlayout 2.0.4 implementation
  • junit:junit 4.12 testImplementation
wrappers/android/examples/java_example/app/build.gradle maven
  • androidx.appcompat:appcompat 1.2.0 implementation
  • androidx.constraintlayout:constraintlayout 2.0.4 implementation
  • junit:junit 4.12 testImplementation
wrappers/android/examples/java_example/build.gradle maven
wrappers/android/examples/multicam/build.gradle maven
  • androidx.appcompat:appcompat 1.2.0 implementation
  • androidx.constraintlayout:constraintlayout 2.0.4 implementation
  • junit:junit 4.12 testImplementation
wrappers/android/examples/native_example/app/build.gradle maven
  • com.android.support.constraint:constraint-layout 1.1.3 implementation
  • com.android.support:appcompat-v7 28.0.0 implementation
  • junit:junit 4.12 testImplementation
wrappers/android/examples/native_example/build.gradle maven
wrappers/android/examples/playback/build.gradle maven
  • androidx.appcompat:appcompat 1.2.0 implementation
  • androidx.constraintlayout:constraintlayout 2.0.4 implementation
  • junit:junit 4.12 testImplementation
wrappers/android/examples/processing/build.gradle maven
  • androidx.appcompat:appcompat 1.2.0 implementation
  • androidx.constraintlayout:constraintlayout 2.0.4 implementation
  • junit:junit 4.12 testImplementation
wrappers/android/examples/recording/build.gradle maven
  • androidx.appcompat:appcompat 1.2.0 implementation
  • androidx.constraintlayout:constraintlayout 2.0.4 implementation
  • com.google.android.material:material 1.2.1 implementation
  • junit:junit 4.12 testImplementation
wrappers/android/examples/sensor/build.gradle maven
  • androidx.appcompat:appcompat 1.2.0 implementation
  • androidx.constraintlayout:constraintlayout 2.0.4 implementation
  • junit:junit 4.12 testImplementation
wrappers/android/examples/stream_pipeline_callback/build.gradle maven
  • androidx.appcompat:appcompat 1.2.0 implementation
  • androidx.constraintlayout:constraintlayout 2.0.4 implementation
  • junit:junit 4.12 testImplementation
wrappers/android/librealsense/build.gradle maven
  • androidx.appcompat:appcompat 1.2.0 implementation
  • junit:junit 4.12 testImplementation
wrappers/android/tools/camera/build.gradle maven
  • androidx.appcompat:appcompat 1.2.0 implementation
  • androidx.constraintlayout:constraintlayout 2.0.4 implementation
  • com.google.android.material:material 1.2.1 implementation
  • junit:junit 4.12 testImplementation
wrappers/csharp/Intel.RealSense/packages.config nuget
  • StyleCop.Analyzers 1.0.2 development
wrappers/python/examples/ethernet_client_server/setup.py pypi
wrappers/python/requirements.txt pypi
  • setuptools *
  • twine *
  • wheel *
wrappers/python/setup.py pypi