Software User Manual - SWEswe.ssa.esa.int/ISM_Public-portlet/resources/SSA-SWE-SWEP-SUM-01… · Distribution SSA-SWE-SWEP ESA UNCLASSIFIED – For Official Use esac ... [AD.14] Monthly

Prepared by R. Keil, P. Beltrami, U. Martinez

Reference SSA-SWE-SWEP-SUM-0100

Issue 1

Revision 2

Date of Issue 25/04/2014

Status

Document Type SUM

Distribution SSA-SWE-SWEP

ESA UNCLASSIFIED – For Official Use

esac

SSA SWE - Two New Precursor Services Software User Manual for Users

Page 2/48

SSA SWE - Two New Precursor Services - Software User Manual for Users

Date 25/04/2014 Issue 1 Rev 2

© Copyright European Space Agency, 2012


The copyright of this document is vested in the European Space Agency. This document may only be reproduced in whole or in part, stored in a retrieval system, transmitted in any form, or by any means electronically, mechanically, or by photocopying, or otherwise, with the prior written permission of the Agency.

Page 3/48





Title SSA SWE - Two New Precursor Services - Software User Manual for Users

Issue 1 Revision 2

Author Ralf Keil Date 25/04/2014

Approved by Date

Pablo Beltrami

Reason for change Issue Revision Date

Initial DRAFT version 1 0 25/04/2014

Implementation of CDR RIDs 1 1 24/02/2014

Remove texts describing the tasks of operators &

administrators (cf. SUM for Operators &

Administrators)

1 2 24/03/2014

Preparation for the AR1D 25/04/2014

Issue 1 Revision 2

Reason for change Date Pages Paragraph(s)

RID #22 24/02/2014 (moved from SSA-

SWE-SWEP-SSD-

0200)


SWE-SWEP-SSD-

0200)

RID #83 24/02/2014 (partly moved from

SSA-SWE-SWEP-

SSD-0200)


SWE-SWEP-SSD-

0200)

RID #96 24/02/2014 (partly moved from

SSA-SWE-SWEP-

SSD-0200)


SWE-SWEP-SSD-

0200)

RID #111 31/01/2014 38 6.4.1

Page 4/48





RID #120 24/02/2014 Title

RID #124 24/02/2014 29 6.4

RID #125 24/02/2014 17 5

RID #126: Section 6.2 removed; will be included in the

SCF (check SSA-SWE-SWEP-SCF-

0001_OverallReduDeployment.pptx for the

implementation of this RID)

24/02/2014

RID #127: Section 6.3 from a previous version

removed; will be included in the SCF

24/02/2014

RID #130 24/02/2014 26 6.2

RID #131 24/02/2014 39 – 41 9, 10, 11

Update Figure 2 (removal of OSB) 25/04/2014 9 Figure 2

Page 5/48





Table of contents:

1 INTRODUCTION ............................................................................................................................. 7 1.1 Purpose ............................................................................................................................................................................... 7 1.2 Project Overview ................................................................................................................................................................ 7 2 APPLICABLE AND REFERENCE DOCUMENTS ............................................................................. 10 2.1 Applicable Documents ..................................................................................................................................................... 10 2.2 Reference Documents ....................................................................................................................................................... 11 3 TERMS, DEFINITIONS AND ABBREVIATED TERMS ..................................................................... 12 3.1 Acronyms .......................................................................................................................................................................... 12 3.2 Glossary ............................................................................................................................................................................ 16 4 PURPOSE OF THE SOFTWARE ..................................................................................................... 23 5 OPERATIONS BASICS ................................................................................................................... 24 5.1 Service roles ...................................................................................................................................................................... 24 5.2 Tasks identification .......................................................................................................................................................... 24 5.3 Sequence of tasks ............................................................................................................................................................. 25 6 OPERATIONS MANUAL ................................................................................................................ 26 6.1 General ............................................................................................................................................................................. 26 6.2 Getting started .................................................................................................................................................................. 26 6.3 Mode selection and control.............................................................................................................................................. 27 6.4 Normal operations ........................................................................................................................................................... 29 6.4.1 The RAF Service solution .............................................................................................................................................. 29 6.4.1.1 Public section ..............................................................................................................................................................29 6.4.1.2 Private section .............................................................................................................................................................34 6.4.2 The ISM Service solution .............................................................................................................................................. 40 6.4.2.1 Public section ............................................................................................................................................................. 40 6.4.2.2 Private section .............................................................................................................................................................43 6.5 Normal termination ......................................................................................................................................................... 47 6.6 Error conditions ............................................................................................................................................................... 47 6.7 Recover runs .................................................................................................................................................................... 48

Page 6/48





Table of tables:

Table 1: Applicable Documents ................................................................................................................................................. 10 Table 2: Reference Documents .................................................................................................................................................. 11 Table 3: List of acronyms ........................................................................................................................................................... 16 Table 4: Glossary terms ............................................................................................................................................................. 22 Table 5: Service roles ................................................................................................................................................................. 24 Table 6: Identified tasks and associated roles .......................................................................................................................... 24

Table of figures:

