Manuals: Wilber 3

Updated 2018-12-04 — added information about federated data access.

Newsletter

See our demo screencast or our newsletter article for a quick overview of Wilber 3.

Browse Events

Load Wilber 3 at http://ds.iris.edu/wilber3.

wilber_find_event.png

Explore the event data

Wilber initially displays all events for the past 30 days. Note that the Date and Magnitude sliders reflect the range of this data.

wilber_date_mag_filter.png

Dragging the slider handles causes both the map and the table of event data to update accordingly.

Load a different set of event data

The last 30 days of data is useful, but larger datasets can be more interesting. Click on the Data Set dropdown and select “Past 12 months, M4.0+”.

wilber_event_dataset.png

This will load all magnitude 4.0 and larger events for the last 12 months. This will return a much larger set of data, usually over 10,000 events.

Note that the slider ranges have changed to reflect the new data.

wilber_date_mag_filter_year.png

Map display limits

You may notice that the map is not displaying every single event. For both legibility and performance reasons, the map limits the number of points it will render. This can be changed depending on your taste and computer speed.

wilber_map_limit.png

500 event limit 5000 event limit
wilber_map_limit_500.png wilber_map_limit_5000.png

The map renders events according to the order that they are listed. Clicking on a column header in the data table will change the ordering, and thus change which events are shown.

wilber_sort_columns.png

Sort by date (500 most recent) Sort by magnitude (500 largest)
wilber_map_limit_500.png wilber_map_mag_order.png

Map zoom and pan

Zoom into the map by using the zoom control or double-clicking on an empty part of the map. Pan around the map by clicking and dragging. When zoomed in, the map bounds are reflected in the Location filter and updated as the map is panned, and the list of events is filtered to match.

wilber_map_zoom.png

Because zooming in reduces the number of events listed, the map can look deeper into the event list before hitting its display limit. The practical effect is that zooming in shows more events.

wilber_events_japan_1.png wilber_events_japan_2.png
When zoomed out to view the entire Pacific Rim, nearly 10,000 events are listed, so most of them are hidden. Zooming in on just the Japanese islands reduces the list to under 1000 events, so every one can be displayed.

Draw a selection box

Click the Draw Selection Box button on the map, then draw a rectangle on the map. Only the points within the box will be shown. When this box is active, the Location filter is fixed and unaffected by panning the map.

wilber_map_box_1.png wilber_map_box_2.png wilber_map_box_3.png

Highlight an event

Clicking on an event marker displays a small box of information, and highlights the event in the data table. Events can also be highlighted by clicking on a row in the table.

wilber_event_highlight.png

Select an event

Both the popup box on the map and the data table contain links to the event page, which can be used to request data.

wilber_event_link_2.png
wilber_event_link_1.png

Stations and Data

For a selected event, this page lists (and maps) all responding stations.

wilber_stations.png

The basic structure of this page is the same as the events page — it contains a map, a set of filters, and a data table, all of which are linked to each other.

Federated Data

Wilber can now find and download data across multiple datacenters through the irisws-fedcatalog service.

The primary datacenter for each station is listed, but apart from that the process is mostly invisible. When processing a request, Wilber will gather data from all the datacenters indicated, and deliver a single download.

See the Federator help page for more information.

Station Map

The map is centered on the event, with station color and contour lines indicating distance from the event.

wilber_stations_map.png

Note that unlike the events map, zooming and panning the map does not affect the listed stations.

View station details

Click on a station, or a row in the table. It is highlighted in the same way as events on the previous page.

wilber_stations_highlight.png

Clicking on a station link in the map popup or the data table shows station details, including sample waveform plots.

wilber_station_detail.png

A dropdown box lists the instruments installed at the station, along with the channels for each. Selecting an instrument will show waveform plots for all of its channels.

Waveform previews

Each channel shows a plot of waveform data. Markers on the plot indicate various phase arrival times, identified by color.

wilber_phase_arrivals.png

Missing waveform data

Wilber relies on various bits of metadata to determine whether data for a particular channel is available. This is occasionally inaccurate, especially for very recent events where data processing may still be in progress.

wilber_data_not_found.png

Waveform plot time window

Data is plotted for a window of time based on either event time or phase arrivals. The various window parameters can be changed with the Time Range controls.

wilber_detail_time_range.png

