https://github.com/fanchengyan/faninsar
A fancy InSAR time series library, in a Pythonic, fast, and flexible way.
https://github.com/fanchengyan/faninsar
deformation geoscience geospatial insar nisar nsbas radar remote-sensing sar sbas sentinel-1 time-series
Last synced: 4 months ago
JSON representation
A fancy InSAR time series library, in a Pythonic, fast, and flexible way.
- Host: GitHub
- URL: https://github.com/fanchengyan/faninsar
- Owner: Fanchengyan
- License: mit
- Created: 2023-08-15T07:28:21.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-10T15:36:35.000Z (over 1 year ago)
- Last Synced: 2025-02-01T09:51:19.029Z (10 months ago)
- Topics: deformation, geoscience, geospatial, insar, nisar, nsbas, radar, remote-sensing, sar, sbas, sentinel-1, time-series
- Language: Python
- Homepage: https://faninsar.readthedocs.io
- Size: 10.2 MB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
[](https://doi.org/10.5281/zenodo.11398347) [](https://faninsar.readthedocs.io/en/latest/?badge=latest) [](https://github.com/psf/black)
**FanInSAR** is a **Fan**cy **In**terferometric **S**ynthetic **A**perture **R**adar (InSAR) time series analysis library written in Python. It aims to provide a foundational library for the development of InSAR algorithms, facilitating efficient processing of InSAR time series data by offering a Pythonic, fast, and flexible approach.
## Why FanInSAR?
Most existing community InSAR software adopts a workflow-oriented approach. While this lowers the entry barrier for new users, it often compromises flexibility and extensibility. For algorithm researchers, integrating new methods into these rigid workflows can be challenging, highlighting the need for a more adaptable framework for InSAR time series analysis.
**FanInSAR** is designed to bridge this gap. It serves as a foundational library for InSAR time series processing, offering a flexible and extensible framework tailored for algorithm researchers and developers. FanInSAR is not a complete end-to-end InSAR processing system; rather, it provides building blocks for creating custom workflows. Its high-level API abstracts the complexity of the processing pipeline and hides low-level implementation details, allowing users to focus on developing and testing new algorithms. For researchers aiming to rapidly prototype and deploy their own InSAR methods, FanInSAR offers a fast and efficient starting point.
## Highlight Features
- **Pythonic**: FanInSAR is written in Python and provides a user-friendly API. For example, a series of well-known InSAR datasets are provided in the form of Python classes; loading data from ``HyP3`` or ``LiCSAR`` products is as simple as providing the corresponding home directory. Sampling values from an interferometric dataset is as easy as calling the ``query()`` method by passing the spatial (Points, BoundingBox, Polygons) and temporal (Pairs) queries. The warping process during sampling (such as reprojecting and resampling) is automatically handled by the library.
- **Fast**: The core computation in FanInSAR is implemented using ``PyTorch``, a high-performance deep learning library. This allows for efficient processing on both CPU and GPU, enabling faster execution.
- **Flexible**: FanInSAR is designed to be flexible, allowing for customization and extension. Users can easily inherit classes or customize the processing pipeline for their specific needs.
## Installation
FanInSAR is a Python package, and requires ``Python >= 3.8``. You can install the latest release of FanInSAR using ``pip`` from the PyPI:
```bash
pip install FanInSAR
```
or from GitHub:
```bash
pip install git+https://github.com/Fanchengyan/FanInSAR.git
```
## Documentation
The detailed documentation is available at:
> :warning: **Note**
>
>FanInSAR is under active development and is currently in the alpha stage. Its API may change in the future until it reaches a stable version.
## Citation
> Fan, C., & Liu, L. (2024). FanInSAR: A Fancy InSAR time series library, in a Pythonic, fast, and flexible way (0.0.1). Zenodo. https://doi.org/10.5281/zenodo.11398347
```bib
@software{fan_2024_11398347,
author = {Fan, Chengyan and
Liu, Lin},
title = {{FanInSAR: A Fancy InSAR time series library, in a
Pythonic, fast, and flexible way}},
month = may,
year = 2024,
publisher = {Zenodo},
version = {0.0.1},
doi = {10.5281/zenodo.11398347},
url = {https://doi.org/10.5281/zenodo.11398347}
}
```