Skip to content

remove_py3.7_from_documentation #13051

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 19, 2024
Merged

remove_py3.7_from_documentation #13051

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
75e6f4d
remove_py3.7_from_documentation
Noy-Zini Jun 18, 2024
b4f9906
added_note
Noy-Zini Jun 19, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 8 additions & 12 deletions wrappers/python/readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,7 @@ Package is available at https://pypi.python.org/pypi/pyrealsense2
To install the package, run:
> `pip install pyrealsense2`

Windows users can install the RealSense SDK 2.0 from the release tab to get pre-compiled binaries of the wrapper, for both x86 and x64 architectures. (Python versions 3.7, 3.8, 3.9, 3.10, 3.11 are supported).

> **Note:**
> Python 2.7 distributables can be found for pyrealsense2 versions <= 2.51.1
Windows users can install the RealSense SDK 2.0 from the release tab to get pre-compiled binaries of the wrapper, for both x86 and x64 architectures. (Python versions 3.8, 3.9, 3.10, 3.11 are supported).
Copy link
Collaborator

@Nir-Az Nir-Az Jun 19, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add this comment:

Note:
Python 3.7 distributables can be found for pyrealsense2 versions <= 2.55.1

Copy link
Contributor Author

@Noy-Zini Noy-Zini Jun 19, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done



## Building From Source
Expand All @@ -32,9 +29,8 @@ Windows users can install the RealSense SDK 2.0 from the release tab to get pre-
1. Ensure apt-get is up to date
* `sudo apt-get update && sudo apt-get upgrade`
* **Note:** Use `sudo apt-get dist-upgrade`, instead of `sudo apt-get upgrade`, in case you have an older Ubuntu 14.04 version
2. Install Python and its development files via apt-get (Python 2 and 3 both work)
* `sudo apt-get install python python-dev` or `sudo apt-get install python3 python3-dev`
* **Note:** The project will only use Python 2 if it can't use Python 3
2. Install Python and its development files via apt-get
* `sudo apt-get install python3 python3-dev`
3. Run the top level CMake command with the following additional flag `-DBUILD_PYTHON_BINDINGS:bool=true`:

* **Note:** For building a self-contained (statically compiled) pyrealsense2 library add the CMake flag:
Expand All @@ -43,7 +39,7 @@ Windows users can install the RealSense SDK 2.0 from the release tab to get pre-
* `mkdir build`
* `cd build`
* `cmake ../ -DBUILD_PYTHON_BINDINGS:bool=true`
> **Note**: To force compilation with a specific version on a system with both Python 2 and Python 3 installed, add the following flag to CMake command:
> **Note**: To force compilation with a specific version on a system with a few Python versions installed, add the following flag to CMake command:
`-DPYTHON_EXECUTABLE=[full path to the exact python executable]`
* `make -j4`
* `sudo make install`
Expand All @@ -55,7 +51,7 @@ Windows users can install the RealSense SDK 2.0 from the release tab to get pre-


#### Windows
1. Install Python 2 or 3 for windows. You can find the downloads on the official Python website [here](https://www.python.org/downloads/windows/)
1. Install Python 3 for windows. You can find the downloads on the official Python website [here](https://www.python.org/downloads/windows/)

2. When running `cmake-gui`, select the `BUILD_PYTHON_BINDINGS` option

Expand All @@ -64,12 +60,12 @@ Windows users can install the RealSense SDK 2.0 from the release tab to get pre-
`-DBUILD_SHARED_LIBS=false`

3. If you have multiple python installations on your machine you can use: `-DPYTHON_EXECUTABLE=<path to python executable>`
For example: `-DPYTHON_EXECUTABLE=C:/Python27/python.exe`
> The precompiled binaries shipped with [the installer](https://github.com/IntelRealSense/librealsense/releases) assume **Python 3.7**.
For example: `-DPYTHON_EXECUTABLE=C:/Python310/python.exe`
> The precompiled binaries shipped with [the installer](https://github.com/IntelRealSense/librealsense/releases) assume **Python 3.11**.
>The error `ImportError: DLL load failed: The specified module could not be found` might indicate versions mismatch or architecture (x86 vs x64) mismatch.

4. Open `librealsense2.sln` that was created in the previous step, and build the `pyrealsense2` project
5. Open the output folder of the project (e.g `build\x64-Release\Release\`) and copy `pyrealsense2.pyd` into your python's `site-packages` (e.g `C:\Python27\Lib\site-packages`)
5. Open the output folder of the project (e.g `build\x64-Release\Release\`) and copy `pyrealsense2.pyd` into your python's `site-packages` (e.g `C:\Python310\Lib\site-packages`)
6. Alternatively, copy the build output (`realsense2.dll` and `pyrealsense2.pyd`) next to your script.

## Examples
Expand Down
2 changes: 1 addition & 1 deletion wrappers/readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Wrappers for Intel® RealSense™ Technology

* [Python](./python/) - Supports both Python 2 and 3
* [Python](./python/) - Supports Python 3
* [ROS](https://github.com/intel-ros/realsense/releases) - Integration with Robot Operating System
* [LabVIEW](./labview) - Integration with National Instruments LabVIEW
* [OpenCV](./opencv) - Integration with OpenCV computer-vision library
Expand Down