ECAT Cases

This repository contains research cases, data-preparation workflows, and advanced examples for the ECAT (Earthquake Cycle Analysis Toolkit).

Data Preparation & Downsampling Examples

Topic	Example	Data / Reader	What to Learn	Local Directory
InSAR / offset downsampling overview	InSAR Downsampling	GAMMA, GeoTIFF, GMTSAR direct-projection, adapter	Choose the right reader/mode and convert dense SAR/offset rasters to CSI-style .txt/.rsp/.cov inputs	Details
GAMMA binary products	2022 Menyuan	reader: gamma; unwrapped_phase, range_offset, azimuth_offset	GAMMA .phs/.azi/.inc/.rsc, old Step1/Step2 scripts, and the newer ecat-downsample workflow	Details
GeoTIFF products	Wushi / Chile	reader: gamma_tiff or custom input when needed	GeoTIFF value rasters with azimuth/incidence geometry, unit scaling, and standard downsampling outputs	Details
GMTSAR direct-projection products	Myanmar 2025 / California	reader: gmtsar; los_displacement, range_offset, azimuth_offset	GRD/NetCDF value grids plus ENU projection grids for LOS and pixel-offset tracking products	Details
Adapter and time-series reuse	Menyuan T128A adapter workflow	input_adapter.enabled: true	Replace only the data-loading layer while reusing ECAT covariance, quadtree, reporting, and optional reference-grid logic	Details

For range/azimuth offset YAMLs, prefer a base outName such as S1_T033D; output_suffix: auto adds _RngOff or _AziOff and current ECAT avoids duplicating an existing suffix.

Current rectangular ECAT outputs write 18-column full-corner .rsp files. Legacy 10-column rectangle .rsp files and 8-column triangle .rsp files remain readable through method: from_rsp.

For the maintained user guide, see the ECAT documentation pages for InSAR downsampling, adapter downsampling, and SAR readers.

Method & Inversion Examples

🏷️ Category	⚡ Earthquake Example	📝 Description (Date, Magnitude, Type)	📁 Local Directory
Nonlinear Inversion (Single-seg)	Hotan Earthquake	2020-06-25, Mw6.3, Normal	Details
	Iran Earthquake	2017-04-05, Mw6.1, Reverse	Details
	Taiwan Earthquake	2024-04-05, Mw7.4, Reverse	Details
	Wushi Earthquake	2024-01-22, Mw7.0, Strike-slip	Details
	Western Xizang Earthquake	2019-07-06, Mw6.3, Normal	Details
Nonlinear Inversion (Multi-segs)	Ridgecrest Earthquake Sequence	2020-07-22, Mw7.1, Strike-slip	Details
BLSE Linear Inversion	Dingri Earthquake 2020	2020-03-20, Mw5.7, Normal	Details

Real Earthquake Cases

🌏 Case Name	📝 Description (Date, Magnitude, Type)	📁 Local Directory	🔗 Zenodo DOI	📄 Paper DOI
Dingri Earthquake 2015	2015-04-25, Mw5.7, Normal	Details	Zenodo	He et al., 2026, CEE
Dingri Earthquake 2020	2020-03-20, Mw5.6, Normal	Details	Zenodo	He et al., 2026, CEE
Dingri Earthquake 2025	2025-01-07, Mw7.0, Normal	Details	Zenodo	He et al., 2026, CEE
Sagaing Earthquake 2025	2025-03-28, Mw7.8, Strike-slip	Details	Zenodo	TBD

Usage

Clone this repository to access the cases:

git clone https://github.com/kefuhe/ECAT-cases.git