{"id":47836749,"url":"https://github.com/seismicsource/seiscat","last_synced_at":"2026-04-17T18:01:05.784Z","repository":{"id":177523404,"uuid":"521227736","full_name":"SeismicSource/seiscat","owner":"SeismicSource","description":"Keep a local seismic catalog","archived":false,"fork":false,"pushed_at":"2026-04-15T16:01:39.000Z","size":564,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-15T16:38:19.696Z","etag":null,"topics":["earthquake-catalogs","earthquake-data","earthquake-source","earthquake-visualization","earthquakes","seismic","seismic-catalogs","seismic-data","seismic-source"],"latest_commit_sha":null,"homepage":"https://seiscat.seismicsource.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SeismicSource.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":".zenodo.json","notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-08-04T10:48:25.000Z","updated_at":"2026-04-15T16:01:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"25ad3de9-a093-4aca-8925-e72464b17046","html_url":"https://github.com/SeismicSource/seiscat","commit_stats":{"total_commits":95,"total_committers":1,"mean_commits":95.0,"dds":0.0,"last_synced_commit":"94496d2db535e5f28b84ab9bd1251ee5250aef3d"},"previous_names":["seismicsource/seiscat"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/SeismicSource/seiscat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SeismicSource%2Fseiscat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SeismicSource%2Fseiscat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SeismicSource%2Fseiscat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SeismicSource%2Fseiscat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SeismicSource","download_url":"https://codeload.github.com/SeismicSource/seiscat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SeismicSource%2Fseiscat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31851057,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["earthquake-catalogs","earthquake-data","earthquake-source","earthquake-visualization","earthquakes","seismic","seismic-catalogs","seismic-data","seismic-source"],"created_at":"2026-04-03T20:33:29.121Z","updated_at":"2026-04-17T18:01:05.778Z","avatar_url":"https://github.com/SeismicSource.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"imgs/SeisCat_logo.svg\" width=\"400\"\u003e\n\n# SeisCat\n\nKeep a local seismic catalog.\n\n[![changelog-badge]][changelog-link]\n[![PyPI-badge]][PyPI-link]\n[![license-badge]][license-link]\n[![docs-badge]][docs-link]\n[![DeepWiki-badge]][DeepWiki-link]\n[![codecov-badge]][codecov-link]\n[![DOI-badge]][DOI-link]\n\nCopyright (c) 2022-2026 Claudio Satriano \u003csatriano@ipgp.fr\u003e\n\n## Overview\n\nSeisCat is a command-line tool to build, maintain, and query a local seismic\ncatalog.\n\nIt builds and updates the catalog from FDSNWS event web services or local\nevent files. Input formats include CSV and any format handled by ObsPy\n(QuakeML, SC3ML, NLLOC, etc.). The catalog is stored in a SQLite\nsingle-file database and can be used as a basis for further analysis.\n\nSeisCat also provides tools to plot and export the catalog, fetch waveforms\nand station metadata for catalog events, and run user-defined scripts on those\nevents.\n\n👇  See below on how to [install](#installation) and\n[get started](#getting-started).\n\n📖 Check out the official documentation [here](https://seiscat.rtfd.io).\n\n## Getting Started\n\nTo get help:\n\n    seiscat -h\n\nFirst thing to do is to generate a sample configuration file:\n\n    seiscat sampleconfig\n\nThen, edit the configuration file and init the database:\n\n    seiscat initdb\n\nAlternatively, you can init the database from an event file (CSV, QuakeML,\nSC3ML, NLLOC, etc.):\n\n    seiscat initdb -f /path/to/your/catalog.csv\n    seiscat initdb -f /path/to/your/events.xml\n\nTo update an existing database from an FDSN webservice, run:\n\n    seiscat updatedb\n\n(This will use the configuration parameter `recheck_period` to recheck the\nlast *n* days or hours).\n\nAlternatively, you can update the database from an event file:\n\n    seiscat updatedb -f /path/to/your/catalog.csv\n    seiscat updatedb -f /path/to/your/events.xml\n\nYou can edit the attributes of specific events in the database using:\n\n    seiscat editdb\n\nYou can print the catalog to screen:\n\n    seiscat print\n\nOr plot it:\n\n    seiscat plot\n\nEach of the above commands can have its own options.\nAs an example, to discover the options for the `plot` command, try:\n\n    seiscat plot -h\n\nSeisCat supports command line tab completion for arguments, thanks to\n[argcomplete](https://kislyuk.github.io/argcomplete/).\nTo enable command line tab completion run:\n\n    activate-global-python-argcomplete\n\n(This is a one-time command that needs to be run only once).\n\nOr, alternatively, add the following line to your `.bashrc` or `.zshrc`:\n\n    eval \"$(register-python-argcomplete seiscat)\"\n\n## Installation\n\n### Installing the latest release\n\n#### Using pip and PyPI (preferred method)\n\nThe latest release of SeisCat is available on the\n[Python Package Index](https://pypi.org/project/seiscat/).\n\nYou can install it easily through `pip`:\n\n    pip install seiscat\n\nOptional plotting backends can be installed with extras:\n\n    pip install seiscat[cartopy]\n    pip install seiscat[plotly]\n    pip install seiscat[cartopy,plotly]\n\nTo upgrade from a previously installed version:\n\n    pip install --upgrade seiscat\n\n#### From SeisCat GitHub releases\n\nDownload the latest release from the\n[releases page](https://github.com/SeismicSource/seiscat/releases),\nin `zip` or `tar.gz` format, then:\n\n    pip install seiscat-X.Y.zip\n\nor\n\n    pip install seiscat-X.Y.tar.gz\n\nWhere, `X.Y` is the version number (e.g., `0.1`).\nYou don't need to uncompress the release files yourself.\n\n### Installing a developer snapshot\n\nIf you need a recent feature that is not in the latest release (see the\n`unreleased` section in [CHANGELOG][changelog-link]), you want to use the more\nrecent development snapshot from the\n[SeisCat GitHub repository](https://github.com/SeismicSource/seiscat).\n\n#### Using pip (preferred method)\n\nThe easiest way to install the most recent development snapshot is to download\nand install it through `pip`, using its builtin `git` client:\n\n    pip install git+https://github.com/SeismicSource/seiscat.git\n\nRun this command again, from times to times, to keep SeisCat updated with\nthe development version.\n\n### Cloning the SeisCat GitHub repository\n\nIf you want to take a look at the source code (and possibly modify it 😉),\nclone the project using `git`:\n\n    git clone https://github.com/SeismicSource/seiscat.git\n\nor, using SSH:\n\n    git clone git@github.com:SeismicSource/seiscat.git\n\n(avoid using the \"Download ZIP\" option from the green \"Code\" button, since\nversion number is lost).\n\nThen, go into the `seiscat` main directory and install the code in \"editable\nmode\" by running:\n\n    pip install -e .\n\nTo install optional plotting backends in editable mode:\n\n    pip install -e .[cartopy]\n    pip install -e .[plotly]\n    pip install -e .[cartopy,plotly]\n\nYou can keep your local SeisCat repository updated by running `git pull`\nfrom times to times. Thanks to `pip`'s \"editable mode\", you don't need to\nreinstall SeisCat after each update.\n\n## Getting Help / Reporting Bugs\n\n### 🙏 I need help\n\nPlease open an [Issue][Issues].\n\n### 🐞 I found a bug\n\nPlease open an [Issue][Issues].\n\n## Contributing\n\nI'm very open to contributions: if you have new ideas, please open an\n[Issue][Issues].\nDon't hesitate sending me pull requests with new features and/or bugfixes!\n\n\u003c!-- Badges and project links --\u003e\n[changelog-badge]: https://img.shields.io/badge/Changelog-136CB6.svg\n[changelog-link]: CHANGELOG.md\n[PyPI-badge]: http://img.shields.io/pypi/v/seiscat.svg\n[PyPI-link]: https://pypi.python.org/pypi/seiscat\n[license-badge]: https://img.shields.io/badge/license-GPLv3-green\n[license-link]: https://www.gnu.org/licenses/gpl-3.0.html\n[docs-badge]: https://readthedocs.org/projects/seiscat/badge/?version=latest\n[docs-link]: https://seiscat.readthedocs.io/en/latest/?badge=latest\n[DOI-badge]: https://zenodo.org/badge/DOI/10.5281/zenodo.19596891.svg\n[DOI-link]: https://doi.org/10.5281/zenodo.19596891\n[Issues]: https://github.com/SeismicSource/seiscat/issues\n[codecov-badge]: https://codecov.io/github/SeismicSource/seiscat/graph/badge.svg?token=X0Z60185PC\n[codecov-link]: https://codecov.io/github/SeismicSource/seiscat\n[DeepWiki-badge]: https://deepwiki.com/badge.svg\n[DeepWiki-link]: https://deepwiki.com/SeismicSource/seiscat\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseismicsource%2Fseiscat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseismicsource%2Fseiscat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseismicsource%2Fseiscat/lists"}