# nasaarset/nisar_surface_displacement architecture

> Architecture diagram of the GitHub repository nasaarset/nisar_surface_displacement, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nasaarset/nisar_surface_displacement
- Repository: https://github.com/nasaarset/nisar_surface_displacement

## Overview

This repository is an ARSET training product: notebooks and presentations teach disaster-focused analysis of NISAR and OPERA surface displacement. The principal workflow is to access displacement data, visualize and process time series, then interpret movement extent and magnitude for hazards. Separate notebook paths cover NISAR/MintPy and OPERA exploration/processing; the README also describes InSAR capabilities, limitations, product selection, and hazard analysis. Source excerpts show the download utilities and their external data lookups; notebook internals were not sampled, so their detailed connections are not inferred.

Main entry points: [`code/Part_2/OPERA_download_utils.py`](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_2/OPERA_download_utils.py) (DISP-S1 static layers), [`code/Part_1/smallbaselineApp_nisar-LA_A34.ipynb`](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_1/smallbaselineApp_nisar-LA_A34.ipynb) (NISAR MintPy), [`code/Part_2/opera-disp-02-mintpy-f11115.ipynb`](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_2/opera-disp-02-mintpy-f11115.ipynb) (OPERA MintPy), [`code/Part_1/NISAR_utils.py`](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_1/NISAR_utils.py) (NISAR data access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_training["Training materials"]
  node_objectives["InSAR and hazards<br/>[README.md]"]
  node_interpretation["Hazard interpretation<br/>[README.md]"]
  node_presentations["Course presentations"]
end

subgraph group_nisar["NISAR workflow"]
  node_nisar_notebook["NISAR MintPy"]
  node_nisar_utils["NISAR utilities<br/>[NISAR_utils.py]"]
  node_nisar_access["NISAR data access<br/>[NISAR_utils.py]"]
  node_nisar_processing["Time-series processing"]
end

subgraph group_opera["OPERA workflow"]
  node_opera_explore["OPERA exploration"]
  node_opera_processing["OPERA MintPy"]
  node_opera_utils["OPERA download and crop"]
  node_opera_access["DISP-S1 static layers"]
end

subgraph group_services["Data services"]
  node_asf{{"ASF search and download"}}
  node_cmr{{"NASA CMR"}}
  node_earthdata{{"Earthdata credentials"}}
end

node_attendee(("Learner"))

node_attendee -->|"learns"| node_objectives
node_attendee -->|"uses"| node_nisar_notebook
node_attendee -->|"uses"| node_opera_explore
node_attendee -->|"uses"| node_opera_processing
node_attendee -->|"studies"| node_presentations
node_nisar_notebook -.->|"accesses data"| node_nisar_access
node_nisar_access -->|"searches and downloads"| node_asf
node_nisar_utils -->|"provides"| node_nisar_access
node_nisar_notebook -.->|"processes time series"| node_nisar_processing
node_opera_explore -.->|"accesses layers"| node_opera_access
node_opera_processing -.->|"uses cropped layers"| node_opera_access
node_opera_utils -->|"implements"| node_opera_access
node_opera_access -->|"looks up URLs"| node_cmr
node_opera_access -->|"gets credentials"| node_earthdata
node_nisar_processing -->|"supports assessment"| node_interpretation
node_opera_processing -->|"supports assessment"| node_interpretation
node_objectives -->|"sets learning goals"| node_interpretation

click node_objectives "https://github.com/nasaarset/nisar_surface_displacement/blob/main/README.md"
click node_nisar_notebook "https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_1/smallbaselineApp_nisar-LA_A34.ipynb"
click node_nisar_utils "https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_1/NISAR_utils.py"
click node_nisar_access "https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_1/NISAR_utils.py"
click node_nisar_processing "https://github.com/nasaarset/nisar_surface_displacement/tree/main/code/Part_1"
click node_opera_explore "https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_2/opera-disp-01-explore-f11115.ipynb"
click node_opera_processing "https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_2/opera-disp-02-mintpy-f11115.ipynb"
click node_opera_utils "https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_2/OPERA_download_utils.py"
click node_opera_access "https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_2/OPERA_download_utils.py"
click node_interpretation "https://github.com/nasaarset/nisar_surface_displacement/blob/main/README.md"
click node_presentations "https://github.com/nasaarset/nisar_surface_displacement/tree/main/presentations"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_objectives,node_interpretation,node_presentations toneBlue
class node_nisar_notebook,node_nisar_utils,node_nisar_access,node_nisar_processing toneAmber
class node_opera_explore,node_opera_processing,node_opera_utils,node_opera_access toneMint
class node_asf,node_cmr,node_earthdata toneRose
class node_attendee toneIndigo
```

## Components

### Training materials

- [InSAR and hazards](https://github.com/nasaarset/nisar_surface_displacement/blob/main/README.md): `README.md`
- [Hazard interpretation](https://github.com/nasaarset/nisar_surface_displacement/blob/main/README.md): `README.md`
- [Course presentations](https://github.com/nasaarset/nisar_surface_displacement/tree/main/presentations): `presentations`

### NISAR workflow

- [NISAR MintPy](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_1/smallbaselineApp_nisar-LA_A34.ipynb): `code/Part_1/smallbaselineApp_nisar-LA_A34.ipynb`
- [NISAR utilities](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_1/NISAR_utils.py): `code/Part_1/NISAR_utils.py`
- [NISAR data access](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_1/NISAR_utils.py): `code/Part_1/NISAR_utils.py`
- [Time-series processing](https://github.com/nasaarset/nisar_surface_displacement/tree/main/code/Part_1): `code/Part_1`

### OPERA workflow

- [OPERA exploration](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_2/opera-disp-01-explore-f11115.ipynb): `code/Part_2/opera-disp-01-explore-f11115.ipynb`
- [OPERA MintPy](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_2/opera-disp-02-mintpy-f11115.ipynb): `code/Part_2/opera-disp-02-mintpy-f11115.ipynb`
- [OPERA download and crop](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_2/OPERA_download_utils.py): `code/Part_2/OPERA_download_utils.py`
- [DISP-S1 static layers](https://github.com/nasaarset/nisar_surface_displacement/blob/main/code/Part_2/OPERA_download_utils.py): `code/Part_2/OPERA_download_utils.py`

### Data services

- **ASF search and download**
- **NASA CMR**
- **Earthdata credentials**

### Other components

- **Learner**

## Connections

- Learner → InSAR and hazards: learns (evidence: `README.md`)
- Learner → NISAR MintPy: uses (evidence: `README.md`)
- Learner → OPERA exploration: uses (evidence: `README.md`)
- Learner → OPERA MintPy: uses (evidence: `README.md`)
- Learner → Course presentations: studies (evidence: `README.md`)
- NISAR MintPy → NISAR data access: accesses data
- NISAR data access → ASF search and download: searches and downloads (evidence: `code/Part_1/NISAR_utils.py`)
- NISAR utilities → NISAR data access: provides (evidence: `code/Part_1/NISAR_utils.py`)
- NISAR MintPy → Time-series processing: processes time series
- OPERA exploration → DISP-S1 static layers: accesses layers
- OPERA MintPy → DISP-S1 static layers: uses cropped layers
- OPERA download and crop → DISP-S1 static layers: implements (evidence: `code/Part_2/OPERA_download_utils.py`)
- DISP-S1 static layers → NASA CMR: looks up URLs (evidence: `code/Part_2/OPERA_download_utils.py`)
- DISP-S1 static layers → Earthdata credentials: gets credentials (evidence: `code/Part_2/OPERA_download_utils.py`)
- Time-series processing → Hazard interpretation: supports assessment (evidence: `README.md`)
- OPERA MintPy → Hazard interpretation: supports assessment (evidence: `README.md`)
- InSAR and hazards → Hazard interpretation: sets learning goals (evidence: `README.md`)
