Skip to content

Processor

Once you have added a job via Add Job in the Search panel, the job folder appears in the Jobs drawer. Click the Jobs button in the top-right corner of the toolbar to open the drawer.

Jobs Button Jobs Button

The Jobs button in the top-right toolbar opens the Job Folders drawer.

Then click the downloader tag (e.g. S1_SLC) on the job folder to open its detail panel.

Downloader Tag Downloader Tag

Click the downloader tag on a job folder to open its detail panel.

Selecting Pairs

Constructing a well-designed interferometric pair network is a critical step in time-series InSAR analysis. A carefully chosen SBAS network balances temporal and perpendicular baseline constraints to maximize coherence while ensuring full temporal connectivity across the scene stack.

Click Select Pairs to automatically generate an SBAS interferogram network from the downloaded scenes.

Select Pairs Button Select Pairs Button

Click Select Pairs to open the pair network configuration dialog.

A configuration dialog will appear with the following options:

Parameter Description
Target Temporal Baselines Comma-separated list of target temporal separations (days) to form pairs around
Tolerance Allowed deviation (days) from each target baseline when matching scene pairs
Max Temporal Hard upper limit on temporal baseline (days); pairs exceeding this are excluded
Max Perp. Baseline Hard upper limit on perpendicular baseline (m); pairs exceeding this are excluded
Min Connections Minimum number of interferograms each scene must participate in to ensure network connectivity
Max Connections Maximum number of interferograms per scene to avoid redundancy
Force Connected Network When enabled, adds extra pairs as needed to guarantee the network has no isolated nodes

Click Run to generate the network. The resulting pair network is displayed as a baseline–time graph and saved to the job folder.

Pair Network Pair Network

Interferogram pair network generated from the scene stack.

Once pair selection is complete, two viewing options become available:

View Network — displays the interferometric baseline–time graph, showing how scenes are connected across the temporal and perpendicular baseline dimensions.

View Network View Network

Click View Network to open the baseline–time graph.

Network Graph Network Graph

Baseline–time graph showing the interferometric network connectivity.

View Pairs — lists all selected interferometric pairs with their temporal and perpendicular baseline values.

View Pairs View Pairs

List of selected interferometric pairs with baseline information.


Submitting Jobs

Once the pair network is reviewed and satisfactory, click Process to open the processor selection dialog.

Process Button Process Button

Click Process to submit interferogram pairs to HyP3.

Processor Selection Processor Selection

Processor selection dialog. Choose a processor (e.g. Hyp3_InSAR) and confirm to submit all pairs to HyP3.

Test before submitting

For submitting jobs to an external server, check Dry Run in the processor dialog to validate your environment and credentials without submitting real jobs. A successful dry run produces output similar to:

[Dry run] Would submit 65 pairs via Hyp3_InSAR from p93_f121
wrote processor_config.json
marked insarhub_workflow.json processor=Hyp3_InSAR

This is recommended before your first submission to ensure everything is configured correctly.

For a full description of all processor parameters and options, see the Processor Reference.

Once jobs are successfully submitted, a Processor tag with your processor name will appear in the job folder panel, indicating that HyP3 processing is active for this stack.

Processor Tab Processor Tab

The Processor tab appears in the job folder panel after jobs are successfully submitted.


Monitoring Jobs

Once jobs are submitted, a job file is automatically saved to the job folder and loaded by default the next time you open the Processor panel. This allows you to resume monitoring even after closing the application.

A drop-down menu at the top of the Processor panel lists all job files found under the job folder, including the initial submission file (hyp3_jobs.json) and any retry files generated by subsequent Retry actions (e.g. hyp3_retry_jobs_20260306t095505.json). Select a different file from the list to inspect or monitor a specific submission.

Click Refresh to check the latest status of all submitted jobs from HyP3. Each job displays one of the following statuses:

Status Meaning
RUNNING Job is actively being processed on HyP3
SUCCEEDED Processing completed successfully
FAILED Processing failed

Job Status Job Status

The processor job panel

If any jobs have FAILED, click Retry to resubmit them. Once jobs show SUCCEEDED, click Download to fetch the processed interferograms to the work directory.


Other Actions

Button Description
Retry Resubmit all failed jobs to HyP3
Download Download all succeeded interferograms to the work directory
Watch Continuously poll HyP3 until all jobs complete, then download automatically
Credits Check remaining HyP3 processing credits

Once all jobs have succeeded and interferograms are downloaded, proceed to the Analyzer panel to run time-series InSAR analysis.

Analyzer

⚠️ Major Redesign

InSARScript v1.1.0 has change of APIs, this documentation is not compatible with version v1.0.0.