data_downloader.services.SentinelOrbit#

class data_downloader.services.SentinelOrbit(home_aux_cal: str = 'https://s1qc.asf.alaska.edu/aux_cal/', home_preorb: str = 'https://s1qc.asf.alaska.edu/aux_poeorb/')#

a class to retrieve Sentinel-1 orbit data links.

Examples

>>> from data_downloader import downloader, services
>>> from pathlib import Path

>>> folder_cal = Path("/media/data/aux_cal")  # specify the folder to save aux_cal
>>> folder_preorb = Path("/media/data/poeorb")  # specify the folder to save aux_poeorb

init SentinelOrbit:

>>> s1_orbit = services.SentinelOrbit()

Get all aux_cal data links of S1A and S1B and download them:

>>> urls_cal = s1_orbit.cal_urls(platform='all')
>>> downloader.async_download_datas(urls_cal, folder=folder_cal)

Get all precise orbit data links of S1A during 20210101-20220301 and download them:

>>> urls_preorb = s1_orbit.poeorb_urls(
>>>    date_start="20210101", date_end="20220301", platform="S1A"
>>> )
>>> downloader.download_datas(urls_preorb, folder=folder_preorb)
__init__(home_aux_cal: str = 'https://s1qc.asf.alaska.edu/aux_cal/', home_preorb: str = 'https://s1qc.asf.alaska.edu/aux_poeorb/') → None#

init SentinelOrbit.

Parameters:

Methods

__init__([home_aux_cal, home_preorb])

init SentinelOrbit.

cal_urls([platform])

filter files from urls of aux_cal by platform.

poeorb_urls(date_start, date_end[, platform])

filter files from urls of aux_poeorb (precise orbit) by date and platform.
__init__(home_aux_cal: str = 'https://s1qc.asf.alaska.edu/aux_cal/', home_preorb: str = 'https://s1qc.asf.alaska.edu/aux_poeorb/') → None#

init SentinelOrbit.

Parameters:
cal_urls(platform: Literal['S1A', 'S1B', 'all'] = 'all')#

filter files from urls of aux_cal by platform.

Parameters:

platform (str, one of ['S1A', 'S1B','all']) – platform of satellite. should be one of [‘S1A’, ‘S1B’,’all’]

poeorb_urls(date_start: str, date_end: str, platform: Literal['S1A', 'S1B', 'all'] = 'all')#

filter files from urls of aux_poeorb (precise orbit) by date and platform.

Parameters:

  • date_start (str) – start/end date to filter, can be any format that can be converted by pd.to_datetime (e.g. ‘20210101’, ‘2021-01-01’, ‘2021/01/01’).

  • date_end (str) – start/end date to filter, can be any format that can be converted by pd.to_datetime (e.g. ‘20210101’, ‘2021-01-01’, ‘2021/01/01’).

  • platform (str, one of ['S1A', 'S1B','all']) – platform of satellite. should be one of [‘S1A’, ‘S1B’,’all’]