Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


  Insert excerptSCOI:Task StatusSCOI:Task Statusnopaneltrue

Service Definition Identification

StatuscolourGreentitleREVIEWEDservice definition identification

title

Service Definition Identification

service definition identification

title

Service definition for the Quantitative Volcanic Ash Information Subscription and Request Service 

edition

00.00.05

reference date

2024-07-01

Table of Contents
maxLevel1
typeflat

Info
titleStatus Key
  • Status
    titleTBD
    - No work has started
  • Status
    colourRed
    titleWORKING
    - Content is being worked on, comments discussed
  • Status
    colourYellow
    titleDRAFT
    - Draft is ready, comments resolved
  • StatuscolourGreentitleREVIEWED - Group has reviewed, edited the final draft StatuscolourBluetitleAGREED - Content is finalised and agreed

    Service Identification

    StatuscolourGreentitleREVIEWED



    Table of Contents
    maxLevel1
    typeflat



    Service Identification

    service identification

    service name

    Quantitative Volcanic Ash Information Subscription and Request Service

    Service Abstract

    StatuscolourGreentitleREVIEWED

    service abstract

    The Quantitative Volcanic Ash Information Subscription and Request Service allows the service consumer to get quantitative volcanic ash information in accordance with ICAO Annex 3 Amdt 82 and PANS-MET.

    The service consumer can subscribe to the service to receive notificationwhen a new significant ash cloud occurs. It is also possible to send a direct request, using a request-reply mechanism, to the service to get the relevant quantitative volcanic ash information.

    The meteorological information is issued by the designated Volcanic Ash Advisory Centre (VAAC). The meteorological information is only intended to be used by service consumers within the aviation domain.

    Service Definition Provider

    status

    colourGreentitleREVIEWED

    service definition provider

    nameEUROCONTROL
    descriptionEUROCONTROL is an intergovernmental organisation with 41 Member and 2 Comprehensive Agreement States.
    point of contactswim@eurocontrol.int

    Geographical Extent of Information

    StatuscolourGreentitleREVIEWED
    geographical extent of information

    The service shall offer quantitative volcanic ash information resulting from volcanic eruptions occurring in the service provider's area of responsibility, except when the responsibility of publishing this information has been transferred to another VAAC due to the ash cloud moving into the area of responsibility of this VAAC.

    The service shall offer the equivalent quantitative volcanic ash information for the areas of responsibility for which the service provider acts as back-up during outages.

    The service shall offer quantitative volcanic ash information resulting from volcanic eruptions occurring outside the service provider's area of responsibility, when the responsibility of publishing this information has been transferred by another VAAC due to an interruption of the operation.

    Note: the back-up arrangements are based on mutual agreements between Volcanic Ash Advisory Centre service providers.

    Note: the ash cloud may extend beyond the area of responsibility.

    Service Categories

    StatuscolourGreentitleREVIEWED

    Service Standard Reference

    status

    colourGreentitleREVIEWED
    Info
    titleExplanatory note

    This field is left empty. It is expected that the service definition developed in Europe by MET3SG will reference any ICAO-level information service definition.


    service standard reference



    reference


    implemented options
    deviations/additions

    Operational Environment

    StatuscolourGreentitleREVIEWED

    Operational Environment

    operational environmentoperational needs
    ICAO Annex 3 Amdt 82 and PANS-MET requires that quantitative volcanic ash (QVA) concentration information is provided by designated Volcanic Ash Advisory Centres (VAAC) as part of the International Airways Volcano Watch (IAVW) framework overseen by the International Civil Aviation Organization (ICAO).
    The quantitative volcanic ash (QVA) concentration information is provided per volcano in the form of a high-resolution four-dimensional representation of a volcanic ash cloud based on 3-hourly timesteps.
    New information is provided when there is a significant change in the erupting characteristics or at 6 hourly intervals until the ash is no longer present.
    The information is intended for use in operator’s flight planning and decision support systems allowing, e.g., more efficient routes in accordance with their safety management programme during significant volcanic ash cloud events.
    capabilities

    The service provides high quality, up-to-date, trusted, regulated meteorological information in digital form for use by service consumers within the aviation domain.

    information exchange requirements

    The service takes into account the following information exchange requirements:

    IER 1 

    The information as defined in ICAO Annex 3 Amdt 82 and PANS-MET:

    • expected dimensions (horizontal and vertical) of significant volcanic ash cloud at four concentration thresholds (0.2mg/m3, 2mg/m3, 5mg/m3 and 10mg/m3)
    • gridded deterministic forecast of significant volcanic ash cloud showing the expected ash concentration
    • gridded probabilistic forecast of significant volcanic ash cloud showing the probability of exceeding four concentration thresholds (0.2mg/m3, 2mg/m3, 5mg/m3 and 10mg/m3)

    Note: significant in this context means an ash cloud that poses a widespread impact to aircraft operations and air navigation.


    Service Functions

    Statuscolour

    GreentitleREVIEWED
    service functions


    functionnameRequest list of volcanoes
    descriptionThe service consumer may be able to request a list of volcanoes for which there is information.
    real-world effectThe service consumer receives the list of volcanoes to use in further functions.
    functionnameRequest quantitative volcanic ash information
    description

    The service consumer shall be able to request the latest quantitative volcanic ash information filtered by erupting volcano number,forecast timesteps and logical (e.g. severity threshold) operators.

    real-world effectThe meteorological information is received and can be used in ATM and other systems.
    functionname

    Request the information in a specific format

    descriptionThe service consumer shall be able to request that the quantitative volcanic ash information be returned as polygons (IWXXM) and/or deterministic gridded data (NetCDF) and/or probabilistic gridded data (NetCDF).
    real-world effectThe meteorological information is received in the specified format and can be used in ATM and other systems.
    functionnameSubscribe to quantitative volcanic ash information
    description

    The service consumer shall be able to subscribe in order to receive notifications when a significant volcanic ash cloud occurs and unsubscribe when needed.

    real-world effectThe service consumer subscribes to the service and will receive notifications as per the subscription or unsubscribes from the service.
    functionnameDistribute notification
    descriptionThe service shall distribute a notification detailing how to access the quantitative volcanic ash information when a significant volcanic ash cloud occurs.
    real-world effectThe service consumer receives notifications with details on how to access the relevant QVA information.

    Service Access and Use Conditions

    StatuscolourGreentitle

    REVIEWED

    service access and use conditions



    legal constraints



    service policies

    business policy

    It shall be made clear to new service consumers that they must also enter an agreement with the back-up VAACs in case they need to revert to the back-up.

    operational policy

    There shall be a service policy to ensure that only service consumers within the aviation domain can use the service.

    The service policy shall include a requirement that service consumers cannot pass the information obtained from the service to non-aviation users without prior authorisation from the service provider.

    technical policy


    service consumption constraints


    There shall be a service consumption constraint to ensure that a service consumer does not impose undue loads on computer and network resources, for example, by polling it at a higher frequency than the status is normally provided.

    Security Constraints

    status

    colourGreentitleREVIEWED

    security constraints



    authentication

    The service shall ensure consumer authentication in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile requirement SWIM-TIYP-0042.

    The service shall ensure provider authentication in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile requirement SWIM-TIYP-0042.

    authorisation

    The service shall ensure that satisfactory authorisation is put in place in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile requirement SWIM-TIYP-0070.

    confidentiality

    The service shall ensure point-to-point confidentiality in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile through the use of Transport Layer Security (TLS) 1.2 or above.

    integrity

    The service shall ensure point-to-point integrity in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile through the use of Transport Layer Security (TLS) 1.2 or above.

    Quality of Service

    StatuscolourGreentitleREVIEWED

    quality of service

    performance

    capacity

    The service shall achieve a quality that is sufficient to ensure the service is fit for purpose.

    The service should ensure that a single user is unable to monopolise a service or to degrade it below agreed service levels for others users.

    response timeThe service shall achieve a quality that is sufficient to ensure the service is fit for purpose.
    reliability

    availability

    The service shall achieve a quality that is sufficient to ensure the service is fit for purpose.

    Note: the following factors must be used in deciding the fitness for purpose:

    • the availability offered by the designated back-up VAACs
    • the number of users likely to be delayed significantly by a loss of the service
    • the acknowledgement that the availability is expected to be higher when a volcano is erupting
    recoverabilityThe service shall achieve a quality that is sufficient to ensure the service is fit for purpose.
    security

    confidentiality

    The service shall ensure confidentiality by using SWIM Technical Infrastructure (TI) Yellow Profile bindings.

    integrityThe service shall ensure integrity by using SWIM Technical Infrastructure (TI) Yellow Profile bindings.

    Quality of Data

    status

    colourGreentitleREVIEWED
    quality of data

    The quality of quantitative volcanic ash information offered by the service shall be verified by the service provider.

    Information on the quality of the QVA information offered by the service shall be reported annually to the ICAO Met Panel Met Operations working group relating to the IAVW who provide oversight of QVA data provision

    Source of Information

    StatuscolourGreentitleREVIEWED

    source of information

    source

    The service provider shall ensure that the quantitative volcanic ash information offered by the service is based on data received from the appropriate authorised originating sources. This includes:

    Note: EUMETSAT may be used to make sure the ash plume corresponds to where it is already being detected by the satellites.

    modificationsNote: atmospheric modelling techniques are used to generate the output.

    Service Validation Information

    StatuscolourGreentitleREVIEWED

    Service Validation Information

    Info
    titleExplanatory note

    This field is left empty.


    service validation information

    description

    Application Message Exchange Pattern

    status

    colourGreentitleREVIEWED

    application message exchange pattern

    Service Behaviour

    StatuscolourGreentitleREVIEWED

    service behaviour

    typical behaviour
    The service behaviour shall be in accordance with the patterns detailed in the Message Exchange Patterns: Identification Guidelines.
    The typical service behaviour, is:
    • The service consumer subscribes to the service
    • The service sends notifications to subscribers when QVA information is available that matches their subscription
    • The service consumer requests the QVA information using the details contained in the notification

    The interfaces that support the service have different behaviour. A combination of an AMQP 1.0 implementation and an OGC implementation shall be used for the basic behaviour.

    The typical behaviour for PUBLISH_SUBSCRIBE means that:

    • The subscription is handled by either:
      • a request-reply implementation (see Quantitative Volcanic Ash Information Subscription and Request Service Subscription Interface) or
      • an email request to the service provider.
    • The distribution of the notifications is handled by an AMQP 1.0 implementation (seeQuantitative Volcanic Ash Information Subscription and Request Service Distribution Interface).
    The typical behaviour for SYNCHRONOUS_REQUEST_REPLY (as used in Quantitative Volcanic Ash Information Subscription and Request Service Request Interface) is as follows:
    • The request message is sent from the service consumer to the service
    • The service consumer remains blocked while awaiting the reply
    • The service remains blocked while processing the reply
    • The Quantitative Volcanic Ash Information Message, the reply message, is sent from the service to the service consumer.

    Service Monitoring

    status

    colourGreentitleREVIEWED

    service monitoring

    A service monitoring mechanism should be made available to service consumersand alert them when the service is unavailable so that they can switch to the back-up service. 

    Service Interfaces

    StatuscolourGreentitleREVIEWED

    service interfaces

    interfacename

    Quantitative Volcanic Ash Information Subscription and Request Service Request Interface

    description

    Allows the service consumer to request filtered quantitative volcanic ash information.

    Note: this interface is used to group the operations offered by the chosen OGC standard.

    provider/consumer sideProvider side
    interfacenameQuantitative Volcanic Ash Information Subscription and Request Service Subscription Interface
    description

    Allows the service consumer to subscribe to the service. It allows the service consumer to manage the subscriptions e.g. to unsubscribe.

    Note: this can be handled by a separate dedicated subscription service.

    Note: some service providers will prefer to receive subscription requests by email.

    provider/consumer sideProvider side
    interfacenameQuantitative Volcanic Ash Information Subscription and Request Service Distribution Interface
    descriptionAllows the service provider to distribute notifications when a new significant ash cloud occurs meeting the need of the service consumer that has subscribed for updates.
    provider/consumer sideConsumer side

    SWIM TI Profile and Interface Bindings

    StatuscolourGreentitleREVIEWED

    Quantitative Volcanic Ash Information Subscription and Request Service Request Interface


    SWIM TI profile and interface bindings





    profile name

    EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile

    profile version

    1.1

    selected service interface bindingWS_LIGHT
    selected network interface bindingThe service shall use the network bindings of the SWIM TIYP.
    descriptionThe interface shall use at least one of the following OGC standards:
    • for services that exchange the meteorological information as resources:
      • OGC API – Environmental Data Retrieval Standard;
    • for services that exchange the meteorological information as coverages:
      • OGC Web Coverage Service (WCS) Interface Standard – Core, version 2.0;
    • for services that exchange the meteorological information as features:
      • OGC Web Feature Service 2.0 Interface Standard;.

    Note: it is expected that the service will implement the OGC API – Environmental Data Retrieval Standard by November 2026.


    Quantitative Volcanic Ash Information Subscription and Request Service Subscription Interface


    SWIM TI profile and interface bindings





    profile name

    EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile

    profile version

    1.1

    selected service interface binding

    WS_LIGHT

    selected network interface bindingThe service shall use the network bindings of the SWIM Technical Infrastructure (TI) Yellow Profile.
    description


    Quantitative Volcanic Ash Information Subscription and Request Service Distribution Interface


    SWIM TI profile and interface bindings





    profile name

    EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile

    profile version

    1.1

    selected service interface bindingSWIM_TI_YP_1_1_AMQP_MESSAGING
    selected network interface bindingThe service shall use the network bindings of the SWIM TIYP.
    description

    AMQP 1.0 shall be used to distribute messages as explained in the Publish/Subscribe Push MEP: Implementation Guidance.


    Service Interface Protocols and Data Format

    status

    colourGreentitleREVIEWED

    service interface protocols and data format





    transport / messaging protocols

    The service shall use TLS1.2 or later in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile.
    data format


    Info

    This is captured at Service Message level (see below).

    WS_LIGHT does not mandate a data format. The header expresses what is used.

    Service Operations

    StatuscolourGreentitleREVIEWED

    .


    Service Operations

    Quantitative Volcanic Ash Information Subscription and Request Service Request Interface

    Info
    titleExplanatory note

    The OGC Web Feature Service Interface Standard, Web Coverage Service (WCS) Interface Standard and OGC API – Environmental Data Retrieval Standard are used to implement the service operations.

    It is not the intention to repeat the standardised operations here. However, the table below illustrates how the WFS GetFeature operation would look in the context of this service.


    Service operations






    operation


    operation name

    GetFeature

    description

    The WFS GetFeature operation returns a selection of features from a data store.  It responds to a GetFeature Request message with a Quantitative Volcanic Ash Information Message that satisfies the query expressions specified in the request. 

    messages

    Request, Quantitative Volcanic Ash Information Message

    Quantitative Volcanic Ash Information Subscription and Request Service Subscription Interface

    Service operations







    reference


    url

    Meteorological SWIM Services Subscription Interface Standard

    description

    The standard operations for subscription and subscription management.

    The following operations shall be implement at a minimum:

    • subscribe
    • unsubscribe

    Quantitative Volcanic Ash Information Subscription and Request Service Distribution Interface

    Service operations






    operation


    operation name

    publish

    description

    This operation allows the service provider to publish Quantitative Volcanic Ash Information Notifications to service consumers based on their subscriptions.

    messages

    Quantitative Volcanic Ash Information Notification

    Service Messages

    status

    colourGreentitleREVIEWED


    Info
    titleExplanatory note

    The OGC Web Feature Service Interface Standard, Web Coverage Service (WCS) Interface Standard and OGC API – Environmental Data Retrieval Standard detail the basic messages such as request and response messages.

    It is not the intention to repeat the standardised messages here. The table below provides extra details for the Quantitative Volcanic Ash Information Message.


    service messages





    message

    name

    Quantitative Volcanic Ash Information Message

    description

    The output message containing thequantitative volcanic ash information.

    directionOut
    data format

    QVA information shall be provided in two file formats:

    • ICAO’s Meteorological Information Exchange Model (IWXXM) format containing a collection of features;
    • NetCDF file containing gridded volcanic ash concentration data.

    Note: the file may be compressed.

    messagenameRequest
    description

    Request message submitted to the service containing query expressions for the WFS GetFeature operation, WCS GetCoverage operation or the EDR HTTP GET operation and the required data format for the Quantitative Volcanic Ash Information Message.

    directionIn
    data formatJSON and/or XML
    messagename

    Quantitative Volcanic Ash Information Notification

    description

    The notification and way to retrieve the Quantitative Volcanic Ash Information Message e.g. the URL, or the volcano number.

    The message will include:

    • publication time
    • operation e.g. if it is an update or a new message

    The message can include:

    • identifier of the VAAC
    • event type e.g. if it is live

    Note: an example of the structure of the URL that is used to retrieve the QVA in IWXXM format using an EDR implementation: https://{organizaton URL}/QVACI_Iwxxm/Locations/{VolcanoNumber}

    Note: the URL, if provided, could be a request formatted for the Quantitative Volcanic Ash Information Subscription and Request Service Request Interface.

    directionOut
    data format

    JSON and/or XML

    referenceurlMeteorological SWIM Services Subscription Interface Standard
    descriptionThe standard messages for subscription and subscription management.

    Information Definition (Minimum) and (Extended)

    StatuscolourGreentitleREVIEWED

    information definition

    The IWXXM QVA information shall include feature information for four ash concentration thresholds (≥0.2mg/m3, ≥2.0mg/m3, ≥5.0mg/m3, ≥10mg/m3) in accordance with the QVA IWXXM schema.

    The probabilistic QVA information shall include the probability of exceeding four ash concentration thresholds (≥0.2mg/m3, ≥2.0mg/m3, ≥5.0mg/m3, ≥10mg/m3) at a 0.25 degree horizontal resolution and for 12 vertical levels in accordance with the NetCDF4 specification for gridded data.

    The deterministic QVA information shall include an expected ash concentration for each grid point at a 0.25 degree horizontal resolution and for 12 vertical levels in accordance with the NetCDF4 specification for gridded data.

    All information types shall be provided for the period 0-hours to 24-hours at 3-hourly intervals.

    Note: the QVA IWXXM schema is expected to be included in the 2025-2 IWXXM release.

    Filter Encoding

    StatuscolourGreentitleREVIEWED
    filter encoding

    The Quantitative Volcanic Ash Information Subscription and Request Service Request Interface shall support filtering by volcano number (i.e., the IAVCIE number) and forecast timestep (dateTime).

    The Quantitative Volcanic Ash Information Subscription and Request Service Request Interface should support filtering of probabilistic information based on the ash concentration threshold (≥0.2mg/m3, ≥2.0mg/m3, ≥5.0mg/m3, ≥10mg/m3).

    The Quantitative Volcanic Ash Information Subscription and Request Service Request Interface may support filtering based on geographic bounding box defined in the OGC Filter Encoding 2.0 Encoding Standard.

    The Quantitative Volcanic Ash Information Subscription and Request Service Request Interface shall support the selection of one or more of the supported data set types.

    If the service implements the OGC API – Environmental Data Retrieval Standard, the Quantitative Volcanic Ash InformationSubscription and Request Service Subscription Interface shall allow for the selection of subscription based on clearly defined criteria.

    Note: for example, subscriptions can be for all QVA messages or by volcano number or by data format type (deterministic, probabilistic or in IWXXM format).

    Machine-Readable Service Interface Definition

    status

    colourGreentitleREVIEWED
    Info
    titleExplanatory note

    This field is left empty. No machine-readable service interface definition is provided.


    machine-readable service interface definition

    reference

    Model View

    StatuscolourGreentitleREVIEWED
    Info
    titleExplanatory note

    This field is left empty. No model view is provided.


    model view

    reference

    Abbreviations and Acronyms

    status

    colourGreentitleREVIEWED
    abbreviations and acronyms


    abbreviationcodeAMQP
    termAdvanced Message Queuing Protocol
    abbreviationcodeAPI
    termApplication Programming Interface
    abbreviationcodeATM

    termAIr Traffic Management
    abbreviationcodeIAVW
    termInternational Airways Volcano Watch
    abbreviationcodeICAO
    termInternational Civil Aviation Organization
    abbreviationcodeIWXXM
    termICAO Meteorological Information Exchange Model
    abbreviationcodeJSON
    termJavaScript Object Notation
    abbreviationcodeMEP
    termMessage Exchange Pattern
    abbreviationcodeNetCDF
    termnetwork Common Data Form
    abbreviationcodeOGC

    termOpen Geospatial Consortium
    abbreviationcodePANS-MET
    termICAO Procedures for Air Navigation Services – Meteorology
    abbreviationcodeQVA

    termQuantitative Volcanic Ash
    abbreviationcodeSWIM
    termSystem wide information management
    abbreviationcodeTI
    termTechnical Infrastructure
    abbreviationcodeTIYP

    termTechnical Infrastructure Yellow Profile
    abbreviationcodeTLS
    termTransport Layer Security
    abbreviationcodeURL
    term

    Uniform Resource Locator

    abbreviationcodeVAAC
    termVolcanic Ash Advisory Centre
    abbreviationcodeWCS
    termWeb Coverage Service
    abbreviationcodeWFS
    termWeb Feature Service
    abbreviationcodeXML
    termExtensible Markup Language

    Appendix A: References

    StatuscolourGreentitleREVIEWED

    referencesreferencetitleIWXXM
    versionICAO Meteorological Information Exchange Model
    descriptionThe ICAO Meteorological Information Exchange Model (IWXXM) is an exchange model capturing Meteorological information. It was introduced to support the exchange of meteorological information in accordance with ICAO Annex 3.
    urlhttps://github.com/wmo-im/iwxxm
    document typeINFORMATION_DEFINITION
    referencetitleOGC API – Environmental Data Retrieval Standard
    version1.1
    descriptionOGC API standards define modular API building blocks to spatially enable Web APIs in a consistent way. The OpenAPI specification is used to define the API building blocks.
    url
    document typeSERVICE_SPECIFICATION
    referencetitleOGC Web Coverage Service (WCS) Interface Standard
    versionversion 2.0
    descriptionA Web Coverage Service (WCS) offers multi-dimensional coverage data for access over the Internet. WCS Core specifies a core set of requirements that a WCS implementation must fulfill.
    urlhttps://www.ogc.org/standard/wcs/
    document typeSERVICE_SPECIFICATION
    referencetitleOGC Web Feature Service 2.0 Interface Standard
    version
    description

    WFS offers direct fine-grained access to geographic information at the feature and feature property level. 

    Note: This is equivalent to ISO 19142 - Geographic Information - Web Feature Service.

    urlhttps://www.ogc.org/standard/wfs/
    document typeSERVICE_SPECIFICATION
    referencetitleOGC Filter Encoding 2.0 Encoding Standard
    version
    description

    This jointly developed OGC and ISO TC/211 International Standard describes an XML and KVP encoding of a system neutral syntax for expressing projections, selection and sorting clauses collectively called a query expression. These components are modular and intended to be used together or individually by other standards which reference this International Standard.

    Note: This is equivalent to ISO 19143 - Geographic Information - Filter encoding.

    urlhttps://www.ogc.org/docs/is
    document typeSERVICE_SPECIFICATION
    referencetitleMessage Exchange Patterns: Identification Guidelines
    versionJULY 2nd, 2019
    descriptionDocument intended to facilitate the understanding of message exchange patterns from an application and Technical Infrastructure perspective.
    urlhttps://reference.swim.aero/technical-infrastructure/message-exchange-patterns-identification-guidelines.html
    document typeSERVICE_BEHAVIOUR_DESCRIPTION
    reference



    titlePublish/Subscribe Push MEP: Implementation Guidance
    versionJULY 2nd, 2019
    descriptionThis document intends to serve as implementation guidance of the Publish/Subscribe Push Message Exchange Pattern using SWIM-TI Yellow Profile Service Bindings.
    urlhttps://reference.swim.aero/technical-infrastructure/guidance-for-pub-sub-push-implementation.html
    document typeSERVICE_SPECIFICATION