Options

Site name: Help

Enter the name of the Athena Web site. This name will be displayed in the Web browser title bar.

Permitted values: Any character combination to a maximum of 255 characters.

Default value: Athena

API key:

Generate Show

Click the Generate button to create a unique API key. The API key is used by other applications to post bulletins to Athena or to query Athena for Binder information. The API key must be communicated to the administrator of the other application. Consult the user guide for that application to determine where the Athena API key should be entered in its configuration.

Public Athena URL: Help

Use current URL

Enter the external URL address that can be used to reach this Athena. This URL is required to provide links to Athena and Google Maps features in notification emails.

Permitted values: The URL address of this Athena, starting with either http:// or https://
Example: https://my.athena.domain.name.com:8080

Default value: None

Magnitude preferences: Help

Enter the magnitude types in order of preference from most to least preferred. When a bulletin is posted with multiple magnitudes, this list specifies which one will be marked as the "preferred magnitude".

Permitted values: Comma-separated, non-case-sensitive list of magnitude names in a descending order of importance.
Example: Ml, Md, Ms, Mb, Mwp, Mblg, Mwc, Mwb

Default value: Mwc, Mwb, Mwp, Ms, Mb, Ml, Md

Prefer official magnitude: Help

Select this option to use the official magnitude from an event bulletin. Selecting this option overrides the configured magnitude preferences. If the bulletin does not contain an official magnitude, the configured Magnitude preferences will be used.

Default value: true

Use GeoNames service: Help

Select this check box to include the distance from the event of the nearest populated place in the event information. The nearest place information is automatically retrieved from the GeoNames geographical database (geonames.org) Web service. Example: 25.0370°N, 143.0736°E; 177 km from Higashi, Tokyo, Japan, indicates the latitude, longitude and nearest populated place to the event.

Default value: true

Locale for GeoNames and ocean names: Help

Select the preferred locale from the options list. This locale will be used for all place name fetched from GeoNames for the origin “nearest place” field. It will also be used for all ocean names in the origin “ocean” field. It will not affect the ocean names displayed in the Google Map. To change the map locale, please see the “Google maps language” setting on the Map tab.

Default value: en

Event list batch: Help

Enter the initial number of events to display on the Event Map page.

Permitted values: Any integer from 1 to 1000, must be less than events list limit.

Default value: 100

Event list limit: Help

Enter the maximum number of events to list on the Event Map page.

Permitted values: Any number from 1 to 50000.

Default value: 10000

FMD plot event limit: Help

Enter the maximum number of events to display on the B-Value Analysis page.

Permitted values: Any number from 1 to 40000.

Default value: 6000

Station range: Help

Enter a distance in metres to specify how close a latitude/longitude position must be to an existing station's position in order to be considered a match. The distance specified is used as a radius around the station. The value can be overridden by specifying a value in the client program making the request.

Permitted values: A number from 1 to 100000.
Example: A value of 1000 means that a matching position must be within 1000 metres of a station.

Default value: 1000

Preferred timezone: Help

Select the preferred timezone from the options list.

This timezone will be used in all email notifications to all users.

Administrator users will see all times in Athena in UTC.
For non-administrator users, the timezone will be used on the following pages:

Events Map (except the histogram)
Event Summary
Temporal Seismicity Shift
FMD Plot (except the histogram)

Default value: (GMT+00:00) UTC

Licence

Licence key: Help

Enter the licence key. You will need to restart Tomcat for this setting to take effect.

Permitted values: A key of the form: XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX

Default value: None

Licence server: Help

Enter the licence server host name and port. You will need to restart Tomcat for this setting to take effect.

Permitted values: Use the format host_name:port_number. e.g. licence.nanometrics.ca:36036

Default value: http://elixir-service.elixir-prod:36036

Page refresh interval: Help

Enter, in seconds, the refresh rate for the Event Map page.

Permitted values: A number from 5 to 86400.
Example: A value of 300 means that the page will be refreshed every 5 minutes.

Default value: 300

Enable high precision checkbox on map: Help

Select this check box to enable the "Locations" check box in the gear menu on the Event Map. The "Locations" check box allows users to toggle between showing standard locations and high precision locations in their search results.

Default value: false

Enable high precision locations search: Help

Select this check box to show the "Apply search criteria to:" field in the search form on the Event Map. This field allows users to apply the search criteria to standard locations or to high precision locations.

Default value: false

Show locale toggle: Help

Select this checkbox to show the locale toggle on the right side of the menu bar. The locale toggle allows users to change the language of some pages.

Default value: false

Show 3D viewer tab on the main page: Help

Select this checkbox to show the 3D viewer tab for events on the main map page.

