Quickstart

Kite supports importing unwrapped displacement scenes from different InSAR processors:

Each processor delivers different file formats and metadata. In order to import the data into Kite, data has to be prepared. Details for each format are described in kite.scene_io.

Import InSAR displacement

We will start with importing a scene from GMT5SAR.

GMT5SAR is an open-source processor based on GMT. We will import a binary .grd file.
from kite import Scene

# We import a unwrapped interferrogram scene.
# The format shall be detected automatically
# in this case processed a GMTSAR5

sc = Scene.import_data('unwrap_ll.grd')
sc.spool()

Manual scene setup

Initialisation of a custom scene from python is also possible. Here we will import arbitrary data and define the reference frame manually.

Any 2D displacement data can be loaded into Kite, also pixel offsets!
from kite import Scene

sc = Scene()
sc.displacement = num.empty((2048, 2048))

# dummy line-of-sight vectors in radians
sc.theta = num.full((2048, 2048), fill=num.pi/2)
sc.phi = num.full((2048, 2048), fill=num.pi/4)


# Reference the scene's frame
sc.frame.llLat = 38.2095  # Lower-left corner latitude
sc.frame.llLon = 19.1256  # Lower-left corner longitude
sc.frame.dLat = .00005  # Latitudal pixel spacing in degree
sc.frame.dLon = .00012  # Longitudal pixel spacing in degree

Inspect an InSAR scene with spool GUI

You can use start InSAR Scene Inspection with Spool to inspect the scene and manipulate it’s properties.

Kite’s GUI spool is based on Qt5. Here we will import data, straight from a GMT5SAR scene.
from kite import Scene
sc = Scene.import_file('unwrap_ll.grd')
sc.spool()

Alternatively spool can be started from command line

# Start spool and import a displacement scene data
spool --load unwrap_ll.grd

# Or load from Kite format
spool my_scene.yml

Save scene and properties

The native file structure of Kite is based on NumPy binary files together with YAML configuration files which hold the all information to and configurable parameters:

Also the expensive calculation of kite.Covariance.covariance_matrix is saved and preserved in the YAML file!

This code snippet shows how to import data from a foreign file format and transferring it to kite’s native format.

Import data and save it in Kite format.
from kite import Scene

# The .grd is interpreted as an GMT5SAR scene
sc = Scene.import_data('unwrap_ll.grd')

# Writes out the scene in kite's native format
sc.save('kite_scene')

Kite’s file structure consists of only two files:

kite_scene.yml
kite_scene.npz