IDF CONVERTER - OVL User Manual

author: Lucile Gaultier, OceanDataLab
date: 2024-09-10

Learn to Convert IDF (Intermediary NetCDF Data for SEAScope) In this tutorial, we will run commands with an explanation point ! to replicate a command launch in a shell. You can also run the command in your shell with your python environment seascopenv activated, but Windows users need to replace / by \.

Convert Sentintel 1 data¶

First go in the data_converter directory and unzip the file provided: `S1A_IW_GRDH_1SDV_20240525T083150_20240525T083215_054025_069179_E726_COG.SAFE.zip`

!idf-converter -t sentinel1/L1 \
               -i path = ../data_converter/S1A.SAFE/measurement/s1a-iw-grd-vv-20240525t083150-20240525t083215-054025-069179-001-cog.tiff \
               -o path = ../ collection = sentinel1_l1_roughness downscale = no

Input / Output options descriptions¶

Input options:

path = [path_to_input_data]

Output options:

path = [path_to_output_data]
downscale = [yes or no] to produce multi resolution when files are at high res
collection = [name of your collection]

Go to your file browser to add the data in your SEAScope catalogue¶

In your materials_space_week directory there should be a sentinel1_l1_roughness directory which contains a granule:

move this granule to the seascope / data / sentinel1_sar_roughness directory

Convert SWOT L3 data¶

!idf-converter -t swot/L3 \
               -i path = ../data_converter/SWOT_L3_LR_SSH_Expert_015_477_20240525T081341_20240525T090507_v1.0.2.nc variables = ssha,ssha_noiseless,ssha_unedited,sigma0,ugos,ugosa,vgos,vgosa \
               -o path = ../ collection = swot_l3 use_float32_values = ssha,ssha_noiseless,ssha_unedited,sigma0,ugos,ugosa,vgos,vgosa downscale = no

Input / Output options descriptions¶

Input Options:

path = [path_to_input_data]
variables = [Variables to convert separated with a coma

Output options:

path = [path_to_output_data]
use_float32_values = [put the variable in list in float32]
downscale = [yes or no] to produce multi resolution files
collection = [name of your collection]

Go to your file browser to add the data in your SEAScope catalogue¶

In your materials_space_week directory there should be a swot_l3 directory which contains a granule:

move this granule to the seascope / data / swot_l3 directory

Convert Sentinel-3 SLSTR L1 SST data¶

First go in the data_converter directory and unzip the file provided: `S3B_SL_1_RBT____20240525T012513_20240525T012813_20240525T022836_0179_093_216_5580_PS2_O_NR_004.SEN3.zip`

!idf-converter -t sentinel3/slstr/L1/bt \
               -i path = ../data_converter/S3B_20240525T012513.SEN3 sst_coeffs_path = ../data_converter/sst_coefficient/S3A_SL_2_N2_CAX_20160216T000000_20991231T235959_20170330T120000___________________MPC_O_AL_004.SEN3/SL_2_N2_CAX.v4.3.1.nc geoloc_spacing = 128 \
               -o path = ../ gcp_spacing = 128 downscale = no collection = sentinel3_slstr_l1_bt

Input / Output options descriptions¶

Input Options:

path = [path_to_input_data]
sst_coeffs_path = [Coefficient file to convert brightness bands into SST
geoloc_spacing = [interval between two locations in input]

Output options:

path = [path_to_output_data]
gcp_spacing = [interval between two locations in output]
downscale = [yes or no] to produce multi resolution when files are at high res
collection = [name of your collection]

Go to your file browser to add the data in your SEAScope catalogue¶

In your materials_space_week directory there should be a sentinel3_slstr_l1_bt directory which contains a granule:

move this granule to the seascope / data / sentinel3_slstr_l1_bt directory