Default value: true

Show Source Parameters tab on the event summary page: Help

Select this checkbox to show the source parameter tab on the summary page of an event

Default value: false

Show Arrivals on Waveforms: Help

Select this checkbox to show the Arrivals on the Waveforms on the Event Summary page

Default value: false

Histogram height: Help

Enter the height, in pixels, to display the histograms on the Event Map page.

Permitted values: Any number from 150 to 1000.

Default value: 150

FTP URL:

To provide access to Waveform data, enter a valid ftp site address to display the Waveforms link on the Event Map page.

Permitted values: An FTP URL string that starts with ftp://

Logon message: Help

Enter the text to be displayed on the log-on page.

Permitted values: Any character combination. HTML can be used.

Default value: None

Standard criteria: Help

Select an event criteria option from the list to specify the default event query for users who do not have query capabilities.
Go to Event Criterias to view or edit the criteria.

Default value: NoneReset

Default criteria: Help

Select an event criteria from the list to specify the default event query.
Go to Event Criterias to view and edit the criteria.

Default value: NoneReset

Accept criteria 1: Help

Select an event criteria option from the list to specify which posted events will be added to Athena. You can specify two Accept event criteria options. Only events that match either Accept criteria 1, Accept criteria 2, or both will be added to Athena.
Events will be rejected and archived if new origins of type manual do not meet Accept 1 and Accept 2 criteria (regardless of reject criteria).
Go to Event Criteria to view or edit the criteria.

Default value: NoneReset

Accept criteria 2: Help

Select an event criteria option from the list to specify which posted events will be added to Athena. You can specify two Accept event criteria options. Only events that match either Accept criteria 1, Accept criteria 2, or both will be added to Athena.
Events will be rejected and archived if new origins of type manual do not meet Accept 1 and Accept 2 criteria (regardless of Reject criteria).
Go to Event Criteria to view or edit the criteria.

Default value: NoneReset

Reject criteria: Help

Select the event criteria that will determine which posted events are rejected from Athena. Events that match the Reject criteria will be omitted from Athena, and events that do not match will be added.

If no Accept criteria are defined, events that do not match the Reject criteria will be accepted.
If Accept criteria 1 is defined, events that match Accept criteria 1 will be accepted. The Reject criteria will be ignored.
If Accept criteria 2 is defined, events that match Accept criteria 2 AND do not match the Reject criteria will be accepted.
If all criteria are defined, events that match Accept criteria 1 will be accepted. Events that do not match Accept criteria 1 will be compared to Accept criteria 2 and the Reject criteria. Events that match Accept criteria 2 and do not match the Reject criteria will be accepted.
Events will be rejected and archived if new origins of type manual do not meet Accept 1 and Accept 2 criteria or match the Reject criteria.

Go to Event Criteria to view or edit the criteria.

Default value: NoneReset

Event author: Help

Enter the text used to describe the author for an event. This text will replace the author specified in IMS or ARC bulletins.

Permitted values: Any character combination to a maximum of 255 characters.

Default value: None

Highlight manual and AI analyst events: Help

Select this check box to highlight manually located events on the Event Map page.

Default value: true

Channel Filtering Patterns

Rejection patterns Inclusion patterns

Determines whether the Channel patterns entered below should act as rejection or inclusion patterns for event data.

Default value: Rejection patternsReset

Channel patterns: Help

Enter the comma separated list of channel patterns in N.S.L.C (Network, Station, Location and Channel) format with optional wildcard (*).

if Rejection patterns is selected, Event data related to these channels will not be added to the database when events are posted to Athena.
if Inclusion patterns is selected, only Event data related to these channels will be added to the database when events are posted to Athena.

Example: IU.*.*.*, CI.ABC.*.*, CI.CD*.*.*, CI.DEF.00.LHZ

The wildcard matches 0 or more characters, and can be used as part of the N.S.L.C codes, e.g.

IU.*.*.* matches all channels on the IU network
IU.AL*.*.* matches all stations on the IU network with station codes that start with "AL"

Default value: NoneReset

Filter station icons using channel patterns: Help

Select this check box to show or hide station icons from the Event Map page using the channel patterns configured above.

if Rejection patterns is selected, stations related to these channels will be hidden on the Event Map page.
if Inclusion patterns is selected, only stations related to these channels will be shown on the Event Map page.

Default value: falseReset

Event radius: Help

Specify the radius in metres of the impacted region around the epicenter of an event. If the specified event radius intersects the region of interest defined by polygon or rectangle notification criteria, then the event is considered a match to that criteria. A notification is sent if a match occurs. You can define multiple radii using the Format.

