{ "info": { "author": "Holger Caesar, Oscar Beijbom, Qiang Xu, Varun Bankiti, Alex H. Lang, Sourabh Vora, Venice Erin Liong, Chris Li, Sergi Widjaja, Kiwoo Shin et al.", "author_email": "nuscenes@nutonomy.com", "bugtrack_url": null, "classifiers": [ "License :: Free for non-commercial use", "Operating System :: OS Independent", "Programming Language :: Python :: 3.6" ], "description": "# nuScenes devkit\nWelcome to the devkit of the [nuScenes](https://www.nuscenes.org) dataset.\n![](https://www.nuscenes.org/public/images/road.jpg)\n\n## Overview\n- [Changelog](#changelog)\n- [Dataset download](#dataset-download)\n- [Map expansion](#map-expansion)\n- [Devkit setup](#devkit-setup)\n- [Getting started](#getting-started)\n- [Citation](#citation)\n\n## Changelog\n- Jul. 1, 2019: Map expansion pack released.\n- Apr. 30, 2019: Devkit v1.0.1: loosen PIP requirements, refine detection challenge, export 2d annotation script. \n- Mar. 26, 2019: Full dataset, paper, & devkit v1.0.0 released. Support dropped for teaser data.\n- Dec. 20, 2018: Initial evaluation code released. Devkit folders restructured, which breaks backward compatibility.\n- Nov. 21, 2018: RADAR filtering and multi sweep aggregation.\n- Oct. 4, 2018: Code to parse RADAR data released.\n- Sep. 12, 2018: Devkit for teaser dataset released.\n\n## Dataset download\nTo download nuScenes you need to go to the [Download page](https://www.nuscenes.org/download), \ncreate an account and agree to the nuScenes [Terms of Use](https://www.nuscenes.org/terms-of-use).\nAfter logging in you will see multiple archives. \nFor the devkit to work you will need to download *all* archives.\nPlease unpack the archives to the `/data/sets/nuscenes` folder \\*without\\* overwriting folders that occur in multiple archives.\nEventually you should have the following folder structure:\n```\n/data/sets/nuscenes\n samples\t-\tSensor data for keyframes.\n sweeps\t-\tSensor data for intermediate frames.\n maps\t-\tFolder for all map files: rasterized .png images and vectorized .json files.\n v1.0-*\t-\tJSON tables that include all the meta data and annotations. Each split (trainval, test, mini) is provided in a separate folder.\n```\nIf you want to use another folder, specify the `dataroot` parameter of the NuScenes class (see tutorial).\n\n## Map expansion\nIn July 2019 we published a map expansion pack with 11 semantic layers (crosswalk, sidewalk, traffic lights, stop lines, lanes, etc.).\nTo install this expansion, please follow these steps:\n- Download the expansion pack from the [Download page](https://www.nuscenes.org/download),\n- Move the four .json files to your nuScenes maps folder (e.g. `/data/sets/nuscenes/maps`).\n- Get the latest version of the nuscenes-devkit.\n- If you already have a previous version of the devkit, update the pip requirements (see [details](https://github.com/nutonomy/nuscenes-devkit/blob/master/setup/installation.md)): `pip install -r setup/requirements.txt`\n\n## Devkit setup\nThe devkit is tested for Python 3.6 and Python 3.7.\nTo install Python, please check [here](https://github.com/nutonomy/nuscenes-devkit/blob/master/installation.md#install-python).\n\nOur devkit is available and can be installed via [pip](https://pip.pypa.io/en/stable/installing/) :\n```\npip install nuscenes-devkit\n```\nFor an advanced installation, see [installation](https://github.com/nutonomy/nuscenes-devkit/blob/master/setup/installation.md) for detailed instructions.\n\n## Getting started\nPlease follow these steps to make yourself familiar with the nuScenes dataset:\n- Read the [dataset description](https://www.nuscenes.org/overview).\n- [Explore](https://www.nuscenes.org/explore/scene-0011/0) the lidar viewer and videos.\n- [Download](https://www.nuscenes.org/download) the dataset. \n- Get the [nuscenes-devkit code](https://github.com/nutonomy/nuscenes-devkit).\n- Read the [online tutorial](https://www.nuscenes.org/tutorial) or run it yourself using:\n```\njupyter notebook $HOME/nuscenes-devkit/python-sdk/tutorial.ipynb\n```\n- Read the [nuScenes paper](https://www.nuscenes.org/publications) for a detailed analysis of the dataset.\n- Run the [map expansion tutorial](https://github.com/nutonomy/nuscenes-devkit/blob/master/python-sdk/nuscenes/map_expansion/map_demo.ipynb).\n- Take a look at the [experimental scripts](https://github.com/nutonomy/nuscenes-devkit/tree/master/python-sdk/nuscenes/scripts).\n- For instructions related to the object detection task (results format, classes and evaluation metrics), please refer to [this readme](https://github.com/nutonomy/nuscenes-devkit/blob/master/python-sdk/nuscenes/eval/detection/README.md).\n- See the [database schema](https://github.com/nutonomy/nuscenes-devkit/blob/master/schema.md) and [annotator instructions](https://github.com/nutonomy/nuscenes-devkit/blob/master/instructions.md).\n- See the [FAQs](https://github.com/nutonomy/nuscenes-devkit/blob/master/faqs.md).\n\n## Citation\nPlease use the following citation when referencing [nuScenes](https://arxiv.org/abs/1903.11027):\n```\n@article{nuscenes2019,\n title={nuScenes: A multimodal dataset for autonomous driving},\n author={Holger Caesar and Varun Bankiti and Alex H. Lang and Sourabh Vora and \n Venice Erin Liong and Qiang Xu and Anush Krishnan and Yu Pan and \n Giancarlo Baldan and Oscar Beijbom},\n journal={arXiv preprint arXiv:1903.11027},\n year={2019}\n}\n```\n\n![](https://www.nuscenes.org/public/images/nuscenes-example.png)\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/nutonomy/nuscenes-devkit", "keywords": "", "license": "cc-by-nc-sa-4.0", "maintainer": "", "maintainer_email": "", "name": "nuscenes-devkit", "package_url": "https://pypi.org/project/nuscenes-devkit/", "platform": "", "project_url": "https://pypi.org/project/nuscenes-devkit/", "project_urls": { "Homepage": "https://github.com/nutonomy/nuscenes-devkit" }, "release_url": "https://pypi.org/project/nuscenes-devkit/1.0.2/", "requires_dist": [ "cachetools", "jupyter", "matplotlib", "numpy", "opencv-python", "Pillow", "pyquaternion (>=0.9.5)", "scikit-learn", "scipy", "Shapely", "tqdm", "descartes" ], "requires_python": ">=3.6", "summary": "The official devkit of the nuScenes dataset (www.nuscenes.org).", "version": "1.0.2" }, "last_serial": 5543722, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "ca1c7789efae55cbcf2178c86e44a525", "sha256": "14f5d509bdfb67f7bcf05d07feb9a7358d9b1a604523d8c3c7ebf166d0b137c5" }, "downloads": -1, "filename": "nuscenes_devkit-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "ca1c7789efae55cbcf2178c86e44a525", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 73203, "upload_time": "2019-03-26T05:28:38", "url": "https://files.pythonhosted.org/packages/85/cb/e22d6d564093e623a23047914c4f1240993c90a442b1bece997833bf83ac/nuscenes_devkit-1.0.0-py3-none-any.whl" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "7ffa177651595abcf97f70acdff17af6", "sha256": "e401caaf33fecb47523a1ce2bfa65d81a40d7714e3d93a137bdbb436664eac8e" }, "downloads": -1, "filename": "nuscenes_devkit-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "7ffa177651595abcf97f70acdff17af6", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 77095, "upload_time": "2019-04-30T05:12:08", "url": "https://files.pythonhosted.org/packages/74/0c/e954910116503653e6612d5d3c6c7262df3124a03d962960696acf4339a2/nuscenes_devkit-1.0.1-py3-none-any.whl" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "cb17519f4921600372d246eaf28da15b", "sha256": "e38b131821b5dc99e61abf3c6d7a6d36c18830f0ef1554f13d9860b67ea7a814" }, "downloads": -1, "filename": "nuscenes_devkit-1.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "cb17519f4921600372d246eaf28da15b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 117708, "upload_time": "2019-07-17T02:54:24", "url": "https://files.pythonhosted.org/packages/16/57/0224a6ad0342647625f1d85806d30b16ce32fab3282e5247174e25cacc15/nuscenes_devkit-1.0.2-py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "cb17519f4921600372d246eaf28da15b", "sha256": "e38b131821b5dc99e61abf3c6d7a6d36c18830f0ef1554f13d9860b67ea7a814" }, "downloads": -1, "filename": "nuscenes_devkit-1.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "cb17519f4921600372d246eaf28da15b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 117708, "upload_time": "2019-07-17T02:54:24", "url": "https://files.pythonhosted.org/packages/16/57/0224a6ad0342647625f1d85806d30b16ce32fab3282e5247174e25cacc15/nuscenes_devkit-1.0.2-py3-none-any.whl" } ] }