Figure 1: Overall SSA Architecture ............................................................................................................................................. 8 Figure 2: Concept view of the system, with particular respect to the two new precursor services RAF and ISM................... 9 Figure 3: RAF and ISM sequences of tasks .............................................................................................................................. 25 Figure 4: Home page of the SWE Portal ................................................................................................................................... 27 Figure 5: ISM entry point in the SWE Portal ........................................................................................................................... 28 Figure 6: RAF entry point in the SWE Portal ........................................................................................................................... 28 Figure 8: The entrance page of the RAF service during dark time (when auroral cameras are in operation) ....................... 31 Figure 17: ISM service nowcast worldwide map of scintillation level ..................................................................................... 40 Figure 18: ISM service nowcast scintillation values for the given location .............................................................................. 41 Figure 21: ISM service forecast worldwide map of scintillation .............................................................................................. 44 Figure 22: Forecast Scintillation estimation plot ..................................................................................................................... 45 Figure 24: SWE Portal Application Subscriptions page .......................................................................................................... 47 Figure 25: RAF Nowcast error page .......................................................................................................................................... 48

Page 7/48





1 INTRODUCTION

1.1 Purpose

This document is the Software User Manual for the users for the work package WP-SWE on the two services “Regional Aurora Forecast” (RAF) and “Ionospheric Scintillation Monitoring” (ISM) being the two new precursor services of the SSA (Space Situational Awareness) DC-IV Evolution of the Pilot Data Centres project in the SWE segment. The DC-IV SWE project is carried out for ESA by a consortium consisting of etamax space as prime contractor supported by FMI, CLS and IEEA as subcontractors.

The document is a formal deliverable of the SSA DC-IV project, work package WP-SWE-4100 on the implementation activities of the project. It covers the description of the two sets of web pages, one per service. This document is complemented by the Software User manual for Operators & Administrators ([RD.10]).

1.2 Project Overview

This ESA pursues its programme on Space Situational Awareness (SSA) in two distinct development strategies:

Definition of the complete future SSA system, comprising the system architecture and design both for the space and ground segments. They are based on system requirements and derived from user requirements. The SSA system is designed to take care of governance and data policy issues of sensitive data,

Rolling out SSA precursor services by reusing and federating existing assets in Europe and later extending them. The practical experience gained in the provision of SSA SWE services and the support for the SSA community is to be fed back in the development activities of the aforementioned first approach.

The SSA system is expected to be highly distributed and federated. The Data Centres hold the storage data-bases that store information produced by the Sensor Operation Centres and accept requests from Service Centres. For the Space weather (SWE) domain, which is the subject of the current activity in this WP-SWE, the Data Centre will be in Redu (Belgium) and the SWE service coordination centre (SSCC) located initially at the Space Pole in Brussels will be in linked by a dedicated line to the SWE data centre at Redu.

The new services to be integrated into the SWE web portal are part of the “SWE Service Provision” building block shown in Figure 1. This block interacts with the COSIF and the “SSA Front End”, i.e. the SSA Identity Management Service (as it is realised in the DC-II activities).

Page 8/48





Figure 1: Overall SSA Architecture

The SSA DC-IV project is part of the precursor activities in the SSA program and is an evolution of the SSA DC-II project, which provides essential parts of the SSA System, i.e. business processes, SOA generic services to deploy a COSIF in the IRE, SWE Data Centre at Redu and Tasking Centre at ESOC. In the frame of DC-IV two new service solutions will be implemented:

A Regional Aurora Forecast Service and

An Ionospheric Scintillation Monitoring Service,

These service solutions will be developed by integrating newly developed and legacy algorithms into the SWE Data Center.

Page 9/48





Figure 2 sketches the overall architecture of the SWE portal and its services, emphasizing the elements essential for both services to be integrated into the architecture under development by the SSA DC-II project, showing the new components to be implemented in DC-IV.

Figure 2: Concept view of the system, with particular respect to the two new precursor

services RAF and ISM

The overall objectives of the DC-IV work package WP-SWE “New Space Weather Precursor Services” are

Design, implement, and deploy two new SWE precursor service solutions:

o A Regional Aurora Forecast Service (RAF) and

o An Ionospheric Scintillation Monitoring Service (ISM),

Design the SWE precursor services such that they are coherent with the development of the SSA DC-II SWE Portal development as a SOA architecture,

Design the new SWE precursor services business processes in the way to maximize the reuse of SOA generic services,

Design the SWE precursor services business processes maximizing the reuse of generic enabling services to be provided by SSA DC-II,

Integrate the new SWE precursor services within a new application server

Page 10/48





2 APPLICABLE AND REFERENCE DOCUMENTS

2.1 Applicable Documents

The following documents are applicable. The version and date information of these applicable documents can be found in [RD.2].

Ref. Title Code

[AD.1] DC-IV SSA Prototype Pilot Data Centres: Statement of Work Appendix I to ITT

SSA-DC-CF-SOW-0004

[AD.2] ECSS-E-ST-40C Space Engineering –Software: Tailoring for Ground

Segment Systems

QMS-EIMO-GUID-CKL-9500-

OPS

[AD.3] ECSS-Q-ST-80C Space Product Assurance - Software Product

Assurance: Tailoring for Ground Segment Systems

QMS-EIMO-GUID-CKL-9501-

OPS

[AD.4] SSA Software Configuration Management Plan SSA-CS-SW-CMP-0001

[AD.5] ESA Security Plan Template

