diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c4907a5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,103 @@
+# Aircraft datasets
+## [CosmiqWorks](https://www.cosmiqworks.org/) *RarePlanes* dataset
+
+[project](https://www.cosmiqworks.org/RarePlanes/), [paper](https://arxiv.org/abs/2006.02963), [data](https://www.cosmiqworks.org/rareplanes-public-user-guide/)
+
+### Summary
+Overhead imagery of aircraft combining real and synthetic data from airports aroud the world, labeled hierarchically. Contains about 50,000 images and 630,000 bounding box annotations.
+
+### Annotations
+- Bounding boxes
+- Segmentation masks for synthetic images
+- [Hierarchical labels](https://www.cosmiqworks.org/wp-content/uploads/2020/05/rareplanes-features.jpg)
+
+### Samples
+![](doc/rareplanes/rareplanes.jpg)
+
+
+## [FGVC (fine-grained visual classification) Aircraft Benchmark](https://www.robots.ox.ac.uk/~vgg/data/fgvc-aircraft/)
+
+[project](https://www.robots.ox.ac.uk/~vgg/data/fgvc-aircraft/), [paper](https://arxiv.org/abs/1306.5151), [data](https://www.robots.ox.ac.uk/~vgg/data/fgvc-aircraft/archives/fgvc-aircraft-2013b.tar.gz)
+
+### Summary
+
+Benchmark dataset for the fine grained visual categorization of aircraft.
+
+This dataset contains 10,200 images of aircraft, with 100 images for each of 102 different aircraft model variants, most of which are airplanes. The main aircraft in each image is annotated with a tight bounding box and a hierarchical airplane model label. Images are from [airliners.net](www.airliners.net) ([more info](#airlinersnet)).
+
+### Annotations
+- Bounding boxes
+- Hierarchical aircraft labels (model variant, family, and manufacturer)
+
+### Sample Images
+
+![](doc/fgvc/fgvc_01.jpg)
+![](doc/fgvc/fgvc_02.jpg)
+![](doc/fgvc/fgvc_03.jpg)
+![](doc/fgvc/fgvc_04.jpg)
+![](doc/fgvc/fgvc_05.jpg)
+
+
+
+## Military Aircraft Detection Dataset
+[project](https://www.kaggle.com/datasets/a2015003713/militaryaircraftdetectiondataset), 
+[data](https://www.kaggle.com/datasets/a2015003713/militaryaircraftdetectiondataset/download)
+
+### Summary
+6178 images of 40 types of military aircraft, from a wide variety of viewing perspectives and environments.
+
+In addition to images with bounding boxes, the dataset also includes extracted crops of each aircraft, organized by aircraft type.
+
+### Annotations
+- Bounding box in PASCAL VOC format (xmin, ymin, xmax, ymax)
+- Aircraft type (A10, A400M, AG600, AV8B, B1, B2, B52 Be200, C130, C17, C5, E2, EF2000, F117, F14, F15, F16, F18, F22, F35, F4, J20, JAS39, MQ9, Mig31, Mirage2000, RQ4, Rafale, SR71/A12, Su34, Su57, Tornado, Tu160, Tu95/Tu142, U2, US2, V22, Vulcan, XB70, YF23)
+
+### Sample Images
+
+![](doc/madd/madd_01.jpg)
+![](doc/madd/madd_02.jpg)
+![](doc/madd/madd_03.jpg)
+![](doc/madd/madd_04.jpg)
+![](doc/madd/madd_05.jpg)
+![](doc/madd/madd_06.jpg)
+
+
+https://pan.baidu.com/s/11UORs4eaKKPZNscIrtbISg
+
+## Military Aircraft Detection in Aerial Images (MADAI)
+
+[project](https://github.com/wangyanfeng231/TransEffiDet), [paper](https://www.hindawi.com/journals/cin/2022/2262549/) ([pdf](https://downloads.hindawi.com/journals/cin/2022/2262549.pdf)), [data](https://pan.baidu.com/s/11UORs4eaKKPZNscIrtbISg) (on Baidu)
+
+### Summary
+This dataset contains 2558 images of military aircraft, labeled as one of five categories (Fighter jets, armed helicopters, bombers, early warning aircraft, and passenger aircraft). 
+
+![](doc/madai/table.png)
+
+### Annotations
+- Bounding boxes
+- Class labels
+
+### Samples
+![](doc/madai/madai_01.jpg)
+![](doc/madai/madai_02.jpg)
+![](doc/madai/madai_03.jpg)
+
+## Airliners.net
+[website](https://www.airliners.net/)
+
+### Summary
+In addition to the curated datasets above, the website [www.airliners.net](http://www.airliners.net) hosts lots of images of aircraft, often including assiciated metadata. The images are sortable by multiple criteria including affiliation (military; nonmilitary), type (passenger; single-engine prop; helicopter), view (air-to-air; creative night/dusk/dawn), and others. The [FGVC dataset](#fgvc-fine-grained-visual-classification-aircraft-benchmark) images are apparently derived from this website, and the broader database itself may be useful to produce other custom datasets.
+
+### Samples
+The following images were selected by searching [www.airliners.net](www.airliners.net) for the keyword ["contrail"](https://www.airliners.net/search?keywords=contrail).
+
+![](doc/airliners.net/airliners_01.jpg)
+![](doc/airliners.net/airliners_02.jpg)
+![](doc/airliners.net/airliners_03.jpg)
+![](doc/airliners.net/airliners_04.jpg)
+![](doc/airliners.net/airliners_05.jpg)
+![](doc/airliners.net/airliners_06.jpg)
+![](doc/airliners.net/airliners_07.jpg)
+![](doc/airliners.net/airliners_08.jpg)
+![](doc/airliners.net/airliners_09.jpg)
+
diff --git a/doc/airliners.net/airliners_01.jpg b/doc/airliners.net/airliners_01.jpg
new file mode 100644
index 0000000..5c4718e
Binary files /dev/null and b/doc/airliners.net/airliners_01.jpg differ
diff --git a/doc/airliners.net/airliners_02.jpg b/doc/airliners.net/airliners_02.jpg
new file mode 100644
index 0000000..cda58a1
Binary files /dev/null and b/doc/airliners.net/airliners_02.jpg differ
diff --git a/doc/airliners.net/airliners_03.jpg b/doc/airliners.net/airliners_03.jpg
new file mode 100644
index 0000000..c8e61d7
Binary files /dev/null and b/doc/airliners.net/airliners_03.jpg differ
diff --git a/doc/airliners.net/airliners_04.jpg b/doc/airliners.net/airliners_04.jpg
new file mode 100644
index 0000000..5f7ec3c
Binary files /dev/null and b/doc/airliners.net/airliners_04.jpg differ
diff --git a/doc/airliners.net/airliners_05.jpg b/doc/airliners.net/airliners_05.jpg
new file mode 100644
index 0000000..ce73904
Binary files /dev/null and b/doc/airliners.net/airliners_05.jpg differ
diff --git a/doc/airliners.net/airliners_06.jpg b/doc/airliners.net/airliners_06.jpg
new file mode 100644
index 0000000..a8adecf
Binary files /dev/null and b/doc/airliners.net/airliners_06.jpg differ
diff --git a/doc/airliners.net/airliners_07.jpg b/doc/airliners.net/airliners_07.jpg
new file mode 100644
index 0000000..7b6aefe
Binary files /dev/null and b/doc/airliners.net/airliners_07.jpg differ
diff --git a/doc/airliners.net/airliners_08.jpg b/doc/airliners.net/airliners_08.jpg
new file mode 100644
index 0000000..b960d58
Binary files /dev/null and b/doc/airliners.net/airliners_08.jpg differ
diff --git a/doc/airliners.net/airliners_09.jpg b/doc/airliners.net/airliners_09.jpg
new file mode 100644
index 0000000..585d366
Binary files /dev/null and b/doc/airliners.net/airliners_09.jpg differ
diff --git a/doc/fgvc/fgvc_01.jpg b/doc/fgvc/fgvc_01.jpg
new file mode 100644
index 0000000..ed312e2
Binary files /dev/null and b/doc/fgvc/fgvc_01.jpg differ
diff --git a/doc/fgvc/fgvc_02.jpg b/doc/fgvc/fgvc_02.jpg
new file mode 100644
index 0000000..340f9ff
Binary files /dev/null and b/doc/fgvc/fgvc_02.jpg differ
diff --git a/doc/fgvc/fgvc_03.jpg b/doc/fgvc/fgvc_03.jpg
new file mode 100644
index 0000000..1721e32
Binary files /dev/null and b/doc/fgvc/fgvc_03.jpg differ
diff --git a/doc/fgvc/fgvc_04.jpg b/doc/fgvc/fgvc_04.jpg
new file mode 100644
index 0000000..4130ace
Binary files /dev/null and b/doc/fgvc/fgvc_04.jpg differ
diff --git a/doc/fgvc/fgvc_05.jpg b/doc/fgvc/fgvc_05.jpg
new file mode 100644
index 0000000..bac46ae
Binary files /dev/null and b/doc/fgvc/fgvc_05.jpg differ
diff --git a/doc/madai/.ipynb_checkpoints/Untitled-checkpoint.ipynb b/doc/madai/.ipynb_checkpoints/Untitled-checkpoint.ipynb
new file mode 100644
index 0000000..7fec515
--- /dev/null
+++ b/doc/madai/.ipynb_checkpoints/Untitled-checkpoint.ipynb
@@ -0,0 +1,6 @@
+{
+ "cells": [],
+ "metadata": {},
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/doc/madai/.ipynb_checkpoints/Untitled1-checkpoint.ipynb b/doc/madai/.ipynb_checkpoints/Untitled1-checkpoint.ipynb
new file mode 100644
index 0000000..7fec515
--- /dev/null
+++ b/doc/madai/.ipynb_checkpoints/Untitled1-checkpoint.ipynb
@@ -0,0 +1,6 @@
+{
+ "cells": [],
+ "metadata": {},
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/doc/madai/madai_01.jpg b/doc/madai/madai_01.jpg
new file mode 100644
index 0000000..7621ab6
Binary files /dev/null and b/doc/madai/madai_01.jpg differ
diff --git a/doc/madai/madai_02.jpg b/doc/madai/madai_02.jpg
new file mode 100644
index 0000000..b0f8c82
Binary files /dev/null and b/doc/madai/madai_02.jpg differ
diff --git a/doc/madai/madai_03.jpg b/doc/madai/madai_03.jpg
new file mode 100644
index 0000000..559c63b
Binary files /dev/null and b/doc/madai/madai_03.jpg differ
diff --git a/doc/madai/table.png b/doc/madai/table.png
new file mode 100644
index 0000000..044e96f
Binary files /dev/null and b/doc/madai/table.png differ
diff --git a/doc/madd/madd_01.jpg b/doc/madd/madd_01.jpg
new file mode 100644
index 0000000..e3b4c2a
Binary files /dev/null and b/doc/madd/madd_01.jpg differ
diff --git a/doc/madd/madd_02.jpg b/doc/madd/madd_02.jpg
new file mode 100644
index 0000000..33b6e9d
Binary files /dev/null and b/doc/madd/madd_02.jpg differ
diff --git a/doc/madd/madd_03.jpg b/doc/madd/madd_03.jpg
new file mode 100644
index 0000000..d6da785
Binary files /dev/null and b/doc/madd/madd_03.jpg differ
diff --git a/doc/madd/madd_04.jpg b/doc/madd/madd_04.jpg
new file mode 100644
index 0000000..03440c8
Binary files /dev/null and b/doc/madd/madd_04.jpg differ
diff --git a/doc/madd/madd_05.jpg b/doc/madd/madd_05.jpg
new file mode 100644
index 0000000..e0be4b5
Binary files /dev/null and b/doc/madd/madd_05.jpg differ
diff --git a/doc/madd/madd_06.jpg b/doc/madd/madd_06.jpg
new file mode 100644
index 0000000..b8847b0
Binary files /dev/null and b/doc/madd/madd_06.jpg differ
diff --git a/doc/rareplanes/rareplanes.jpg b/doc/rareplanes/rareplanes.jpg
new file mode 100644
index 0000000..415dca5
Binary files /dev/null and b/doc/rareplanes/rareplanes.jpg differ
diff --git a/papers/maji_2013_fine_grained_visual_classification_of_aircraft.pdf b/papers/maji_2013_fine_grained_visual_classification_of_aircraft.pdf
new file mode 100644
index 0000000..6f20aee
Binary files /dev/null and b/papers/maji_2013_fine_grained_visual_classification_of_aircraft.pdf differ
diff --git a/papers/shermeyer_2020_rareplanes_synthetic_data_takes_flight.pdf b/papers/shermeyer_2020_rareplanes_synthetic_data_takes_flight.pdf
new file mode 100644
index 0000000..8c75008
Binary files /dev/null and b/papers/shermeyer_2020_rareplanes_synthetic_data_takes_flight.pdf differ
diff --git a/papers/wang_2022_TransEffiDet_Aircraft_Detection_and_Classification_in_Aerial_Images_Based_on_EfficientDet_and_Transformer.pdf b/papers/wang_2022_TransEffiDet_Aircraft_Detection_and_Classification_in_Aerial_Images_Based_on_EfficientDet_and_Transformer.pdf
new file mode 100644
index 0000000..111a9c3
Binary files /dev/null and b/papers/wang_2022_TransEffiDet_Aircraft_Detection_and_Classification_in_Aerial_Images_Based_on_EfficientDet_and_Transformer.pdf differ