Metadata-Version: 2.1
Name: kite
Version: 1.5.6
Summary: InSAR unwrapped surface displacement processing for earthquake modelling.
Author-email: Marius Paul Isken <mi@gfz-potsdam.de>, Henriette Sudhaus <hsudhaus@ifg.uni-kiel.de>
Maintainer-email: Marius Paul Isken <mi@gfz-potsdam.de>
License: GPLv3
Project-URL: Home, https://pyrocko.org
Project-URL: GitHub, https://github.com/pyrocko/kite
Project-URL: Issues, https://github.com/pyrocko/kite/issues
Keywords: InSAR,satellite,radar,earthquake,optimization
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Classifier: Topic :: Scientific/Engineering :: Image Recognition
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: C
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: numpy (>=1.17.3)
Requires-Dist: scipy (>=1.8.0)
Requires-Dist: PyQt5 (>=5.15.7)
Requires-Dist: pyqtgraph (==0.12.4)
Requires-Dist: pyrocko (>=2022.06.10)
Requires-Dist: utm (>=0.7.0)
Requires-Dist: geojson (>=2.5.0)
Provides-Extra: development
Requires-Dist: flake8 ; extra == 'development'
Requires-Dist: black ; extra == 'development'
Requires-Dist: pre-commit ; extra == 'development'
Provides-Extra: gdal
Requires-Dist: gdal (>=3.5.0) ; extra == 'gdal'
Provides-Extra: tests
Requires-Dist: pytest ; extra == 'tests'

# Kite

[![Docs](https://img.shields.io/badge/kite-Documentation-blue.svg)](https://pyrocko.org/kite/docs/current/)
[![PyPI](https://img.shields.io/pypi/v/kite)](https://pypi.org/project/kite)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/kite)
[![CI](https://github.com/pyrocko/kite/actions/workflows/build-wheels.yaml/badge.svg)](https://github.com/pyrocko/kite/actions/workflows/build-wheels.yaml)
<a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>

_Preparation of InSAR surface displacement maps for geophysical modelling_

## Installation

Install from pip:

```sh
pip install kite
```

With additional gdal dependency, used for GeoTIFF (GACOS and LiCSAR):

```sh
pip install kite[gdal]
```

## Introduction

This framework is streamlining InSAR displacement processing routines for earthquake inversion through [Pyrocko](https://www.pyrocko.org) and Grond.

Kite features simple and efficient handling of displacement data:

* Import InSAR displacement data from GAMMA, ISCE, GMTSAR, ROI_PAC, SARScape, [COMET LiCSAR](https://comet.nerc.ac.uk/COMET-LiCS-portal/), [SNAP](https://step.esa.int/main/toolboxes/snap/) and Matlab
* Import of average timeseries from [STAMPS](https://homepages.see.leeds.ac.uk/~earahoo/stamps/) and German [BodenBewegungsDienst](https://bodenbewegungsdienst.bgr.de)
* **Quadtree** calculation for data reduction
* **Covariance** estimation from data noise
* **APS removal** from [GACOS](http://ceg-research.ncl.ac.uk/v2/gacos/) atmoshperic models and empirical elevation correlation

## Citation

Recommended citation for Kite

> Isken, Marius; Sudhaus, Henriette; Heimann, Sebastian; Steinberg, Andreas; Daout, Simon; Vasyura-Bathke, Hannes (2017): Kite - Software for Rapid Earthquake Source Optimisation from InSAR Surface Displacement. V. 0.1. GFZ Data Services. <http://doi.org/10.5880/GFZ.2.1.2017.002>

[![DOI](https://img.shields.io/badge/DOI-10.5880%2FGFZ.2.1.2017.002-blue.svg)](http://doi.org/10.5880/GFZ.2.1.2017.002)

# Documentation

Find the documentation at <https://pyrocko.org/kite/docs/current/>.

## Short Example

```python
from kite import Scene

# Import Matlab container to kite
scene = Scene.load('SNAP_data/')
scene.spool()  # start the GUI for data inspection and Quadtree parametrisation
```

Visual parametrisation of the quadtree and spatial covariance for SLC and InSAR time-series.

![L'Aquila earthquake unwrapped displacement data](https://pyrocko.org/grond/docs/current/_images/example_spool-quadtree.png)
