Skip to content

Latest commit

 

History

History
208 lines (168 loc) · 8.56 KB

README.md

File metadata and controls

208 lines (168 loc) · 8.56 KB

jsame

jsame is a JS library to decode EAS/SAME (Emergency Alert System/Specific Area Message Encoding) alert messages. These messages are primarily used by the National Weather Service for weather-related warnings. jsame will decode a demodulated message, filter by SAME (US/CA) and/or event code, provide readable object back.

PLESE DONT TRUST THIS CODE WITH YOUR LIFE... COMMON SENSE

Requirements

Installation

$ npm install @maxwelldps/jsame

Usage

jsame can decode EAS messages diectly from multitmon, or in SAME format ZCZC-ORG-EEE-PSSCCC-PSSCCC+TTTT-JJJHHMM-LLLLLLLL-

jsame.decode(Message, List of EEE to exclude, List of FIPS to watch )

Example to watch for Lancatser County NE, and not exclude events.

jsame.decode("ZCZC-WXR-RWT-031109+0030-0771800-KOAX/NWS", [], ["031109"])

Exlude Required Weekly tests

jsame.decode("ZCZC-WXR-RWT-031109+0030-0771800-KOAX/NWS", ["RWT"])

Exlude Required Weekly tests, and Match state of NE

jsame.decode("ZCZC-WXR-RWT-031109+0030-0771800-KOAX/NWS", ["RWT"], ["031109"])

Example input

ZCZC-WXR-RWT-055027-055039-055047-055117-055131-055137-055139-055015-055071+0030-0771800-KMKX/NWS-

EAS: ZCZC-WXR-RWT-055027-055039-055047-055117-055131-055137-055139-055015-055071+0030-0771800-KMKX/NWS -

var jsame = require("./jsame.js"); 

Message = "ZCZC-WXR-RWT-055027-055039-055047-055117-055131-055137-055139-055015-055071+0030-0771800-KMKX/NWS-";

decodedMeassage = jsame.decode(Message);
console.log(decodedMeassage["MESSAGE"]);

Event Codes

This list includes current and proposed event codes.

Code Description Code Description
ADR Administrative Message AVA Avalanche Watch
AVW Avalanche Warning BHW Biological Hazard Warning
BWW Boil Water Warning BZW Blizzard Warning
CAE Child Abduction Emergency CDW Civil Danger Warning
CEM Civil Emergency Message CFA Coastal Flood Watch
CFW Coastal Flood Warning CHW Chemical Hazard Warning
CWW Contaminated Water Warning DBA Dam Watch
DBW Dam Break Warning DEW Contagious Disease Warning
DMO Demo Warning DSW Dust Storm Warning
EAN Emergency Action Notification EAT Emergengy Action Termination
EQW Earthquake Warning EVA Evacuation Watch
EVI Evacuation Immediate EWW Extreme Wind Warning
FCW Food Contamination Warning FFA Flash Flood Watch
FFS Flash Flood Statement FFW Flash Flood Warning
FLA Flood Watch FLS Flood Statement
FLW Flood Warning FRW Fire Warning
FSW Flash Freeze Warning FZW Freeze Warning
HLS Hurricane Local Statement HMW Hazardous Materials Warning
HUA Hurricane Watch HUW Hurricane Warning
HWA High Wind Watch HWW High Wind Warning
IBW Iceberg Warning IFW Industrial Fire Warning
LAE Local Area Emergency LEW Law Enforcement Warning
LSW Land Slide Warning NAT National Audible Test
NIC National Information Center NMN Network Message Notification
NPT National Periodic Test NST National Silent Test
NUW Nuclear Plant Warning POS Power Outage Statement
RHW Radiological Hazard Warning RMT Required Monthly Test
RWT Required Weekly Test SMW Special Marine Warning
SPS Special Weather Statement SPW Shelter in Place Warning
SSA Storm Surge Watch SSW Storm Surge Warning
SVA Severe Thunderstorm Watch SVR Severe Thunderstorm Warning
SVS Severe Weather Statement TOA Tornado Watch
TOE 911 Outage Emergency TOR Tornado Warning
TRA Tropical Storm Watch TRW Tropical Storm Warning
TSA Tsunami Watch TSW Tsunami Warning
VOW Volcano Warning WFA Wild Fire Watch
WFW Wild Fire Warning WSA Winter Storm Watch
WSW Winter Storm Warning BLU Blue Alert
SQW Snow Squall Warning

