En español
Care to take a survey on IEB?
  1. Introduction
  2. Implementation
  3. Basic Usage
  4. Map Controls
  5. Event Filtering
  6. Display Statistics
  7. Region Selection
  8. Data downloads
  9. View in 3D

The IRIS Earthquake Browser (IEB) is an interactive map for exploring millions of seismic event epicenters (normally earthquakes) on a map of the world.

Selections of up to 5000 events can also be viewed in profile and freely rotated with the 3D Viewer companion tool. No plugins (like Flash or Java) are required. These selections can also be viewed as sortable tables and exported to Excel.

Notably the map, with (almost) all of its settings, can be bookmarked, emailed and socially shared. Other websites can dynamically construct IEB URLs and thereby send people to a certain very specific place, time, and set of quakes (example).

IEB and 3DV are easy to use. They are intended to be of value both educationally and as research tools.

Note: The terms "earthquakes", "quakes" and "events" may be used interchangeably in this document. The reason "events" is used is that human activities (bombs, mining etc), as well as phenomena like meteors, are also detected, and there is no difference to a seismometer whether the cause was actually an earthquake or not.


IEB is a Google map. It uses its own earthquake database, which is periodically updated using IRIS web services.

At present, the IEB database contains 3.3 million earthquakes dating from the early 1970s to less than an hour old.  About small magnitudes in the U.S.

The data come from various sources, mainly the USGS, and are stored in the main data archive at the IRIS Data Management Center in Seattle, WA, USA.

Basic Usage

The user selects earthquakes to display on the map using filtering options like date, magnitude, and depth ranges, along with choosing a priority for either most recent or largest magnitude quakes. Regions of interest can be selected by drawing a selection box on the map.

For practical reasons, only a small subset of the millions of earthquakes can be shown at a given time (currently up to 5000). However, by zooming and panning, the user can quickly discover all of the earthquakes in the database for any region of the world.

When zooming and panning, the earthquakes displayed update dynamically (the filter is re-applied and database re-queried) to match the currently-visible boundaries of the map.

But if the user has selected a region of interest, then the set of earthquakes is "locked", and zooming or panning will not cause a database update. To resume dynamic updating the "Deselect Region" link is used. Region selections can be as tiny as a few kilometers square!

Tip: If your intention is to select the whole world, do not make a huge selection box, simply deselect any region you may have selected and zoom out to where the whole world is visible. The first approach is the slowest database query possible, and the second is the fastest.

Earthquakes shown or selected on the map may be viewed in a table or downloaded using the "Open: Other formats" link in the Options panel.

The resulting table can be sorted by up to three of its columns. It can be copied, by double clicking it, and pasted into various editors and programs such as Excel. Direct exporting to Excel and NetCDF formats is also possible, for most browsers.

Mileage May Vary:

Recent versions of Chrome, Safari and Firefox work best. All WebKit-based browsers tested work.

Ancient versions of Internet Explorer (6 and below) do not work with IEB. Versions 7 to 10 have issues, but the functionality improves with each version; and the 3DV viewer tool is slow. (They need faster JavaScript engines.)

Older Opera has issues, but the new Opera Next is one of the fastest and best.

Finally, your computer's operating system, speed, available memory and Internet connection bandwidth will all impact performance.
Map Overview
The following diagram describes some of the features available in the IEB :
  1. Earthquake Count - Displays how may earthquakes are displayed, how many could have been displayed (and how many are visible on the map at this time).
  2. Open: Other formats - Used to export data from the map to a sortable table, where you can copy and paste into other programs, and download as an Excel or NetCDF file.
  3. Map Views - Select from various Google map view modes such as satellite or terrain.
  4. Depth Scale - Circle colors indicate the depths of earthquakes (kilometers)
  5. Options - A set of filtering options for determining the subset of available earthquakes to display.
  6. Magnitude Scale - Circle sizes indicate earthquake magnitudes
  7. Region Selection - Use this to select a map region and zoom down to it. Only events in the selected region will be displayed.
  8. Navigation Information - Displays the lat/lon bounds of the current selection and the lat-lon coordinates of the cursor.
  9. Show Plates - Shows or hides the display of (clickable) tectonic plate boundaries.
  10. Go To Region - Takes map to one of several predefined regions of interest (e.g. 'Aleutian Islands') or topics, which can be historical, such as 'Asian Tsunami Disaster Aftershocks'.
  11. 3D Viewer - Opens a new window with a rotatable, zoomable 3D-view of the data.
Event Filtering Controls

Be sure to press Apply after making changes!

Earthquake filtering determines which quakes from the IRIS database are shown in any given map view. The quakes you get are filtered in two ways:

  1. By number of quakes.
  2. By quake parameters