Format: minimum : maximum = radius, minimum : maximum = radius

Example: 0 : 2 = 1000, 2 : 4 = 2000
The example defines a radius of 1000 m for events with magnitudes from 0 to 2 (0 <= magnitude < 2), and a radius of 2000 m for events with a magnitude between 2 and 4.

Default value: None

Focal depth fractional digits: Help

Use this option to specify the number of decimal places that are displayed for any reference to a focal mechanism depth. Values that do not meet the specified precision are padded with zeros.

Example: With a value of 2 specified

1.0 is displayed as 1.00
1.005 is displayed as 1.01

Permitted values: Any number from 0 to 4.

Default value: 2

Ground motion fractional digits: Help

Use this option to specify the number of decimal places that are displayed for any reference to a peak ground motion. Values that do not meet the specified precision are padded with zeros.

Example: With a value of 2 specified

1.0 is displayed as 1.00
1.005 is displayed as 1.01

Permitted values: Any number from 0 to 8.

Default value: 4

Units for distances: Help

Select the units to be used for all distances in Athena.

Imperial means distances will be displayed in miles and feet
Metric means distances will be displayed in kilometres and metres

Default value: Metric

EPSG Code: Help

When configured, this EPSG code will be used to calculated projected coordinates for each event in the Event Details CSV download. Two new columns will be added to the CSV: Northing and Easting. These columns are not present when the EPSG code is empty.

Default value: None

Show beachballs: Help

Select this check box to display MT/CMT beachball diagrams on the Event Map and in the events list. Note that users with custom query permissions can override this setting from the Event Map page using the Show beachballs check box in the Search Criteria pane.

Default value: true

Show stations: Help

Select this check box to display station markers on multiple events maps (For example, the Event Map page or the b-value map) and on single event event maps. Note that single event maps can be accessed by clicking on an event in the event list on the Event Map page. Stations are always shown on the Stations Map and the Ground Motion Map.

Default value: true

Event marker type: Help

Select the default icon type for displaying events on the map.

Automatic - Date is used for the list of recent events, Magnitude is used for all other lists
Date - marker colour indicates relative time of event; marker size is relative to magnitude
Depth - marker colour indicates depth of event; marker size is relative to magnitude
Magnitude - marker colour indicates magnitude of event; marker size is fixed
Date fixed - marker colour indicates relative time of event; marker size is fixed

Default value: Automatic

Event radius colors: Help