http://forum.esacert.esa.int/internal-forum/esacerton/ESASystem-

Security-Plan

[AD.6] ESA Security Directives ESA/ADMIN/IPOL(2008)6,

ANNEX 2

[AD.7] ESA Network Security Policy ESA/ADMIN(99)6

[AD.8] ESA Security Plan Template http://forum.esacert.esa.int/internal-

forum/esacerton/ESASystem-Security-Plan

---

[AD.9] ESA SSA CO-III Software Quality Model ---

[AD.10] SSA Software Configuration Management SSA-CS-SW-CMP-001

[AD.11] SSA Preparatory Programme

Information and Communication Technologies Design Solution

---

[AD.12] SSA Systems Specification Document (Option 5) ---

[AD.13] SSA Precursor Services Software

Development Baseline Specification

SSA-DC-SW-SRB-001

[AD.14] Monthly Progress Report Template

BIRF-MPR v2.5.1

EGOS-GEN-BIRFSW-TN-

1002-I2R5+MPRtool.xls

[AD.15] SSA SOA Governance Model SSA-CS-SW-RD-0003

[AD.16] SSA Service and Data Meta-Model SSA-CS-ESA-SD-0001

[AD.17] SSA SWE – Two New Precursor Services

Software Development Plan

SSA-SWE-SWEP-SDP-0001


Software Requirements Specification – Regional Aurora Forecast

SSA-SWE-RAF-SRS-0002


Software Requirements Specification – Ionospheric Scintillation

Monitoring

SSA-SWE-ISM-SRS-0002

Table 1: Applicable Documents

http://forum.esacert.esa.int/internal-forum/esacerton/ESASystem-Security-Plan

http://forum.esacert.esa.int/internal-forum/esacerton/ESASystem-Security-Plan

Page 11/48





2.2 Reference Documents

The following table is an excerpt of the full list of reference documents to be used for general guidance only and need not to be applied, but they should be given precedence over other documents covering similar topics. The version and date information of these reference documents can be found in the Document Control List [RD.2].

Ref. Title Code

[RD.1] SSA DC-II SWE Portal Services (WP5) – Software Design Document SSA-SWE-SWEP-SDD-0001

[RD.2] SSA SWE – Two New Precursor Services

Document Control List

SSA-SWE-SWEP-DCL-0002

[RD.3] SSA SWE – Two New Precursor Services – SWE Portal System,

Software Design Document

SSA-SWE-SWEP-SDD-0200

[RD.4] SSA SWE – Two New Precursor Services – SWE Services, Software

Design Document

SSA-SWE-SWEP-SDD-0040

[RD.5] SSA SWE – Two New Precursor Services – Glossary SSA-SWE-SWEP-GLO-0002

[RD.6] SOA Principles of Service Design, by Thomas Erl

http://serviceorientation.com/

ISBN: 0132344823

[RD.7] SSA SWE – Two New Precursor Services – SWE Portal System,

Interface Control Document

SSA-SWE-SWEP-ICD-0200

[RD.8] SSA SWE – Two New Precursor Services – SWE Services, Interface

Control Document

SSA-SWE-SWEP-ICD-0040

[RD.9] SSA SWE – Two New Precursor Services – Software User Manual for

Users

SSA-SWE-SWEP-SUM-0100

[RD.10] SSA SWE – Two New Precursor Services – Software User Manual for

Operators & Administrators

SSA-SWE-SWEP-SUM-0101

[RD.11] SSA DC-IV – Two New Precursor Services – Software Configuration

File

SSA-SWE-SWEP-SCF-0002

[RD.12] …

[RD.13] …

Table 2: Reference Documents

http://serviceorientation.com/

Page 12/48





3 TERMS, DEFINITIONS AND ABBREVIATED TERMS

3.1 Acronyms

Acronyms used in this document and needing a definition can be found in the Glossary (SSA-SWE-SWEP-GLO-0002).

Acronym Definition 2D Two Dimensional 3D Three Dimensional AD Applicable Document AND Alphanumeric Display API Application Programming Interface AR Acceptance Review ASCII American Standard Code for Information Interchange BIRF Business Intelligence and Reporting Framework BP Business Process BPMN Business Process Model and Notation CAPF Central Archiving and Processing Facility (MONITOR project) CCN Contract Change Notice CCSDS Consultative Committee for Space Data Systems CD Compact Disc CDDIS Crustal Dynamics Data Information System (NASA) CDR Critical Design Review CFI Customer Furnished Item CLS Collecte Localisation Satellites CM Configuration Management CME Coronal Mass Ejection CMS Content Management System CN Change Notice COE Centre Of Excellence COSIF Common SSA Integration Framework COSPAR Committee On Space Research COTS Commercial-off-the-Shelf CR Change Request CRUD Create, Read, Update, Delete CSV Comma Separated Values DC Data Centre DORIS Doppler Orbitography and Radiopositioning Integrated by Satellite DVD Digital Versatile Disc E2E End-to-end ECMWF European Centre for Medium-Range Weather Forecasts ECSS European Cooperation for Space Standardisation EDID European Impact Detector Database ENET Ethernet EoC End of Contract

Page 13/48