The first two options, Max Quakes: and Priority:, determine the number of quakes that will be displayed in a map. The rest of the options determine what parameters to use in selecting (filtering) from the quakes in the database.

Options Max Quakes: and Priority: are always shown. To show the other options you must click on their option names.

Max quakes: determines the maximum number of quakes that will be shown in any given view. You can choose values between 10 and 5,000.

Displaying too many quakes can cause some web-browsers to be slow or unresponsive. In rare cases the web browser may have to be restarted.

Priority: determines which quakes have priority to be displayed when the number of quakes matching your filter in the database is greater than the Max quakes: setting. You can either prioritize Newer or Larger quakes.

Time Range: determines the dates of quakes that will be shown. By default all available dates are used: Earliest Available to Latest Available.

To use your own date range, uncheck one or both of the check boxes and enter dates in the text fields or the date picker popups. Dates are in Universal Time (UTC) and run midnight to midnight.

Magnitude Range: determines the magnitudes of quakes that will be shown. By default all available magnitudes are used.

To use your own magnitude range, uncheck the check box and enter values in the text fields.

Depth Range: determines the depths of quakes that will be shown. By default all available depths are used.

To use your own depth range, uncheck the check box and enter values in the text fields.

Earthquake Count Field

The Earthquake Count shows how many quakes were retrieved from the database, along with the total number of that could have been retrieved (but the limits of Max quakes prevented it). Since zooming and panning hides some quakes, the number that are actually visible in the current map view is given.

If the Earthquake Count reads "500 of 38738" then 500 quakes are on the map and 38,738 - 500 = 38,238 matched in the database but are not displayed. So although a huge number of quakes matched your Options filter, they were not retrieved, based on the Max quakes setting of 500. Which 500 of them were retrieved is based on the Priority setting.

If the counts are positive, but the number visible is zero, pan, zoom out, or use "Zoom to Region" if a region is currently selected. IEB prompts you if this condition arises. If all the values are zero, relax your filter settings in Options and press Apply.

If you have selected a region using Select New Region, then zooming and panning will not affect the quakes displayed, the selected set is "locked" until you either deselect the region or change filter settings and press Apply.

Region Selection Controls

The region selection control allows you to quickly select a region and zoom there. Only events in the selected region will be shown.


To start, click Select New Region (or press the zoom icon directly above it, or just hold down the shift key).

The cursor changes to a cross hairs, and the map and icon are slightly darkened. Now drag from one corner to the opposite corner of the desired region and release.


Press the ESC key to cancel out of region select mode.


The event filter options will be freshly applied, but to the selected region only.


Next click Zoom to Region to zoom to the selected region.


When a region is selected, the events inside it are effectively 'frozen'. If you pan the map away or zoom too close, no events will be visible -- but IEB recognizes this condition and will prompt you what to do.




Click Deselect Region to remove the selection box and 'unfreeze' the events, so they once again auto update to reflect the visible map area as you zoom and pan.

You can immediately select a new region without deselecting the current one first.

Open: Other formats link and downloading data files
The Other formats link leads to a new HTML page containing the currently-loaded earthquakes in table format, where the data can also be downloaded as Excel or NetCDF files. The columns of this table can be sorted by clicking on them, and double-clicking the table selects all its contents, which can usually be copied and then pasted into other programs for further analysis. IEB earthquakes exported to table with links to maps of each quake

Here is an example exported table.

If the table has more than, say, a thousand rows, use caution with the copy/paste method, and consider saving the table to disk as an Excel or NetCDF file, and then open/import it into the other program.

Rotating a set of Earthquakes with the 3D Viewer tool



The IRIS 3D Earthquake Viewer (3DV) allows you to rotate thousands of earthquakes in any direction as well zoom in and out. It allows a better understanding of the spatial relationships in a set of earthquakes and often reveals a fault line or other underground feature only visible from a side view.

It will show coastline and plate boundaries and has a selection of view options to help visualize seismicity in emulated 3D space. It is very simple to use, and it requires no Flash or Java plugin.


After selecting a region of interest, in this case the Fiji Islands region, you simply press the
3D Viewer link:


A new browser window (or tab) with a black background opens up.

By dragging your mouse you can rotate the scene.

With the mouse wheel you can zoom in and out.

There are various settings and view-related commands in the View menu such as auto-rotation, scaling, and capturing a screenshot.


More help on how to use 3DV will be forthcoming, but it's simplicity means you can generally discover what is possible to do by simple trial-and-error.



We thank the USGS, the NSF and IRIS Consortium members for data, funding and support; and original author B. Weertman.

image of rotating earthquakes in 3D near Fiji Islands