Package: seiscat
SeisCatKeep a local seismic catalog.Copyright (c) 2022-2023 Claudio Satrianosatriano@ipgp.frOverviewSeisCat is a command line tool to keep a local seismic catalog.
The local catalog can be used as a basis for further analyses.The seismic catalog is built and updated by querying a FDSNWS event webservice.
More ways of feeding the catalog will be added in the future.The local catalog is stored in a SQLite database (single file database).👇  See below on how toinstallandget started.📖 Check out the official documentationhere.Getting StartedTo get help:seiscat -hFirst thing to do is to generate a sample configuration file:seiscat sampleconfigThen, edit the configuration file and init the database:seiscat initdbTo keep the database updated, run on a regular basis:seiscat updatedb(This will use the configuration parameterrecheck_periodto recheck the
lastndays or hours).You can edit the attributes of specific events in the database using:seiscat editdbYou can print the catalog to screen:seiscat printOr plot it:seiscat plotEach of the above commands can have its own options.
As an example, to discover the options for theplotcommand, try:seiscat plot -hSeisCat supports command line tab completion for arguments, thanks toargcomplete.
To enable command line tab completion run:activate-global-python-argcomplete(This is a one-time command that needs to be run only once).Or, alternatively, add the following line to your.bashrcor.zshrc:eval "$(register-python-argcomplete seiscat)"InstallationInstalling the latest releaseUsing pip and PyPI (preferred method)The latest release of SeisCat is available on thePython Package Index.You can install it easily throughpip:pip install seiscatTo upgrade from a previously installed version:pip install --upgrade seiscatFrom SeisCat GitHub releasesDownload the latest release from thereleases page,
inziportar.gzformat, then:pip install seiscat-X.Y.ziporpip install seiscat-X.Y.tar.gzWhere,X.Yis the version number (e.g.,0.1).
You don't need to uncompress the release files yourself.Installing a developer snapshotIf you need a recent feature that is not in the latest release (see theunreleasedsection inCHANGELOG), you want to use the more
recent development snapshot from theSeisCat GitHub repository.Using pip (preferred method)The easiest way to install the most recent development snapshot is to download
and install it throughpip, using its builtingitclient:pip install git+https://github.com/SeismicSource/seiscat.gitRun this command again, from times to times, to keep SeisCat updated with
the development version.Cloning the SeisCat GitHub repositoryIf you want to take a look at the source code (and possibly modify it 😉),
clone the project usinggit:git clone https://github.com/SeismicSource/seiscat.gitor, using SSH:git clone git@github.com:SeismicSource/seiscat.git(avoid using the "Download ZIP" option from the green "Code" button, since
version number is lost).Then, go into theseiscatmain directory and install the code in "editable
mode" by running:pip install -e .You can keep your local SeisCat repository updated by runninggit pullfrom times to times. Thanks topip's "editable mode", you don't need to
reinstall SeisCat after each update.Getting Help / Reporting Bugs🙏 I need helpPlease open anIssue.🐞 I found a bugPlease open anIssue.ContributingI'm very open to contributions: if you have new ideas, please open anIssue.
Don't hesitate sending me pull requests with new features and/or bugfixes!