Acronym Definition EOA ESA Owned Asset ESA European Space Agency ESAC European Space Astronomy Centre ESB Enterprise Service Bus ESC Expert Service Centre ESOC European Space Operations Centre FAT Factory Acceptance Test FMI Finnish Meteorological Institute FTP File Transfer Protocol GBAS Ground-Based Augmentation System GCC GNU Compiler Collection GISM Global Ionospheric Scintillation Model GLONASS Global Navigation Satellite System (a radio-based satellite navigation

system) GNSS Global Navigation Satellite System GPS Global Positioning System GSIUS Ground Segment Infrastructure Support Services GUI Graphical User Interface HIRLAM High Resolution Limited Area Model HMI Human-Machine Interface HTML Hypertext Markup Language HTTP Hypertext Transfer Protocol HTTPS HTTP Secure HW Hardware ICD Interface Control Document ICT Information and Communications Technology ID Identifier IDL Interactive Data Language IdP Identity Provider IGN Institut Géographique National (France) IGS International GNSS Service IMT Infrastructure Maintenance Team I/O Input/Output IP Internet Protocol IPP Ionospheric Pierce Point IPR Intellectual Property Right IRE Integration and Reference Environment ISM Ionospheric Scintillation Monitor (Instrument) ISM Ionospheric Scintillation Monitoring (Service) ISO International Organisation for Standardisation IT Information Technology ITIL IT Information Library ITT Invitation to Tender J2EE Java 2 Platform Enterprise Edition JMS Java Message Service JMX Java Management Extension

Page 14/48





Acronym Definition JPA Java Persistence API JPEG Joint Photographic Experts Group JSF Java Server Faces JSP Java Server Pages KO Kick-off KP Key Parameter KPI Key Performance Indicator LAN Local Area Network LDAP Lightweight Directory Access Protocol MMI Man-Machine Interface MOI Mission Operations Infrastructure MPM Monthly Progress Meeting MPR Monthly Progress Report MS Microsoft N/A Not Applicable NASA National Aeronautics and Space Administration NCR Non-Conformance Report NOAA National Oceanic and Atmospheric Administration NRT Near Real-Time OASIS Organisation for the Advancement of Structured Information Standards OGC Open Geospatial Consortium OS Operating System OSAT On-Site Acceptance Test PA Product Assurance PDF Portable Document Format PDR Preliminary Design Review PEP Policy Enforcement Point PM Progress Meeting PMP Project Management Plan PNG Portable Network Graphics PP Preparatory Programme PRIS Prediction of Ionospheric Scintillations QA Quality Assurance QAP Quality Assurance Plan QMS Quality Management System RAF Regional Aurora Forecast (Service) RD Reference Document RF Radio Frequency REST Representational State Transfer RFP Request For Proposal RID Review Item Discrepancy RINEX Receiver INdependent EXchange format SBAS Satellite-Based Augmentation System SDE System Development Environment SDLC System Development Life-Cycle SDT Software Development Team

Page 15/48





Acronym Definition SFTP Secure FTP SI Software Item SIDC Solar Influences Data Analysis Center SLA Service Level Agreement SMS Short Message Service SOA Service Oriented Architecture SOAP Simple Object Access Protocol SoW Statement Of Work SPR Software Problem Report SQM Software Quality Model SRR Software Requirements Review SRS Software Requirements Specification SSA Space Situational Awareness SSCC SWE Service Coordination Centre SSGAT SSA SOA Governance Templates SSGCB SSA SOA Governance Cook Book SSGM SSA SOA Governance Model SSGR SSA SOA Governance Requirements SSGT SSA SOA Governance Tooling SSO Single Sign On STC Special Tender Conditions STS Security Token Service SUM Software User Manual SVG Scalable Vector Graphics SW Software SWE Space Weather SWENET SWE Network SWPC SWE Prediction Centre SWRR Software Requirements Review T0 Beginning of the project TAD Travelling Atmospheric Disturbances TBC To Be Completed TBD To Be Discussed TBW To Be Written TEC Total Electron Content TID Travelling Ionospheric Disturbances TO Technical Officer TRR Test Readiness Review UI User Interface UML Unified Modelling Language URI Uniform Resource Identifier URL Uniform Resource Locator UTC Coordinated Universal Time VHF Very High Frequency VM Virtual Machine WAN Wide Area Network

Page 16/48





Acronym Definition WBFE Web-Based Front End WBS Work Breakdown Structure WP Work Package WPD Work Package Description WS Web Service WSDL Web Services Description Language XACML eXtensible Access Control Markup Language XML eXtensible Markup Language

Table 3: List of acronyms

3.2 Glossary

A glossary of the terms and definitions used in this document is given in Table 4.

Term Definition

Alert Alerts on space weather data based on a set of conditions and thresholds specified by users at subscription time.

Alert Subscription Allows the users to subscribe to selected datasets and specify a set of conditions and thresholds. An alert email is sent to the e-mail address specified in the subscription when a threshold is crossed.

ASAP “As soon as possible”; when conditions warrant an email with the notification will be sent.

Aurora A natural light display in the sky particularly in the high latitude (Arctic and Antarctic) regions, caused by the collision of energetic charged particles with atoms in the high altitude atmosphere (thermosphere). The charged particles originate in the magnetosphere and solar wind and, on Earth, are directed by the Earth's magnetic field into the atmosphere.

