Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Python client for the Ouster Lidar OS-1

Project description

Python client for the Ouster Lidar OS-1

Compatible with Firmware Version 1.6.0 and python 3

Your milage may vary with other versions, it was tested against on a device running 1.6.0


pip install ouster-os1

Quick start

from os1 import OS1
from os1.utils import xyz_points

def handler(raw_packet):
    """Takes each packet and log it to a file as xyz points"""
    with open('points.csv', 'a') as f:
        x, y, z = xyz_points(raw_packet)
        for coords in zip(x, y, z):

os1 = OS1('', '')  # OS1 sensor IP and destination IP
# Inform the sensor of the destination host and reintialize it
# Start the loop which will handle and dispatch each packet to the handler
# function for processing

You run the server as threaded with os1.run_forever(handler, threaded=True)


Generally speed is a concern since the OS1 is sending 12,608 bytes/packet at a rate of 1280 packets/sec. So a multiprocessing producer consumer model works well.

import json
from multiprocessing import Process, Queue

from os1 import OS1
from os1.utils import build_trig_table, xyz_points

OS1_IP = ''
HOST_IP = ''
unprocessed_packets = Queue()

def handler(packet):

def worker(queue, beam_altitude_angles, beam_azimuth_angles) :
    build_trig_table(beam_altitude_angles, beam_azimuth_angles)
    while True:
        packet = queue.get()
        coords = xyz_points(packet) 
        # do work...

def spawn_workers(n, worker, *args, **kwargs):
    processes = []
    for i in range(n):
        process = Process(
    return processes

os1 = OS1(OS1_IP, HOST_IP)
beam_intrinsics = json.loads(os1.api.get_beam_intrinsics())
beam_alt_angles = beam_intrinsics['beam_altitude_angles']
beam_az_angles = beam_intrinsics['beam_azimuth_angles']
spawn_workers(4, worker, unprocessed_packets, beam_alt_angles, beam_az_angles)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ouster-os1, version 1.0.1
Filename, size File type Python version Upload date Hashes
Filename, size ouster_os1-1.0.1-py3-none-any.whl (6.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size ouster-os1-1.0.1.tar.gz (4.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page