High resolution wrapped phase estimation for InSAR using combined PS/DS processing.
The following will install dolphin
into a conda environment.
- Download source code:
git clone https://github.com/opera-adt/dolphin.git && cd dolphin
- Install dependencies:
conda env create --file conda-env.yml
or if you have an existing environment:
conda env update --name my-existing-env --file conda-env.yml
- Install
dolphin
via pip:
conda activate dolphin-env
python -m pip install .
The main entry point for running the phase estimation workflow is named dolphin
, which has two subcommands:
dolphin config
: create a workflow configuration file.dolphin run
: run the workflow using this file.
Example usage:
$ dolphin config --slc-files /path/to/slcs/*tif
$ dolphin run dolphin_config.yaml
The config
command creates a YAML file (by default dolphin_config.yaml
in the current directory).
The only required inputs for the workflow is a list of coregistered SLC files (in either geographic or radar coordinates). If the SLC files are spread over multiple files, you can either
- use the
--slc-files
option with a bash glob pattern, (e.g.dolphin config --slc-files merged/SLC/*/*.slc
would match the ISCE2 stack processor output ) - Store all input SLC files in a text file delimited by newlines (e.g.
my_slc_list.txt
), and give the name of this text file prefixed by the@
character (e.g.dolphin config --slc-files @my_slc_list.txt
)
The full set of options is written to the configuration file; you can edit this file, or you can see which commonly tuned options by are changeable running dolphin config --help
.
See the documentation for more details.
This software is licensed under your choice of BSD-3-Clause or Apache-2.0 licenses. See the accompanying LICENSE file for further details.
SPDX-License-Identifier: BSD-3-Clause OR Apache-2.0