Skip to content

APKLOT - A dataset for aerial parking block segmentation.

License

Notifications You must be signed in to change notification settings

langheran/APKLOT

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation



-----------------

Join the chat at https://gitter.im/apklot/users License Dataset Size

APKLOT is a dataset for aerial parking block segmentation. It is suitable for deep learning on GPU enabled devices.

Even though there are many datasets like PKLot [1] or CNRPark-EXT [2] for occupancy detection in parking lots, none of them were designed to tackle the parking block segmentation problem directly. Given the lack of a suitable dataset in the deep learning realm, we propose APKLOT, a dataset of roughly 7000 polygons for segmenting parking blocks from the satellite perspective and from the camera perspective.

Table of contents

Introduction

The main goal of this dataset is to segment parking block spaces from several parking lots of the world in realistic satellite photos. Satellite photos were generated using the free Google Maps API service. Given a training set, this is fundamentally a supervised-learning learning problem.

For the purpose of this dataset, a parking block is a painted area specially designed inside the parking lot for parking. we are not considering the following:

  • Parking spot(s)/block(s) outside the parking lot.
  • Badly parked vehicles, including those parked on the traffic lane and non-parking spot (benches, gardens, etc).
  • Debris or machinery in the parking block when it is used as manner of storage facility.
  • Trees in the way of the parking block.

These are the countries and cities included in APKLOT:

Country City # Instances
México México 90
México Monterrey 6
México Guadalajara 7
United States New York 119
United States Los Ángeles 78
United States Chicago 25
United States Houston 53
Chile Santiago 62
Spain Madrid 23
Japan Tokyo 40

: Countries and cities included in APKLOT

Objectives

  • Provides aerial view image dataset for parking block segmentation, i.e. generate pixel-wise areas given the class visible at each pixel through a mask.
  • Provides benchmark code for evaluating the quality of the masks.
  • Enables evaluation and comparison of different methods vs the results of obtained in the companion paper.

Related work

The authors on [3] present the CARPK dataset. It is the first large-scale dataset for counting cars from flying drones. CARPK provides 89,777 instances bounding boxes from moving video in 4 distinct parking lots.

Ground truth description

The ground truth is available in two formats:

  1. Pascal VOC 2010. The PASCAL Visual Object Classes format [4] is one of the most used for segmentation. Here is a brief description of the each folder, however if you wish to dive deeper you can refer to the Pascal VOC page:
    1. JPEGImages. The binary image files on JPEG compression format are stored here.
    2. Annotations. Contains xml Pascal VOC annotation files. The most prominent feature of these files is that they do not contain the real shape polygon, just a bounding rectangle without orientation.
    3. ImageSets\Segmentation. 3 text files are included here: (1) train.txt, (2) trainval.txt and (3) val.txt. Each is a list of files without extension for the train, validation and test set respectively.
    4. SegmentationClass. Contains the masks for training by class i.e. a class-wise color is assigned.
    5. SegmentationObject. Contains the masks i.e. a object-wise color is assigned. Due we are using just one class, it is worthwhile to point out that this folder contains exactly the same images as the SegmentationClass folder and is included for compatibility issues.

Example segmentation images on the Pascal VOC: (A) JPEGImages folder, (B) SegmentationClass folder, (C) SegmentationObject folder.

  1. LabelMe masks. LabelMe mask format was introduced as part of a web site for image segmentation on [5]. Here are the most important elements of the ensued json file:
    1. shapes. An array containing each of the shape polygons that were labeled as a parking block.
    2. imageData. This element was deleted on behalf of reducing redundancy and making the dataset smaller. There is one Jupyter Notebook on the labelme folder - imagedata.ipynb - which can restore or delete this dictionary element if one would like to modify some area mapping with the labelme python tool. You should restore the imageData dictionary element in order to run once again the labelme tool on the provided json file.
    3. Other features. lineColor, fillColor and image path is also provided for the labelme tool to render the polygons on edit mode.

Included scripts guide

All the scripts were written in Jupyter Notebooks with a python 3.6 kernel for readers' ease. The scripts and the folder that contains them are numbered for you to execute in order on behalf of achieving the following objectives:

  1. Select the train, validation and tests sets for building the PASCAL dataset from the labelme annotations.
  2. Generate each of the required folders for the PASCAL VOC 2010 format.
  3. Expand the image set with jittering and corresponding annotations.
  4. Extract statistical features to evaluate the datasets

                         +---1. build_training_test_folders
                         |   |   build.ipynb
                         |   \---builds
                         |       \---\<date\>
                         +---2. pascal
                         |   |   1. JPEGImages.ipynb
                         |   |   2. Annotations.ipynb
                         |   |   3. ImageSets.Segmentation.ipynb
                         |   |   4. SegmentationClass.ipynb
                         |   \---5. SegmentationObject.ipynb
                         +---3. jittering
                         |   |   1. Jittering.ipynb
                         |   |   2. Annotations.ipynb
                         |   |   3. ImageSets.Segmentation.ipynb
                         |   \---4. MoveEmpty.ipynb
                         \---4. features
                             |   1. marked_area.ipynb
                             |   2. stats features.ipynb
                             \---3. evaluation.ipynb

