Git Product home page Git Product logo

nuscenes-devkit's Introduction

Lyft Dataset SDK

Welcome to the devkit for the Lyft Level 5 AV dataset! This devkit shall help you to visualise and explore our dataset.

Release Notes

This devkit is based on a version of the nuScenes devkit.

Getting Started

Installation

You can use pip to install lyft-dataset-sdk:

pip install -U lyft_dataset_sdk

If you want to get the latest version of the code before it is released on PyPI you can install the library from GitHub:

pip install -U git+https://github.com/lyft/nuscenes-devkit

Dataset Download

Go to https://level5.lyft.com/dataset/ to download the Lyft Level 5 AV Dataset.

The dataset is also availible as a part of the Lyft 3D Object Detection for Autonomous Vehicles Challenge.

Utils for converting LEVEL5 data into Kitti format

Simply run
python -m lyft_dataset_sdk.utils.export_kitti nuscenes_gt_to_kitti --lyft_dataroot ${DS_PTH} --table_folder ${TBL_PTH}
for converting data.
See help ( python -m lyft_dataset_sdk.utils.export_kitti nuscenes_gt_to_kitti --help ) for more information.
You can draw results after converting with utils:
python -m lyft_dataset_sdk.utils.export_kitti render_kitti

Tutorial and Reference Model

Check out the tutorial and reference model README.

Dataset structure

The dataset contains of json files:

  1. scene.json - 25-45 seconds snippet of a car's journey.
  2. sample.json - An annotated snapshot of a scene at a particular timestamp.
  3. sample_data.json - Data collected from a particular sensor.
  4. sample_annotation.json - An annotated instance of an object within our interest.
  5. instance.json - Enumeration of all object instance we observed.
  6. category.json - Taxonomy of object categories (e.g. vehicle, human).
  7. attribute.json - Property of an instance that can change while the category remains the same.
  8. visibility.json - (currently not used)
  9. sensor.json - A specific sensor type.
  10. calibrated_sensor.json - Definition of a particular sensor as calibrated on a particular vehicle.
  11. ego_pose.json - Ego vehicle poses at a particular timestamp.
  12. log.json - Log information from which the data was extracted.
  13. map.json - Map data that is stored as binary semantic masks from a top-down view.

With the schema.

Data Exploration Tutorial

To get started with the Lyft Dataset SDK, run the tutorial using Jupyter Notebook.

Contributing

We would be happy to accept issue reports and pull requests from the community.

For creating pull requests follow our contributing guide.

nuscenes-devkit's People

Contributors

ternaus avatar rkesten avatar jackkwok avatar lopuhin avatar kylelee82 avatar mikeedi avatar mephistopheies avatar megaserg avatar stalkermustang avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.