Crustal Dynamics Data Information System (CDDIS; NASA)

A global data centre to serve for the International GNSS Service (IGS) and provides ready on-line access to a variety of data sets, products and information about space geodesy data. The CDDIS supports data archiving and distribution activities for the space geodesy and geodynamics community. The main objectives of the system are to store space geodesy and geodynamics related data products in a central database, to maintain information about the archival of these data, and to disseminate these data and information in a timely manner.

Client Service consumer.

Coronal Mass A solar phenomenon in which huge amounts of solar material, e.g.

Page 17/48





Term Definition Ejection (CME) electrons and protons, are ejected into space. CMEs create disturbances in

the background solar wind which can lead to geomagnetic storms when they reach the Earth between 2 and 6 days after leaving the Sun. Electronic systems on board satellites and on ground can show malfunctions or failures as a result of the influence of a CME.

Concept A SKOS concept is a unit of thought. It is used to describe the conceptual or intellectual structure of a knowledge organization system such as thesauruses and classification schemes.

Data Raw or processed measurements of any space weather parameter.

Data assimilation (models / techniques)

Process by which observations are incorporated into a computer model of a real system. Data assimilation proceeds by analysis cycles. In each analysis cycle, observations of the current (and possibly past) state of a system are combined with the results from a numerical prediction model (the forecast) to produce an analysis, which is considered as 'the best' estimate of the current state of the system.

Data-driven Service or Process

These are BP or Services that are triggered by update of the data providers. They are mainly responsible for ingesting data into the SWE repository and serving this data to user-driven services and to subscribers.

Dataset Collection of time series of space weather data. Each dataset entry is assigned to a timestamp and is presented in tabular form in the following types: Numeric, Plain text, Temporal or Binary.

Data Subscription Allows the user to subscribe to selected datasets and receive new data automatically when these datasets are updated by the data provider. New data can be received by e-mail or FTP depending on the delivery mechanism specified by the user.

EOA ESA Owned Asset. These refer to space weather information systems owned by ESA providing different kind of services for space weather users. These can range from simple data provision to more complex interactive models run using user provided data.

Feature Abstraction of real-world phenomena.

[from OGC 08-094r1 document]

[see also ISO 19101:2002, definition 4.11]

Forecast Description of the space environment at a future date based on actual data, proxies and models.

Fundamental High-level classification of different datasets from various data sources,

Page 18/48





Term Definition Data Type grouped according to a science-oriented User view of the underlying and

fundamental physical nature of the measurements; i.e. what physical property or process does the measurement pertain to? Examples are: measurement of magnetic fields, plasma bulk velocity, proton flux, etc.

International GNSS Service (IGS)

Service of the International Association of Geodesy (IAG), an international organisation of geodesists. The IGS provides data sets, data products, and other information related to GPS and GLONASS, e.g. GNSS orbits, data on satellite tracking, and supplementing data in near real time. One of the primary data centres of the IGS is the CDDIS.

Indices A set of derived variables frequently used to parameterise space weather conditions and as input to models. The default sets of indices are:

- Solar Activity and geomagnetism: Ap, Kp, Dst, IG12, IMF, R, R12, F10.7, S10, E10, M10, Y10;

- Ionospheric scintillation: S4, sigma_phi, fading depth, fade duration, time between fades

Ionospheric scintillation

Observed rapid (few ms) and random high-rate variations in the phase and amplitude of a radioelectric signal as it passes through small-scale plasma density irregularities in the ionosphere (100 to 1500 km) [Conker et al., 2003].

ISES URSIgram encoded data

Some of the Reports provided by SIDC are encoded using URSIgram Codes. These URSIgram codes were originally developed to facilitate the rapid exchange of information by telex. Coded data are still useful as they are easier than text messages to ingest into automatic forecast programs. These ISES messages provided by SIDC are parsed and ingested decoded into the database.

Measure Value described using a numeric amount with a scale or using a scalar reference system.


[see also ISO 19136:2007, definition 4.1.41]

Measurement Set of operations having the object of determining the value of a quantity.


[see also ISO/TS 19101-2:2008, definition 4.20]

Metadata Data providing information about one or more aspects of the space weather data provided by the SWE portal.

Page 19/48





Term Definition

Metrics Quality indicators for datasets of type forecast. A set of statistical functions applied to the dataset and compared to a referenced dataset. E.g. a forecast of a value is compared to the measured value to generate statistic (metrics) on the quality of the forecasting model.

Near Real-time Statement that an action is occurring as close as possible to the same rate at which an observable is measured/observed.

Nowcast Reconstruction in near real-time of a description of the present space environment based on actual data, proxies and models

Observation Act of observing a property.


[see also ISO/DIS 19156, definition 4.10]

Observation Procedure

Method, algorithm or instrument, or system of these which may be used in making an observation.


[see also ISO/DIS 19156, definition 4.11]

Observation Result

Estimate of the value of a property determined through a known procedure.


[see also ISO/DIS 19156:2010]

Offering Service metadata describing the contents of an instance of a service. (OGC terminology)

Ontology The specification of a conceptualisation, used to help programs and humans share knowledge. An ontology is aimed at reducing or eliminating conceptual and terminological ambiguity, sharing understanding, enabling reuse and validation.

Phenomenon Same as fundamental data type.

