Add FAIR1M Dataset

[isaaccorley]

This PR adds the FAIR1M dataset which is listed as an ISPRS benchmark dataset and currently being used in the Gaofen Challenge. The dataset is hosted on Google Drive but is private and requires sign in to the Gaofen Challenge to download so we aren't able to support automatic downloads.

The dataset is also split into several parts released throughout the challenge duration. I haven't received an email yet with the updated links so I'm only including part 1 for now.

• Adds torchgeo.datasets.FAIR1M and torchgeo.datasets.FAIR1MDataModule

Notes:

• The objects are oriented/rotated so the targets are actually 5 point polygons so they aren't true bounding boxes. This is different than what we have encountered in other datasets but we should definitely consider supporting this. I've seen this represented as either just 4 point bounding boxes or a non rotated bounding box with an associated rotation angle.

TODO:

• add methods for verifying checksum and directories
  - add method for plotting samples
• add part2 of dataset

Examples using the FAIR1M.plot method:

[adamjstewart]

Tried testing this datamodule with our new ObjectDetectionTask but it doesn't seem compatible. Looking at the fake data, it seems like all boxes are unrotated, but looking at the plot in this PR, it seems like they are rotated in general. Am I correct that we would need #840 in order to properly train this datamodule?

[isaaccorley]

Tried testing this datamodule with our new ObjectDetectionTask but it doesn't seem compatible. Looking at the fake data, it seems like all boxes are unrotated, but looking at the plot in this PR, it seems like they are rotated in general. Am I correct that we would need #840 in order to properly train this datamodule?

That's correct. We don't currently support oriented object detection. Right now we simply provide a way to load the data but not train on it.

[austinmw]

@isaaccorley How can I download the dataset now that the challenge page is down?

[isaaccorley]

@austinmw Not sure. I can reach out to the authors but I do have a subset of it hosted here

[austinmw]

Thanks! Very interested to obtain it.

[isaaccorley]

@austinmw I'm able to access the google drive link from here after logging in. Can you check if it works for you?

[isaaccorley]

@austinmw Here's a quick and dirty bash script if you want to automatically download the entire FAIR1M 2.0 dataset using the gdown library

[austinmw]

Thanks a ton!

[adamjstewart]

@isaaccorley can you update the dataset download instructions?

[isaaccorley]

@adamjstewart I'm actually working on a PR to update the entire dataset.