# growclust

Python reimplementation of [GrowClust](https://github.com/dttrugman/GrowClust), a program for the relative relocation of earthquake hypocenters based on waveform cross-correlation data.

## Installation

```bash
pip install growclust
```

## Usage

```bash
growclust ssprings.inp
```

```python
from growclust.growclust import run_growclust

run_growclust("ssprings.inp")
```

## Validation

See [docs/validate_fortran_consistency.ipynb](docs/validate_fortran_consistency.ipynb) for a step-by-step comparison with the original Fortran code.

## References

- Trugman, D. T., & Shearer, P. M. (2017). GrowClust: A hierarchical clustering algorithm for relative earthquake relocation, with application to the Spanish Springs and Sheldon, Nevada, earthquake sequences. *Seismological Research Letters*, 88(2A), 379-391.
