CAP DWD Profile
for the
Common Alerting Protocol v1.2
Version 2.1.7
21 March 2016
Deutscher Wetterdienst
Frankfurter Straße 135, D-63067 Offenbach, Germany
Tel: +49 (0)69 / 8062 – 0
Fax: +49 (0)69 / 8062 – 4484
http://www.dwd.de
[email protected]
Document History
Version
Date
Changes
2.1.7
21.03.2016
Initial version of the document. This document is a translation of the
document “CAP DWD Profil zum Common Alerting Protocol v1.2”
(german), version 2.1.7.
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 2 / 28
Table of Contents
1 Introduction................................................................................................................5
1.1 Objective........................................................................................................5
1.2 Process..........................................................................................................5
1.3 Terminology....................................................................................................5
1.4 References.....................................................................................................6
2 CAP DWD profile.......................................................................................................7
2.1 File name.......................................................................................................7
2.1.1 Overall warning status...................................................................7
2.1.1.1 Overall warning status as a ZIP file...........................7
2.1.1.2 Overall warning status as XML file............................7
2.1.2 Issuance of status changes...........................................................8
2.1.2.1 Changes as a ZIP file................................................8
2.2 XML/CAP format............................................................................................8
2.3 CAP elements................................................................................................8
2.3.1 <alert>............................................................................................8
2.3.1.1 <identifier>.................................................................9
2.3.1.2 <sender>....................................................................9
2.3.1.3 <sent>........................................................................9
2.3.1.4 <status>.....................................................................9
2.3.1.5 <msgType>................................................................9
2.3.1.6 <source>..................................................................10
2.3.1.7 <scope>...................................................................10
2.3.2 <info>...........................................................................................11
2.3.2.1 <language>..............................................................11
2.3.2.2 <category>...............................................................11
2.3.2.3 <event>....................................................................11
2.3.2.4 <responseType>......................................................11
2.3.2.5 <urgency>................................................................12
2.3.2.6 <severity>................................................................12
2.3.2.7 <certainty>...............................................................12
2.3.2.8 <eventCode>...........................................................12
2.3.2.9 <effective>...............................................................13
2.3.2.10 <onset>..................................................................13
2.3.2.11 <expires>...............................................................13
2.3.2.12 <senderName>......................................................13
2.3.2.13 <headline>.............................................................14
2.3.2.14 <description>.........................................................14
2.3.2.15 <instruction>..........................................................14
2.3.2.16 <web>....................................................................15
2.3.2.17 <contact>...............................................................15
2.3.2.18 <parameter> (optional)..........................................15
2.3.3 <area>..........................................................................................16
2.3.3.1 <areaDesc>.............................................................16
2.3.3.2 <polygon> (Optional)...............................................16
2.3.3.3 <geocode>...............................................................16
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 3 / 28
2.3.3.4 <altitude>.................................................................18
2.3.3.5 <ceiling>...................................................................18
3 Appendices..............................................................................................................19
3.1 Terminology used for ii values (<event>).....................................................19
3.1.1 Vorabinformation Unwetter (preliminary information on severe
weather).................................................................................................20
3.2 Parameters of the ii values (<parameter>)..................................................21
3.3 Groups <eventCode:GROUP>....................................................................23
3.4 Altitude information <altitude>, <ceiling>.....................................................24
3.4.1 Altitude information used for <geocode:ALTITUDE>...................24
3.5 Colours used by the DWD...........................................................................26
3.6 Sample file of the overall status...................................................................27
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 4 / 28
1 Introduction
1.1 Objective
The Deutscher Wetterdienst (DWD, Germany's National Meteorological Service)
aims to speak with a singlevoice concerning the issued warnings. For this purpose it
is necessary that all warnings remain consistent with each other. In this respect the
CAP Format v1.2 specifies the basic framework for XML based alert data. However,
the content of CAP v1.2 documents can be interpreted in different ways. Therefore it
is necessary to define a profile for the protocol, according to which warning
messages in the CAP format are published, especially when this data is being
generated by different systems.
The Common Alerting Protocol (CAP) provides an open, non-proprietary digital
message format for all types of warnings and notifications. It does neither address
any particular application nor telecommunications method.
1.2 Process
This profile is still being developed and is constantly adapted to meet the
requirements of the DWD and it's customers.
This document makes no claim to be complete and it will be supplemented if new
developments make changes necessary. Existing content may be altered or removed
completely.
In order to validate the CAP DWD profile, we provide an XSD file.
1.3 Terminology
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" and "OPTIONAL" in this
document are to be interpreted as described in [RFC2119] .
The terms warning, warning message and message are used as synonyms
throughout this document.
The term coordinate pair in this document refers to a pair of comma separated
decimal values in degrees (°), which describe a geographical location (not projected)
and are given in the form of “[latitude]”,”[longitude]”. Latitudes of the southern
hemisphere and longitudes of the western hemisphere have negative values, which
is indicated by a prefixed minus sign.
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 5 / 28
1.4 References
[CAP12]
[WMO386]
[RFC2119]
Common Alerting Protocol Version 1.2
(http://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf)
WMO-No. 386 (Manual on the Global Telecommunication System)
Key words for use in RFCs to indicate Requirement Levels, S.
Bradner, IETF RFC 2119, March 1997
(http://www.ietf.org/rfc/rfc2119.txt)
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 6 / 28
2 CAP DWD profile
The following sub-items specify the REQUIRED preconditions for a CAP v1.2
message in order to be compatible with the CAP DWD profile.
2.1 File name
For the file name the following specifications are made.
2.1.1 Overall warning status
The overall warning status is generated by the PVW system and is available in two
different data formats.
2.1.1.1 Overall warning status as a ZIP file
Info
Format of the file name for the overall status as a ZIP file
Format
Z_CAP_C_EDZW_<TS>_<A>_<B>.zip
<TS> Time stamp in UTC in the format: yyyyMMddHHmmss
<A> System that generated the status. Usually 'PVW'
<B> Abbreviation for describing the contents.
e.g. 'STATUS', 'STATUS_GEOMETRY'
Further abbreviations are possible.
Example
Z_CAP_C_EDZW_20151005141100_PVW_STATUS.zip
Info
Format of the file name for a single warning within the ZIP file
Format
Z_CAP_C_EDZW_<A>_PVW_<SessionID>.xml
<A> Time stamp in UTC in the format: yyyyMMddHHmmss
<SessionID> Sequential number within the status
Example
Z_CAP_C_EDZW_20151005141100_PVW_12.xml
2.1.1.2 Overall warning status as XML file
Info
Format of the file name for the overall status as XML file
Format
Z_CAP_C_EDZW_<A>_PVW_STATUS.xml
<A> Time stamp in UTC in the format: yyyyMMddHHmmss
Example
Z_CAP_C_EDZW_20151005141100_PVW_STATUS.xml
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 7 / 28
2.1.2 Issuance of status changes
If the overall warning status is has to be changed, a list of changes can be issued in
CAP format.
2.1.2.1 Changes as a ZIP file
Info
Format of the file name for the overall status as a ZIP file
Format
Z_CAP_C_EDZW_<TS>_<A>_<B>.zip
<TS> Time stamp in UTC in the format: yyyyMMddHHmmss
<A> System that generated the status. Usually 'PVW'
<B> Abbreviation for describing the contents.
e.g. 'DIFFERENCE', 'DIFFERENCE_GEOMETRY'
Further abbreviations are possible.
Example
Z_CAP_C_EDZW_20151005141100_PVW_DIFFERENCE.zip
Info
Format of the file name for a single warning within the ZIP file
Format
Z_CAP_C_EDZW_<A>_PVW_<SessionID>.xml
<A> Time stamp in UTC in the format: yyyyMMddHHmmss
<SessionID> Sequential number within the status
Example
Z_CAP_C_EDZW_20151005141100_PVW_11.xml
2.2 XML/CAP format
The content of a CAP file is determined by the following parameters.
Coding
UTF-8
Format
<?xml version="1.0" encoding="UTF-8"?>
Name space
CAP v1.2
Format
<alert xmlns="urn:oasis:names:tc:emergency:cap:1.2"
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
xsi:schemaLocation=”urn:oasis:names:tc:emergency:cap:1.2
https://werdis.dwd.de/conf/CAP-DWD-Profil-v2.1.xsd”>
The general structure of a CAP file can be found in [CAP12].
2.3 CAP elements
In the following the CAP elements which exceed the specifications of the CAP v1.2
format will be detailed. REQUIRED elements from the CAP v1.2 protocol, which are
not listed in this document, are not considered invalid, and can be used as specified
in CAP v1.2 protocol. Optional elements may be specified, but also may be omitted.
2.3.1 <alert>
A CAP file MUST contain exactly one <alert> element, which displays the basic
information about the warning message. It MAY include one or more <info> elements,
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 8 / 28
each representing a warning. If the warning is issued in different languages, each
language SHOULD be placed in a separate <info> element. There MAY be multiple
<info> elements describing the same warning in different languages.
2.3.1.1 <identifier>
Info
Unambiguous identification of a CAP message
Format
2.49.0.1.276.<A>.<B>.<C>.<D>
<A> Agency issuing the warning: DWD
<B> Generating system: PVW
<C> Time stamp in milliseconds since midnight, January 1, 1970 (in UTC)
<D> Sequential number: 1 ... n
Example
2.49.0.1.276.DWD.PVW.1305123392346.0
2.3.1.2 <sender>
Info
E-Mail address of the agency issuing the CAP warning
Format
[email protected]
2.3.1.3 <sent>
Info
The date and time when the message was issued
Format
<A> + <B>
<A> Time and date (local time)
<yyyy>-<MM>-<dd>T<HH>:<mm>:<ss>
<B> Time offset to UTC (CET: +01:00; CEST: +02:00)
Example
2010-05-18T12:24:18+02:00
(Version of: Tuesday, May 18, 2010, 12:24 local time (daylight saving
time))
2.3.1.4 <status>
Info
Status of the message
Format
<A>
<A> Actual
Current Message
2.3.1.5 <msgType>
Info
Type of message
Format
<A>
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 9 / 28
<A> Alert
New release of warnings
Update
Update of a warnings
(only for CAP status as a ZIP file)
Cancel
Cancellation of warnings or „empty status“, which
consists only of the <alert> element and marks a
situation free of warnings
2.3.1.6 <source>
Info
Source of the message (shown as well in the identifier)
Format
<A>
<A> PVW
The message was generated by PVW
2.3.1.7 <scope>
Info
Recipient of the message
Format
<A>
<A> Public
Message for public dissemination
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 10 / 28
2.3.2 <info>
An <alert> element MAY have one or more <info> elements. Each <info> element
represents a warning in a certain language. Additional languages SHOULD be placed
in separate <info> elements and SHOULD carry the same information. An <info>
element MAY contain one or more <area> elements.
2.3.2.1 <language>
Info
Language of the text in the <info> element
Format
<lang>-<COUNTRY>
<lang> RFC 3066 Specification of the language (lower case letters)
<COUNTRY> RFC 3066 Specification of the country (upper case letters)
Example
de-DE
2.3.2.2 <category>
Info
Category of the warning message
Format
<A>
<A> Met
Health
Meteorological message
Medicine related meteorological message (heat warning)
2.3.2.3 <event>
Info
Terminology of the event depending on the ii of the message
Example
WINDBÖEN (wind gusts)
Note: Information concerning the event codes can be found in Appendices.
2.3.2.4 <responseType>
Info
Action to be initiated following the message
Format
<A>
<A> Prepare
If the message has an additional text; the additional text
SHOULD be found in <instruction>
None
Message without an additional text
Monitor
Test message, MAY be ignored
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 11 / 28
2.3.2.5 <urgency>
Info
Time frame of the message
Format
<A>
<A> Immediate
Issued warning
Future
Preliminary information
2.3.2.6 <severity>
Info
Severity of the warning
Format
<A>
<A> Minor
Wetterwarnung (minimal to no known threat to life or
property),yellow
Moderate
Markante Wetterwarnung (possible threat to life or
property), orange
Severe
Unwetterwarnung (significant threat to life or property),
red
Extreme
Extreme Unwetterwarnung (extraordinary threat to life or
property), violet
2.3.2.7 <certainty>
Info
Type of message
Format
<A>
<A> Observed
Observation
2.3.2.8 <eventCode>
Info
Further Information regarding the message
Format
<valueName><A></valueName>
<value><B></value>
<A> DWD key word
<B> Value of the key word
Example
<valueName>II</valueName><value>59</value>
Following words are permitted as DWD key words:
II
ii-value of the warning, e.g. „59“ corresponds to fog
GROUP
The event group, e.g. „WIND“. There MAY be multiple
<eventCode> elements with valueName=GROUP.
AREA_COLOR
The DWD's preferred RGB colour for visualisation. Colour
values are separated by spaces, e.g. „255 255 0“
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 12 / 28
PROFILE_VERSION
Version of the DWD profile, which the content of the CAP file
refers to, e.g. „2.0“.
LICENSE
License under which the data is provided (especially
geodata), e.g. BKG (Federal Agency for Cartography and
Geodesy)
Note: Further Information can be found in Appendices.
2.3.2.9 <effective>
Info
Time at which the warning was issued
Format
<A> + <B>
<A> Date and time
<yyyy>-<MM>-<dd>T<HH>:<mm>:<ss>
<B> Time offset to UTC (UTC: +00:00; CET: +01:00; CEST: +02:00)
Example
2.3.2.10
2010-01-18T12:24:18+01:00 (= 2010-01-18T11:24:18+00:00)
(issued on: Tuesday, 18.01.2010 12:24 local time (standard time))
<onset>
Info
The expected time of the beginning of the event
Format
<A> + <B>
<A> Date and time
<yyyy>-<MM>-<dd>T<HH>:<mm>:<ss>
<B> Time offset to UTC (UTC: +00:00; CET: +01:00; CEST: +02:00)
Example
2.3.2.11
2010-05-18T12:24:18+02:00 (= 2010-05-18T10:24:18+00:00)
(Valid from: Tuesday, 18.05.2010 12:24 local time (daylight saving time))
<expires>
Info
The expected end of the event
Format
<A> + <B>
<A> Date and time
<yyyy>-<MM>-<dd>T<HH>:<mm>:<ss>
<B> Time offset to UTC (UTC: +00:00; CET: +01:00; CEST: +02:00)
Example
2.3.2.12
2010-05-18T15:24:18+02:00 (= 2010-05-18T13:24:18+00:00)
(Valid until: Tuesday, 18.05.2010, 15:24 local time (daylight saving time))
<senderName>
Info
The text naming the originator of the message
Format
DWD / Nationales Warnzentrum Offenbach (national warning centre)
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 13 / 28
Zentrum für Medizin-Meteorologische Forschung (Centre for medicine
related meteorological research)
2.3.2.13
<headline>
Info
Headline of the message
Example
Amtliche WARNUNG vor … (official warning)
Example
Amtliche UNWETTERWARNUNG vor … (official severe weather warning)
Example
VORABINFORMATION UNWETTER: … (preliminary information on
severe weather)
Example
AUFHEBUNG der UNWETTERWARNUNG vor … (cancellation of the
severe weather warning)
Example
AUFHEBUNG der VORABINFORMATION UNWETTER: ... (cancellation
of the preliminary information on severe weather).
2.3.2.14
<description>
Info
Text describing the warning or the preliminary information
Example
Es treten Windböen mit Geschwindigkeiten bis 60 km/h (17 m/s, 33 kn, Bft
7) aus Südwest bis West auf.
Example of a In den nächsten Stunden wird einsetzender extrem ergiebiger Dauerregen
preliminary
erwartet.
information
2.3.2.15
<instruction>
Info
Additional text to the warning (instructions and safety advises)
Example
ACHTUNG! Hinweis auf mögliche Gefahren:
Es können zum Beispiel Bäume entwurzelt und Dächer
beschädigt werden. Achten Sie besonders auf herabstürzende
Äste, Dachziegel oder Gegenstände. Schließen Sie alle
Fenster und Türen! Sichern Sie Gegenstände im Freien!
Halten Sie insbesondere Abstand von Gebäuden, Bäumen,
Gerüsten und Hochspannungsleitungen.
Vermeiden Sie möglichst den Aufenthalt im Freien!
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 14 / 28
2.3.2.16
<web>
Info
The identifier of the hyperlink (URI) associating additional
information with the alert message
Format
http://www.wettergefahren.de
2.3.2.17
<contact>
Info
The contact for the message
Format
Deutscher Wetterdienst
2.3.2.18
<parameter> (optional)
Info
Parameters related to the event
Format
<valueName><A></valueName>
<value><B> <C></value>
<A> ParameterName
<B> ParameterValue
<C> ParameterUnit in square brackets
Example
<valueName>Sichtweite</valueName><value>&lt;150 [m]</value>
ParameterValue and ParameterUnit are separated by spaces, ParameterUnit is in
square brackets. Special characters are replaced, e.g. ">" is replaced by "&gt;"
and "<" ist replaced by "&lt;".
Following symbolism is possible:
Symbolism
Meaning
Example
Text
<A
Less than A
<150 [m]
kleiner 150 m
>A
Greater than A
>90 [km/h]
größer 90 km/h
~A
about A
~120 [cm]
um 120 cm
A-B
Between A and B
65-90 [km/h]
zwischen 65 und 90 km/h
An exemplary table of parameters can be found in chapter 3.2.
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 15 / 28
2.3.3 <area>
An <area> element MAY occur one or more times. Each <area> element represents
a warning area. If more than one area is affected by the event, multiple <area>
elements MAY be used.
2.3.3.1 <areaDesc>
Info
Name of the area
Example
Vogelsbergkreis
2.3.3.2 <polygon> (Optional)
Info
The paired values of points defining a polygon
Format
whitespace-delimited list of [latitude, longitude] coordinate pairs (points);
the first point MUST be identical to the last point.
Example
48.3,8.2 48.2,8.3 ... 48.3,8.2
An <area> element MAY contain one or more <polygon> elements for an area.
2.3.3.3 <geocode>
Further information on the specified area is provided in <geocode> elements. At least
one <geocode> element is REQUIRED. An <area> element MAY contain more than
one <geocode> element.
Info
Geocode of the specified areas
Format
<valueName><A></valueName>
<value><B></value>
<A> DWD key word
<B> Value of the key word
Example
<valueName>WARNCELLID</valueName>
<value>9115085002</value>
Following words are permitted as DWD key words:
WARNCELLID
Identification of all the DWD's warning areas as used in PVW,
e.g. "9115085002".
This key is used as unambiguous identification
(identifier) of the area!
STATE
Federal state to which the area belongs, e.g. „HE“ referring to
Hessen (Hesse).
Multiple states are declared by multiple <geocode> elements
with the key word STATE.
SIGN
A 3-letter code used in the header of text warnings as a
reference to the warning area (CCC).
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 16 / 28
This code corresponds to the abbreviation in the file name of
text warnings. E.g. SLI stands for „Schleswig-Flensburg –
Binnenland“
SIGN is only used as fall-back position in special single
warnings.
ALTITUDE
(1) A letter describing the altitude range of the warning. In this
letter both the upper and the lower limit of the warning's
scope is encoded.
(2) <value> can be set to one of the following letters:
X, B, C, D, E, F, G, H, L, M, N, A
A detailed description of the meaning of those letters can be
found in the tables in chapter 3.4.1.
(3) The letter used for <value> is the same letter as used in
the header or in the file name of text warnings in order to
express the altitude.
EXCLUDE_POLYGON (1) Hole in the warning area (area without a warning) as a
polygon.
(2) The contents of „value“ MUST include the whitespacedelimited list of points of the exclusion polygon in the form of
[latitude, longitude] coordinate pairs (points), the last point
MUST be identical to the first point (this is the same format
as in the contents of a <polygon> element, see chapter
2.3.3.2). For example:
<geocode>
<valueName>EXCLUDE_POLYGON</valueName>
<value>48.3,8.2 48.2,8.3 ... 48.3,8.2</value>
</geocode>
(3) There MAY be multiple <geocode> elements with
valueName=“EXCLUDE_POLYGON“ in one <area> block.
Therefore, in processing, each <geocode> element SHOULD
be checked for valueName=“EXCLUDE_POLYGON“. All
exclusion polygons SHOULD then be cut out of each polygon
of a <polygon> element.
(4) In order to conform with CAP v1.2, each hole SHOULD be
covered entirely by at least one polygon of a <polygon>
element.
(5) The <geocode> element with
valueName=“EXCLUDE_POLYGON“ SHOULD NOT be used
if there is no <polygon> element declared in the <area>
element, because in this case the specification of exclusion
polygons does not make any sense.
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 17 / 28
2.3.3.4 <altitude>
Info
Lower limit of the altitude range in feet.
Format
Altitude in feet
Example
1312,336 (=400m)
For explanations and unit conversions see chapter 3.4.
2.3.3.5 <ceiling>
Info
Upper limit of the altitude range in feet.
Format
Altitude in feet
Example
2624,672 (=800m)
For explanations and unit conversions see chapter 3.4.
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 18 / 28
3 Appendices
3.1 Terminology used for ii values (<event>)
ii
Terminology
11 BÖEN (gusts)
12 WIND (wind)
13 STURM (gale)
22 FROST (frost)
24 GLÄTTE (slippery road surfaces)
31 GEWITTER (thunderstorm)
33 STARKES GEWITTER (heavy thunderstorm)
34 STARKES GEWITTER (heavy thunderstorm)
36 STARKES GEWITTER (heavy thunderstorm)
38 STARKES GEWITTER (heavy thunderstorm)
40 SCHWERES GEWITTER (severe thunderstorm)
41 SCHWERES GEWITTER mit EXTREMEN ORKANBÖEN (severe thunderstorm with hurricane-force gusts)
42 SCHWERES GEWITTER( severe thunderstorm)
44 SCHWERES GEWITTER (severe thunderstorm)
45 SCHWERES GEWITTER mit EXTREMEN ORKANBÖEN (severe thunderstorm with hurricane-force gusts)
46 SCHWERES GEWITTER (severe thunderstorm)
48 SCHWERES GEWITTER (severe thunderstorm)
49 SCHWERES GEWITTER mit EXTREMEN ORKANBÖEN (severe thunderstorm with hurricane-force gusts)
51 WINDBÖEN (wind gusts)
52 STURMBÖEN (gale-force gusts)
53 SCHWERE STURMBÖEN (strong gale-force gusts)
54 ORKANARTIGE BÖEN (violent storm gusts)
55 ORKANBÖEN (hurricane-force gusts)
56 EXTREME ORKANBÖEN (extreme hurricane-force gusts)
57 STARKWIND (strong winds)
58 STURM (gale)
59 NEBEL (fog)
61 STARKREGEN (heavy rainfall)
62 HEFTIGER STARKREGEN (excessive heavy rainfall)
63 DAUERREGEN (continuous rainfall)
64 ERGIEBIGER DAUERREGEN (excessive continuous rainfall)
65 EXTREM ERGIEBIGER DAUERREGEN (extreme excessive continuous rainfall)
66 EXTREM HEFTIGER STARKREGEN (extreme excessive heavy rainfall)
70 SCHNEEFALL (snowfall)
71 SCHNEEFALL (snowfall)
72 STARKER SCHNEEFALL (heavy snowfall)
73 EXTREM STARKER SCHNEEFALL (extreme heavy snowfall)
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 19 / 28
74 SCHNEEVERWEHUNG (snow drift)
75 STARKE SCHNEEVERWEHUNG (heavy snow drift)
76 SCHNEEVERWEHUNG (snow drift)
77 STARKE SCHNEEVERWEHUNG (heavy snow drift)
78 EXTREM STARKE SCHNEEVERWEHUNG (extreme heavy snow drift)
79 LEITERSEILSCHWINGUNGEN (powerline vibration)
81 FROST (frost)
82 STRENGER FROST (heavy frost)
83 GLÄTTE (slippery road surfaces)
84 GLÄTTE (slippery road surfaces)
85 GLATTEIS (glaze)
86 GLÄTTE (slippery road surfaces)
87 GLÄTTE (slippery road surfaces)
88 TAUWETTER (thaw)
89 STARKES TAUWETTER (heavy thaw)
94 SCHWERES GEWITTER (severe thunderstorm)
95 SCHWERES GEWITTER mit EXTREM HEFTIGEM STARKREGEN (severe thunderstorm with extreme
heavy rainfall)
96 SCHWERES GEWITTER mit EXTREM HEFTIGEM STARKREGEN (severe thunderstorm with extreme
heavy rainfall)
98 TEST-WARNUNG (warning for test purposes)
99 TEST-UNWETTERWARNUNG (severe weather warning for test purposes)
3.1.1 Vorabinformation Unwetter (preliminary information on
severe weather)
ii
Text
40
Vorabinformation
thunderstorms)
55
Vorabinformation Unwetter vor ORKANBÖEN (preliminary information on hurricane-force wind gusts)
65
Vorabinformation Unwetter vor HEFTIGEM / ERGIEBIGEM REGEN (preliminary information on excessive
rainfall)
75
Vorabinformation Unwetter vor STARKEM SCHNEEFALL / SCHNEEVERWEHUNGEN (preliminary
information on heavy snowfall / snowdrift)
85
Vorabinformation Unwetter vor GLATTEIS (preliminary information on glaze)
89
Vorabinformation Unwetter vor STARKEM TAUWETTER (preliminary information on heavy thaw)
99
TEST-Vorabinformation (preliminary information for test purposes)
Unwetter
vor
SCHWEREN
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
GEWITTERN
(preliminary
information
on
severe
21.03.2016
Page 20 / 28
3.2 Parameters of the ii values (<parameter>)
Thunderstorm
ii
31 / 33
34 / 36
38 / 40
41 / 42
44 / 45
46 / 48
49 / 94
95 / 96
Wind
Only some of the characteristics are listed below in an exemplary manner.
Hagel (hail)
Tornado (tornado)
51 / 52 Böen (gusts)
53 / 54 Exponierte Böen (gusts at
55 / 56 exposed positions)
Windrichtung (wind direction)
Snowfall and -drift Snow drift
Snowfall
Continuous rainfall Heavy rainfall
Fog
59
ParameterName
Gewitter (thunderstorm)
ParameterValue
einzelne / örtlich / wiederholt/ verbreitet
(isolated / local / repetitive / widespread)
N / NO / O / SO / S / SW / W / NW
(N / NE / E / SE / S / SW / W / NW)
Gewitteraufzugsrichtung
(direction which the
thunderstorm is coming from)
Böen (gusts)
<50 / ~50 / >120 / ...
Niederschlag (precipitation) <10 / ~10 / 10-15 / ...
Windrichtung später
(subsequent wind direction)
Lagen (location)
Sicht (visibility)
Nebel (fog)
61 / 62 Niederschlag (precipitation)
66
~2 / ...
möglich (possible)
<50 / ~50 / >120 / ...
<55 / ~55 / >55 / ...
N / NO / O / SO / S / SW / W / NW
(N / NE / E / SE / S / SW / W / NW)
N / NO / O / SO / S / SW / W / NW
(N / NE / E / SE / S / SW / W / NW)
Berge / Flüsse und Täler
(mountains / rivers and valleys)
<150 / ...
verbreitet / gebietsweise
(widespread / regional)
<10 / ~10 / >10 / 5-10 / ...
ParameterUnit
[km/h]
[l/m² in 1h] /
[l/m² in 6h]
[cm]
[km/h]
[km/h]
[m]
[l/m² in 1h] /
[l/m² in 6h]
63 / 64 Niederschlag (precipitation)
65
Staulagen (orographically
intensified)
Bisheriger Niederschlag
(amount of precipitation
already fallen)
<5 / ~5 / >5 / 5-10 / ...
<10 / ...
[/m²]
[l/m²]
<10
[l/m²]
70 / 71 Schneefall (snowfall)
72 / 73
Staulagen (orographically
intensified)
<1 / ~1 / >2 / 1-3 / ...
[cm]
<1 / ~1 / >1 / ...
[cm]
<1 / ~1 / >1 / ...
[cm]
74 / 75 Schnee (sow)
Böen (gusts)
5-10 / >10
40-60 / >65
[cm]
[km/h]
76 / 77 Schneefall (snowfall)
78
Staulage (orographically
intensified)
Bisheriger Schneefall
(amount of snow already
fallen)
Böen (gusts)
<1 / ~1 / >2 / 1-3 / ...
<1 / ~1 / >1 / …
[cm]
[cm]
<1 / ~1 / >1 / ...
[cm]
40-60 / >65
[km/h]
Bisheriger Schneefall
(amount of snow already
fallen)
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 21 / 28
Frost
ii
81 /
82
Thaw
Glaze
Slippery road surfaces
Frost/ slippery road surfaces
83
84
ParameterName
Ort (location)
ParameterValue
bei Aufklaren /
Tal- und Muldenlagen / über Schnee
(at clearing of the sky /
in valleys and hollows / above snow-covered
surfaces)
~0 / >-1 / ...
Lufttemperatur (air
temperature)
Exponierte Temperatur (air
>-2 / ~-2 / ...
temperature at exposed
positions)
Bodentemperatur
>-2 / ~-2 / ...
(temperature at ground level)
Ort (location)
bei Aufklaren /
Tal- und Muldenlagen / über Schnee
(at clearing of the sky /
in valleys and hollows / above snow-covered
surfaces)
Lufttemperatur (air
~0 / >-1 / ...
temperature)
Exponierte Temperatur (air
>-2 / ~-2 / ...
temperature at exposed
positions)
Bodentemperatur
>-2 / ~-2 / ...
(temperature at ground level)
Glätteursache (causing
überfrierende Nässe (freezing dampness) /
event)
starke Reifablagerungen (rime) /
Schneeregen (sleet) /
geringfügiger Schneefall (light snowfall)
Glätteort (location where
Nebenstrassen und Brücken (non-principal
slippery road surfaces are to roads and bridges)
be expected)
Glätteursache (causing
überfrierende Nässe (freezing dampness) /
event)
starke Reifablagerungen (rime) /
Schneeregen (sleet) /
geringfügiger Schneefall (light snowfall)
Glätteort (location where
Nebenstrassen und Brücken (non-principal
slippery road surfaces are to roads and bridges)
be expected)
85 / 86 Ursache (causing event)
87
88 / 89 Niederschlagsdargebot
(potential maximum run-off
due to precipitation and snow
melt)
Beim Übergang von Schnee in Regen /
Beim Übergang von Regen in Schnee
(when changing from snow to rain /
when changing from rain to snow)
<5 / ~5 / >5 / 5-10 / ...
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
ParameterUnit
[°C]
[°C]
[°C]
[°C]
[°C]
[°C]
[l/m²]
21.03.2016
Page 22 / 28
3.3 Groups <eventCode:GROUP>
Group (Weather
phenomenon)
ii
THUNDERSTORM
31;33;34;36;38;
40;41;42;44;45;46;48;49;
(57);(58);
95;96
WIND
11;12;13
(31);33;(34);36;38;
40;41;(42);44;45;(46);48;49;
51;52;53;54;55;56;
57;58;
74;75;76;77;78;
(95);96
TORNADO
(41);(45);(49);(96)
RAIN
34;36;38;
(40);(41);42;44;45;46;48;49;
(57);(58);
61;62;621;63;64;65;66;
88;89;
95;96
HAIL
(33);(34);38;
(40);(41);(42);(44);(45);46;48;49;
95;96
SNOWFALL
70;71;72;73;76;77;78
SNOWDRIFT
74;75;76;77;78
FOG
59
FROST
22;81;82;83
GLAZE
24;83;84;85;86;87
THAW
88;89
POWERLINEVIBRATION
79
UV
246
HEAT
247
TEST
98;99
Note:
The assignment of an ii value to a group is determined by the event and by its
attributes. Accordingly, the ii values in brackets are OPTIONAL, i.e. ii=41 MAY belong
to the group TORNADO, but doesn't necessarily have to.
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 23 / 28
3.4 Altitude information <altitude>, <ceiling>
The altitude information <altitude> and <ceiling> in CAP are specified in feet. To
convert to meters following approach can be used:
meter =feet∗0,3048
The values are rounded to the nearest integer value.
Following rules apply:
•
•
If <altitude> = 0 and <ceiling> not equal 9842.5197 (=3000 m),
it means: „Altitudes below ...“,
for example: <altitude>0</altitude><ceiling>2624.67192</ceiling>
=> Altitudes below 800 m
If <altitude> not equal 0 and <ceiling> = 9842.5197 (=3000 m),
it means: „Altitudes above...“,
for
example
<altitude>2624.67192</altitude><ceiling>9842.5197</ceiling>
•
=> Altitudes above 800 m
If <altitude> = 0 and ceiling = 9842.5197 (=3000 m),
it means: „All altitudes“,
for example: <altitude>0</altitude><ceiling>9842.5197</ceiling>
=> All altitudes
3.4.1 Altitude information used for <geocode:ALTITUDE>
General altitude
Lower limit
Upper limit
Letter in the header /
Meaning
<geocode:ALTITUDE>
0m/
3000 m /
X
0.0 ft
9842.5197 ft
All altitudes
Upward expansion
Lower limit
Upper limit
Letter in the header /
Meaning
<geocode:ALTITUDE>
200 m /
3000 m /
B
>200 m
656.16798 ft
9842.5197 ft
400 m /
3000 m /
C
>400 m
1312.33596 ft
9842.5197 ft
600 m /
3000 m /
D
>600 m
1968.50394 ft
9842.5197 ft
800 m /
3000 m /
E
>800 m
2624.67192 ft
9842.5197 ft
1000 m /
3000 m /
F
>1000 m
3280.8399 ft
9842.5197 ft
1500 m /
3000 m /
G
>1500 m
4921.25985 ft
9842.5197 ft
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 24 / 28
2000 m
3000 m /
H
>2000 m
9842.5197 ft
Downward expansion
Lower limit
Upper limit
Letter in the header /
Meaning
<geocode:ALTITUDE>
0m/
800 m /
L
< 800 m
0.0 ft
2624.67192 ft
0m/
600 m /
M
< 600 m
0.0 ft
1968.50394 ft
0m/
400 m /
N
< 400 m
0.0 ft
1312.33596 ft
0m/
200 m /
A
< 200 m
0.0 ft
656.16798 ft
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 25 / 28
3.5 Colours used by the DWD
Following colour coding is applied on the web page of the DWD:
Type of warning / Severity
Colour
DWD Internet (RGB)
CAP (RGB)
none
Light blue 100, 180, 255
-
Vorabinformation
(preliminary information)
Pink
-
255, 128, 128
Wetterwarnung
(minor weather warning)
Yellow
255, 255, 0
255, 255, 0
Markantes Wetter
Orange
(moderate weather warning)
255, 153, 0
255, 153, 0
Unwetterwarnung
(severe weather warning)
Red
255, 0, 0
255, 0, 0
Extreme Wetterwarnung
(extreme weather warning)
Violet
175, 0, 100
175, 0, 100
Following conversions are applicable:
RGB Float value
Hex value
0
0.00
00
100
0.39
64
128
0.50
80
150
0.59
96
153
0.60
99
175
0.68
AF
180
0.71
B4
204
0.80
CC
255
1.00
FF
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 26 / 28
3.6 Sample file of the overall status
<?xml version="1.0" encoding="UTF-8"?>
<alert xmlns="urn:oasis:names:tc:emergency:cap:1.2"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="urn:oasis:names:tc:emergency:cap:1.2
https://werdis.dwd.de/conf/CAP-DWD-Profil-v2.1.xsd">
<identifier>2.49.0.1.276.DWD.PVW.1301649736071.1</identifier>
<sender>[email protected]</sender>
<sent>2011-04-01T11:22:16+02:00</sent>
<status>Actual</status>
<msgType>Alert</msgType>
<source>PVW</source>
<scope>Public</scope>
<info>
<language>de-DE</language>
<category>Met</category>
<event>ORKANARTIGE BÖEN</event>
<responseType>Prepare</responseType>
<urgency>Immediate</urgency>
<severity>Minor</severity>
<certainty>Observed</certainty>
<eventCode>
<valueName>II</valueName>
<value>54</value>
</eventCode>
<eventCode>
<valueName>GROUP</valueName>
<value>WIND</value>
</eventCode>
<eventCode>
<valueName>AREA_COLOR</valueName>
<value>255 255 0</value>
</eventCode>
<eventCode>
<valueName>PROFILE_VERSION</valueName>
<value>2.0</value>
</eventCode>
<effective>2011-04-01T10:22:17+02:00</effective>
<onset>2011-04-01T12:22:16+02:00</onset>
<expires>2011-04-02T01:22:16+02:00</expires>
<senderName>DWD / Nationales Warnzentrum Offenbach</senderName>
<headline>Amtliche UNWETTERWARNUNG vor ORKANARTIGEN BÖEN
</headline>
<description>Es treten orkanartige Böen mit Geschwindigkeiten
bis 119 km/h (32 m/s, 63kn, Bft 11) auf.
</description>
<instruction>ACHTUNG! Hinweis auf mögliche Gefahren: Es können
Bäume entwurzelt und Dächer beschädigt werden. {...}
</instruction>
<web>http://www.wettergefahren.de</web>
<contact>Deutscher Wetterdienst</contact>
<parameter>
<valueName>Böen</valueName>
<value>105-119 [km/h]</value>
</parameter>
<!-- continued on next page -->
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 27 / 28
<!-- continuation -->
<area>
<areaDesc>Ortenaukreis</areaDesc>
<polygon>48.701202392578125,7.992008209228516
48.70725631713867,7.986664772033691 {...}
</polygon>
<geocode>
<valueName>WARNCELLID</valueName>
<value>108317000</value>
</geocode>
<geocode>
<valueName>STATE</valueName>
<value>BW</value>
</geocode>
<altitude>0.0</altitude>
<ceiling>9842.5197</ceiling>
</area>
</info>
</alert>
CAP DWD Profile v2.1.7
Copyright © DWD 2011-2016. Subject to change.
21.03.2016
Page 28 / 28