\normalsize \begin{figure} \captionof{lstlisting}{Included scripts tree file structure} \end{figure}

Format conversion

Subset selection - 1. build_training_test_folders

Sometimes it is convenient to just reduce the training data for selecting the sample size or filter out some countries we want to ignore. In those cases having a script to rebuild the dataset is convenient.

That said, the purpose of this task is to allow change the training and test sets from all the images folder and two txt files that specify both training and testing filenames without extension. Thus, the input is the images folder containing both png images and json labelme annotations and two txt files list. The output is two folders containing those images. Subset selection is done in this folder, 1. build_training_test_folders. Inside you will find build.ipynb notebook. You have to setup the following:

  1. training.txt and testing.txt files.
  2. Inside the script:
    1. IMAGES_PATH. Where are all the png images and labelme annotations located.
    2. BUILD_DAY. The name of the folder where the training.txt and testing.txt files are.
    3. BUILD_OUTPUT. Where the training and testing folders will be created for the new dataset.

Then, you can just run the script and the folders will be generated at the desired location.

Pascal format conversion - 2. pascal

Statistical features - 4. features

Finally, we want to assess how well suited is the data by itself to an specific algorithm we are developing. E.g., in some environments we would like to filter out parking spaces with very little annotated spaces to train more effectively, in others we would like to bound the algorithm in terms of computational power.

Stats features from the APKLOT dataset: (A) size in KB, (B) width and height of the image, (C) total area vs annotated area, (D) area count per image.

Figure @ref(fig:fig2) show some of the statistical features that were extracted by using the features.ipynb script:

  • (A) Size. We can see that the interquatile range lies beneath 200KB. However, there maybe outliers reaching at most 3.4 MB. You should be careful in identifying these outliers in case your algorithm fall short of GPU memory 1.
  • (B) Width and Height. We can see from theses section that most images have a quadratic proportion with more or less the same width than height. Just as the previous case, a researcher could filter out images out of proportion to cope with the required input dimensions, e.g. the input layer of a neural network.

  • (C) Total area vs Annotated area. This plot evince that sparse annotations dominate the dataset. Subset of a larger proportion could be assembled. However, we should take into account that the total area will ever be greater than the annotated area, and that due to the image borders will be approximately $\frac{1}{4}$ of the total.

  • (D) Area count per image. We can see that each image has marked about $15$ disconnected parking block regions. There are images in which this number is really small, meaning a big fully connected clustered region. Depending on the problem, these regions might be desirable or just as well should be avoided. E.g. If we want to boost our segmentation algorithm with the prior probability from near regions, then big clusters should be used for training. On the contrary, if we want our algorithm to be robust enough to be able to detect parking spots solely on the appearance of just one of them, then images with a large area count (disconnected spots) should be selected.

Mask evaluation

3. evaluation.ipynb

Intersection over union is an evaluation metric that is used extensively on the object detection task, specifically in the PASCAL VOC dataset. It is also known as the Jaccard index and measures the similarity pixel sets between bounding boxes. The formula for calculating the intersection over union o a bounding box is given by the following formula: $$ \frac{iTP}{(iTP+FP+iFN)} $$

Example segmentation images on our dataset APKLOT.

Clear metrics [6].

Dataset expansion

Download more images

Jittering - 3. jittering

Jittering was done by using the imgaug python library. The following listing shows the code that was used for jittering:

seq = iaa.Sequential([
        iaa.Crop(px=(0, 50)), # crop images from each side by 0 to 16px (randomly chosen)
        iaa.Fliplr(0.5), # horizontally flip 50% of the images
        iaa.Flipud(0.5),
        iaa.Affine(rotate=(-45, 45))
    ])

\normalsize \begin{figure} \captionof{lstlisting}{Jittering transformations} \end{figure}

Lets give it a closer look and explain it line by line:

(2) Randomly crop by a value between 0 and 50 pixels

(3) Horizontally flip 50% of the images

(4) Vertically flip 50% of the images

(5) Rotate images by a value between -45 and 45 degrees

