L7 Irish

class torchgeo.datasets.L7Irish(paths='data', crs=None, res=None, bands=('B10', 'B20', 'B30', 'B40', 'B50', 'B61', 'B62', 'B70', 'B80'), transforms=None, cache=True, download=False, checksum=False, time_series=False)

Bases: IntersectionDataset

L7 Irish dataset.

The L7 Irish dataset is based on Landsat 7 Enhanced Thematic Mapper Plus (ETM+) Level-1G scenes. Manually generated cloud masks are used to train and validate cloud cover assessment algorithms, which in turn are intended to compute the percentage of cloud cover in each scene.

Dataset features:

• Images divided between 9 unique biomes

• 206 scenes from Landsat 7 ETM+ sensor

• Imagery from global tiles between June 2000–December 2001

• 9 Level-1 spectral bands with 30 m per pixel resolution

Dataset format:

• Images are composed of single multiband geotiffs

• Labels are multiclass, stored in single geotiffs

• Level-1 metadata (MTL.txt file)

• Landsat 7 ETM+ bands: (B10, B20, B30, B40, B50, B61, B62, B70, B80)

Dataset classes:

0. Fill

1. Cloud Shadow

2. Clear

3. Thin Cloud

4. Cloud

If you use this dataset in your research, please cite the following:

• https://doi.org/10.5066/F7XD0ZWC

• https://doi.org/10.1109/TGRS.2011.2164087

• https://www.sciencebase.gov/catalog/item/573ccf18e4b0dae0d5e4b109

Added in version 0.5.

__init__(paths='data', crs=None, res=None, bands=('B10', 'B20', 'B30', 'B40', 'B50', 'B61', 'B62', 'B70', 'B80'), transforms=None, cache=True, download=False, checksum=False, time_series=False)

Initialize a new L7Irish instance.

Parameters:

• paths (str | PathLike[str] | Iterable[str | PathLike[str]]) – one or more root directories to search or files to load

• crs (CRS | None) – coordinate reference system (CRS) to warp to (defaults to EPSG:3857)

• res (float | tuple[float, float] | None) – resolution of the dataset in units of CRS in (xres, yres) format. If a single float is provided, it is used for both the x and y resolution. (defaults to the resolution of the first file found)

• bands (Sequence[str]) – bands to return (defaults to all bands)

• transforms (Callable[[dict[str, Any]], dict[str, Any]] | None) – a function/transform that takes an input sample and returns a transformed version

• cache (bool) – if True, cache file handle to speed up repeated sampling

• download (bool) – if True, download dataset and store it in the root directory

• checksum (bool) – if True, check the MD5 of the downloaded files (may be slow)

• time_series (bool) – if True, stack data along the time series dimension [T, C, H, W]. If False, merge data into a [C, H, W] mosaic.

Raises:

DatasetNotFoundError – If dataset is not found and download is False.

Added in version 0.9: The time_series parameter.

plot(sample, show_titles=True, suptitle=None)

Plot a sample from the dataset.

Parameters:

• sample (dict[str, Any]) – a sample returned by RasterDataset.__getitem__()

• show_titles (bool) – flag indicating whether to show titles above each panel

• suptitle (str | None) – optional string to use as a suptitle

Returns:

a matplotlib Figure with the rendered sample

Raises:

RGBBandsMissingError – If bands does not include all RGB bands.

Return type:

Figure

__annotate_func__()

The type of the None singleton.