Skip to content

Downloader Aqua

A General Pipeline for create ML-Ready Data - Downloading the Data - Data Harmonization - Normalizing - Patching

MODISAquaDownload dataclass

Downloading class for AQUA/MODIS data and cloud mask

Source code in rs_tools/_src/data/modis/downloader_aqua.py 
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
@dataclass
class MODISAquaDownload:
    """Downloading class for AQUA/MODIS data and cloud mask"""
    start_date: str
    end_date: str
    start_time: str
    end_time: str
    save_dir: str
    bounding_box: tuple[float, float, float, float]

    def download(self) -> List[str]:
        aqua_files = modis_download(
            start_date=self.start_date,
            end_date=self.end_date,
            start_time=self.start_time, 
            end_time=self.end_time,
            day_step=1,
            satellite="Aqua",
            save_dir=Path(self.save_dir).joinpath("L1b"),
            processing_level='L1b',
            resolution="1KM",
            bounding_box=self.bounding_box,
            day_night_flag="day",
            identifier= "02"
            )
        return aqua_files

    def download_cloud_mask(self) -> List[str]:
        aqua_files = modis_download(
            start_date=self.start_date,
            end_date=self.end_date,
            start_time=self.start_time, 
            end_time=self.end_time,
            day_step=1,
            satellite="Aqua",
            save_dir=Path(self.save_dir).joinpath("CM"),
            processing_level='L2',
            resolution="1KM",
            bounding_box=self.bounding_box,
            day_night_flag="day",
            identifier= "35"
            )
        return aqua_files

download(start_date='2020-10-01', end_date='2020-10-01', start_time='14:00:00', end_time='21:00:00', save_dir='./data/', region='-130 -15 -90 5', cloud_mask=True)

Downloads AQUA MODIS data including cloud mask

Parameters:

Name Type Description Default
start_date str

The start date of the period to download files for in the format "YYYY-MM-DD".

 '2020-10-01'
end_date str

The end date of the period to download files for in the format "YYYY-MM-DD".

 '2020-10-01'
start_time str

The start time of the period to download files for in the format "HH:MM:SS".

 '14:00:00'
end_time str

The end time of the period to download files for in the format "HH:MM:SS".

 '21:00:00'
save_dir str

The directory path to save the downloaded files.

 './data/'
region str

The geographic region to download files for in the format "min_lon min_lat max_lon max_lat".

 '-130 -15 -90 5'
cloud_mask bool

Whether to download the cloud mask data (default: True).

 True

Returns:

Type Description

None
Source code in rs_tools/_src/data/modis/downloader_aqua.py 
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
def download(
        start_date: str = "2020-10-01", 
        end_date: str = "2020-10-01",
        start_time: str = "14:00:00",
        end_time: str = "21:00:00",
        save_dir: str = "./data/",
        region: str = "-130 -15 -90 5",
        cloud_mask: bool = True
):
    """
    Downloads AQUA MODIS data including cloud mask

    Args:
        start_date (str): The start date of the period to download files for in the format "YYYY-MM-DD".
        end_date (str): The end date of the period to download files for in the format "YYYY-MM-DD".
        start_time (str): The start time of the period to download files for in the format "HH:MM:SS".
        end_time (str): The end time of the period to download files for in the format "HH:MM:SS".
        save_dir (str): The directory path to save the downloaded files.
        region (str, optional): The geographic region to download files for in the format "min_lon min_lat max_lon max_lat".
        cloud_mask (bool, optional): Whether to download the cloud mask data (default: True).

    Returns:
        None
    """
    bounding_box = tuple(map(lambda x: int(x), region.split(" ")))
    # Initialize AQUA Downloader
    logger.info("Initializing AQUA Downloader...")
    dc_aqua_download = MODISAquaDownload(
        start_date=start_date,
        end_date=end_date,
        start_time=start_time,
        end_time=end_time,
        save_dir=Path(save_dir).joinpath("aqua"),
        bounding_box=bounding_box,
    )
    logger.info("Downloading AQUA Data...")
    modis_filenames = dc_aqua_download.download()
    logger.info("Done!")
    if cloud_mask:
        logger.info("Downloading AQUA Cloud Mask...")
        modis_filenames = dc_aqua_download.download_cloud_mask()
        logger.info("Done!")

    logger.info("Finished AQUA Downloading Script...")