Metadata-Version: 2.4
Name: fsarcamp
Version: 2.0.1
Summary: Data loaders for selected F-SAR campaigns
Author-email: Nikita Basargin <nikita.basargin@dlr.de>
License: MIT License
        
        Copyright (c) 2024 Nikita Basargin
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: shapely
Requires-Dist: matplotlib
Requires-Dist: pandas
Requires-Dist: openpyxl
Requires-Dist: geopandas
Requires-Dist: rasterio
Requires-Dist: pyproj
Dynamic: license-file

# F-SAR campaigns package

The main purpose of this package is to provide a convenient way to load the data of different F-SAR campaigns, including F-SAR radar data (e.g. SLC, incidence), geocoding lookup tables (LUT), and campaign ground measurements (if available).

## Editable installation
- Clone this repository to your machine.
- Then, activate the python environment (e.g. conda or venv) where the package should be installed.
- Run `pip install -e .` in the root folder of this package (where `pyproject.toml` is located).

## Campaign components

Each F-SAR campaign is represented by a python class e.g. `CROPEX14Campaign` that contains data about all available campaign flights and passes.
Using this class you can obtain instances of F-SAR passes e.g. `CROPEX14Pass` that provide loaders for the radar data (e.g. SLC, incidence).

In addition, each campaign can provide loaders for the ground measurements.
The data varies from campaign to campaign and may include useful constants (e.g. specific dates), region boundaries (e.g. fields), point measurements, etc.

## Supported campaigns

F-SAR campaigns are usually experimental and the folder structure or file naming slightly change over the years.
This package is not intended to be a universal data loader but supports only specific F-SAR campaigns.
See the list of campaigns and the available data below.

### CROPEX 2014

Campaign focusing on agricultural crops with many flights over 10 weeks.
X-, C-, and L-band are available, some dates have several baselines allowing tomography.

Several fields have been monitored during the campaign.
The measurement include crop height, water content, biomass, and soil moisture.

Following data loaders are currently supported:
- `CROPEX14Campaign`: F-SAR data loader (SLC, incidence, lookup tables, etc.)
- `CROPEX14Biomass`: Point-wise biomass ground measurements collected by the ground teams over specific fields
- `CROPEX14Moisture`: Point-wise soil moisture ground measurements collected by the ground teams over specific fields
- `CROPEX14Regions`: Region definitions and geocoding for the relevant fields (as polygons)

### HTERRA 2022

Campaign focusing on soil moisture in agricultural areas.
The campaign was executed in two missions, the first one in April and the second one in June.
There are 8 flights in total, most passes are zero-baseline, with a few exceptions.
C- and L-band are available.

Several fields were monitored during the campaign.
The measurements include a large number of soil moisture points for each flight and some biomass measurements.

This package defines following constants:
- 8 time periods correponding to the flights
- several region names that cover specific fields + region extent in SLC and LUT coordinates

Following data loaders are currently supported:
- `HTERRA22Campaign`: F-SAR data loader (SLC, incidence, lookup tables, etc.)
- `HTERRA22Moisture`: Point-wise soil moisture ground measurements collected by the ground teams over specific fields
- `HTERRA22Regions`: Region definitions and geocoding for the relevant fields (as polygons)


# Notes

This repository includes third party code obtained from `https://github.com/birgander2/PyRAT` to read RAT files.
Third party code is located in the `fsarcamp/src/fsarcamp/ste_io` folder and is licensed under the MPL-2.0 license.