An alert must match one of each specified alert type in order to be processed. If an alert type is omitted, any alert will match that type. In most cases, using only SAME codes to filter alerts will be the best option.

Output

Output is an object with the following

Variable Description Example
MESSAGE Readable message (See sample text output below)
ORG Organization code WXR
EEE Event code RWT
PSSCCC Geographical area (SAME) codes 020103-020209-020091-020121-029047-029165-029095-029037
TTTT Purge time code 0030
JJJHHMM Date code 1051700
LLLLLLLL Originator code KEAX/NWS
COUNTRY Country code US
LLLL-ORG Originating station - Org code KEAX-WXR
organization Organization name National Weather Service
location Originator location Pleasant Hill, Missouri
event Event type Required Weekly Test
type Event type indicator T
start Start time 12:00 PM
end End time 12:30 PM
length Length of event 30 minutes
seconds Event length in seconds 1800
date Local date Tuesday, March 17th 2020, 1:00:00 pm

Sample output 1

"EAS: ZCZC-WXR-EWW-055027-055039-055047-055117-055131-055137-055139-055015-055071+0030-0771800-KOAX/NWS-" (same_decode(TEST_STRING2, ["RWT", "DMO", "RMT"], ["055000"]));

{ 
  "MESSAGE": "The National Weather Service in Omaha, NE has issued a Extreme Wind Warning valid until 1:30 PM for the following counties in Wisconsin: Calumet, Dodge, Fond du Lac, Green Lake, Manitowoc, Sheboygan, Washington, Waushara, Winnebago. (KOAX/NWS)",
  "ORG": "WXR",
  "EEE": "EWW",
  "PSSCCC_LIST":
   [ "055015",
     "055027",
     "055039",
     "055047",
     "055071",
     "055117",
     "055131",
     "055137",
     "055139" ],
  "TTTT": "0030",
  "JJJHHMM": "0771800",
  "STATION": "KOAX",
  "LLLLLLLL": "KOAX/NWS",
  "COUNTRY": "US",
  "LLLL-ORG": "KOAX-WXR",
  "organization": "National Weather Service",
  "location": "Omaha, NE ",
  "event": "Extreme Wind Warning",
  "type": "W",
  "start": "1:00 PM",
  "end": "1:30 PM",
  "length": 30,
  "seconds": 1800,
  "date": "Tuesday, March 17th 2020, 1:00:00 pm" 
}

Sample output 2

"ZCZC-CIV-LAE-000000+0030-0771800-KXYZ/FM-" (same_decode(TEST_STRING2, ["RWT", "DMO", "RMT"]));

{ 
  "MESSAGE": "The Civil Authorities in undefined have issued a Local Area Emergency valid until 1:30 PM for the following counties in Nebraska: ALL. (KXYZ/NWS)",
  "ORG": "CIV",
  "EEE": "LAE",
  "PSSCCC_LIST": [ "031000" ],
  "TTTT": "0030",
  "JJJHHMM": "0771800",
  "STATION": "KXYZ",
  "LLLLLLLL": "KXYZ/NWS",
  "COUNTRY": "US",
  "LLLL-ORG": "KXYZ-CIV",
  "organization": "Civil Authorities",
  "location": "undefined ",
  "event": "Local Area Emergency",
  "type": "E",
  "start": "1:00 PM",
  "end": "1:30 PM",
  "length": 30,
  "seconds": 1800,
  "date": "Tuesday, March 17th 2020, 1:00:00 pm"
}

Sample Text Output

The National Weather Service in Pleasant Hill, Missouri has issued a Required Weekly Test valid until 12:30 PM for the following counties in Kansas: Leavenworth, Wyandotte, Johnson, Miami, and for the following counties in Missouri: Clay, Platte, Jackson, Cass. (KEAX/NWS)

This experimental pagermon site is updated using jsame, pagermon, multimon-ng and a rtl-sdr dongle.

Known Issues

Credits

Thanks to dsame Copyright (c) 2016 Joseph W. Metcalf from which the code was adapted