https://github.com/nutonomy/nuscenes-devkit
Revision afabcfd86c18f10ae9316bb72c6812c4f9f34a99 authored by holger-nutonomy on 09 March 2019, 03:31:56 UTC, committed by Oscar Beijbom on 09 March 2019, 03:31:56 UTC
* Added disclaimer * Added actual warning in the code
1 parent 80c084e
Tip revision: afabcfd86c18f10ae9316bb72c6812c4f9f34a99 authored by holger-nutonomy on 09 March 2019, 03:31:56 UTC
Added disclaimer (#58)
Added disclaimer (#58)
Tip revision: afabcfd
instructions.md
# nuScenes Annotator Instructions
# Overview
- [Instructions](#instructions)
- [Special Rules](#special-rules)
- [Labels](#labels)
- [Attributes](#attributes)
- [Detailed Instructions and Examples](#detailed-instructions-and-examples)
# Instructions
+ Draw 3D bounding box around all objects from the [labels](#labels) list, and label them according to the instructions below.
+ **Do not** apply more than one box to a single object.
+ Check every cuboid in every frame, to make sure all points are inside the cuboid and **look reasonable in the image view**.
# Special Rules
+ **Minimum LIDAR Points** :
+ Label any target object containing **at least 1 LIDAR point**, as long as you can be reasonably sure you know the location and shape of the object. Use your best judgment on correct cuboid position, sizing, and heading.
+ **Cuboid Sizing** :
+ **Cuboids must be very tight.** Draw the cuboid as close as possible to the edge of the object without excluding any LIDAR points. There should be almost no visible space between the cuboid border and the closest point on the object.
+ **Extremities** :
+ **If** an object has extremities (eg. arms and legs of pedestrians), **then** the bounding box should include the extremities.
+ **Exception**: Do not include vehicle side view mirrors. Also, do not include other vehicle extremities (crane arms etc.) that are above 1.5 meters high.
+ **Carried Object** :
+ If a pedestrian is carrying an object (bags, umbrellas, tools etc.), such object will be included in the bounding box for the pedestrian. If two or more pedestrians are carrying the same object, the bounding box of only one of them will include the object.
+ **Stationary Objects** :
+ Sometimes stationary objects move over time due to errors in the localization. If a stationary object’s points shift over time, please create a separate cuboid for every frame.
+ **Use Pictures**:
+ For objects with few LIDAR or RADAR points, use the images to make sure boxes are correctly sized. If you see that a cuboid is too short in the image view, adjust it to cover the entire object based on the image view.
+ **Visibility Attribute** :
+ The visibility attribute specifies the percentage of object pixels visible in the panoramic view of all cameras.
+ 
# Labels
**For every bounding box, include one of the following labels:**
1. **[Car or Van or SUV](#car-or-van-or-suv)**: Vehicle designed primarily for personal use, e.g. sedans, hatch-backs, wagons, vans, mini-vans, SUVs and jeeps.
2. **[Truck](#truck)**: Vehicles primarily designed to haul cargo including lorrys, trucks.
3. **[Pickup Truck](#pickup-truck)**: A pickup truck is a light duty truck with an enclosed cab and an open or closed cargo area. A pickup truck can be intended primarily for hauling cargo or for personal use.
4. **[Front Of Semi Truck](#front-of-semi-truck)**: Tractor part of a semi trailer truck. Trailers hauled after a semi-tractor should be labeled as a trailer.
5. **[Bendy Bus](#bendy-bus)**: Buses and shuttles designed to carry more than 10 people and comprises two or more rigid sections linked by a pivoting joint. Annotate each section of the bendy bus individually.
6. **[Rigid Bus](#rigid-bus)**: Rigid buses and shuttles designed to carry more than 10 people.
7. **[Construction Vehicle](#construction-vehicle)**: Vehicles primarily designed for construction. Typically very slow moving or stationary. Cranes and extremities of construction vehicles are only included in annotations if they interfere with traffic. Trucks used to hauling rocks or building materials are considered trucks rather than construction vehicles.
8. **[Motorcycle](#motorcycle)**: Gasoline or electric powered 2-wheeled vehicle designed to move rapidly (at the speed of standard cars) on the road surface. This category includes all motorcycles, vespas and scooters. It also includes light 3-wheel vehicles, often with a light plastic roof and open on the sides, that tend to be common in Asia. If there is a rider and/or passenger, include them in the box.
9. **[Bicycle](#bicycle)**: Human or electric powered 2-wheeled vehicle designed to travel at lower speeds either on road surface, sidewalks or bicycle paths. If there is a rider and/or passenger, include them in the box.
10. **[Bicycle Rack](#bicycle-rack)**: Area or device intended to park or secure the bicycles in a row. It includes all the bicycles parked in it and any empty slots that are intended for parking bicycles. Bicycles that are not part of the rack should not be included. Instead they should be annotated as bicycles separately.
11. **[Trailer](#trailer)**: Any vehicle trailer, both for trucks, cars and motorcycles (regardless of whether currently being towed or not). For semi-trailers (containers) label the truck itself as "front of semi truck".
12. **[Police Vehicle](#police-vehicle)**: All types of police vehicles including police bicycles and motorcycles.
13. **[Ambulance](#ambulance)**: All types of ambulances.
14. **[Train](#train)**: Any vehicle that travels on rails e.g. light rail / tram / train. For trains, that consist of several linked units, annotate each segment with a bounding box.
15. **[Adult Pedestrian](#adult-pedestrian)**: An adult pedestrian moving around the cityscape. Mannequins should also be annotated as Adult Pedestrian.
16. **[Child Pedestrian](#child-pedestrian)**: A child pedestrian moving around the cityscape.
17. **[Construction Worker](#construction-worker)**: A human in the scene whose main purpose is construction work.
18. **[Stroller](#stroller)**: Any stroller. If a person is in the stroller, include in the annotation. If a pedestrian pushing the stroller, then they should be labeled separately.
19. **[Wheelchair](#wheelchair)**: Any type of wheelchair. If a pedestrian is pushing the wheelchair then they should be labeled separately.
20. **[Portable Personal Mobility Vehicle](#portable-personal-mobility-vehicle)**: A small electric or self-propelled vehicle, e.g. skateboard, segway, or scooters, on which the person typically travels in a upright position. Driver and (if applicable) rider should be included in the bounding box along with the vehicle.
21. **[Traffic Police](#traffic-police)**: Police officer actively directing traffic.
22. **[Other Police](#other-police)**: Police officer NOT actively directing traffic.
23. **[Animal](#animal)**: All animals, e.g. cats, rats, dogs, deer, birds.
24. **[Traffic Cone](#traffic-cone)**: All types of traffic cones.
25. **[Temporary Traffic Barrier](#temporary-traffic-barrier)**: Any metal, concrete or water barrier temporarily placed in the scene in order to re-direct vehicle or pedestrian traffic. In particular, includes barriers used at construction zones. If there are multiple barriers either connected or just placed next to each other, they should be annotated separately.
26. **[Pushable Pullable Object](#pushable-pullable-object)**: Objects that a pedestrian may push or pull. For example dolleys, wheel barrows, garbage-bins with wheels, or shopping carts. Typically not designed to carry humans.
27. **[Debris](#debris)**: Debris or movable object that is left **on the driveable surface** that is too large to be driven over safely, e.g tree branch, full trash bag etc.
# Attributes
1. **For every object, include the attribute:**
+ **Visibility**:
+ **0%-20%**: The object is 0% to 20% visible in panoramic view of all cameras.
+ **21%-40%**: The object is 21% to 40% visible in panoramic view of all cameras.
+ **41%-60%**: The object is 41% to 60% visible in panoramic view of all cameras.
+ **61%-80%**: The object is 61% to 80% visible in panoramic view of all cameras.
+ **81%-100%**: The object is 81% to 100% visible in panoramic view of all cameras.
+ This attribute specifies the percentage of an object visible through the cameras. For this estimation to be carried out, all the different camera views should be considered as one and the visible portion would be gauged in the resulting **panoramic view**
+ 
2. **For each vehicle with four or more wheels, select the status:**
+ **Vehicle Activity**:
+ **Parked**: Vehicle is stationary (usually for longer duration) with no immediate intent to move.
+ **Stopped**: Vehicle, with a driver/rider in/on it, is currently stationary but has an intent to move.
+ **Moving**: Vehicle is moving.
3. **For each bicycle, motorcycle and portable personal mobility vehicle, select the rider status.**
+ **Has Rider**:
+ **Yes**: There is a rider on the bicycle or motorcycle.
+ **No**: There is NO rider on the bicycle or motorcycle.
4. **For each human in the scene, select the status**
+ **Human Activity**:
+ **Sitting or Lying Down**: The human is sitting or lying down.
+ **Standing**: The human is standing.
+ **Moving**: The human is moving.
<br><br><br>
# Detailed Instructions and Examples
Bounding Box color convention in example images:
+ **Green**: Objects like this should be annotated
+ **Red**: Objects like this should not be annotated
## Car or Van or SUV
+ Vehicle designed primarily for personal use, e.g. sedans, hatch-backs, wagons, vans, mini-vans, SUVs and jeeps.
+ If the vehicle is designed to carry more than 10 people label it is a bus.
+ If it is primarily designed to haul cargo it is a truck.
[Top](#overview)
## Truck
+ Vehicles primarily designed to haul cargo including lorrys, trucks.
[Top](#overview)
## Pickup Truck
+ A pickup truck is a light duty truck with an enclosed cab and an open or closed cargo area. A pickup truck can be intended primarily for hauling cargo or for personal use.
[Top](#overview)
## Front Of Semi Truck
+ Tractor part of a semi trailer truck. Trailers hauled after a semi-tractor should be labeled as a trailer.
[Top](#overview)
## Bendy Bus
+ Buses and shuttles designed to carry more than 10 people and comprises two or more rigid sections linked by a pivoting joint.
+ Annotate each section of the bendy bus individually.
+ If you cannot see the pivoting joint of the bus, annotate it as **rigid bus**.
[Top](#overview)
## Rigid Bus
+ Rigid buses and shuttles designed to carry more than 10 people.
[Top](#overview)
## Construction Vehicle
+ Vehicles primarily designed for construction. Typically very slow moving or stationary.
+ Trucks used to hauling rocks or building materials are considered as truck rather than construction vehicles.
+ Cranes and extremities of construction vehicles are only included in annotations if they interferes with traffic.
[Top](#overview)
## Motorcycle
+ Gasoline or electric powered 2-wheeled vehicle designed to move rapidly (at the speed of standard cars) on the road surface. This category includes all motorcycles, vespas and scooters. It also includes light 3-wheel vehicles, often with a light plastic roof and open on the sides, that tend to be common in Asia.
+ If there is a rider, include the rider in the box.
+ If there is a passenger, include the passenger in the box.
+ If there is a pedestrian standing next to the motorcycle, do NOT include in the annotation.
[Top](#overview)
## Bicycle
+ Human or electric powered 2-wheeled vehicle designed to travel at lower speeds either on road surface, sidewalks or bicycle paths.
+ If there is a rider, include the rider in the box
+ If there is a passenger, include the passenger in the box
+ If there is a pedestrian standing next to the bicycle, do NOT include in the annotation
[Top](#overview)
## Bicycle Rack
+ Area or device intended to park or secure the bicycles in a row. It includes all the bicycles parked in it and any empty slots that are intended for parking bicycles.
+ Bicycles that are not part of the rack should not be included. Instead they should be annotated as bicycles separately.
[Top](#overview)
## Trailer
+ Any vehicle trailer, both for trucks, cars and motorcycles (regardless of whether currently being towed or not). For semi-trailers (containers) label the truck itself as "front of semi truck".
+ A vehicle towed by another vehicle should be labeled as vehicle (not as trailer).
[Top](#overview)
## Police Vehicle
+ All types of police vehicles including police bicycles and motorcycles.
[Top](#overview)
# Firetruck
+ All types of firetrucks.
[Top](#overview)
## Ambulance
+ All types of ambulances.
[Top](#overview)
## Train
+ Any vehicle that travels on rails e.g. light rail / tram / train.
+ For trains, that consist of several linked units, annotate each segment with a bounding box.
[Top](#overview)
## Adult Pedestrian
+ An adult pedestrian moving around the cityscape.
+ Mannequins should also be treated as adult pedestrian.
[Top](#overview)
## Child Pedestrian
+ A child pedestrian moving around the cityscape.
[Top](#overview)
## Construction Worker
+ A human in the scene whose main purpose is construction work.
[Top](#overview)
## Stroller
+ Any stroller
+ If a person is in the stroller, include in the annotation.
+ Pedestrians pushing strollers should be labeled separately.
[Top](#overview)
## Wheelchair
+ Any type of wheelchair
+ If a person is in the wheelchair, include in the annotation.
+ Pedestrians pushing wheelchairs should be labeled separately.
[Top](#overview)
## Portable Personal Mobility Vehicle
+ A small electric or self-propelled vehicle, e.g. skateboard, segway, or scooters, on which the person typically travels in a upright position. Driver and (if applicable) rider should be included in the bounding box along with the vehicle.
[Top](#overview)
## Traffic Police
+ Police officer actively directing traffic.
[Top](#overview)
## Other Police
+ Police officer NOT actively directing traffic.
[Top](#overview)
## Animal
+ All animals, e.g. cats, rats, dogs, deer, birds.
[Top](#overview)
## Traffic Cone
+ All types of traffic cones.
[Top](#overview)
## Temporary Traffic Barrier
+ Any metal, concrete or water barrier temporarily placed in the scene in order to re-direct vehicle or pedestrian traffic. In particular, includes barriers used at construction zones.
+ If there are multiple barriers either connected or just placed next to each other, they should be annotated separately.
+ If barriers are installed permanently, then do NOT include them.
[Top](#overview)
## Pushable Pullable Object
+ Objects that a pedestrian may push or pull. For example dolleys, wheel barrows, garbage-bins with wheels, or shopping carts. Typically not designed to carry humans.
[Top](#overview)
## Debris
+ Debris or movable object that is left **on the driveable surface** that is too large to be driven over safely, e.g tree branch, full trash bag etc.
[Top](#overview)
Computing file changes ...
