Quick Start Guide for IS-EPOS

This quick start guide provides the basic information on how to access, register and make use of the database and the applications available in IS-EPOS web-platform, which can be accessed at https://tcs.ah-epos.eu/login.html (Figure 1).

An example of application is presented in the tutorial appended, introducing step by step the integration of data and applications available in the portal. For a more detailed description of the portal navigation, configuration options, scientific implementations and visualization applications the user is referred to the IS-EPOS User Guide. User Guide which comprises several chapters associated with specific functions, provides a more detailed description, supported with snapshots and figures demonstrating step-by-step examples of certain applications.

This quick guide includes the most important information comprising the following sections:

• Logging in
• IS-EPOS Home Page
• Tabs and Icons
• AH Episodes
• Applications
• Document Repository
• Tutorial

• Additional Resources

LOGGING IN

The IS_EPOS web platform is available at https://tcs.ah-epos.eu/login.html. IS-EPOS operational language is English. If a user already has an account, he/she can easily log in by simply providing the e-mail address and password. To create an account, the user shall click on either the ‘SIGN UP’ or the 'SIGN UP TO GET ACCESS' tab available (shown in the red frames, Figure 1). The fields that the user is requested to fill are shown in Figure 2. After submitting the registration form the system generates a password which is sent by e-mail to the user and can be hereinafter used for logging in the IS-EPOS web-platform.

Figure 1. Home Page of IS-EPOS platform

Figure 2. Registration form to sign up

IS-EPOS HOME PAGE

The home page of IS-EPOS platform is shown in Figure 3. The user may switch among the IS-EPOS portal, Documents repository, Platform User Guide and Forum (Field 1, Figure 3). Portal grants access to three major facility categories: The AH Episodes (database), the Applications (Field 2, Figure 3) and the user's workspace (Field 3 Figure 3). In the workspace the user may upload and use the available data and Applications at any combination. In the example of Figure 3 the AH-Episodes category is selected and the user may select an Episode from the list or filter this list by either involvement in particular Project or Impacting Factor (Field 4, Figure 3). In such way the user obtains access to the selected Episode database. Alternatively, advanced data search can be performed (Field 5, Figure 3), which provides additional filtering and searching options.  

Figure 3. AH Episodes Main Page of IS-EPOS

TABS AND ICONS

Most of the command tabs are self-explanatory (such as 'search', 'plot', 'show', 'Add to workspace', etc).

The 'Actions' tab provide a list of actions:

-          In case of the AH Episodes data, the only available action is 'Add to workspace'.

-          In the case of seismic catalogs there is also a tab 'action list' which provides visualizations of catalog elements such as tables with catalog contents, seismic activity step plot, 3D events distribution etc.

-          In case of the elements in workspace (data, results) the 'Actions' tab provides a variety of actions depending upon the format and potential usage of an element. Such actions are also self-explanatory as: 'copy', 'delete', 'use in Application', 'make a directory', etc.

There are also some actions which are defined by the following symbols:

File information (in the advanced data search)

View file (in the advanced data search)

Add to workspace (in the advanced data search)

  Actions list for the seismic catalog contents. It includes visualization tools such as histograms and 1D plots. 

  Logout (always shown at the top right corner of the IS-EPOS Portal)

  Print the chart (for figures)

  Export to raster or vector image (for figures) in 'png', 'jpeg' or 'pdf' image format and 'svg' vector format

  Directory (Workspace)

  File (Workspace)

  Application (Workspace)

  Show a list to select an item or option

AH EPISODES

Each AH Episode contains some informative fields and a short Description of the Episode and related images (Figure 4). Episode Data are found just below the Description and they are categorized into 3 groups of different data types (Field 1, Figure 4): Seismic data, Industrial data and Geodata (Other data relevant to anthropogenic hazards, such as physico-chemical water properties or air quality data are also available in certain Episodes). There are additional fields shown in Figure 4:

Field 2, "All data related to this episode", grants access to the "Advanced data search"

Field 3, "Available visualizations" gives the ability to the User to perform various visualizations, regarding the selected Episode.

Field 4, "See more information in Document Repository", leads the User to the document repository engine.

Figure 4. Demonstration of an AH Episode 

APPLICATIONS

The available applications in IS-EPOS are grouped into Data Processing and Data Handling applications, each one containing several applications (the user may extend the applications by clicking on each category).

-          Data Processing Applications sustain advanced methodologies for AH data analysis:

• Inter-event Time Distribution Analysis

