{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Event Bank\n", "\n", "The EventBank class is used to interact with a local directory of event files. The `get_events` method of Event Bank are compatible with the `get_events` method of the FDSN client in obspy. Additionally there are several useful features for managing events on disk. \n", "\n", "\n", "## Quickstart" ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "execution": { "iopub.execute_input": "2024-02-28T22:20:04.190253Z", "iopub.status.busy": "2024-02-28T22:20:04.190079Z", "iopub.status.idle": "2024-02-28T22:20:06.300240Z", "shell.execute_reply": "2024-02-28T22:20:06.299623Z" } }, "outputs": [], "source": [ "import obspy\n", "import obsplus" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "execution": { "iopub.execute_input": "2024-02-28T22:20:06.303233Z", "iopub.status.busy": "2024-02-28T22:20:06.302681Z", "iopub.status.idle": "2024-02-28T22:20:06.404251Z", "shell.execute_reply": "2024-02-28T22:20:06.403623Z" } }, "outputs": [], "source": [ "%%capture\n", "# make sure the dataset is downloaded and supress output.\n", "obsplus.load_dataset('crandall_test')" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "execution": { "iopub.execute_input": "2024-02-28T22:20:06.407022Z", "iopub.status.busy": "2024-02-28T22:20:06.406660Z", "iopub.status.idle": "2024-02-28T22:20:06.464416Z", "shell.execute_reply": "2024-02-28T22:20:06.463818Z" } }, "outputs": [ { "data": { "text/plain": [ "EventBank(base_path=/tmp/tmpfpqpe12v/crandall_test/events)" ] }, "execution_count": 3, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# copy the Crandall dataset to a temporary directory\n", "crandall = obsplus.copy_dataset('crandall_test')\n", "\n", "# path to directory where events are stored\n", "event_path = crandall.event_path\n", "\n", "# init an EventBank instance\n", "bank = obsplus.EventBank(event_path)\n", "\n", "# ensure index is up-to-date\n", "bank.update_index() " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Accessing the index \n", "The index can be accessed directly to get a summary of the events contained in the archive. Depending on the task, it may be more natural to work with the index dataframe rather than the obspy catalog objects directly." ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "execution": { "iopub.execute_input": "2024-02-28T22:20:06.492737Z", "iopub.status.busy": "2024-02-28T22:20:06.492539Z", "iopub.status.idle": "2024-02-28T22:20:06.521852Z", "shell.execute_reply": "2024-02-28T22:20:06.521255Z" } }, "outputs": [ { "data": { "text/html": [ "
\n", " | time | \n", "latitude | \n", "longitude | \n", "depth | \n", "magnitude | \n", "event_description | \n", "associated_phase_count | \n", "azimuthal_gap | \n", "event_id | \n", "horizontal_uncertainty | \n", "... | \n", "standard_error | \n", "used_phase_count | \n", "station_count | \n", "vertical_uncertainty | \n", "updated | \n", "author | \n", "agency_id | \n", "creation_time | \n", "version | \n", "path | \n", "
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | \n", "2007-08-06 08:48:40.010 | \n", "39.4635 | \n", "-111.2277 | \n", "410.0 | \n", "4.37 | \n", "LR | \n", "0.0 | \n", "NaN | \n", "smi:local/248839 | \n", "NaN | \n", "... | \n", "1.7356 | \n", "0.0 | \n", "134.0 | \n", "NaN | \n", "2024-02-28 22:19:00.794070528 | \n", "DC | \n", "NIOSH | \n", "2018-10-10 20:33:13.618111 | \n", "\n", " | 2007/08/06/2007-08-06T08-48-40_48839.xml | \n", "
1 | \n", "2007-08-07 02:14:24.080 | \n", "39.4632 | \n", "-111.2230 | \n", "4180.0 | \n", "1.26 | \n", "LR | \n", "0.0 | \n", "NaN | \n", "smi:local/248883 | \n", "NaN | \n", "... | \n", "0.8834 | \n", "0.0 | \n", "14.0 | \n", "NaN | \n", "2024-02-28 22:19:00.794070528 | \n", "DC | \n", "NIOSH | \n", "2018-10-10 21:10:26.864045 | \n", "\n", " | 2007/08/07/2007-08-07T02-14-24_48883.xml | \n", "
2 | \n", "2007-08-07 03:44:18.470 | \n", "39.4625 | \n", "-111.2152 | \n", "4160.0 | \n", "1.45 | \n", "LR | \n", "0.0 | \n", "NaN | \n", "smi:local/248887 | \n", "NaN | \n", "... | \n", "0.5716 | \n", "0.0 | \n", "15.0 | \n", "NaN | \n", "2024-02-28 22:19:00.798070784 | \n", "DC | \n", "NIOSH | \n", "2018-10-10 21:10:27.576204 | \n", "\n", " | 2007/08/07/2007-08-07T03-44-18_48887.xml | \n", "
3 | \n", "2007-08-07 07:13:05.760 | \n", "39.4605 | \n", "-111.2242 | \n", "3240.0 | \n", "2.24 | \n", "\n", " | 0.0 | \n", "NaN | \n", "smi:local/248891 | \n", "NaN | \n", "... | \n", "0.9901 | \n", "0.0 | \n", "35.0 | \n", "NaN | \n", "2024-02-28 22:19:00.802070528 | \n", "\n", " | \n", " | NaT | \n", "\n", " | 2007/08/07/2007-08-07T07-13-05_48891.xml | \n", "
4 | \n", "2007-08-07 02:05:04.490 | \n", "39.4648 | \n", "-111.2255 | \n", "1790.0 | \n", "2.08 | \n", "LR | \n", "0.0 | \n", "NaN | \n", "smi:local/248882 | \n", "NaN | \n", "... | \n", "0.9935 | \n", "0.0 | \n", "35.0 | \n", "NaN | \n", "2024-02-28 22:19:00.806070528 | \n", "DC | \n", "NIOSH | \n", "2018-10-10 21:15:19.190404 | \n", "\n", " | 2007/08/07/2007-08-07T02-05-04_48882.xml | \n", "
5 | \n", "2007-08-06 10:47:25.600 | \n", "39.4615 | \n", "-111.2317 | \n", "2050.0 | \n", "1.57 | \n", "LR | \n", "0.0 | \n", "NaN | \n", "smi:local/248843 | \n", "NaN | \n", "... | \n", "0.8237 | \n", "0.0 | \n", "29.0 | \n", "NaN | \n", "2024-02-28 22:19:00.810070528 | \n", "DC | \n", "NIOSH | \n", "2018-10-10 20:33:27.110914 | \n", "\n", " | 2007/08/06/2007-08-06T10-47-25_48843.xml | \n", "
6 | \n", "2007-08-07 21:42:51.130 | \n", "39.4627 | \n", "-111.2200 | \n", "4620.0 | \n", "1.65 | \n", "\n", " | 0.0 | \n", "NaN | \n", "smi:local/248925 | \n", "NaN | \n", "... | \n", "0.5704 | \n", "0.0 | \n", "19.0 | \n", "NaN | \n", "2024-02-28 22:19:00.814070784 | \n", "DC | \n", "NIOSH | \n", "2018-10-11 22:08:54.236916 | \n", "\n", " | 2007/08/07/2007-08-07T21-42-51_48925.xml | \n", "
7 | \n", "2007-08-06 01:44:48.810 | \n", "39.4617 | \n", "-111.2378 | \n", "6570.0 | \n", "1.78 | \n", "LR | \n", "0.0 | \n", "NaN | \n", "smi:local/248828 | \n", "NaN | \n", "... | \n", "0.8936 | \n", "0.0 | \n", "23.0 | \n", "NaN | \n", "2024-02-28 22:19:00.818070528 | \n", "DC | \n", "NIOSH | \n", "2018-10-10 20:26:49.642650 | \n", "\n", " | 2007/08/06/2007-08-06T01-44-48_48828.xml | \n", "
8 rows × 28 columns
\n", "