https://github.com/erksch/waymo-open-dataset-viewer

A WebGL viewer for pointclouds of the Waymo Open Dataset
https://github.com/erksch/waymo-open-dataset-viewer

Last synced: 2 months ago
JSON representation

A WebGL viewer for pointclouds of the Waymo Open Dataset

• Host: GitHub
• URL: https://github.com/erksch/waymo-open-dataset-viewer
• Owner: erksch
• Created: 2019-12-04T11:53:42.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2023-10-27T06:49:06.000Z (about 1 year ago)
• Last Synced: 2023-11-07T18:27:48.444Z (about 1 year ago)
• Language: TypeScript
• Homepage:
• Size: 929 KB
• Stars: 109
• Watchers: 5
• Forks: 17
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Waymo Open Dataset Viewer

A WebGL viewer for pointclouds of the [waymo open dataset](https://waymo.com/open) that runs seamlessly in the browser with an integrated python server that processes and serves the dataset segments.

![Screenshot](./screenshot.png)

## Prerequisites

### Dataset  

Before using the viewer, you first need to download (parts of) the dataset from the [official download page](https://waymo.com/open/licensing/). Create a directory containing the segments (.tfrecord files) you want to view.

#### Install tensorflow (2.0.0)

Consider using tensorflow-gpu since it will speed up reading the segments.

#### Install dependencies

Server dependencies:

```

pip install -r requirements.txt

```

Frontend dependecies:  

```

yarn install

```

## Usage 

Start the websocket that processes and serves the segment files in a given directory:

```

python websocket.py --segments-dir path/to/segments

```

Build the frontend.

```

yarn build

```

Now, you can open the `index.html` file in the browser or call

```

yarn serve

```

to start a small python server on port 8000 that serves the html file.

## Known Issues

If you had a GPU with a small RAM, misalignment between the LIDARs can happen.

In this case, please try to run the websocket using CPU:

```

CUDA_VISIBLE_DEVICES="-1" python websocket.py --segments-dir path/to/segments

```