Anchor
top top

Contents of this guide

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

Citations

When publishing results obtained using IS-EPOS EPISODES 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.

Image Removed

Image Removed

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.  

Image Removed

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:

Image Removed View file (in the advanced data search)

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

  Image Removed  Application (Workspace)

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

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

Image Removed Delete multiple files

Image Removed  Refresh Workspace

TODO

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): 

Image Removed

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:

Image Removed

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:

Image Removed

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:

Image Removed

Main page and navigation

The main page of the EPISODES Platform is http://EpisodesPlatform.eu, it provides basic information about the Platform and its main goals (see Figure 1). The main page, as well as all the other pages within the Platform contain have the same navigation menu, from which you can register or log in (with buttons marked with (1) in Figure 1), and go to the core part of the EPISODES Platform by using the Episodes Platform menu (marked with (3) in Figure 1) or the Try EPISODES Platform button. Inside you will find AH Episodes, Applications and My Workspace described in further chapters of this guide.

Image Added

Figure 1. Main page of the EPISODES Platform with most important elements marked

Anchor
Registration Registration

Registration/Sign up

To create your own user account for the EPISODES Platform, use the Sign up button you in the top right corner of the page (marked with (1) in Figure 1). You will be provided with a registration form (Figure 2), where it is required that you fill your e-mail address (it will be also used as your username when you log in), password and optional personal information.

Image Added

Figure 2. Registration form

The registration is free of charge and does not require any confirmation from the EPISODES Platform staff. Once the process is successful, you should receive a confirmation e-mail and be able to log in.

Anchor
LogIn LogIn

Logging in

After successful registration, you can now log in to your account. Do this by using the Log in button on the right side of the site menu, next to the Sign up button you used to register (both buttons are marked with (1) in Figure 1). This will take you to the EPISODES Platform Single Sign On page (see Figure 3). Your login is the e-mail address you provided during the registration process.

Image Added

Figure 3. EPISODE Platform user account login panel

Notice, that after you log in, the right part of the site menu changes, displaying your user name and allowing you to access your Profile and Affiliations page. You will also now be able to access your workspace and to download episode files to your local computer.

Thanks to using the SSO system, you will log in with the same login and password, and using the same page to all the tools related to the Platform, including Application Workbench. You will also be able to use this form of authentication when logging in to the ICS-C Portal (see also Accessing through EPOS ICS-C).

Changing the language

The interface of EPISODES Platform is currently available in three languages: English, French and Polish. The displayed language is based on your browser settings, with English as default. To change the language use the menu with the language abbreviation in the top-right corner of the page (marked with (2) in Figure 1). If you already have your user account, you can also change the language by editing it in your profile, it will be remembered by the system the next time you log in.

User profile

The preferences associated with your account are managed within the Profile and Affiliations page (see Figure 4) accessed from the main navigation menu. Note, that the page is available only after logging in.

Image Added

Figure 4. User Profile and Affiliations page with most important elements marked

By editing your profile data (marked with (1) in Figure 4) you can customize your personal information and preferences. You can also change your password (panel marked as (2) in Figure 4)

Anchor
Affiliations Affiliations

Affiliations

While most of the data and applications offered by the EPISODES Platform are open, there are also some datasets that were embargoed by their data providers or are limited to non-commercial use only. Therefore, if you want to access them, you have to provide a relevant affiliation. There are two types of affiliations: researcher status or a project membership (both marked with (3) in Figure 4).

Applying for the researcher status (Figure 5), will grant you access to the resources restricted to non-commercial use after you are verified. The verification is based on the provided e-mail address coming from your research institution (it doesn't have to be the same e-mail address you used for the registration) and the institution's webpage (if you are listed there, it may speed up the process) may last up to one working day. After you are positively verified, you will obtain an e-mail confirmation. If your request is rejected, you will also get the reason for rejection in the incoming message.

Image Added

Figure 5. Form used to apply for researcher's status

To apply for the project membership affiliation (Figure 6), you have to be a member of one of the projects that is a source of an embargo on data or application. Choose your project, and Work Package in it (if required) from the list and send the request. Similarly as in case of the researcher status, your membership in the chosen project will be verified by our staff and you will be notified by e-mail of the result of verification.

Image Added

Figure 6. Form used to apply for project membership affiliation

To send a message (e.g. to report problem or suggest improvement) to our staff, please use the contact form available from the Support menu (marked with (4) in Figure 1). Provide your message along with your e-mail address so that we could answer your request.

Image Added

Figure 7. Contact form

Deleting your account

To delete your account from the EPISODES Platform use the Delete account button on your user profile page (marked with (4) in Figure 4). Note, that this operation is irreversible. We will not be able to re-create your data after we delete them.

Feedback and support

In case you need any support in working with the EPISODES Platform, use the Support menu from the main portal menu (marked with (4) in Figure 1). You will find there the link to this documentation, user forum and the contact form.

We would also much appreciate any feedback you could leave us after using the Platform - we prepared a short survey that can be accessed using the Your Feedback from the aforementioned Support menu. You can also rate us by using the widget in right lower corner of each page (marked as (5) in Figure 1). You can also send us your comments by contact form.

EPISODES Platform and EPOS

The EPISODES Platform is the core of Thematic

Image Removed

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. 

Image Removed

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).

Image Removed

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.

Follow us on social media

Facebook profile: https://www.facebook.com/AnthropogenicHazard/

Twitter: https://twitter.com/TCS_AH

Additional resources

IS-EPOS TCS AH webpage: httphttps://istcs.ah-epos.eu/home,2,en.html

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

IS-EPOS Platform User Guide: https://docs.cyfronet.pl/display/ISDOC/

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

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

Back to top

Related Documents