Use this option to define the event circle colours. Colours are defined using a comma-separated list of hexadecimal colour codes (e.g. The hex code #FF0000 displays red). Each item in the list corresponds to the range of event radii specified by Event radius.

Format: #RRGGBB, #RRGGBB where RR, GG and BB are hexadecimal colour values of red, green and blue.

Example: #FFFF00, #FF0000
This example defines yellow as the colour of the first radius, and red as the colour of the second radius.

Default value: #FF0000

External help link: Help

Use this option to specify the link to an external page. When a URL is entered in this field, the Help label will display on the Events Map page.

Default value: None

Multiple Events Map

View type: Help

Select one of the list options to specify how the map will display multiple events.

Whole world displays the entire map.
Bounding box resizes the map to fit around displayed stations
Specific region resizes the map to a specified default viewing region regardless of the displayed events. If you select this option, then you must enter the geographic coordinates in the View region field.

Default value: Bounding box

View region: Help

If you selected Specific regions as the View type enter the geographic coordinates of the specific region to use when displaying multiple events in the map.

Permitted values: Latitude1,Longitude1/Latitude2,Longitude2

Default value: -60, -180/80, 180

Single Event Map

View type: Help

Select one of the list options to specify how the map will display single events.

Whole world displays the entire map.
Specific region resizes the map to a specified default viewing region regardless of the displayed events. If you select this option, then you must enter the geographic coordinates in the View regions field.
Range resizes the map to display the event along with a longitudinal boundary on each side of the event specified by the View range. If you select this option, then you must specify the View range.

Default value: Range

View range: Help

Enter the degrees of longitude to display to the East and West of an event in a single event map. You must specify a value if you have selected Range as the View type
Single event maps can be viewed in Athena by clicking on an event in the Event list on the Event Map page.

Permitted values: A number from 0 to 180.
Example: A value of 40 means that the map will show 40° of longitude on either side of the event.

Default value: 1

View regions: Help

If you selected Specific regions as the View type for a single event map, enter the geographic coordinates of the specific regions to use when displaying a single event in a map. The region in which the event is located will be displayed. If the event is outside of the specified regions, then the whole world is displayed.

Permitted values: Latitude1,Longitude1/Latitude2,Longitude2

Multiple regions are separated with semi-colon (;). For example: Latitude1,Longitude1/Latitude2,Longitude2; Latitude3,Longitude3/Latitude4,Longitude4

Default value: None

Google Map

Google maps language: Help

Enter a language code to specify which language to display on Google Maps.

Default value: None

Google maps region: Help

Enter the ISO 3166-1 alpha-2 region code for Google Maps display.

Default value: None

Default map type: Help

Select the default map type to display from the options list.

Map displays a physical map.
Satellite displays a satellite image of the map.
Hybrid displays a satellite image with geopolitical borders showing.
Terrain displays a topographical map.

Default value: Hybrid

Show map type control: Help

Select this check box to display the Map and Satellite selection buttons on the map.

Default value: true

Draw event radius: Help

Select this check box to display a circle around the event marker to illustrate the impacted region of the event. The radius of the circle is specified by the Event Radius option located on the Configuration | Events tab.

Event radii are not shown on the B-Value map.

Default value: false

Historical Map

Historical criteria: Help

Select an event criteria option from the list to specify which events to display as historical events.
Go to Event Criterias to view or edit the criteria.

Default value: NoneReset

Historical map type: Help

Requires that the Historical criteria option be configured in order to have effect.

Use this option to specify how historical events will be displayed on the Event Map.

Select Individual to display events as distinct coloured circles.
Select Heatmap to display events as a heatmap where heat corresponds to the number of events and their magnitude.

Default value: Individual

Analytics code: Help

Enter the HTML code snippet that will be used by a web analytics tool to monitor the traffic on your Web site. This code will be inserted into the head section of each page.

Default value: None - no analytics code will be inserted.

Twitter code: Help

Enter the HTML code snippet that will be used to add a Twitter button to the menu bar. The Twitter website provides a button generator to produce HTML code for your choice of button

Default value: None - no Twitter button will appear on the menu bar.

Send notifications: Help

Select this check box to enable email notifications for new events based on the routes you have configured.
To configure an email route, navigate to Configuration | Email | Routes

Default value: true

From address: Help

Enter the email address that will populate the "From" field of email notification messages. This email address is used to collect bounced email messages, feedback from users, SPAM, etc.

Permitted values: A valid email address.

Default value: events@nanometrics.net

Email subject: Help

Enter the text and variables to be included in the subject line of email notifications sent from Athena.

Permitted values: Text combined with any of the following variables:

Variable	Description	Example of text in subject line
%date%	Date of origin	2009-04-17
%time%	Time of origin	16:08:30.9
%location%	Latitude and longitude of origin	69.8342 N, 131.0546 E
%id%	Event ID	20090417-3
%depth%	Depth of origin in kilometres	89.7 km
%magnitude%	Magnitude of origin and type of preferred magnitude	4.1 Mb
%updated-magnitude%	Magnitude along with magnitude type of the updated origin	4.1 Mb
%place%	Distance from and name of the closest place in the places list	239 km from Ottawa, Canada
%nearby%	Distance from and name of the nearest populated place (from Geonames.org)	39 km from Club Salinitas, Sonsonate, El Salvador
%analysis-type%	Analysis type of origin	Automatic
%url%	Url of the summary page for the event	https://athena.nanometrics.ca/en/events/359997/summary
%event-tags%	Tags of the Event	Tag-1, Tag-2

The variables are replaced with the relevant event data when the email notification message is sent.

Default value: Event %location% @ %date% %time% %magnitude%
Example: Event 69.8 N, 131.0 E @ 2009-04-17 04:54:30.9 4.1 Mb

Email header: Help

Enter any optional descriptive text to be displayed at the top of an email notification message as a header.

Permitted values: Any character combination. HTML can be used.

Default value: None

Email footer: Help

Enter any optional descriptive text to be displayed at the bottom of an email notification message as a footer.

Permitted values: Any character combination. HTML can be used.

Default value: None

Server

Domain:

Enter the domain name that the Athena server should use when initiating the HELO conversation with the SMTP server.

Permitted values: A fully qualified domain name (FQDN) or an IP address.
Example: myhost.example.com

Default value: nanometrics.net

Host name: Help

Enter the address for the SMTP-capable email server that Athena should use to send email notifications.
To configure an email route, navigate to Configuration | Email | Routes

Permitted values: A local host name, fully qualified domain name (FQDN), or an IP address.
Example: mail.example.com

Default value: email-smtp.us-east-1.amazonaws.com

Port:

Enter the port number used by the SMTP server.
Configure this option if the SMTP server does not accept connections from the default port (port 25).

Permitted values: A valid TCP/IP port number.

Default value: 587

Encryption: Help

If required by the SMTP server, select an encryption type from the list.

Permitted values: None or TLS.

Default value: Tls

Authorization type: Help

If required by the SMTP server, select an authentication type from the option list. If you select Login or Cram md5, then you must also configure a User name and Password.

Permitted values: Select one of the following options: Plain, Login, or Cram md5.

Default value: Login

User name: Help

If the configured Authorization type is Login or Cram md5, enter a valid email address as the user name.
Example: userA@mail.example.com

Default value: NoneReset

Password:

Show

If the configured Authorization type is Login or Cram md5, enter a valid password.

Example: $password123

Default value: NoneReset

Static Map

View range: Help

Enter the degrees of longitude to display to the East and West of an event in the static map shown in email notifications.

Permitted values: A number from 0 to 180.
Example: A value of 1 means that the map will show 1° of longitude on either side of the event.

Default value: 1

Map type:

Select the map type for the Google Maps static map shown in email notifications. Descriptions of the map types can be found here.

Permitted values: roadmap, satellite, terrain, hybrid.

Default value: roadmap

Host name: Help

If your network requires a proxy server to connect to the geonames.org server, enter the name of the host server. If you have entered a name in this field, you must also provide the port number in the Port field.

Permitted values: A local host name, fully qualified domain name (FQDN) or the IP address of an HTTP proxy server.
Example: proxy.example.com

Default value: None

Port:

Enter the port number of the proxy server for the specified Host name.

Permitted values: A valid TCP/IP port number.
Example: 8080

Default value: 80

ApolloServer

ApolloServer URL: Help

Enter the URL for an ApolloServer instance with waveform data. Athena will then fetch waveform data for all posted events.

Permitted values: The URL address of an ApolloServer instance, starting with either http:// or https://
Example: https://www.nanometrics.ca:8081

Default value: None

Pre-origin time (s): Help

Enter the number of seconds of waveform data before the origin time of an event that will be fetched from ApolloServer when that event is posted.

Permitted values: A number from 0 to 600.

Default value: 30

Post-origin time (s): Help

Enter the number of seconds of waveform data after the origin time of an event that will be fetched from ApolloServer when that event is posted.

Permitted values: A number from 0 to 600.

Default value: 300

Fetch waveforms from Apollo Server on demand: Help

Select this check box to fetch waveforms directly from Apollo Server every time you want to view the waveforms on the summary page or every time you're trying to download seed files.

Default value: true

Skip waveform storage in database: Help

Select this check box to disable fetching waveforms from Apollo Server and storing into Athena database.

Default value: true

Temporal Seismicity Shift

Event limit: Help

The temporal seismicity shift graphs may load slowly when displaying many events. Use this option to restrict the number of returned events to a value that enables the graphs to load quickly.

Permitted values: Any integer from 1 to 30000.

Default value: 6000

Graph range (days): Help

Enter the default range of days to display on the temporal seismicity shift graphs.

Permitted values: Any number from 1 to 10000.

Default value: 30

Temporal b-value Graph

Minimum magnitude: Help

The minimum magnitude to be used in each b-value calculation for the temporal b-value graph.

Permitted values: Any number, must be less than the temporal b-value maximum magnitude.

Default value: None

Maximum magnitude: Help

The maximum magnitude to be used in each b-value calculation for the temporal b-value graph.
If no maximum magnitude is specified, then the magnitude of completeness is used.

Permitted values: Any number, must be greater than the temporal b-value minimum magnitude.

Default value: None

Bin width: Help

The bin width to be used in each b-value calculation for the temporal b-value graph.

Permitted values: Any number greater than 0.

Default value: 0.1

Number of events per point: Help

The number of events to be used for each b-value calculation for the temporal b-value graph.

Permitted values: Any integer greater than or equal to 3.

Default value: 50

Number of overlapping events: Help

The number of events that overlap between adjacent computed b-values on the temporal b-value graph.

Permitted values: Any integer greater than or equal to 0.
Must be less than the temporal b-value number of events per point.

Default value: 25

Error Emails

When an error occurs, an email is sent to any route with the "Error" email format. See routes.

There is no "Error" route defined. Add "Error" route (be sure to choose the "Error" email format)

Ocean Names

The names of the oceans that appear in the description of the event position can be customized by editing the ocean names file (ATHENA_HOME/config/ocean_names.yaml).

There is no custom ocean names file, or it is being ignored due to invalid formatting. Rename the sample file (ocean_names.yaml.example) to ocean_names.yaml, edit it and then restart Athena.

Events

Networks

Stations

Channel Responses

Instruments and Sensors

Setup

Users

Supported Languages