Start End Plot
2 minutes before P 10 minutes after P wilber_waveform_1.png
5 minutes before event 60 minutes after P wilber_waveform_2.png

Show only certain stations

The filter controls allow only certain stations to be displayed.

wilber_stations_filters.png

By default, the Networks filter is configured to show only stations in the _GSN virtual network. Additional networks can be added by clicking on an empty area in the control and selecting an entry. Typing will filter this list to only matching entries.

wilber_stations_network_filter_1.png wilber_stations_network_filter_2.png wilber_stations_network_filter_3.png

To remove a network, click the “x” next to its name. Clearing this field entirely will show all networks.

The Channels filter includes only stations with data in one of the given channels. The dropdown list here includes only certain common channels, but any channel can by typed in. This filter also supports wildcards (eg. BH?).

Common channels listed Typing “bh” lists only the matches in that list But “bhe” is still valid
wilber_stations_channel_filter_1.png wilber_stations_channel_filter_bh.png wilber_stations_channel_filter_bhe.png

Note that the channel selection is applied everywhere — for example, if BHE is selected, then areas like the station preview will show only BHE data.

wilber_stations_channel_filter_preview.png

Record Section

Wilber can also show waveform data as a record section.

wilber_record_section_button.png wilber_record_section.png

Stations are arranged by distance from the event. Phase arrivals are marked for each station.

Display controls

The record section uses the same time window and decimation parameters as the station preview. These controls are also linked — changes made in one place will be reflected in the other.

Start End Plot
2 minutes before P 10 minutes after P wilber_record_section_time_window_1.png
5 minutes before event 60 minutes after P wilber_record_section_time_window_2.png

The record section also includes a minimum spacing control, which hides plots that would otherwise be drawn on top of each other.

20px spacing 5px spacing
wilber_record_section_20px.png wilber_record_section_5px.png

Station Selection

The filter controls determine which stations are available for inclusion in any data request; the actual selection of individual stations occurs on top of this.

Each listed station can be selected or deselected through a checkbox. By default, all available stations are selected.

wilber_stations_selection.png

Individual stations can be selected or deselected, or a set of stations can be selected using group controls. All and None select and deselect all available stations. A dropdown option selects a distributed set of stations, one station every X degrees distant from the event.

wilber_stations_distributed.png

Requesting Data

The ultimate goal of Wilber is to generate a request for downloadable data.

wilber_data_request_button.png wilber_data_request_dialog.png

Requested Channels

Wilber will request data for all available channels, which is often too much. The Channels filter on the main page should specify the channels to include.

No channel filter Channels set to BH?
wilber_data_request_channels_1.png wilber_data_request_channels_2.png

Time Range

The settings here will reflect any changes made in the station preview or record section previews.

Data Output

Wilber supports a variety of output formats. Depending on the format, additional options may be available; for example, if the output format generates a separate file for each channel (eg. SAC) these can be bundled into a single downloadable file.

Request Information

Your name and an arbitrary label (default is an event description) are used to identify the request. The combination of these must be unique; you cannot submit multiple requests with the same name and label.

You may optionally receive email notifications regarding the progress of your request. Requests are queued and may not be handled immediately, especially if there are many other requests being submitted at the same time.

Monitoring a Data Request

Once a data request has been successfully submitted, you will be given a link that can be used to track the request and (when complete) download the data. This is a permanent link, so it can be bookmarked and returned to later.

wilber_data_request_link.png

wilber_data_request.png

This page maintains a live view of the data request progress. The data request is first added to a queue (Queued) until the back end system is ready to process it. The request is then processed (Working) with the page indicating the progress of each step. Once the request is complete (Success) the page will provide a link to download the resulting data file(s).

wilber_data_request_queued.png wilber_data_request_working.png wilber_data_request_success.png

Downloading Data

The downloadable data is placed in a public folder based on the user name and label of the request, and may be accessed via HTTP or FTP. For example:
User: Wilber Demo
Label: 2012-08-14 Mw7.7 Sea of Okhotsk
HTTP Access: http://www.iris.edu/pub/userdata/wilber/wilber-demo/2012-08-14-mw77-sea-of-okhotsk
Anonymous FTP Access: www.iris.edu/pub/userdata/wilber/wilber-demo/2012-08-14-mw77-sea-of-okhotsk

Release date:     Modified date:

02:24:45 v.01697673