Skip to main content

A Practical Seismological Database Library in Python.

Project description


Pisces is a Python library that connects your geophysical analysis environment to a SQL database that uses the Center for Seismic Studies (CSS) 3.0 or NNSA KB Core table schema.




  • Import/export waveforms directly to/from your database.
  • Build database queries using Python objects and methods (SQLAlchemy), not by concatenating SQL strings.
  • Integration with ObsPy.
  • Geographic filtering of results.



  • ObsPy
  • SQLAlchemy
  • Click
  • C compiler

Install from PyPI:

pip install pisces-db

Install current master from GitHub:

pip install git+

Recent History

(full change log)



  • pisces.util.get_tables, pisces.util.make_tables, and pisces.util.get_or_create_tables are deprecated and will raise a warning.
  • pisces.request.get_waveforms now has a tol keyword that will raise an exception if any returned waveform is not within tol seconds from the requested starttime/endtime.
  • Added --bbfk flag to pisces sac2db, which uses the broadband f-k (BBFK) convention of reading x, y array offset distances in the USER 7, 8 SAC header variables and storing them Site.dnorth and Site.deast.
  • Windows support! Thanks to @mitchburnett! e1 and convert C libraries now build (using MSVC).
  • Automated testing on Mac OSX, Linux, and Windows 7, for Python 2.7 and 3.4, thanks to Travis CI and Appveyor.
  • Require ObsPy > 1.0

Bug fixes

  • Fixed sac2db wfdisc.foff (issue #12) and wfdisc.dir (issue #11) handling.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pisces-db, version 0.2.3
Filename, size File type Python version Upload date Hashes
Filename, size pisces_db-0.2.3-cp27-cp27m-macosx_10_5_x86_64.whl (72.1 kB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size pisces-db-0.2.3.tar.gz (68.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page