class MassDownloader(providers=None, debug=False, configure_logging=True)[source]

Bases: object

Class facilitating data acquisition across all FDSN web service implementations.

  • providers (list[str] or Client instances) – List of FDSN client names or service URLS. Will use all FDSN implementations known to ObsPy except RASPISHAKE (generally worse quality data) and IRISPH5 (active source / nodal experiments that might match a very large amount of data occasionally) if set to None. The order in the list also determines their priority, if data is available at more then one provider it will always be downloaded from the provider that comes first in the list. To include RASPISHAKE and IRISPH5, you must set this parameter to obspy.clients.fdsn.header.URL_MAPPINGS explicitly.

  • debug – Debug flag passed to the underlying FDSN web service clients.

Public Methods


Launch the actual data download.

Private Methods


Private methods are mainly for internal/developer use and their API might change without notice.


Initialize all clients.

Special Methods

MassDownloader.__delattr__(name, /)

Implement delattr(self, name).


Default dir() implementation.

MassDownloader.__eq__(value, /)

Return self==value.

MassDownloader.__format__(format_spec, /)

Default object formatter.

MassDownloader.__ge__(value, /)

Return self>=value.

MassDownloader.__getattribute__(name, /)

Return getattr(self, name).

MassDownloader.__gt__(value, /)

Return self>value.


Return hash(self).

MassDownloader.__init__(providers=None, debug=False, configure_logging=True)[source]

This method is called when a class is subclassed.

The default implementation does nothing. It may be overridden to extend subclasses.

MassDownloader.__le__(value, /)

Return self<=value.

MassDownloader.__lt__(value, /)

Return self<value.

MassDownloader.__ne__(value, /)

Return self!=value.


Helper for pickle.

MassDownloader.__reduce_ex__(protocol, /)

Helper for pickle.


Return repr(self).

MassDownloader.__setattr__(name, value, /)

Implement setattr(self, name, value).


Size of object in memory, in bytes.


Return str(self).


Abstract classes can override this to customize issubclass().

This is invoked early on by abc.ABCMeta.__subclasscheck__(). It should return True, False or NotImplemented. If it returns NotImplemented, the normal algorithm is used. Otherwise, it overrides the normal algorithm (and the outcome is cached).