Python decoder for Sentinel-1 level0 files. The level0 format consists of the raw space packets downlinked from the Sentinel-1 spacecraft. This package decodes these and produces the raw I/Q sensor output from the SAR instrument, which can then be further processed to focus a SAR image. An example Jupyter notebook which runs through the process of decoding Level 0 data and forming an image is available on github here or nbviewer.org here.
This code is heavily based on an implementation in C by jmfriedt which can be found here.
In a terminal window:
pip install git+https://github.com/Rich-Hall/sentinel1decoder
Numpy and Pandas are also required.
Import the package:
import sentinel1decoder
Initialize a Level0Decoder object:
decoder = sentinel1decoder.Level0Decoder( filename )
Generate a Pandas dataframe containing the header information associated with the Sentinel-1 downlink packets contained in the file:
df = decoder.decode_metadata()
Further decode the satellite ephemeris data from the information in the packet headers:
ephemeris = sentinel1decoder.utilities.read_subcommed_data(df)
Extract the data payload from the data packets in the file. Takes a Pandas dataframe as an input, and only decodes packets whose header is present in the input dataframe. The intended usage of this is to allow the user to select which packets to decode, rather than having to always decode the full file. For example, to decode the first 100 packets only:
selection = df.iloc[0:100]
iq_array = decoder.decode_file(selection)