pyrocko.squirrel

Prompt seismological data access with a fluffy tail.

../../_images/squirrel.svg

This is the reference manual for the Squirrel framework. It describes the API of the pyrocko.squirrel subpackage. For a conceptual overview see Squirrel - Data access infrastructure. A tutorial describing the API usage is provided at Examples: Squirrel powered data access.

Usage

Public symbols implemented in the various submodules are aggregated into the pyrocko.squirrel namespace for use in user programs:

from pyrocko.squirrel import Squirrel

sq = Squirrel()

Implementation overview

The central class and interface of the framework is Squirrel, part of it is implemented in its base class Selection. Core functionality directly talking to the database is implemented in base, selection and database. The data model of the framework is implemented in model. User project environment detection is implemented in environment. Portable dataset description in dataset. A unified IO interface bridging to various Pyrocko modules outside of the Squirrel framework is available in io. Memory cache management is implemented in cache. Compatibility with Pyrocko’s older waveform archive access module is implemented in pile.

Modules

pyrocko.squirrel.base

Squirrel main classes.

pyrocko.squirrel.cache

Squirrel memory cacheing.

pyrocko.squirrel.check

Functionality to check for common data/metadata problems.

pyrocko.squirrel.client

Squirrel remote data access.

pyrocko.squirrel.database

Database interface code.

pyrocko.squirrel.dataset

Portable dataset description.

pyrocko.squirrel.environment

Manage separate databases and caches for different user projects.

pyrocko.squirrel.error

Squirrel exception definitions.

pyrocko.squirrel.io

Local file reading and indexing.

pyrocko.squirrel.lock

Directory locking utility.

pyrocko.squirrel.model

Data model and content types handled by the Squirrel framework.

pyrocko.squirrel.operators

On-demand data processing pipelines.

pyrocko.squirrel.pile

Emulation of the older pyrocko.pile interface.

pyrocko.squirrel.selection

Meta-data caching for flexible file selections.

pyrocko.squirrel.storage

Waveform data storage utilities.

pyrocko.squirrel.streaming

Real-time streaming support.

pyrocko.squirrel.tool

Squirrel command line tools.