# obspy.imaging.maps.plot_basemap

`plot_basemap`(lons, lats, size, color, labels=None, projection='global', resolution='l', continent_fill_color='0.8', water_fill_color='1.0', colormap=None, colorbar=None, marker='o', title=None, colorbar_ticklabel_format=None, show=True, fig=None, **kwargs)

  Creates a basemap plot with a data point scatter plot.

  Parameters: | lons (list/tuple of floats) Longitudes of the data points. lats (list/tuple of floats) Latitudes of the data points. size (float or list/tuple of floats) Size of the individual points in the scatter plot. color (list/tuple of floats (or objects that can be converted to floats, like e.g. `UTCDateTime`)) Color information of the individual data points to be used in the specified color map (e.g. origin depths, origin times). labels (list/tuple of str) Annotations for the individual data points. projection (str, optional) The map projection. Currently supported are: `"global"` (Will plot the whole world.) `"ortho"` (Will center around the mean lat/long.) `"local"` (Will plot around local events) Defaults to “global”. resolution (str, optional) Resolution of the boundary database to use. Will be based directly to the basemap module. Possible values are: `"c"` (crude) `"l"` (low) `"i"` (intermediate) `"h"` (high) `"f"` (full) Defaults to `"l"`. For compatibility, you may also specify any of the Cartopy resolutions defined in `plot_cartopy()`. continent_fill_color (Valid matplotlib color, optional) Color of the continents. Defaults to `"0.9"` which is a light gray. water_fill_color (Valid matplotlib color, optional) Color of all water bodies. Defaults to `"white"`. colormap (str, any matplotlib colormap, optional) The colormap for color-coding the events as provided in color kwarg. The event with the smallest color property will have the color of one end of the colormap and the event with the highest color property the color of the other end with all other events in between. Defaults to None which will use the default matplotlib colormap. colorbar (bool, optional) When left None, a colorbar is plotted if more than one object is plotted. Using True/False the colorbar can be forced on/off. title (str) Title above plot. colorbar_ticklabel_format (str or function or subclass of `matplotlib.ticker.Formatter`) Format string or Formatter used to format colorbar tick labels. show (bool) Whether to show the figure after plotting or not. Can be used to do further customization of the plot before showing it. fig (`matplotlib.figure.Figure`) Figure instance to reuse, returned from a previous `plot_basemap()` call. If a previous basemap plot is reused, any kwargs regarding the basemap plot setup will be ignored (i.e. projection, resolution, continent_fill_color, water_fill_color). Note that multiple plots using colorbars likely are problematic, but e.g. one station plot (without colorbar) and one event plot (with colorbar) together should work well.

### 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)