Skip to content

Downloader Goes16

GOES16Download dataclass

A class for downloading GOES 16 data and cloud mask

Attributes:

Name Type Description
start_date str

The start date of the data to download.
end_date str

The end date of the data to download.
start_time str

The start time of the data to download.
end_time str

The end time of the data to download.
daily_window_t0 str

The start time of the daily window for data download.
daily_window_t1 str

The end time of the daily window for data download.
time_step str

The time step for data download.
save_dir str

The directory to save the downloaded data.

Methods:

Name Description
download

Downloads GOES 16 data.
download_cloud_mask

Downloads GOES 16 cloud mask.
Source code in rs_tools/_src/data/goes/downloader_goes16.py 
13
14
15
16
17
18
19
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
@dataclass
class GOES16Download:
    """A class for downloading GOES 16 data and cloud mask

    Attributes:
        start_date (str): The start date of the data to download.
        end_date (str): The end date of the data to download.
        start_time (str): The start time of the data to download.
        end_time (str): The end time of the data to download.
        daily_window_t0 (str): The start time of the daily window for data download.
        daily_window_t1 (str): The end time of the daily window for data download.
        time_step (str): The time step for data download.
        save_dir (str): The directory to save the downloaded data.

    Methods:
        download: Downloads GOES 16 data.
        download_cloud_mask: Downloads GOES 16 cloud mask.  
    """

    start_date: str
    end_date: str 
    start_time: str 
    end_time: str 
    daily_window_t0: str  
    daily_window_t1: str  
    time_step: str
    save_dir: str 

    def download(self) -> List[str]:
        """Downloads GOES 16 data"""
        goes_files = goes_download(
            start_date=self.start_date,
            end_date=self.end_date,
            start_time=self.start_time,
            end_time=self.end_time,
            daily_window_t0=self.daily_window_t0, 
            daily_window_t1=self.daily_window_t1, 
            time_step=self.time_step,
            satellite_number=16,
            save_dir=Path(self.save_dir).joinpath("L1b"),
            instrument="ABI",
            processing_level='L1b',
            data_product='Rad',
            domain='F',
            bands='all',
            check_bands_downloaded=True,
        )
        return goes_files

    def download_cloud_mask(self) -> List[str]:
        """Downloads GOES 16 cloud mask"""
        goes_files = goes_download(
            start_date=self.start_date,
            end_date=self.end_date,
            start_time=self.start_time,
            end_time=self.end_time,
            daily_window_t0=self.daily_window_t0, 
            daily_window_t1=self.daily_window_t1, 
            time_step=self.time_step,
            satellite_number=16,
            save_dir=Path(self.save_dir).joinpath("CM"),
            instrument="ABI",
            processing_level='L2',
            data_product='ACM',
            domain='F',
            bands='all',
            check_bands_downloaded=True,
        )
        return goes_files

download()

Downloads GOES 16 data

Source code in rs_tools/_src/data/goes/downloader_goes16.py 
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
def download(self) -> List[str]:
    """Downloads GOES 16 data"""
    goes_files = goes_download(
        start_date=self.start_date,
        end_date=self.end_date,
        start_time=self.start_time,
        end_time=self.end_time,
        daily_window_t0=self.daily_window_t0, 
        daily_window_t1=self.daily_window_t1, 
        time_step=self.time_step,
        satellite_number=16,
        save_dir=Path(self.save_dir).joinpath("L1b"),
        instrument="ABI",
        processing_level='L1b',
        data_product='Rad',
        domain='F',
        bands='all',
        check_bands_downloaded=True,
    )
    return goes_files

download_cloud_mask()

Downloads GOES 16 cloud mask

Source code in rs_tools/_src/data/goes/downloader_goes16.py 
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
def download_cloud_mask(self) -> List[str]:
    """Downloads GOES 16 cloud mask"""
    goes_files = goes_download(
        start_date=self.start_date,
        end_date=self.end_date,
        start_time=self.start_time,
        end_time=self.end_time,
        daily_window_t0=self.daily_window_t0, 
        daily_window_t1=self.daily_window_t1, 
        time_step=self.time_step,
        satellite_number=16,
        save_dir=Path(self.save_dir).joinpath("CM"),
        instrument="ABI",
        processing_level='L2',
        data_product='ACM',
        domain='F',
        bands='all',
        check_bands_downloaded=True,
    )
    return goes_files

download(start_date='2020-10-02', end_date='2020-10-02', start_time='14:00:00', end_time='20:00:00', daily_window_t0='14:00:00', daily_window_t1='14:30:00', time_step='00:15:00', save_dir='./data/', cloud_mask=True)

Downloads GOES 16 data including cloud mask

Parameters:

Name Type Description Default
start_date str

The start date of the data to download (format: 'YYYY-MM-DD')

 '2020-10-02'
end_date str

The end date of the data to download (format: 'YYYY-MM-DD')

 '2020-10-02'
start_time str

The start time of the data to download (format: 'HH:MM:SS')

 '14:00:00'
end_time str

The end time of the data to download (format: 'HH:MM:SS')

 '20:00:00'
daily_window_t0 str

The start time of the daily window (format: 'HH:MM:SS')

 '14:00:00'
daily_window_t1 str

The end time of the daily window (format: 'HH:MM:SS')

 '14:30:00'
time_step str

The time step between consecutive data downloads (format: 'HH:MM:SS')

 '00:15:00'
save_path str

The path to save the downloaded data

 required
cloud_mask bool

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

 True

Returns:

Type Description

List[str]: List of downloaded file names
Source code in rs_tools/_src/data/goes/downloader_goes16.py 
 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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
def download(
        start_date: str="2020-10-02",
        end_date: str="2020-10-02", 
        start_time: str="14:00:00", 
        end_time: str="20:00:00", 
        daily_window_t0: str="14:00:00",  
        daily_window_t1: str="14:30:00",  
        time_step: str="00:15:00",
        save_dir: str='./data/', 
        cloud_mask: bool = True
):
    """
    Downloads GOES 16 data including cloud mask

    Args:
        start_date (str): The start date of the data to download (format: 'YYYY-MM-DD')
        end_date (str): The end date of the data to download (format: 'YYYY-MM-DD')
        start_time (str): The start time of the data to download (format: 'HH:MM:SS')
        end_time (str): The end time of the data to download (format: 'HH:MM:SS')
        daily_window_t0 (str): The start time of the daily window (format: 'HH:MM:SS')
        daily_window_t1 (str): The end time of the daily window (format: 'HH:MM:SS')
        time_step (str): The time step between consecutive data downloads (format: 'HH:MM:SS')
        save_path (str): The path to save the downloaded data
        cloud_mask (bool, optional): Whether to download the cloud mask data (default: True)

    Returns:
        List[str]: List of downloaded file names
    """
    logger.debug(f"TIME STEP: {time_step}")
    # Initialize GOES 16 Downloader
    logger.info("Initializing GOES16 Downloader...")
    dc_goes16_download = GOES16Download(
        start_date=start_date,
        end_date=end_date,
        start_time=start_time,
        end_time=end_time,
        daily_window_t0=daily_window_t0,
        daily_window_t1=daily_window_t1,
        time_step=time_step,
        save_dir=Path(save_dir).joinpath("goes16"),
    )
    logger.info("Downloading GOES 16 Data...")
    goes16_filenames = dc_goes16_download.download()
    logger.info("Done!")
    if cloud_mask:
        logger.info("Downloading GOES 16 Cloud Mask...")
        goes16_filenames = dc_goes16_download.download_cloud_mask()
        logger.info("Done!")

    logger.info("Finished GOES 16 Downloading Script...")