Ouster Python SDK¶
The Ouster Python SDK provides a high-level interface for interacting with sensor hardware and recorded sensor data suitable for prototyping, evaluation, and other non-safety-critical applications. Example and reference code is provided for several common operations on sensor data. The SDK includes APIs for:
Querying and setting sensor configuration
Recording and reading data in pcap format
Reading and buffering sensor UDP data streams reliably
Frame-based access to lidar data as numpy datatypes
Conversion of raw data to range/signal/near_ir/reflectivity images (de-staggering)
Efficiently projecting range measurements to cartesian (X, Y, Z) coordinates
Pre-built binaries are provided on PyPI for x86-64 platforms including:
Most glibc-based Linux distributions (
Macos >= 10.13 (
Windows 10 (
Building from source is supported on:
Ubuntu 18.04, 20.04, and Debian 10 (x86-64)
macOS >= 10.13 (x86-64)
Windows 10 (x86-64)
See the build instructions for requirements needed to build from a source distribution or from a clone of the repository.
The Ouster Python SDK requires Python >= 3.6 and pip >= 19.0. To install, run:
$ python3 -m pip install ouster-sdk
If you’re running ARM, a non-glibc-based linux distribution, or wish to modify the Ouster Python SDK, you will need to build from source.
See the quick start section of the documentation to begin working with Ouster data!
Status and Contact Info¶
The Ouster Python SDK is currently provided as an early pre-1.0 preview. The APIs are subject to change in every release.