# github-xviz-data

**Repository Path**: imxplus/github-xviz-data

## Basic Information

- **Project Name**: github-xviz-data
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-12-26
- **Last Updated**: 2021-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# XVIZ example Dataset

The data provided in this repo is being processed into [XVIZ](https://github.com/uber/xviz). The original data is available at the following URLs:

- [Kitti](http://www.cvlibs.net/datasets/kitti/raw_data.php)
- [nuTonomy](https://www.nuscenes.org/download) 

## Update dataset

This repos is mainly used to demonstrate the capability of [`streetscape.gl`](https://github.com/uber/streetscape.gl), 
it is not necessary to preserve the commit history. Also it is very costly for github to track the change of
large data files. 

So every time you updates this repo, do a squash commit instead.

```bash
git reset <first-commit> --hard // reset the commit history back to the first commit
git add --all
git commit -m "Update dataset" // Or your own message
git push -f origin master // force update
```

## How to convert

- kitti
    ```bash
    yarn start 
    -d <your_path_to_source_data>/kitti/2011_09_26/2011_09_26_drive_0005_sync 
    -o <your_path_to_xviz-data>/kitti/2011_09_26_drive_0005_sync
    --fake-streams=true
    --disable-streams=image_00, image_01
    ```

   - Available image streams are `image_00`, `image_01`, `image_02`, `image_03`
   - Default `--image-max-width` is 400, `--image-max-height` is 300 (actual conversion will preserve aspect ratio)


- nuTonomy

    ```bash
    yarn start 
    -d <your_path_to_source_data>/streetscape.gl/data/nutonomy/nuscenes_teaser_meta_v1/v0.1
    -o <your_path_to_xviz-data>/nutonomy --samples-directory=~/dev/streetscape.gl/data/nutonomy/samples 
    --scenes=6
    ```
    
    - `-d/--data-directory` is metadata and annotations
    - `--samples-directory` is lidar, radar and images
    - `--scenes` also supports multiple numbers, `--scenes=1,2,6`
    - Default `--image-max-width` is 400, `--image-max-height` is 250 (actual conversion will preserve aspect ratio)