Products Derived data generated using one or more space weather tool or model. An SSA Product is a digital file(s) delivered to members of a user community from an operational element of the SSA system that has a defined format and is archived and is reproducible.

Property Facet or attribute of an object referenced by a name.

Page 20/48





Term Definition


[see also ISO/DIS 19143:2010]

Provider Institutions which provide on e or more different sources of utilisable data for the SWE database

Real-time Statement that an action is occurring at the same rate at which an observable is measured/observed.

Report (for SWE data)

Space Weather Reports refer to emails sent by data providers to subscribed users containing any kind information related to space weather. This information is usually provided in textual form (e.g. news or announcements) although it might also contain numerical data in a standard format. Reports can be received either at regular intervals (e. monthly reports) or be event triggered (e.g. CME reports).

RINEX International data interchange format for raw satellite navigation system data (GNSS data). This format allows the user to post-process the received satellite data to produce a more accurate positioning solution — usually with other data unknown to the original receiver, such as better models of the atmospheric conditions at time of measurement.

Scintillation (cf. Ionospheric Scintillation)

Scintillation indices

(cf. indices)

Sensor Type of observation procedure that provides the estimated value of an observed property at its output.


Sensor Data List of digital values produced by a sensor that represents estimated values of one or more observed properties of one or more features.


Service A Service, in the sense of SOA Service, is a stateless endpoint providing any functionality, e.g. customer data service with add, remove, update operations. A SOA Service is a reusable enterprise-level unit of work, which is available on the network via open standards and combined to support business processes.

[from document „SSA Service and Data Meta-Model”, section 4.2.2]

Page 21/48





Term Definition

Service Solution The new space weather services to allow executing a dedicated process related to a space weather phenomenon

Solar activity The collective term for all active phenomena on the Sun, including sunspots, faculae, active regions, plagues, active prominences, and flares.

Space weather Conditions on the sun and in the solar wind, magnetosphere, ionosphere, and thermosphere that can influence the performance and reliability of space-borne and ground-based technological systems and can endanger human life or health. Cosmic rays are covered by this definition.

Space Weather Event

A time-limited condition of the space environment (e.g. Solar Flare, Solar energetic particle event, Substorm). Often this involves a propagating disturbance (e.g. CME or interplanetary shock).

Subscription See Data subscription or Alert subscription.

SWE Portal The web page in the frontend where the users access to the system

SWE Portal Services

The complete SSA Space Weather system

SWE Services See Service

Total Electron Content (TEC / vTEC)

Descriptive quantity for the ionosphere of the Earth. TEC is the total number of electrons present along a path between two points, with units of electrons per square meter, where 1016 electrons/m² = 1 TEC unit (TECU). TEC is significant in determining the scintillation and group delay of a radio wave through a medium. Ionospheric TEC is characterized by observing carrier phase delays of received radio signals transmitted from satellites located above the ionosphere, often using Global Positioning System satellites. TEC is strongly affected by solar activity.

Thesaurus A thesaurus is a networked collection of controlled vocabulary terms, which provide formal descriptions that approximate term meanings and enable a consistent interpretation of the terms and of their relationships. A thesaurus can be viewed as a particular case of an ontology.

User Domain User Domains as defined in the SWE CRD. The User Domains are as follows: Spacecraft Design, Spacecraft Operations, Human Spaceflight, Launch Operations, Space Surveillance and Tracking, Transionospheric Radio link, Non-Space Systems Operation, and General Data Service.

User-driven Service or Process

These are BP or Services that are triggered by an action of the user on the Portal. They are mainly responsible for obtaining the information required by the Portal to satisfy the user requests (e.g. discover data, display data,

Page 22/48





Term Definition subscribe to data or alerts, etc).

Table 4: Glossary terms

Page 23/48





4 PURPOSE OF THE SOFTWARE

The software provides the user with two services extending the list of accessible services in the SWE Web portal. These services are

A Regional Aurora Forecast (RAF) service

o to monitor the current auroral situation by means of camera images and additional information to spot the occurrence of aurora in the region of the RAF monitoring service (i.e. geogr. latitudes 60-70 deg north, longitudes 10-30 deg east)

o to provide forecast information of auroral occurrence in the region of the RAF monitoring service

A Ionospheric Scintillation Monitoring (ISM) service

o to present a nowcast or forecast worldwide and regional map of ionospheric scintillations level

o to provide a nowcast or forecasted status of ionospheric scintillations level at a given location on Earth

o to send an alert via email if the scintillation level nowcast exceeds or the forecast is expected to exceed a defined threshold at a given location

o to evaluate the scintillation level for regions where no data is available

Refer to the sections 6.4.1 (RAF service) and 6.4.2 (ISM service) in chapter 6 to read about the way how to utilise the services for your purposes.

Page 24/48





5 OPERATIONS BASICS

This chapter describes the roles and operational tasks. It identifies the sequence of tasks and hierarchy.

5.1 Service roles

The default configuration of the services includes roles for the two SWE services RAF and ISM. The following roles for persons or groups are predefined, the last three are specifically important for the permission policies.

Role Purpose

Guest Unauthenticated user

User Authenticated user

Operator Operator

Administrator Administrator

Table 5: Service roles

5.2 Tasks identification

The following table lists the tasks, each one representing a set of clear actions a user has to perform. The purpose of this table is to map each task to the role required for the task to perform.

Identified Task Associated Role

Pages view Guest

Select the service of interest User

Select set of data (service product, region of interest) User

Manage the configuration files of the services Operator

Monitor operations of each service Operator

Respond to service error messages Operator

Invoke the services, view data, edit or delete alerts Operator

Report to the administrator in case of unexpected service

behaviour

Operator

Configure all preferences related to a service, data and tools

for each service

Administrator

Table 6: Identified tasks and associated roles

Page 25/48





5.3 Sequence of tasks

Operations associated to the roles ‘Operator’ and ‘Administrator’ will be performed by the persons with the appropriate privileges only. The user will follow the sequence for the main SWE Portal Application operations and, in this way, will enter each of the services as illustrated in the diagrams below.

Figure 3: RAF and ISM sequences of tasks The guest will select the service of interest via the SWE Portal application. For each of the two services the main web page will show information visible equally for guests and registered users. In addition, the user may use the Data Viewer to display service products or subscribe to the service. In case of the ISM Service the user may select the set of data before displaying nowcast information (‘pages view’) or forecast information via the Data Viewer and saves the data.

Page 26/48





6 OPERATIONS MANUAL

6.1 General

From the technical point of view, the SSA DC-IV SWE Portal is the evolutionary successor of the SSA SN-I SWE Portal and from the users’ point of view the SWE Portal Application replaces the SWENET application as the web application on space weather related services.

The SSA DC-IV SWE Portal Services Solution is supposed to operate by means of its SWE Portal.

The SWE Portal Application is a web application. As such, it is available through a standard web browser.

6.2 Getting started

The portal is accessible at the address http://swe.ssa.esa.int using one of the popular web browsers

Internet Explorer (version 8+)

Firefox (version 5+)

Chrome (version 14+)

The main page of the DC-IV SWE Portal is the web page ‘Current Space Weather’ and will look like Figure 4.

http://swe.ssa.esa.int/

Page 27/48





Figure 4: Home page of the SWE Portal

6.3 Mode selection and control

The user may click on the link ‘Ionospheric Weather’ on the SWE Portal home page to access space weather services and information on this topic. On that web page a link will provide the user to access resources of the ISM service, see Figure 5.

Page 28/48





Figure 5: ISM entry point in the SWE Portal

The user may click on the link ‘Geomagnetic Conditions’ on the SWE Portal home page to access space weather services and information on this topic. On that web page a link will provide the user to access of the resources of the RAF service, see Figure 6.

Figure 6: RAF entry point in the SWE Portal

Page 29/48





6.4 Normal operations

This section focuses on the two service solutions and their web pages. It describes the operations a user may perform to retrieve products of the service of interest.

6.4.1 The RAF Service solution

The RAF service solution offers public web content, accessible for the guests and a private section only available for registered users.

6.4.1.1 Public section

The page shown in Figure 7 is the main page of the service during daylight time (i.e. when there is too much light at all stations for auroral imaging). Like all pages in the service, it will contain the links to the other pages of the service. The prevailing location of auroral oval is shown on a map. Two different estimates for the oval location will be given: One is based on global geomagnetic activity (Kp-index) and the other is based on regional geomagnetic activity (dB/dt-values recorded in Fennoscandia). The display of three “lamps” which can be in on/off state is used to summarize the space weather conditions as characterized by the NOAA and SIDC/CACTUS alerts during the last 48 hours.

The Daytime entrance page shows also near-real-time camera images from the Helsinki station with the refreshing rate of 5 minutes. As supporting information the cloudiness situation on a map is shown and the Sun set time and potential warning of Full Moon (with its rise and set times) are listed for each of the auroral camera stations.

Page 30/48





Figure 7: The entrance page of the RAF service during daytime (when auroral cameras are not

in operation)

The page shown in Figure 8 will be the service main page when one or more of the auroral camera stations are imaging. It will have the same contents as the daytime entrance page except instead of one NRT-image of Helsinki a set of NRT-images from all stations which are recording will be shown. Sun rise times for the camera stations will be given together with the Full Moon information.

Page 31/48





(Image to be updated when the station camaras are available again)

Figure 8: The entrance page of the RAF service during dark time (when auroral cameras are

in operation)

The page “Service information” is the guide for the RAF service. It will contain a short user guide for occasional visitors and a more thorough technical description for professional users. This page will not contain any dynamic elements. A preliminary layout of the RAF Info page is shown in Figure 9.

Page 32/48





Figure 9: Service information page

The “Auroral information” page gives a general introduction about space weather, auroral activity, and auroral occurrence rates as function of latitude, season and time. Also the issue of light pollution will be discussed. This page will not contain any dynamic elements. A preliminary layout of the General Information page is shown in Figure 10.

Page 33/48





Figure 10: Auroral information page for the RAF service

Finally, the “About” page shows contact information for the Finnish Meteorological Institute. This page will not contain any dynamic elements. A preliminary layout of the General Information page is shown in Figure 11.

Page 34/48





Figure 11: About page for the RAF service

6.4.1.2 Private section

The forecast pages for the four different ranges of lead times (lead times from 0 to 3 hours, from 3 to 6 hours, from 6 to 9 hours and from 9 to 12 hours ) will all have the same structure. The title of the page will tell the range of the lead time and the corresponding forecast period in UT.

The predicted auroral occurrence probabilities are shown as ovals (or latitude bands) on the map. The latitudes bands where the probability exceeds 70% are showed with a different shading (or colour) than the bands where the probability is in the range of 50-70%. For the given UT range the closest times of Sun rise and set and Full Moon rise and set are listed in the bottom part of the page. Examples of the forecast pages are shown in Figure 12, Figure 13, Figure 14 and Figure 15.

Page 35/48





Figure 12: RAF service forecast page (lead time 0-3 hours)

Page 36/48






Page 37/48






Page 38/48






Forecasts in the RAF service solution are based on statistical relationships between data sets which describe solar and global magnetic activity and magnetic time derivative values recorded in the RAF magnetometer stations. When constructing these statistical models ten year data sets (2002-2012) were used for NOAA alerts, Halo-CME alerts and time derivative values, while for FMI/ACE alerts data from years 2010-2011 (1,5 years) were used. Although the NOAA data records used cover almost a whole solar cycle, the data set does not contain enough data points for constructing reliable statistical relationships in the cases of strong activity levels (ALTK07 or above). For those conditions we plan to show the maps of highest activity levels available in the Forecast service statistics with a special note in the Figure caption that the activity level is assumed to be even higher than the map suggests.

The “Recent activity” page shows the geomagnetic activity level for the KEV, MUO, OUJ, HAN and NUR stations for the previous day. An example of the Bar plots page is shown in Figure 16.

Page 39/48





Figure 16: RAF Recent activity page

Page 40/48





Finally the registered users will have the possibility to subscribe to data or alerts for the products shown in the RAF web pages.

6.4.2 The ISM Service solution

In order to show the ISM Service solution products, the SWE Portal Application will be extended with a new section, the Ionospheric Scintillation Monitoring.

6.4.2.1 Public section

The homepage of the ISM section displays the nowcast worldwide map of scintillation intensity as shown in Figure 17. This product is the only one accessible to unregistered users. Three different map types can be chosen: S4 (amplitude scintillation), SigmaPhi (phase scintillation) and TEC (total electron content).

Figure 17: ISM service nowcast worldwide map of scintillation level

By selecting a different geographic area, the site will display a nowcast regional map of scintillation intensity computed the hour before. The user has also access to the ASCII data table of each map by a download link.

Page 41/48





In order to get the current status of the scintillation for a given location, the user indicates the coordinates below and the page displays the value for the S4, SigmaPhi and TEC parameters as well as theirs confidence level, see Figure 18.

Figure 18: ISM service nowcast scintillation values for the given location

Information about the ISM service can be found in the “Service information” section of the web page as shown in Figure 19.

Page 42/48





Figure 19: ISM Service information page

Finally, in the “About” web page contact details of the CLS and IEEA can be found (see Figure 20).

Page 43/48





Figure 20: ISM service About page

6.4.2.2 Private section

In a similar way as displayed in Figure 21, the registered user will be able to see an animated map of scintillation intensity for the next 12 hours either in a worldwide area or in specific areas. After inserting the coordinates, a diagram with level of hourly scintillation forecasts will be displayed.

Page 44/48





Figure 21: ISM service forecast worldwide map of scintillation

In order to get the forecast status of the scintillation for a given location, the user indicates the coordinates below and the page displays the value of the selected parameter (S4, SigmaPhi) as well as its confidence level, see Figure 22.

Page 45/48





Figure 22: Forecast Scintillation estimation plot

The user can easily subscribe to alerts on either observed or forecasted scintillation levels (S4, SigmaPhi or TEC). He chooses the threshold and the location on which he/she will receive an alert that is sent via email (see Figure 23). By default, the service uses the e-mail address linked to the user’s account. Optionally, the user can indicate an additional address where the alert shall be sent.

Page 46/48





Figure 23: ISM service subscription to alerts and warnings on scintillation levels

All the Data or Alert subscriptions can be managed in the SWE Portal Application, as displayed in Figure 24.

Page 47/48





Figure 24: SWE Portal Application Subscriptions page

6.5 Normal termination

No specific procedure is considered to stop using a service under normal circumstances.

6.6 Error conditions

In case of an error encountered while using a service, an error message will be shown on top of the display area. One example is shown in Figure 25.

The main reasons for errors are:

Error retrieving data. No data returned by the underlying services

SOAP Fault: BEA-380001 Internal Server Error The User Data Access Service throws an Exception,

Page 48/48





Figure 25: RAF Nowcast error page

6.7 Recover runs

The recovery of an application run may be attempted with the following guidance:

Error retrieving data Remove the cache and try again, if the error persist contact the administrator

SOAP Fault: BEA-380001 Internal Server Error The SWE Portal infrastructure administrator shall verify the system and potentially apply the VM snapshot recovery procedure mentioned below,

The SWE Portal infrastructure administrator shall back up the entire system at VM level on a regular basis by means of the VM hosting software. This backup shall include all software, services, files, and databases. The frequency of system backups depends on the change rate of each of the VMs in time and in technical significance.

Before any critical change to apply to the system, the VM hosting software shall take a snapshot of each of the VMs. This allows to use restore the system in cases where malfunctions other errors prevent the system from running.