# Additional Context Annotation for the BDD100K Dataset

This dataset provides additional context annotations and extends the BDD100K dataset [1]. Therefore, the approximately 80,000 images with annotation for 2D object detection in the BDD100K dataset were annotated with additional context attributes. The application possibilities of the dataset are diverse. It could be used for model training or evaluating the model performance in different contexts combination, as we did. The annotated contexts per image contain 11 attributes (time_of_day, sky, illumination, precipitation, infrastructure, road, tunnel, construction_site, clear_windshield, light_exposure, and reflections). The underlying annotation guideline with further details is also available for download. 

To use the context annotations, the official [BDD100K Dataset](https://doc.bdd100k.com/download.html) is required. On top, the provided python-script "extent_bdd_with_context.py" has to be executed to merge the BDD100K original annotations and our additional context annotations. Further instructions are available in the readme file.

[1] Yu, F. and Chen, H. and Wang, X. and Xian, W. and Chen, Y. and Liu, F. and Madhavan, V. and Darrell, T.: "BDD100K: A Diverse Driving Dataset for Heterogeneous Multitask Learning", in Proc. of CVPR, Seattle, WA, USA, 2020, doi: 10.1109/CVPR42600.2020.00271

IMPORTANT: In case you use the dataset, please cite our corresponding article mentioned below.

### Corresponding Article

@InProceedings{Heidecker2023a, 
  author    = {Heidecker, Florian and Susetzky, Tobias and Fuchs, Erich and Sick, Bernhard},
  booktitle = {Proc. of ITSC},
  title     = {{Context Information for Corner Case Detection in Highly Automated Driving}},
  year      = {2023},
  note      = {{accepted}},
}

### How to add context labels to BDD100K:

Extends existing BDD100K annotation file with additional context information:

    python extent_bdd_with_context.py -i <PATH>/detection_v2.json

if context annotation file is not in the same folder:

    python extent_bdd_with_context.py -i <PATH>/detection_v2.json -c <PATH>/bdd100k_context.json

To save BDD100k + context in a different folder:

    python extent_bdd_with_context.py -i <PATH>/detection_v2.json -o <PATH>/output.json

#### Except where otherwise noted, this item's license is described as [Creative Commons Attribution-NonCommercial 4.0](https://creativecommons.org/licenses/by-nc/4.0/)

Impressum: University of Kassel (https://www.uni-kassel.de/uni/index.php?id=372)