Skip to content

Repository files navigation

Spatial-VTK

CI Docs PyPI Python License

spatial-vtk provides spatial validation tools for ground-motion simulations, with data QC, residual and metric calculations, geologic metadata integration, spatial statistics, mapping, and dashboard preparation for understanding model performance patterns.

For more details, check out the the public documentation here!

Spatial-VTK workflow

Quick References

Install

The package can be installed from PyPI using:

python -m pip install spatial-vtk

Or create the conda environment and install from a source checkout:

conda env create -f svtk_environment.yaml
conda activate spatial-vtk
python -m pip install -e .

The package imports as spatial_vtk and installs the svtk command:

python -c "import spatial_vtk; print(spatial_vtk.__version__)"
svtk --help

Package Structure Overview

  • spatial_vtk.io: metadata preparation, input inventories, waveform preprocessing, manifests, and waveform format helpers.
  • spatial_vtk.config: repository paths, bounds, and runtime settings.
  • spatial_vtk.qc: quality-control build, review, and summary workflows.
  • spatial_vtk.metrics: ground-motion metric and residual calculations.
  • spatial_vtk.spatial: metric-field preparation, spatial correlation, PCA spatial modes, REDCAP and residual-feature clustering, geology joins, pattern tests, plots, and map helpers.
  • spatial_vtk.visualize: context figures, QC views, and dashboard data.
  • spatial_vtk.cli: command-line entry points.

Issues/Questions/Troubleshooting

Review the documentation, particularly the examples and troubleshooting pages. Still having problems or have suggestions for useful additions to the package? Shoot me an email at birkel@usc.edu or open an issue on GitHub.

Happy validating!

About

Spatial validation tools for ground-motion simulations.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages