Help
Contents
  1. Introduction
  2. Map Overview
  3. Event Filtering
  4. Display Statistics
  5. Region Selection
  6. Download Data
  7. GEON IDV
  8. Event Catalogs
Introduction
The IRIS Earthquake Browser (IEB) is an interactive map service for viewing Earthquake Epicenters superimposed on a map of the world. Data can be exported from the IEB and viewed in 3D with the GEON Integrated Data Viewer. The IEB is useful both educationally and as a research tool.
IEB is a Google Map - Mashup composed of a Google Map, HTML and Javascript code and an IRIS earthquake web-service. The web-service accesses several earthquake catalogs stored in the IRIS database. In total, the database contains around 2 million unique events dating from the early 1960s until present. Filtering logic determines which one of those earthquakes are shown on any given map view. The user can control how the filtering is done, and how many events to show. Because of practical limitations, only a small subset of all earthquakes my be shown in any given map view. However, by zooming and panning, the user can quickly discover all of the earthquakes held in the IRIS database for any region of the globe.
Earthquakes shown on an IEB map may be viewed in a table, or exported in NetCDF or XML formats. The GEON Integrated Data Viewer program (free download) can be used to 3-Dimensionally visualize the exported NetCDF data.
Mileage May Vary: Recent versions of Firefox seem to work best. Older versions of Internet Explorer (6 and below) do not work with the IEB. Your computer's operating system, speed, amount of memory and internet connection bandwidth will all impact performance.
Map Overview
The following diagram describes some of the features available in the IEB :
  1. Events Displayed Statistics - Displays how may events are displayed and not displayed for this view.
  2. Export Data - Use these links to export data from the map.
  3. Map Views - Click these to display different views, including map and aerial images.
  4. Depth Scale - Colors indicate the depths of earthquakes (kilometers)
  5. Display Filter - A set of controls that allow one to determine what events are displayed.
  6. Magnitude Scale - Circle sizes indicate event sizes
  7. Region Selection - Use this to select a region and zoom down to it. Only events in the selected region will be displayed.
  8. Overview Map - This map shows the location of the current map.
  9. Navigation Information - Displays the lat/lon bounds of the current selection and the lat-lon coordinates of the cursor.
Event Filtering Controls

Be sure to press Apply after making changes!

Event filtering determines which events from the IRIS database are shown in any given map view. Events are filtered in two ways:

  1. By number of events.
  2. By event parameters

The first two options, Display at most: and Prioritize:, determine the number of events that will be displayed in a map. The rest of the options determine what event parameters to use in selecting (filtering) events.

Options Display at most: and Prioritize: are always shown. To show the other options you must click on the option names.

Display at most: determines the maximum number of events that will be shown in any given view. You can choose values between 100 and 5,000.

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

Prioritize: determines which events have priority to be displayed when the number of events for a map view is greater than the Prioritize: option. You can either prioritize Newer Events or Larger Events.

Time Range: determines the dates of events 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. Dates are in Universal Time (UTC) and run midnight to midnight.

Magnitude Range: determines the magnitudes of events 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 events 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.

Advanced Event Filter: allows you to control what catalogs, contributors and magnitude types are used when selecting events. It is important to understand that the database contains a large number of duplicate events. This is mainly because the database contains multiple catalogs. Each event maybe recorded in more than one catalog. There are roughly two database entries for each actual recorded earthquake. By default Automatic Logic is used to determine which records in the database will be shown in the map. The logic attempts to show unique, non-duplicate earthquakes.

Uncheck the Automatic Logic check box to select a catalog,contributor or magnitude type. To see all events in the database, uncheck Automatic Logic and leave the other fields set to <All>. After doing this, you should see the Display Statistics field increase.

Using the Advanced Event Filter in conjunction with the Download Table link at the top of the map makes it possible to quickly understand the relationships between contributors, catalogs and events.

Display Statistics Field

The Events Displayed field shows how many events are currently plotted on the map view along with the total number of events that could be shown.

If the Events Displayed field reads "500 of 38738" then 500 events will have been plotted and 38,738 - 500 = 38,238 events not plotted. Zooming into the map and pan to reveal the hidden events.

If the two displayed numbers are the same ("123 of 123") then all events are being displayed and zooming and panning will not display any more events.

Region Selection Control

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

 

 

The region selection control is only available with the Firefox and Safari web browsers.

To start, click Select a region and drag from top-left to bottom-right of the desired region.

Only events in the selected region are now shown.

 

 

Note: occasionally the existing events will remain shown. If this happens, click the Apply button to refresh the display.

 

 

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

 

As long as a region is selected, the group of selected events is effectively frozen - even if you move the selected region off of the view!

Click Clear Selection to remove the selection rectangle.

 

 

Alternatively, you may click Select a region to select a new region.

Download Data Links

The Download data links at the top of the page allow you to export the data shown in the current map view. These links are dynamically updated as the map is zoomed and panned.

 

The Table link leads to a new HTML page containing a list of earthquakes in table format. The column headers of this table can be clicked to re-order the data. Use the event table in conjunction with the Advanced Filter Control to better understand the relationships between contributors, catalogs, mag-types and events.

 

The NetCDF link can be used to download the events in NetCDF data format. NetCDF (Network Common Data Form) is a binary data format standard for exchanging scientific data. The NetCDF data created by the IEB can be imported into the GEON IDV and visualized three dimensionally.

 

Click Here to learn more about using the GEON IDV.

 

The XML link goes to an XML document containing the displayed earthquake information. This is is the same XML document that is used in plotting the points on the map. It is mainly useful as a diagnostic tool. If the map does not appear to be working properly, click on the XML link and see if it downloads without errors. If the XML document does not download properly, the map will not work properly either. Problems with this link are indicative of problems with IRIS' earthquake event web-service.

 

The WEED link goes to an WEED event file document containing the displayed earthquake information. See WEED Manual: IRIS for more information.

Viewing Earthquakes with the GEON IDV
In the following instructions describe how to import data from the IRIS Earthquake Browser into the GEON Integrated Data Viewer (IDV).
Step 1: Download the GEON IDV. Click This Link to go to the UNAVCO web page with instructions on downloading and installing the GEON IDV.
Step 2: In the IEB find a region of interest.
Step 3: Right-Click on the NetCDF link at the top of the map and select Copy Link Location to copy the link's address to your computer's clipboard.
Step 4: Start the GEON IDV and select Data Chooser. Select URLs in the left had column and then in the URL field paste the link location from the clipboard. Make sure netCDF Point Data files is selected in the Data Source Type field and then click the Add Source button.
Step 5: In the Field Selector dialog click the Create Display button. The map should now appear.
Step 6: In the Displays dialog uncheck the Declutter check box and check the Show All Times at Once check box.
Step 7: In the map display, click the scale control on the left hand side (looks like hair a comb). Set the Min value: to 0.0 and the Max value: to 300000 meters. (The default range is 0.0 to 16000 meters, which is too shallow). Click OK. Read the GEON IDV's online help to learn about rotating the map.
A completed map of New Zealand showing the subducting pacific plate.
Earthquake Event Catalogs

 

Catalog Definitions
NEICALRT
List distributed by NEIS (National Earthquake Information Service) of the USGS via email and used to trigger the IRIS SPYDER® system. These events are NOT included in the "PREFERRED" catalog algorithm because they are redundant (of FINGER) and do not include all events reported by FINGER.
FINGER
List distributed by NEIS (National Earthquake Information Service) of the USGS through the "finger quake@gldfs.cr.usgs.gov" service. The earthquakes on the "quake" list have been reviewed by a seismic analyst. However, in the interest of timeliness, locations and magnitudes are entered once and not updated on the list.. This list contains data for the past 7 days. Once an event rolls off the list it appears on the QED (see next definition).
QED
Quick Epicenter Determinations - distributed by the USGS NEIS 7 days behind real time. These data are extremely preliminary and the parameters of the earthquakes are subject to change as more data are used to relocate the earthquakes. The QED rolls over to the WHDF (see next definition).
WHDF
Weekly Hypocenter Data File - distributed by the USGS NEIS. Covering the time period following the Monthly data up to four weeks behind the current week. The Weekly PDE (Preliminary Determinations of Epicenters) data are replaced by the Monthly PDE data as soon as they become available.
MHDF
Monthly Hypocenter Data File - distributed by the USGS NEIS. This list is the most complete computation of hypocenters and magnitudes done by the USGS NEIC. It is normally produced a few months after the events occur. The publication is called "preliminary" because the "final" computation of hypocenters for the world is considered to be the Bulletin of the International Seismological Centre (ISC), which is produced about two years after the earthquakes occur.
ISCCD
Bulletin of the International Seismological Centre (ISC). List of earthquakes two years behind real time.