• Completeness Magnitude Estimation
• Time-Dependent Seismic Hazard (in mining front surroundings)
• Time-Dependent Seismic Hazard (in mining a selected area)
• Stationary Seismic Hazard Parameters (Exceedance Probability, Maximum Credible Magnitude, Mean Return Period)
  
• Source Size Distribution Functions
• Source Localization/Relocalization
• Moment Tensor Inversion
• Spectral Analysis
• Fracture Network Models - Mechanical Stresses
• Stress Inversion
• Correlation Analysis (Autocorrelation, Coefficient of Randomness, Cross Correlation, Priestley-Subba Rao Test)

-          Data Handling Applications comprise tools for data transformation and handling:  

• Catalog Export
• GDF Export
• Magnitude Conversions
• Catalog filtering
• Waveform Processing tools (Signal Download tool, Seismogram Picking Tool, SEED to SAC Converter, Waveform Download Tool)
  
• Time Series Builder
• Ground Motion Parameters Tool

Information on each selected Application is shown on the screen (short description and affiliation) and the user may upload the Application in the workspace to perform applications by clicking on the 'Add to Workspace' tab.

DOCUMENT REPOSITORY

Figure 5 demonstrates how the Document Repository web page looks like within the IS-EPOS platform. The 'About' page contains contact information and useful links, that can be accessed by clicking on the links in blue fonts. The choices provided to the user, (tabs in red boxes, indicated by the numbers in Figure 5) are the following:

1) Leads to the IS-EPOS web platform.

2)  Leads to IS-EPOS Document Repository Home page. The Search Repository tool is provided here, which supports both quick and advanced search.

3) Leads to the IS-EPOS platform User Guide

4) Leads to 'Browse' page. Items can be browsed by Year, Subject, Episode, Author or Software references

5) Leads to search repository options (quick and advanced)

Figure 5. Document Repository page with available functionalities

TUTORIAL

Example of estimating seismic hazard parameters from a catalog.

Step 1: Select a specific Episode from the list by clicking on one of the panels (e.g. the one indicated by the red box in the figure):

Step 2: Select a data type from the list (e.g. ‘Catalog’ in this example). There are several data types available with respect to the episode and the induced seismicity technology:

Step 3: Once the user selects one data type, access is granted to data attributes, numerical values and visualization applications. For further data processing the user has to click on the "Actions" tab and then on the 'ADD TO WORKSPACE' window which appears right below (red frame at the top of Figure). There are several option for that, either add as a link or  a copy to a selected location (directory). The data has now moved to the workspace and can be processed by the means of Data Handling and Data Processing applications and Visualization tools:

Step 4: Once the selected data are uploaded in the workspace (a file has appeared in the workspace tree), the user may click on the 'Actions' tab in order to use these data in one of the available applications as shown in the figure. 'Source size distribution functions/ Stationary Hazard' is selected in this case:

Step 5: The application has now been selected and the user is requested to fulfill some fields with parameter values needed for the SSH analysis (red frames in the Figure). These parameters can be selected either from a list of values (e.g. 'Select Magnitude column') or just typed by the user (e.g. 'Start', 'End' and 'Step of Magnitude'. Note that 'Mmin' parameter can either be typed or chosen from the histograms after clicking on 'Histogram' or 'Cumulative Histogram' tabs. 'Change Input' can be selected for using a different dataset under the precondition that it is already uploaded in the workspace. Once all the parameters have been selected, the user may click on the 'Run' button (green button at the bottom of the figure), for the calculation process to be initiated:

Step 6: The process soon terminates and the status changes to 'Finished'. The results of the process include a report with parameters values previously selected by the user and then estimated by the system (blue panel in the figure) and two charts plotting the PDF and CDF of the magnitude distribution, respectively, as functions of magnitude. The figures may be printed or downloaded by clicking on the icons indicated in the red frame of the figure. Options for figure handling are available below the charts. 

Step 7: The output of the Application contains files in matlab format (.mat files shown in the blue frame of the figure). These files can be further used in a variety of actions including downloading, copying and use in other applications e.g. for estimating the Mean Return Period (red frame of the figure).

IS-EPOS is available in social media

Facebook: https://www.facebook.com/Anthropogenic-Hazard-564300977074963/

Twitter: https://twitter.com/TCS_AH)

ADDITIONAL RESOURCES

IS-EPOS webpage: http://is-epos.eu/home,2,en.html

IGF-PAS webpage: http://www.igf.edu.pl/home.php

ACK CYFRONET webpage: http://www.cyfronet.krakow.pl/

EPOS webpage: http://www.epos-eu.org/

AH-EPOS Platform User Guide (Confluence): https://docs.cyfronet.pl/display/ISDOC/