Download Recorded Sample Data

If you haven’t downloaded the ouster-sdk, please follow the Python Installation instructions.

Download Data

Download one of the following samples of recorded Ouster data and unzip the contents:

In your unzipped directory, you should have two files, one .pcap file and one .json file. For example, in the unzipped recorded sample of OS1-128 Rev 06 data you should find:

  • OS1-128_Rev-06_fw23_Urban-Drive_Dual-Returns.pcap

  • OS1-128_Rev-06_fw23_Urban-Drive_Dual-Returns.json

We will use SAMPLE_DATA_PCAP_PATH to refer to this pcap and SAMPLE_DATA_JSON_PATH to this json in the following. You may find it convenient to assign the paths appropriately in your console.

Visualize It!

If you’ve installed the ouster-sdk (see Python Installation) then you’re all set to visualize with:

$ simple-viz --pcap $SAMPLE_DATA_PCAP_PATH --meta $SAMPLE_DATA_JSON_PATH

You should get a view similar to:

_images/simple-viz.png

Ouster simple-viz visualization of OS1 128 Rev 6 sample data

You can control your visualizer with mouse and keyboard:

Keyboard controls:

Key

What it does

o

Toggle on-screen display

p/P

Increase/decrease point size

m

Cycle point cloud coloring mode

b

Cycle top 2D image

n

Cycle bottom 2D image

R

Reset camera

e/E

Increase/decrease size of displayed 2D images

'/"

Increase/decrease spacing in range markers

w

Camera pitch up

s

Camera pitch down

a

Camera yaw left

d

Camera yaw right

1

Toggle first return point cloud visibility

2

Toggle second return point cloud visibility

0

Toggle orthographic camera

=/-

Dolly in/out

(space)

Toggle pause

./,

Step one frame forward/back

ctrl + ./,

Step 10 frames forward/back

>/<

Increase/decrease playback rate (during replay)

shift

Camera Translation with mouse drag

Congratulations! You’ve installed and visualized with the Ouster Python SDK!

For more on simple-viz, please see Running the Ouster visualizer