# Author: Maria Yli-Heikkilä
# Date : 30.1.2025

This project's Allas repository can stand as an ecosystem for Sentinel research (AOI approx. Finland's territory). The idea is that 
collaborators can all add SAFE folders here for shared use. Ask for access to the repository from maria.yli-heikkila@luke.fi

Best way to access the dataset is by Paituli STAC queries. See https://paituli.csc.fi/stac.html

Description of the dataset:
https://radiantearth.github.io/stac-browser/#/external/paituli.csc.fi/geoserver/ogc/stac/v1/collections/sentinel2-l2a?.language=en&.itemFilterOpen=1


########## Acknowledgement:
See citation in Etsin: https://etsin.fairdata.fi/dataset/2dc83dd7-92aa-4a82-9892-39d8ecd3a79e

There is a legal notice from ESA on the use or distribution of Sentinel data:
https://a3s.fi/README/Sentinel_Data_Legal_Notice.pdf

Please, fill up a short description file of your project, if you use this repo. The description file follows the same structure of 
initiating a project at my.csc.fi. See e.g.:
https://a3s.fi/README/projectSummary1.txt
https://a3s.fi/README/projectSummary2.txt
https://a3s.fi/README/projectSummary_MaaTu.txt

If you are not a member of the collaborator team, send the description to maria.yli-heikkila@luke.fi or kylli.ek@csc.fi. 

########## Instructions for future contributors of Sentinel repository:

SAFE files are under granule (tile) wise buckets. The good part of this is that user can access straight the .jpeg2000 files (bands), even 
without downloading the whole file, but with GDAL VSI user can crop AOI. Ask Kylli Ek for examples on this, and see: 
https://github.com/csc-training/geocomputing/tree/master/python/allas

# to use s3cmd commands (more options that with a-commands):
module load allas
allas-conf -k --mode s3cmd

# here is an exmaple how to upload new SAFE files to this repository:
s3cmd put -r $safedir s3://Sentinel2-MSIL2A-cloud-0-95-2016-$TILE/

# if bucket does not yet exist, make it by:
s3cmd mb s3://my_bucket

Please, use similar nomenclature as before when creating new buckets:
[satellite]-[product level]-cloud-[cloud threshold minimum]-[cloud threshold maximum]-[year]-[tilename]
e.g. Sentinel2-MSIL2A-cloud-0-95-2016-T34VDM

######### Note:

From 2017 on ESA scihub has been providing Sentinel-2 products on level L2A. L2A products here are downloaded from scihub 
(unless stated otherwise).

However, in 2016 only L1C level poducts are available. Thus, L2A products here are further processed from L1C downloads. L1C 
products were processed into L2A with FORCE software tool with command: L2A_Process filename.SAFE