The IS-EPOS Platform gathers data related to environmental hazards triggered by human activity and software allowing for processing and visualization of these data. The data are offered in form of grouped datasets (Episodes) that relate anthropogenic seismicity to its industrial cause. The software is provided as a set of Applications prepared to operate on these data. The applications are run within the user Workspace, which also provides means for storing, comparison and organization of the initial and processed data. The contents of the Workspace might be shared with other users, thus facilitating the collaborative aspect of their research.

Contents of this guide

This quick start guide will briefly introduce you to the IS-EPOS Platform, showing you the registration process, main menus and symbols. You will also see an example scenario how the Platform can be used to work with its data and applications. Each main page of the platform is additionally described on the subsequent pages of this documentation:

Citations

When publishing results obtained using IS-EPOS Platform, please cite the following articles:

Orlecka-Sikora, B., Lasocki, S., Kocot, J. et al. (2020) An open data infrastructure for the study of anthropogenic hazards linked to georesource exploitation., Sci Data 7, 89, doi: 10.1038/s41597-020-0429-3.
Lasocki, S. and Orlecka-Sikora, B. (2016) Integrated approach to geophysical hazards induced by exploration and exploitation of georesources - to facilitate the way of attaining excellence, EPOS Newsletter 1, July 2016
Leptokaropoulos, K., Cielesta, S., Staszek, M. et al. (2019). IS-EPOS: A Platform For Anthropogenic Seismicity Research, Acta Geophysica, 67(1), pp. 299-310, doi:10.1007/s11600-018-0209-z.

Data contained within the Platform also have their citing information provided in a How to cite section of each episode to which the data belongs (see also page AH Episodes of this guide).

The IS-EPOS web platform is available at https://tcs.ah-epos.eu/ IS-EPOS operational language is English. If a user has already an account, he/she can easily log in by clicking on the 'LOGIN' tab (top right corner of Figure 1) and simply providing the e-mail address and password. To create an account, the user shall click on either the ‘SIGN UP’ tab (blue button, the right top corner of Figure 1). The fields that the user is requested to fill are shown in Figure 2. After submitting the registration form the system verifies the provided affiliation and the user can hereinafter log in the IS-EPOS web-platform.

Figure 1. Start Page of the IS-EPOS platform

Figure 2. Registration form to sign up

Affiliations

TODO

IS-EPOS HOME PAGE

The home page of IS-EPOS platform is shown in Figure 3. The user may switch among (from left to right, Field 1, Figure 3) the Platform Start Page, the IS-EPOS portal (demonstrated in Figure 3), Documents repository and Support. This latter field includes a shortcut to Platform User Guide, the Platform Forum and a contact form in order to submit queries and comments to the IS-EPOS team. The 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. Alternatively, advanced data search can be performed (Field 5, Figure 3), which provides a plethora of additional filtering and searching options. Finally, the user may edit his/her profile and affiliations and request access to particular Project-related Episodes and Applications (Field 6, Figure 3). To log out, the user has to click on the icon shown in Field 7 of Figure 3.

Figure 3. AH Episodes Main Page of IS-EPOS platform with the basic features and available functionalities

TABS AND ICONS

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

The 'Actions' tab provide a list of actions:

In case of the AH Episodes data, the available actions are 'View File, 'View Episode', 'Add to workspace' (either as file or as a link) , 'Show file information' and 'Download'.
In the case of seismic catalogs there is also a tab 'action list' which provides, depending on the episode, 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', 'create link' etc.

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

View file (in the advanced data search)

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

Application (Workspace)

Expand the list of action in the elements located in My Workspace

When the User holds the cursor still on that icon, information of the corresponding element appears in the screen

Delete multiple files

Refresh Workspace

Contact form

TODO

Usage scenario

Example of estimating stationary seismic hazard (SSH) 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 below):

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 right corner of Figure below). There are several options 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 any 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 either on the three dots icon to the right of 'SONG_TRANH_catalog.mat' or on the 'Actions' tab (right top corner of the figure) in order to use these data in one of the available applications as shown in the figure below. '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 fulfil 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. 'Chosen 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. The 'SAVE' button can be also used for saving the application form (Field 1). Autorun option can be selected as well (Field 2):

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 below). 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 frames in the Figure below).

IS-EPOS Platform and EPOS

The IS-EPOS Platform is the core of Thematic Core Service Anthropogenic Hazard (TCS-AH), an e-research infrastructure of the European Plate Observing System (EPOS). TCS AH is one of 10 thematic core services forming EPOS, a solid earth science European Research Infrastructure Consortium (ERIC). It is integrated within the EPOS Integrated Core Service (ICS), providing additional opportunities for interoperability with different scientific communities engaged in solid earth science.