utdquake 0.1__tar.gz → 0.2__tar.gz

{utdquake-0.1/utdquake.egg-info → utdquake-0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: utdquake
-Version: 0.1
+Version: 0.2
 Summary: University of Texas at Dallas Earthquake Dataset
 Home-page: https://github.com/ecastillot/UTDQuake
 Author: ecastillot (Emmanuel Castillo)
@@ -22,6 +22,7 @@ Requires-Dist: pandas
 Requires-Dist: pyarrow
 Requires-Dist: numpy
 Requires-Dist: matplotlib
+Requires-Dist: scikit-learn
 Requires-Dist: seaborn
 Requires-Dist: packaging
 Requires-Dist: scipy
@@ -38,19 +39,32 @@ Dynamic: requires-python
 Dynamic: summary
 
 
-[![LinkedIn](https://img.shields.io/badge/LinkedIn-Follow-blue?logo=linkedin)](https://www.linkedin.com/in/ecastillot/) ![GitHub followers](https://img.shields.io/github/followers/ecastillot?style=social)  ![GitHub stars](https://img.shields.io/github/stars/ecastillot/UTDQuake?style=social) ![GitHub forks](https://img.shields.io/github/forks/ecastillot/UTDQuake?style=social)
+[![PyPI](https://img.shields.io/pypi/v/utdquake?color=orange&label=PyPI&style=flat)](https://pypi.org/project/utdquake/) ![GitHub stars](https://img.shields.io/github/stars/ecastillot/UTDQuake?style=social) ![GitHub forks](https://img.shields.io/github/forks/ecastillot/UTDQuake?style=social) ![GitHub followers](https://img.shields.io/github/followers/ecastillot?style=social) [![LinkedIn](https://img.shields.io/badge/LinkedIn-Follow-blue?logo=linkedin)](https://www.linkedin.com/in/ecastillot/) 
 
 
+<img src="docs/source/_static/logo/utdquake_logo_ok.png" alt="seismonitor" width="150"> 
 
+<!--
 # <span style="background:#E87500; color:white; padding:2px 6px; border-radius:6px;">UTD</span>Quake
+-->
 
-University of Texas at Dallas Earthquake Dataset
+**University of Texas at Dallas Earthquake Dataset**
 
-## Authors
-- Emmanuel Castillo (emmanuel.castillotaborda@utdallas.edu)
-- Nadine Ushakov (nadine.igonin@utdallas.edu)
-- Marine Denolle (mdenolle@uw.edu)
+A global earthquake dataset constructed from high-quality source and receiver metadata, including associated seismic phase picks across diverse station geometries.
 
+![utdquake](figures/utdquake_overview.png)
+
+# Documentation
+
+Full documentation for UTDQuake is available here: 
+
+ [![Read the Docs](https://img.shields.io/badge/Docs-Read%20the%20Docs-blue?style=for-the-badge&logo=read-the-docs)](https://utdquake.readthedocs.io/en/latest/index.html)
+
+You will see:
+
+- QuickStart guide to get you up and running  
+- Detailed API reference  
+- Tutorials and example workflows  
 
 # Dataset
 
@@ -58,6 +72,12 @@ The dataset is available on Hugging Face: **UTDQuake**
 
 [![Hugging Face Dataset](https://img.shields.io/badge/HuggingFace-Dataset-yellow?style=for-the-badge&logo=huggingface&logoColor=black)](https://huggingface.co/datasets/ecastillot/UTDQuake)
 
+
+## Installation ([utdquake](https://pypi.org/project/utdquake))
+```bash
+pip install utdquake
+```
+
 ## Why this dataset matters?
 
 Curated datasets of earthquake **events and phase picks** are essential for modern seismology, especially in the AI era. While waveform datasets have advanced earthquake detection, multistation picks provide complementary information crucial for **phase association** and **earthquake location**.  
@@ -68,10 +88,11 @@ This dataset offers structured event catalogs, station metadata, and phase picks
 
 | Directory   | Format        | Description |
 |------------|---------------|-------------|
-| `bank/`     | `*.zip`       | ObsPlus `EventBank` datasets, one per network. Can be read directly using [ObsPlus EventBank](https://niosh-mining.github.io/obsplus/versions/latest/api/obsplus.bank.eventbank.html). |
+| `network/`   | `*.parquet`   | Network metadata. |
 | `events/`   | `*.parquet`   | Earthquake event catalogs per network. |
 | `stations/` | `*.parquet`   | Station metadata per network. |
 | `picks/`    | `*.parquet`   | Seismic phase pick datasets per network. |
+| `bank/`     | `*.zip`       | ObsPlus `EventBank` datasets, one per network. Can be read directly using [ObsPlus EventBank](https://niosh-mining.github.io/obsplus/versions/latest/api/obsplus.bank.eventbank.html). |
 
 For details on the contents and schema of each dataset, please refer to the [Hugging Face dataset viewer](https://huggingface.co/datasets/ecastillot/UTDQuake/viewer).
 
@@ -150,3 +171,55 @@ Thanks to the [UT Dallas HPC team](https://hpc.utdallas.edu/) for providing the
 We also thank the seismology and AI communities for their work in earthquake research, and Hugging Face for hosting and sharing open datasets.
 
 We welcome feedback and contributions!
+
+# Authors
+
+<table>
+  <tr>
+    <td valign="middle">
+      <strong>Emmanuel Castillo</strong><br>
+      University of Texas at Dallas<br>
+      <a href="https://www.linkedin.com/in/ecastillot/" target="_blank">
+        <img src="https://img.shields.io/badge/LinkedIn-Follow-blue?logo=linkedin&logoColor=white&style=flat" height="20">
+      </a>
+      <a href="mailto:castillo.280997@gmail.com" target="_blank">
+        <img src="https://img.shields.io/badge/Email-Send-red?logo=gmail&logoColor=white&style=flat" height="20">
+      </a>
+    </td>
+    <td width="100" align="center">
+      <img src="docs/source/_static/photos/emmanuel.jpg" alt="Emmanuel" width="80" height="80" style="border-radius:50%; object-fit:cover;">
+    </td>
+  </tr>
+  <tr>
+    <td valign="middle">
+      <strong>Nadine Ushakov</strong><br>
+      University of Texas at Dallas<br>
+      <a href="https://www.linkedin.com/in/nadineushakov/" target="_blank">
+        <img src="https://img.shields.io/badge/LinkedIn-Follow-blue?logo=linkedin&logoColor=white&style=flat" height="20">
+      </a>
+      <a href="mailto:nadine.igonin@utdallas.edu" target="_blank">
+        <img src="https://img.shields.io/badge/Email-Send-red?logo=gmail&logoColor=white&style=flat" height="20">
+      </a>
+    </td>
+    <td width="100" align="center">
+      <img src="docs/source/_static/photos/nadine.jpg" alt="Nadine" width="80" height="80" style="border-radius:50%; object-fit:cover;">
+    </td>
+  </tr>
+  <tr>
+    <td valign="middle">
+      <strong>Marine Denolle</strong><br>
+      University of Washington<br>
+      <a href="https://www.linkedin.com/in/marine-denolle-b528144b/" target="_blank">
+        <img src="https://img.shields.io/badge/LinkedIn-Follow-blue?logo=linkedin&logoColor=white&style=flat" height="20">
+      </a>
+      <a href="mailto:mdenolle@uw.edu" target="_blank">
+        <img src="https://img.shields.io/badge/Email-Send-red?logo=gmail&logoColor=white&style=flat" height="20">
+      </a>
+    </td>
+    <td width="100" align="center">
+      <img src="docs/source/_static/photos/marine.jpg" alt="Marine" width="80" height="80" style="border-radius:50%; object-fit:cover;">
+    </td>
+  </tr>
+</table>
+
+

utdquake-0.2/README.md

@@ -0,0 +1,185 @@
+
+[![PyPI](https://img.shields.io/pypi/v/utdquake?color=orange&label=PyPI&style=flat)](https://pypi.org/project/utdquake/) ![GitHub stars](https://img.shields.io/github/stars/ecastillot/UTDQuake?style=social) ![GitHub forks](https://img.shields.io/github/forks/ecastillot/UTDQuake?style=social) ![GitHub followers](https://img.shields.io/github/followers/ecastillot?style=social) [![LinkedIn](https://img.shields.io/badge/LinkedIn-Follow-blue?logo=linkedin)](https://www.linkedin.com/in/ecastillot/) 
+
+
+<img src="docs/source/_static/logo/utdquake_logo_ok.png" alt="seismonitor" width="150"> 
+
+<!--
+# <span style="background:#E87500; color:white; padding:2px 6px; border-radius:6px;">UTD</span>Quake
+-->
+
+**University of Texas at Dallas Earthquake Dataset**
+
+A global earthquake dataset constructed from high-quality source and receiver metadata, including associated seismic phase picks across diverse station geometries.
+
+![utdquake](figures/utdquake_overview.png)
+
+# Documentation
+
+Full documentation for UTDQuake is available here: 
+
+ [![Read the Docs](https://img.shields.io/badge/Docs-Read%20the%20Docs-blue?style=for-the-badge&logo=read-the-docs)](https://utdquake.readthedocs.io/en/latest/index.html)
+
+You will see:
+
+- QuickStart guide to get you up and running  
+- Detailed API reference  
+- Tutorials and example workflows  
+
+# Dataset
+
+The dataset is available on Hugging Face: **UTDQuake**  
+
+[![Hugging Face Dataset](https://img.shields.io/badge/HuggingFace-Dataset-yellow?style=for-the-badge&logo=huggingface&logoColor=black)](https://huggingface.co/datasets/ecastillot/UTDQuake)
+
+
+## Installation ([utdquake](https://pypi.org/project/utdquake))
+```bash
+pip install utdquake
+```
+
+## Why this dataset matters?
+
+Curated datasets of earthquake **events and phase picks** are essential for modern seismology, especially in the AI era. While waveform datasets have advanced earthquake detection, multistation picks provide complementary information crucial for **phase association** and **earthquake location**.  
+
+This dataset offers structured event catalogs, station metadata, and phase picks across networks, supporting reproducible research and the development of data-driven seismological methods.
+
+## What’s inside?
+
+| Directory   | Format        | Description |
+|------------|---------------|-------------|
+| `network/`   | `*.parquet`   | Network metadata. |
+| `events/`   | `*.parquet`   | Earthquake event catalogs per network. |
+| `stations/` | `*.parquet`   | Station metadata per network. |
+| `picks/`    | `*.parquet`   | Seismic phase pick datasets per network. |
+| `bank/`     | `*.zip`       | ObsPlus `EventBank` datasets, one per network. Can be read directly using [ObsPlus EventBank](https://niosh-mining.github.io/obsplus/versions/latest/api/obsplus.bank.eventbank.html). |
+
+For details on the contents and schema of each dataset, please refer to the [Hugging Face dataset viewer](https://huggingface.co/datasets/ecastillot/UTDQuake/viewer).
+
+To get started, see the [Quick Start](#quick-start) section below, or click **“Use this dataset”** on the Hugging Face dataset page for example loading code.
+
+
+## Quick start
+
+### Basic Access
+```python
+import utdquake as utdq
+
+# dataset overview 
+dataset = utdq.Dataset()
+print(dataset)
+
+# network level
+network_data = dataset.networks
+print(network_data)
+
+dataset.plot_overview(savepath="utdquake.png")
+```
+
+### Network Data
+```python
+# load network 
+network = dataset.get_network(name="tx")
+print(network)
+
+# events
+events = network.events
+print(events)
+
+# stations
+stations = network.stations
+print(stations)
+
+# picks
+picks = network.picks
+print(picks)
+```
+
+### Event Bank
+Check [ObsPlus EventBank](https://niosh-mining.github.io/obsplus/versions/latest/api/obsplus.bank.eventbank.html) for more details.
+```python
+# get event bank
+ebank = network.bank # 
+
+# Example: Filter by event_id
+ev_ids = events["event_id"].iloc[:5].tolist()
+cat = ebank.get_events(event_id=ev_ids)
+print(cat)
+
+# Example 2: Other filter (check obsplus.EventBank for more details)
+cat2 = ebank.get_events(minmagnitude=4.3)
+print(cat2)
+```
+
+
+### Plot
+```python
+# get Obspy Event
+network = dataset.get_network(name="tx")
+network.plot_overview(savepath="overview.png")
+network.plot_uncertainty_boxplots(savepath="uncertainty_boxplots.png")
+network.plot_station_location_uncertainty(savepath="station_location_uncertainty.png")
+network.plot_stats(savepath="stats.png")
+network.plot_pick_histograms(savepath="histograms.png")
+network.plot_pick_stats(savepath="pick_stats.png")
+```
+
+# Thanks
+
+Thanks to the [UT Dallas HPC team](https://hpc.utdallas.edu/) for providing the computational resources for this dataset.  
+
+We also thank the seismology and AI communities for their work in earthquake research, and Hugging Face for hosting and sharing open datasets.
+
+We welcome feedback and contributions!
+
+# Authors
+
+<table>
+  <tr>
+    <td valign="middle">
+      <strong>Emmanuel Castillo</strong><br>
+      University of Texas at Dallas<br>
+      <a href="https://www.linkedin.com/in/ecastillot/" target="_blank">
+        <img src="https://img.shields.io/badge/LinkedIn-Follow-blue?logo=linkedin&logoColor=white&style=flat" height="20">
+      </a>
+      <a href="mailto:castillo.280997@gmail.com" target="_blank">
+        <img src="https://img.shields.io/badge/Email-Send-red?logo=gmail&logoColor=white&style=flat" height="20">
+      </a>
+    </td>
+    <td width="100" align="center">
+      <img src="docs/source/_static/photos/emmanuel.jpg" alt="Emmanuel" width="80" height="80" style="border-radius:50%; object-fit:cover;">
+    </td>
+  </tr>
+  <tr>
+    <td valign="middle">
+      <strong>Nadine Ushakov</strong><br>
+      University of Texas at Dallas<br>
+      <a href="https://www.linkedin.com/in/nadineushakov/" target="_blank">
+        <img src="https://img.shields.io/badge/LinkedIn-Follow-blue?logo=linkedin&logoColor=white&style=flat" height="20">
+      </a>
+      <a href="mailto:nadine.igonin@utdallas.edu" target="_blank">
+        <img src="https://img.shields.io/badge/Email-Send-red?logo=gmail&logoColor=white&style=flat" height="20">
+      </a>
+    </td>
+    <td width="100" align="center">
+      <img src="docs/source/_static/photos/nadine.jpg" alt="Nadine" width="80" height="80" style="border-radius:50%; object-fit:cover;">
+    </td>
+  </tr>
+  <tr>
+    <td valign="middle">
+      <strong>Marine Denolle</strong><br>
+      University of Washington<br>
+      <a href="https://www.linkedin.com/in/marine-denolle-b528144b/" target="_blank">
+        <img src="https://img.shields.io/badge/LinkedIn-Follow-blue?logo=linkedin&logoColor=white&style=flat" height="20">
+      </a>
+      <a href="mailto:mdenolle@uw.edu" target="_blank">
+        <img src="https://img.shields.io/badge/Email-Send-red?logo=gmail&logoColor=white&style=flat" height="20">
+      </a>
+    </td>
+    <td width="100" align="center">
+      <img src="docs/source/_static/photos/marine.jpg" alt="Marine" width="80" height="80" style="border-radius:50%; object-fit:cover;">
+    </td>
+  </tr>
+</table>
+
+

{utdquake-0.1 → utdquake-0.2}/utdquake/__init__.py

@@ -20,9 +20,11 @@ Usage
 >>> net.events.head()
 
 """
-__version__ = "0.1"
+__version__ = "0.2"
 
 from .core.utdquake import Dataset, Network
 from .core.data import download_snapshot, load
+from .core.patch import utdquake_obspy_patch
 
-__all__ = ["Dataset", "Network", "download_snapshot", "load"]
+utdquake_obspy_patch()
+__all__ = ["Dataset", "Network", "download_snapshot", "load"]