# obspy.core.event.Catalog

class `Catalog`(events=None, **kwargs)

  Bases: `builtins.object`

  This class serves as a container for Event objects.

  Parameters: | events (list of `Event`, optional) List of events resource_id (`ResourceIdentifier`) Resource identifier of the catalog. description (str, optional) Description string that can be assigned to the earthquake catalog, or collection of events. comments (list of `Comment`, optional) Additional comments. creation_info (`CreationInfo`, optional) Creation information used to describe author, version, and creation time.

  Note

  For handling additional information not covered by the QuakeML standard and how to output it to QuakeML see the ObsPy Tutorial.

  Attributes

  `__dict__` |
  `__doc__` | str(object=’‘) -> str
  `__hash__` |
  `__module__` | str(object=’‘) -> str
  `__weakref__` | list of weak references to the object (if defined)
  `creation_info` |
  `resource_id` |

  Public Methods

  `append` | Appends a single Event object to the current Catalog object.
  `clear` | Clears event list (convenient method).
  `copy` | Returns a deepcopy of the Catalog object.
  `count` | Returns the number of Events in the Catalog object.
  `extend` | Extends the current Catalog object with a list of Event objects.
  `filter` | Returns a new Catalog object only containing Events which match the
  `plot` | Creates preview map of all events in current Catalog object.
  `write` | Saves catalog into a file.

  Private Methods

  Warning

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

  `_get_creation_info` |
  `_get_resource_id` |
  `_repr_pretty_` |
  `_set_creation_info` |
  `_set_resource_id` |

  Special Methods

  `__add__` | Method to add two catalogs.
  `__delitem__` | Passes on the __delitem__ method to the underlying list of traces.
  `__dir__` | default dir() implementation
  `__eq__` | __eq__ method of the Catalog object.
  `__format__` | default object formatter
  `__getitem__` | __getitem__ method of the Catalog object.
  `__getslice__` | __getslice__ method of the Catalog object.
  `__iadd__` | Method to add two catalog with self += other.
  `__init__` |
  `__iter__` | Return a robust iterator for Events of current Catalog.
  `__len__` | Returns the number of Events in the Catalog object.
  `__ne__` |
  `__new__` | Create and return a new object.
  `__reduce__` | helper for pickle
  `__reduce_ex__` | helper for pickle
  `__setitem__` | __setitem__ method of the Catalog object.
  `__sizeof__` | size of object in memory, in bytes
  `__str__` | Returns short summary string of the current catalog.
  `__subclasshook__` | Abstract classes can override this to customize issubclass().

### Thank you!

We would like to thank our contributors, whose efforts make this software what it is. These people have helped by writing code and documentation, and by testing. They have created and maintained this product, its associated libraries and applications, our build tools and our web sites.

#### Contributors

- Ackerley, Nick
- Allgeyer, Sebastien
- Ammon, Charles J.
- Antunes, Emanuel
- Arnarsson, Ólafur St.
- Bank, Markus
- Barsch, Robert
- Behr, Yannik
- Bernardi, Fabrizio
- Bernauer, Felix
- Bes de Berc, Maxime
- Beyreuther, Moritz
- Boltz, Shawn
- Bonaimé, Sébastien
- Carothers, Lloyd
- Chamberlain, Calum
- Chambers, Derrick
- Chen, Zhao
- Clark, Adam
- Danecek, Peter
- Egdorf, Sven
- Engels, Fabian
- Ermert, Laura
- Eulenfeld, Tom

- Fabbri, Tommaso
- Falco, Nicholas
- Fee, Jeremy
- Grellier, Clément
- Grunberg, Marc
- Hammer, Conny
- Heimann, Sebastian
- Heiniger, Lukas
- Hope, Gaute
- Igel, Heiner
- Inza, Adolfo
- Isken, Marius
- Ketchum, David
- Koymans, Mathijs
- Kremers, Simon
- Kress, Victor
- Krieger, Lars
- Krischer, Lion
- Kula, Damian
- Käufl, Paul
- Köhler, Andreas
- Lecocq, Thomas
- Leeman, John
- Legovini, Paride

- Lesage, Philippe
- Li, Yulin
- Lomax, Anthony
- Lopes, Rui L.
- MacCarthy, Jonathan
- Maggi, Alessia
- Martin, Henri
- Medlin, Andrew
- Megies, Tobias
- Meschede, Matthias
- Michelini, Alberto
- Miller, Nathaniel C.
- Morgenstern, Bernhard
- Nof, Ran Novitsky
- Panning, Mark P.
- Parker, Tom
- Pestourie, Romain
- Rapagnani, Giovanni
- Reyes, Celso
- Ringler, Adam
- Rothenhäusler, Nicolas
- Russo, Emiliano
- Sales de Andrade, Elliott

- Satriano, Claudio
- Saul, Joachim
- Scheingraber, Chris
- Schneider, Simon
- Sippl, Christian
- Snoke, Arthur
- Stange, Stefan
- Stähler, Simon C.
- Sullivan, Benjamin
- Tian, Dongdong
- Trabant, Chad
- Trani, Luca
- Uieda, Leonardo
- Walker, Andrew
- Walther, Marcus
- Wassermann, Joachim
- Williams, Mark C.
- Winkelman, Andrew
- Zaccarelli, Riccardo
- Zad, Seyed Kasra Hosseini
- Zhu, Lijun
- van Driel, Martin
- van Wijk, Kasper

#### Funds

ObsPy was partially funded by the

- German Science Foundation (DFG) via grant DFG IG 16/9-1
- German Ministry for Education and Research (BMBF), GEOTECHNOLOGIEN grant 03G0646H.
- NERA project (Network of European Research Infrastructures for Earthquake Risk Assessment and Mitigation) under the European Community's Seventh Framework Programme (FP7/2007-2013) grant agreement n° 262330
- Leibniz Institute for Applied Geophysics (LIAG)
- VERCE EU-FP7 project (no. 283543)