Useful Software

Google Maps Api

labelme

We already digressed around labelme but here we indulge in a more formal introduction. Labelme is a polygon manual annotation tool for segmentation that was published on [5]. It was first exposed to the public through a webpage and then through a python pip package.

dlib

Dlib is an open source library that was published on [7]. It has extensive documentation through its webpage.

History and Background

Year Statistics New developments Notes
2018 Only 1 class discriminating between parking blocks and other spaces.
Train:
   300 images
   4034 labelme polygons
Validation:
   100 images
   1513 labelme polygons
Test:
   101 images
   1459 labelme polygons
One segmentation task:
Parking Block detection
Images were taken from
Google Maps API.

Organizers

  • Nisim Hurst-Tarrab, M.Sc.ORCID iD icon (graduate in Computer Science from Tecnologico de Monterrey).
  • Leonardo Chang, Ph.D.ORCID iD icon (researcher and professor at Tecnologico de Monterrey).

with major contributions from

  • Miguel González-Mendoza, Ph.D.ORCID iD icon (distinguished professor and researcher in the School of Science and Engineering, Tecnologico de Monterrey)
  • Neil Hernandez-Gress, Ph.D.ORCID iD icon (associate vice-chancellor for research in the School of Science and Engineering, Tecnologico de Monterrey)

Support

The preparation and running of this dataset is supported by the Instituto Tecnologico y de Estudios Superiores de Monterrey, and was funded up to some point by the Consejo Nacional de Ciencia y Tecnología CONACyT. If you wish to contribute to this dataset or have any doubt, please contact us at langheran@gmail.com.

Legal Notice

The Aerial Parking Lot dataset (APKLOT), is made available under the MIT license found in the LICENSE.md file. A MIT license is one of several public copyright licenses that enable free distribution of otherwise copyrighted work.

APKLOT consist of 500 still images with more than 7000 marked polygons of parking blocks. The images were extracted from Google Maps API. Users are entitled to use this image under this conditions:

  1. Comply with the fair-use google maps terms of service given at their page.
  2. Comply with the license file on the LICENSE.md file.
  3. Comply with best practices for attribution found here: https://wiki.creativecommons.org/wiki/best_practices_for_attribution
  4. Understand that the authors make no guarantee or warranty of non-infringement with respect to the dataset.

How to Cite

Please cite this dataset using the following bibtex reference:

@article{hurst2020,
  title={Robust Parking Block Segmentation from a Surveillance Camera Perspective},
  author={Hurst-Tarrab, Nisim and Chang, Leonardo and Gonzalez-Mendoza, Miguel and Hernandez-Gress, Neil},
  journal={Applied Sciences},
  volume={10},
  number={15},
  pages={5364},
  year={2020},
  publisher={Multidisciplinary Digital Publishing Institute}
}

Open Access version of the accompanying paper can be found here.

Version: 2.0 Date: 2020-08-03

References

[1] P. R. Almeida, L. S. Oliveira, A. S. Britto, E. J. Silva, and A. L. Koerich, “PKLot - A Robust Dataset for Parking Lot Classification the PKLOT Dataset,” Expert Systems with Applications, vol. 42, no. 11, pp. 1–6, Jul. 2015.

[2] G. Amato, F. Carrara, F. Falchi, C. Gennaro, C. Meghini, and C. Vairo, “Deep learning for decentralized parking lot occupancy detection,” Expert Systems with Applications, vol. 72, pp. 327–334, 2017.

[3] M. Hsieh, Y. Lin, and W. H. Hsu, “Drone-based object counting by spatially regularized regional proposal network,” Computing Research Repository (CoRR), vol. abs/1707.05972, 2017.

[4] M. Everingham, L. Van Gool, C. K. I. Williams, J. Winn, and A. Zisserman, “The pascal visual object classes (voc) challenge,” International Journal of Computer Vision, vol. 88, no. 2, pp. 303–338, Jun. 2010.

[5] A. Barriuso and A. Torralba, “Notes on image annotation,” Computing Research Repository (CoRR), vol. abs/1210.3448, 2012.

[6] R. Stiefelhagen, K. Bernardin, R. Bowers, J. Garofolo, D. Mostefa, and P. Soundararajan, “The clear 2006 evaluation,” in International evaluation workshop on classification of events, activities and relationships, 2006, pp. 1–44.

[7] D. E. King, “Dlib-ml: A machine learning toolkit,” J. Mach. Learn. Res., vol. 10, pp. 1755–1758, Dec. 2009.

Footnotes

  1. By ignoring this warning and if you are using CUDA, a cudaMalloc error could be thrown.