natgillin/translations-raw huggingface dataset:
Handling of Seconds in NtS messages
XML-struktur i ”meddelanden till befälhavare”
Format of decimals in NtS messages
Mål
Units to be used in NtS messages
Grundläggande principer och begränsningar
Rules for the elements ‘name’, ‘position_code’ and ‘type_code’
Webbstandarder
Rules for the element ‘fairway_name’
Interaktionsmodell och kodningsmetod för webbtjänsten för meddelanden
Clarifications for translations in the spreadsheet ‘reference_code’
Allmänna specifikationer och rekommendationer
Recommendation for the element ‘coordinate’
Specifikation: versionsinformation
Handling of target groups
Specifikation: struktur för namnfält
Display of valid messages at a given time
Rekommendation: användning av namnfält
Optional functions to increase user friendliness of NtS editor tools
Rekommendation: användning av namnfältsprefix
NtS XML Message Structure
Specifikation: användning av ISRS-identifieringskoder
Objective
Tjänst för ”meddelanden till befälhavare” (specifikation för implementering)
Basic Principles and constraints
Förfrågan
Web standards
Svar
Interaction model and encoding method for NtS WS
Generering av tjänster och klienter
General specifications and recommendations
Ordlista
Specification: Version information
”Meddelanden till befälhavare” implementerades i flera europeiska länder baserat på kommissionens förordning (EG) nr 416/2007 om tekniska specifikationer för de ”meddelanden till befälhavare” som avses i artikel 5 i Europaparlamentets och rådets direktiv 2005/44/EG om harmoniserade flodinformationstjänster (RIS) på inre vattenvägar i gemenskapen.
Specification: Structure of namespaces
Standarden för ”meddelanden till befälhavare” utvecklas fortlöpande, och utrullningen av webbtjänsten för meddelanden, såväl som XSD 4.0 för meddelanden för befälhavare, var ett stort steg framåt.
Recommendation: Use of namespaces
Tjänsten underlättar utbyte av ”meddelanden till befälhavare” mellan olika myndigheter och mellan myndigheter och mottagare av ”meddelanden till befälhavare”.
Recommendation: Use of namespace prefixes
Vägledningen för kodning av ”meddelanden till befälhavare” förklarar hur de fyra olika typerna av ”meddelanden till befälhavare” ska användas och förklarar koderna som ska användas i vissa situationer.
Specification: Use of ISRS Location Codes
Den tillhandahåller utförliga instruktioner till redaktörer och möjliggör nationellt och internationellt harmoniserade koder för ”meddelanden till befälhavare”.
NtS Message Service (implementation specification)
Vägledningen för kodning av ”meddelanden till befälhavare” version 1.0 gäller för XSD 4.0 och webbtjänsten WSDL 2.0.4.0.
Request
Denna vägledning är avsedd för personer som redigerar och publicerar ”meddelanden till befälhavare” och omfattar stegvisa instruktioner för hur man skapar rätt typ av meddelande och förklaring av koderna.
Response
Vägledningen för kodning av ”meddelanden till befälhavare” för redaktörer innehåller även relevant information för tillämpningsutvecklare.
Generation of services and clients
Denna vägledning omfattar riktlinjer för utveckling och implementering av tillämpningar för ”meddelanden till befälhavare” och förklarar bakomliggande logik, processer och automatiska värden/standardvärden.
Glossary
Ett ”meddelande till befälhavare” består av följande:
Notices to Skippers (NtS) were being implemented in various European countries based on Commission Regulation 416/2007/EC of the European Parliament and of the Council concerning the technical specifications for Notices to Skippers as referred to in Article 5 of RIS directive 2005/44/EC.
Identifieringsavsnitt.
The NtS standard is in the continuous process of enhancement, a major step forward was the release of the NtS Web Service facilitating exchange of NtS messages between authorities as well as between authorities and NtS users as well as NtS XSD 4.0 streamlining the encoding of NtS messages.
Avsnitt som definierar de aktuella objekt eller farledsavsnitt som meddelandet avser.
The NtS Encoding Guide explains the applicability of the four NtS message types as well as codes to be used in case of certain events.
Ett eller fler av följande avsnitt enligt meddelandetyp:
It provides NtS editors with NtS message filling instructions, thus allows nationally and internationally harmonised encoding of NtS messages.
Begränsning(ar) för meddelande om farled och trafik.
The NtS Encoding Guide version 1.0 applies to NtS XSD 4.0 and the NtS Web Service WSDL 2.0.4.0.
Mätning(ar) för meddelande om vatten.
The NtS Encoding Guide for editors is intended for personnel editing (and publishing) NtS messages including step-by-step creation instructions for the proper message types as well as explanation of codes.
Isförhållande(n) för meddelande om is.
The encoding guide for editors also includes relevant information for application developers.
Väderleksrapport(er) för meddelande om väder.
The NtS Encoding Guide for developers includes guidelines for NtS application implementation explaining logic, processes and auto/default values.
Figur 2
An NtS message consists of the following:
Visualisering av strukturen för ”meddelanden till befälhavare”: obligatoriskt element (1); obligatoriskt element som kan förekomma en eller två gånger (1…2); obligatoriskt element måste förekomma två gånger (2); obligatoriskt element som kan förekomma så mycket som behövs (1-n); frivilligt element som kan förekomma så mycket som behövs (0…n)
the identification section,
Identifieringsavsnittet är obligatoriskt och innefattar allmän information om meddelandets uppgiftslämnare, avsändare, datum för utfärdande, land och originalspråk och tillhandahålls tillsammans med ett av de fyra olika avsnittstyperna för ”meddelanden till befälhavare”:
section defining the applicable object(s) or fairway section(s) the message is related to,
Avsnitt om farled och trafik: ett meddelande om farled och trafik (FTM) skapas vanligtvis av redaktörer av ”meddelanden till befälhavare” som följer Kodning av meddelanden till befälhavare – vägledning för redaktörer.
one or more of the following sections according to the message type:
Avsnittet är kopplat till sträckor på vattenvägar definierade av ISRS-identifieringskoder för början och slut och/eller objekt på vattenvägen definierade av deras respektive identifieringskoder.
limitation(s) for the Fairway and traffic related message,
[gå till kapitel 6]
measurement(s) for the Water level related message,
Avsnitt om vattennivå: ett meddelande om vatten (WRM) underlättar förmedling om information om aktuella och prognostiserade vattennivåer samt annan information.
ice condition(s) for the Ice related message,
Vanligtvis skapas WRM automatiskt (och periodiskt) baserat på sensormätningar av infrastrukturstatus som inte kräver åtgärd av en redaktör.
weather report(s) for the Weather related message.
Avsnittet om vatten innehåller information om ett objekt (t.ex. en mätstation) eller ett farledsavsnitt (t.ex. det minsta lodade djupet för en sträcka eller tillämpliga bestämmelser för ett vattenvägsavsnitt).
Figure 2
Avsnitt om is: ett meddelande om is (ICEM) innehåller information om isförhållanden för en sträcka på en farled som definieras med ISRS-identifieringskoder för dess början och slut.
Visualisation of the NtS message structure: mandatory element (1), mandatory element that may occur one or two times (1…2), mandatory element that has to occur two times (2), mandatory elements that may occur as often as necessary (1-n), optional element that may occur as often as necessary (0…n)
[gå till kapitel 4]
The identification section is mandatory and includes general information about the message originator, sender, date issue, country and original language and is provided together with one of the four different NtS message section types:
Avsnitt om väder: ett meddelande om väder (WERM) förmedlar information om aktuellt och prognostiserat väder för en sträcka på en vattenväg som definieras med ISRS-identifieringskoder för dess början och slut.
Fairway and traffic related section: a ‘Fairway and Traffic related Message’ (FTM) is usually created by NtS editors following the NtS Encoding Guide for editors.
[gå till kapitel 5]
It is related to stretches of waterways (defined by its begin and end ISRS Location Codes and/or objects on the waterway defined by their respective ISRS Location Code.
ISRS-identifieringskoden (International Ship Reporting Standard) används dessutom för att definiera aktuella objekt eller farledsavsnitt som meddelandet avser.
[go to chapter 6]
Identifieringskoden definieras i punkt 4.3 av bilagan till denna förordning.
Water level related section: a ‘Water Related Message’ (WRM) facilitates provision of information on current and predicted water levels as well as other information.
Information om vattennivå är mycket viktig för såväl ruttplanering som säkerhet.
Usually WRM are created automatically (and periodically) based on sensor measurements or infrastructure status not requiring NtS editor interaction.
Det finns för närvarande ingen gemensam standard för hänvisningar till vattennivå.
The water related message section contains information for an object (e.g. gauge station) or a fairway section (e.g. least sounded depth for a stretch, applicable regime at a waterway section).
Värden för vattennivå anges med hänvisning till olika havsnivåer eller särskilda referenspunkter.
Ice related section: an ‘ICE Message’ (ICEM) contains information about the ice conditions for a fairway stretch defined by its begin- and end-ISRS Location Codes.
För att tillhandahålla en korrekt referens ska respektive Reference_code alltid tillhandahållas tillsammans med värdet.
[go to chapter 4]
WRM kan användas för följande information:
Weather related section: a ‘WEather Related Message’ (WERM) enables provision of information on current as well as forecasted weather situations on a waterway stretch defined by its begin- and end-ISRS Location Codes.
Vattennivå (inklusive prognoser).
[go to chapter 5]
Minsta lodade djup (inklusive prognoser).
In addition, the ISRS Location Code (International Ship Reporting Standard) is used to define the applicable object(s) or fairway section(s) the message is related to.
Frihöjd (inklusive prognoser).
The ISRS location code is defined in point 4.3 of the Annex to this Regulation.
Utsläpp (inklusive prognoser).
Water level information is very important for voyage planning as well as safety.
Fördämningsstatus.
At the moment there is no common standard of referencing water level information.
Ordning.
The values of gauges are referring to different sea-levels or to special reference points.
Clarifications for translations in the spreadsheet ”reference_code” tillhandahålls i kapitel 7.11.
To provide a proper reference, the respective ‘reference_code’ shall always be provided together with the value.
WRM skapas och publiceras vanligen automatiskt baserat på information från sensorutrustning, eller information från infrastruktur (t.ex. prognoser, fördämningsstatus).
WRM may be used to provide the following information:
WRM-meddelanden kan publiceras av olika anledningar.
Water level (including predictions),
Det kan handla om periodiska publiceringar eller att ett visst värde nås.
Least sounded depth (including predictions),
I XSD 4.0 för ”meddelanden till befälhavare” är meddelandenumret inte obligatoriskt för WRM.
Vertical clearance (including predictions),
Om meddelandenumret anges måste varje nummer vara unikt (organisation/år/nummer/serie) för meddelandetypen, och det är upp till organisationen som skickar ut WRM-meddelandet att se till att numret är unikt (på varandra följande nummer krävs inte).
Discharge (including predictions),
Startdatum för giltighetsperiod (date_start resp. validity_period) måste anges med aktuellt datum (date_issue) och slutdatum (date_end) för giltighetsperiod ska anges som dagen efter datumet i date_issue.
Barrage status,
För förmedling av t.ex. information om vattennivåer på ett användarvänligt sätt kan skillnaden i förhållande till en tidigare jämförande mätning anges i WRM-meddelandets avsnitt ”Skillnad”.
Regime.
Utöver värdeskillnaden (t.ex. - 5 [cm]) måste även tidsskillnaden i förhållande till den jämförande mätningen anges.
Clarifications for translations in the spreadsheet ‘reference_code’ are provided in chapter 7.11.
När det gäller prognoser är ”measure_date” det datum/den tid prognosen gäller för.
Usually WRM are created and published automatically based on information received from sensor equipment or information received from infrastructure (e.g. predictions, barrage status).
Prognoser om vattennivåer är aldrig helt säkra.
There may be different triggers for WRM publication, e.g. periodically or when certain values are reached.
Vanligtvis används modeller med olika parametrar (t.ex. väderprognoser) för att göra beräkningar vilket leder till varierande prognoser för vattennivåvärden.
In NtS XSD 4.0 the NtS number is optional within WRM messages.
För tillhandahållande av minsta och största prognostiserade värde, t.ex. visualisering av konfidensintervall för vattennivåprognoser, finns två ytterligare datafält i WRM-meddelandets avsnitt om mätningar.
If it is provided every number has to be unique (Organisation/Year/Number/Serial) per message type and it is up to the organisation providing the WRM to ensure unique numbers (it is not required to have consecutive numbers).
Följande figur är en illustration av konfidensintervall för vattennivåprognoser:
The date_start of validity_period has to be filled with present date (date_issue) and the date_end of validity_period has to be filled with the next day after date_issue.
Figur 3
To provide changes in e.g. water level in a user-friendly way the difference to a previous comparative measurement may be provided in the WRM difference section.
I XSD-schemat för ”meddelanden till befälhavare” finns två element:
Besides the change in the value (e.g. - 5 [cm]) also the time difference to the comparative measurement has to be provided.
< value_min > Lägsta värde för konfidensintervall.
Water level predictions always include a factor of uncertainty.
Utöver prognostiserade vattennivåer kan konfidensintervallet också användas för att ange osäkerheten för ett publicerat minsta lodade djup och information om frihöjd.
Usually models with different parameters (e.g. weather forecast) are calculated leading to different predicted water level values.
Mätkoden (measure_code) ”NOM” får inte användas.
To enable provision of a minimum and maximum predicted value e.g. visualisation of a water level prediction confidence interval, two additional optional data fields are included in the WRM ‘measure’ section.
Om det inte finns några mätningar för en viss typ av WRM, men ett meddelande ändå ska skickas, ska värdeelementen utelämnas.
An illustration of water level prediction confidence interval is given in the following figure:
Meddelanden om isförhållanden är beroende av lokala observationer och utvärderingar och skapas vanligtvis manuellt (för automatiskt genererade meddelanden måste reglerna för manuellt skapade meddelanden följas, se Kodning av meddelanden till befälhavare – vägledning för redaktörer).
Two elements are available in the NtS XSD:
För att undvika att ICEM som inte längre är giltiga visas för användare måste slutdatumet för giltighetsperioden (date_end) anges automatiskt som dagen efter publiceringen av tillämpningen för ”meddelanden till befälhavare” (om det inte finns nationella processer som säkrar att meddelanden får ett slutdatum för giltighet så snart informationen i meddelandet inte längre är aktuell).
< value_min > lowest value of confidence interval
I vägledningen för kodning av ”meddelanden till befälhavare” för redaktörer beskrivs under vilka förhållanden en redaktör skapar ett nytt ICEM eller uppdaterar ett befintligt ICEM.
< value_max > highest value of confidence interval
Följande processer ska användas:
Besides predicted water levels the confidence interval may also be used to state the uncertainty of published least sounded depth and vertical clearance information.
Tillämpningar för ”meddelanden till befälhavare” kan erbjuda redaktörer att använda
The confidence interval value_min and value_max enable provision of WRM value confidence interval via standardised NtS WRM Message to use it in graphs.
a. befintliga meddelanden som utkast för att skapa ett nytt ICEM (t.ex. om isförhållandena liknar dem i det befintliga meddelandet) och/eller
The raw data itself shall not be displayed to IWT users (e.g. in code format).
b. meddelandemallar för vissa situationer.
The measure_code ‘NOM’ must not be used.
Innehållet (t.ex. tiden för mätningen eller respektive isförhållanden) måste anges av redaktören i enlighet med kapitel 6 i Kodning av meddelanden till befälhavare – vägledning för redaktörer.
In case there is no measurement for a certain type of WRM the value elements have to be omitted if a message should be sent anyhow.
Datum och tid för mätningen kan också anges av tillämpningen enligt nationella definitioner.
Ice Messages depend on local observation and assessment and will usually be generated manually (in case of automatic generation the rules for manual creation have to be followed, see NtS Encoding Guide for editors).
När en redaktör/utgivare av ”meddelanden till befälhavare” startar publiceringsprocessen
The ICEM is published for a certain fairway_section defined by its begin and end ISRS Location Codes and contains the ice_condition at a certain measurement date.
a. kontrolleras det om allt obligatoriskt innehåll tillhandahålls i enlighet med XSD-schemat för ”meddelanden till befälhavare” (om något saknas, gå tillbaka till (2)),
The validity of the ICEM starts at the date of publication (automatically set by the NtS application).
b. genereras nts_number av tillämpningen för ”meddelanden till befälhavare”,
In order to avoid ICEM being displayed to users that are not valid any more, the validity date_end has to be filled automatically by the NtS application with the day after publication (unless it is ensured by national processes that messages will get a validity date end as soon as the information included in the message is not up-to-date any more).
i. ”organisation” fylls i med namn eller kod för den ansvariga organisationen beroende på avsändarens roll,
In the NtS Encoding Guide for editors it is described under which circumstances an NtS editor creates a new ICEM or updates an existing ICEM.
”year” fylls i med aktuellt år,
The following processes apply:
nästa tillgängliga ”number” tilldelas,
NtS applications may offer NtS editors:
”serial number” 0 tilldelas.
to use existing notices as draft upon creation of new ICEM (e.g. if ice conditions are similar to the existing notice); and/or
c. fylls ”date issue” automatiskt i med aktuellt datum för publiceringen,
to use notice templates for certain situations.
d. fylls ”validity_period” – ”date_start” automatiskt i med aktuellt datum för publiceringen,
The content (e.g. time of measurement or respective ice conditions) has to be entered by the editor in line with chapter 6 of the NtS Encoding Guide for editors.
e. fylls ”validity_period” – ”date_end” automatiskt i som dagen efter publiceringen av meddelandet (om det inte finns nationella processer som säkrar att meddelanden får ett slutdatum för giltighet så snart informationen i meddelandet inte längre är aktuellt).
The date and time of measurement could also be set by the application according to national definitions.
Respektive publicerat meddelande måste väljas för uppdatering i ICEM-redigeringsverktyget.
When an NtS editor/publishers triggers the publish action:
Det ursprungliga ICEM-meddelandet måste kopieras eller ändras i databasen (beroende på nationella processer).
it is checked if all mandatory content is provided in line with the NtS XSD (if not go back to (2));
Utgångna ICEM (som passerat datumet i validity_date_end) går inte att uppdatera.
the nts_number is generated by the NtS application:
Om meddelandena är ogiltiga måste redaktörer av ”meddelanden till befälhavare” skapa ett nytt ICEM.
the ‘organisation’ is filled with the name or code of the responsible organisation depending on the role of the publishing user;
Innehållet (t.ex. tiden för mätningen eller respektive isförhållanden) måste ändras av redaktören i enlighet med kapitel 6 i Kodning av meddelanden till befälhavare – vägledning för redaktörer.
the ‘year’ is filled with the current year;
Datum och tid för mätningen kan också ändras av tillämpningen enligt nationella definitioner.
the next available ‘number’ is assigned;
När en redaktör/utgivare av ”meddelanden till befälhavare” startar publiceringsprocessen
the ‘serial number’ 0 is assigned;
”serial number” ökas (med 1),
‘date_issue’ is automatically filled with the actual date/time of publish action;
WERM skapas och publiceras vanligen automatiskt baserat på information från sensorutrustning, eller information från infrastruktur.
‘validity_period’ — ‘date_start’ is automatically filled with the actual date of publication;
Farledsavsnittet i WERM-meddelandet indikeras som en sträcka mellan två punkter på farleden, dvs. mätområdet för väderstationen (mätaren).
‘validity_period’ — ‘date_end’ is automatically filled with the next day after the date of publication (unless it is ensured by national processes that messages will get a validity date end as soon as the information included in the message is not up-to-date any more).
Datum och tid för mätningen/prognosen måste anges även om det inte är obligatoriskt i WERM.
Expired ICEM (which passed the validity_date_end) cannot be updated any more, if this is the case NtS editors have to create a new ICEM.
Om meddelandenumret anges måste varje nummer vara unikt (organisation/år/nummer/serie) för meddelandetypen, och det är upp till organisationen som skickar ut WERM att se till att numret är unikt (på varandra följande nummer krävs inte).
The content (e.g. time of measurement or respective ice conditions) has to be altered by the editor in line with chapter 6 of the NtS Encoding Guide for editors.
Vindhastigheten i ”weather_category_code” (värde mellan 0 och 12) ska anges i enlighet med Beaufort-skalan som beskrivs av World Meteorological Organization i Manual on Marine Meteorological Services ”WMO-No.
The date and time of measurement could also be altered by the application according to national definitions.
558”.
When an NtS editor/publisher triggers the publish action:
Siktvärdet i ”weather_category_code” (värde mellan 13 och 22) ska anges enligt definitionen i följande tabell:
it is checked if all mandatory content is provided in line with the NtS XSD (if not, go back to (2)); (b) the nts_number is generated by the NtS application:
Värde, betydelse
the ‘organisation’ stays unchanged; (ii) the ‘year’ stays unchanged; (iii) the ‘number’ stays unchanged;
Sikt
the ‘serial number’ is incremented (increased by 1);
Ytterligare information
Usually WERM are created and published automatically based on information received from sensor equipment or information received from infrastructure.
13, Tjocka
The fairway section in WERM is indicated as a stretch between two points on the fairway, i.e. area of applicability of the weather station (gauge).
mindre än 50 meter
Date and time of measurement/forecast have to be provided even if it is not mandatory in WERM messages.
14, Tät dimma
In case of forecasts the ‘measure date’ is the date/time the forecast is valid for.
mindre än 100 meter
In NtS XSD 4.0 the NtS number is optional within WERM messages.
15, Måttlig dimma
If it is provided every number has to be unique (Organisation/Year/Number/Serial) per message type and it is up to the organisation providing the WERM to ensure unique numbers (it is not required to have consecutive numbers).
mindre än 200 meter
The wind speed in ‘weather_category_code’ (values 0 to 12) shall be provided in line with the Beaufort scale published by the World Meteorological Organization in its Manual on Marine Meteorological Services ‘WMO-No 558’.
16, Dimma
The visibility in ‘weather_category_code’ (values 13 to 22) shall be provided as defined in the following table:
mindre än 1000 meter
Value, meaning
Dimma består av vattendroppar.
Visibility
17, Lätt dimma
Additional information
mellan 1 och 4 km
13, thick fog
Lätt dimma består av vattendroppar.