Merge pull request #1192 from MMesch/radpattern

Plot Event far-field radiation pattern / refactor core/event.py into folder structure

CHANGELOG.txt

@@ -32,6 +32,8 @@ master:
    * New method Stream/Trace.remove_sensitivity() to remove instrument
      sensitivity
    * Fix incorrect parsing of some non-ISO8601 date/time strings. (see #1215)
+   * Added plotting method to Event (customizable subplots from a selection
+     of map, beachball and farfield radiation plots, see #1192)
  - obspy.clients.fdsn:
    * Replace FDSN webservice shortcut `NERIES` with `EMSC` and deprecate the
      `NERIES` shortcut, will be removed in a future release (see #1146).
@@ -58,6 +60,7 @@ master:
      argument to functions that plot maps to select between Basemap or Cartopy.
    * New default colormap for all plots. A backport of the new viridis colormap
      from matplotlib is available for those using older matplotlib releases.
+   * Added plotting routines for farfield radiation patterns of moment tensors
  - obspy.io.kml:
    * New module for Google KML output of Inventory and Catalog objects
      (e.g. for use in Google Earth)

misc/docs/source/bibliography/Aki1980.bib

@@ -0,0 +1,5 @@
+@book{Aki1980,
+  title={Quantitative Seismology},
+  author={Aki, Keiiti and Richards, Paul G},
+  year={1980},
+}

misc/docs/source/gallery.rst

@@ -167,7 +167,7 @@ Gallery
     net.plot(projection="ortho")
 
 .. gallery-plot::
-    :target: packages/autogen/obspy.core.event.Catalog.plot.html
+    :target: packages/autogen/obspy.core.event.catalog.Catalog.plot.html
     :alt: Basemap preview plot of Catalog class
 
     from obspy import read_events
@@ -223,6 +223,22 @@ Gallery
 
     polynomial(tr.data, order=3, plot=True)
 
+.. gallery-plot::
+    :target: packages/autogen/obspy.core.event.event.Event.plot.html
+    :alt: Event plot
+
+    from obspy import read_events
+    cat = read_events("/path/to/CMTSOLUTION")
+    cat.plot()
+
+.. gallery-plot::
+    :target: packages/autogen/obspy.core.event.event.Event.plot.html
+    :alt: Event plot
+
+    from obspy import read_events
+    cat = read_events("/path/to/CMTSOLUTION")
+    cat.plot(kind=[['global'], ['p_sphere', 'p_quiver']])
+
 .. image:: /_static/sds_report.png
     :target: packages/autogen/obspy.scripts.sds_html_report.html
     :alt: SDS html report

misc/docs/source/packages/obspy.core.event.rst

@@ -0,0 +1,37 @@
+.. currentmodule:: obspy.core.inventory
+.. automodule:: obspy.core.inventory
+
+    .. comment to end block
+
+    Classes & Functions
+    -------------------
+    .. autosummary::
+       :toctree: autogen
+       :nosignatures:
+
+       catalog.Catalog
+       event.Event
+       origin.Origin
+       magnitude.Magnitude
+       origin.Pick
+       magnitude.Amplitude
+       source.FocalMechanism
+       source.MomentTensor
+
+    .. comment to end block
+
+    Modules
+    -------
+    .. autosummary::
+       :toctree: autogen
+       :nosignatures:
+
+       base
+       catalog
+       event
+       header
+       magnitude
+       origin
+       source
+
+    .. comment to end block

misc/docs/source/packages/obspy.imaging.rst

@@ -15,6 +15,7 @@
        waveform
        mopad_wrapper
        maps
+       source
 
     .. comment to end block
 

misc/docs/source/tutorial/code_snippets/quakeml_custom_tags.rst

@@ -52,7 +52,7 @@ a dictionary as ``'attrib'``.
 If desired for better (human-)readability, namespace abbreviations in the
 output xml can be specified during output as QuakeML by providing a dictionary
 of namespace abbreviation mappings as `nsmap` parameter to
-:meth:`Catalog.write() <obspy.core.event.Catalog.write>`.
+:meth:`Catalog.write() <obspy.core.event.catalog.Catalog.write>`.
 The xml output of the above example looks like:
 
 .. code-block:: xml

obspy/CONTRIBUTORS.txt

@@ -39,6 +39,7 @@ Jonathan MacCarthy
 Alessia Maggi
 Henri Martin
 Tobias Megies
+Matthias Meschede
 Alberto Michelini
 Bernhard Morgenstern
 Nathaniel C. Miller