Skip to content

darts_acquisition.s2.grid

Download of the s2 mgrs based grid.

logger module-attribute 

logger = logging.getLogger(
    __name__.replace("darts_", "darts.")
)

_download_zip 

_download_zip(url: str, grid_dir: pathlib.Path)
Source code in darts-acquisition/src/darts_acquisition/s2/grid.py 
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
@stopwatch.f("Downloading and extracting zip file", printer=logger.debug)
def _download_zip(url: str, grid_dir: Path):
    response = requests.get(url)

    # Get the downloaded data as a byte string
    data = response.content
    logger.debug(f"Downloaded {len(data)} bytes")

    # Create a bytesIO object
    with io.BytesIO(data) as buffer:
        # Create a zipfile.ZipFile object and extract the files to a directory
        grid_dir.mkdir(parents=True, exist_ok=True)
        with zipfile.ZipFile(buffer, "r") as zip_ref:
            # Extract the files to the specified directory
            zip_ref.extractall(grid_dir)

    # Move the extracted files one level up
    extracted_folder = grid_dir / "Sentinel-2-Shapefile-Index-master"
    for item in extracted_folder.iterdir():
        item.rename(grid_dir / item.name)
    extracted_folder.rmdir()

download_sentinel_2_grid 

download_sentinel_2_grid(grid_dir: pathlib.Path)

Download the Sentinel 2 grid files.

Files will be stored under [grid_dir]/adm1.shp and [grid_dir]/...

Parameters:

Source code in darts-acquisition/src/darts_acquisition/s2/grid.py 
37
38
39
40
41
42
43
44
45
46
47
48
49
50
@stopwatch.f("Downloading Sentinel 2 grid", printer=logger.debug)
def download_sentinel_2_grid(grid_dir: Path):
    """Download the Sentinel 2 grid files.

    Files will be stored under [grid_dir]/adm1.shp and [grid_dir]/...

    Args:
        grid_dir (Path): The path to the grid.

    """
    grid_dir.mkdir(exist_ok=True, parents=True)
    grid_url = "https://github.com/justinelliotmeyers/Sentinel-2-Shapefile-Index/archive/refs/heads/master.zip"
    logger.debug(f"Downloading {grid_url} to {grid_dir.resolve()}")
    _download_zip(grid_url, grid_dir)