Merge pull request #330 from kvos/development

New Sentinel-2 download function

README.md

@@ -31,6 +31,10 @@ CoastSat is an open-source software toolkit written in Python that enables users
 
 ### Latest updates
 
+:arrow_forward: *(2022/09/21)*
+CoastSat 2.1:
++ new download function for Sentinel-2 images (better alignment between 10m RGB & NIR bands, 20 m SWIR band and 60 m QA band)
+
 :arrow_forward: *(2022/08/01)*
 CoastSat 2.0 (major release):
 + new download function for Landsat images (better alignment between panchromatic and multispectral bands)
@@ -132,7 +136,7 @@ To retrieve from the GEE server the available satellite images cropped around th
 - `sat_list`: satellite missions to consider (e.g., `sat_list = ['L5', 'L7', 'L8', 'L9', 'S2']` for Landsat 5, 7, 8, 9 and Sentinel-2 collections)
 - `sitename`: name of the site (this is the name of the subfolder where the images and other accompanying files will be stored)
 - `filepath`: filepath to the directory where the data will be stored
-- :new: `landsat_collection`: whether to use Collection 1 (`C01`) or Collection 2 (`C02`). Note that after 2022/01/01, Landsat images are only available in Collection 2. Landsat 9 is therefore only available as Collection 2. So if the user has selected `C01`, images prior to 2022/01/01 will be downloaded from Collection 1, while images captured after that date will be automatically taken from `C02`. Also note that at the time of writing `C02` is not complete in Google Earth Engine and still being uploaded.
+- :new: `landsat_collection`: whether to use Collection 1 (`C01`) or Collection 2 (`C02`). Note that after 2022/01/01, Landsat images are only available in Collection 2. Landsat 9 is therefore only available as Collection 2. So if the user has selected `C01`, images prior to 2022/01/01 will be downloaded from Collection 1, while images captured after that date will be automatically taken from `C02`.
 
 The call `metadata = SDS_download.retrieve_images(inputs)` will launch the retrieval of the images and store them as .TIF files (under */filepath/sitename*). The metadata contains the exact time of acquisition (in UTC time) of each image, its projection and its geometric accuracy. If the images have already been downloaded previously and the user only wants to run the shoreline detection, the metadata can be loaded directly by running `metadata = SDS_download.get_metadata(inputs)`.