rtwx/docs/README.md

4.8 KiB

RTWX Operator Manual

Welcome to the Realtime Weather Explorer (RTWX)! RTWX is a browser-based application allowing you to quickly access live weather radar data from the NEXRAD network, lightning strike data from Blitzortung, weather alerts directly from NWS, and soon predictive weather forecasts from a custom-built predictive weather engine!

This manual is intended to get scope operators up and running with their RTWX scope as quickly as possible.

Currently Implemented Features:

  • Radar scope

Features In Development:

  • Lightning strike data

Planned Features:

  • NWS alerts
  • Predictive Weather Engine

Contents

Requirements

RTWX is a realtime browser application and therefore requires an internet connection. In addition, RTWX requires WebAssembly support (your browser version must be newer than November 2017) and is rendered entirely via WebGL. Your browser and hardware must support WebGL 2.0, which is supported by all semi-modern GPUs (integrated GPUs will work) and all browsers released after February 2022.

Opening RTWX

To open RTWX, open rtwx.e3t.cc in your browser. After a brief flash, your page should display the main scope window.

The Scope

After you initially load RTWX, the scope will appear blank. This is because text is hidden by default. To show it, enter the command `T to toggle ` text T.

The scope is broken down into 5 main parts.

Status Information Area

In the top left of the scope is the Status Information Area.

Status Information Area

It will consist of multiple lines, telling you:

  • the scope you are in (almost always NEXRAD)
  • the current radar site ICAO (in this case INOP, as the radar is inoperative)
  • any currently active alerts (in this case, there is an alert that the radar is inoperative because there is no data loaded)

Common Alerts

There are a few alerts that are very common:

Alert Meaning Reason To Fix
RADAR INOPERATIVE NO DATA LOADED The radar is currently not working because no radar data has been loaded. A file has not yet been loaded or a dataserver track has not yet been started. Load a file locally (with CLF OV) or start a dataserver track (see Dataserver)
NEW DATA AVAIL RLD RQD There is new data in the buffer that needs to be reloaded into the scope A new file has been uploaded or a dataserver track has received new radar data. Reload the scope (with CLF RELOAD)
DATASERVER TRACK LOST A track on the dataserver has been lost (is no longer responding to queries) The client has been disconnected from the dataserver for unknown reasons. Typically caused by a transient network error. Try reloading the browser. If issue persists, check your internet connection.

Command Buffer

On the left middle of the scope, below the Status Information Area, is the Command Buffer:

Command Buffer

The command buffer will contain any commands you are entering and responses to those commands. It may span multiple lines depending on the command.

Site Information Area

Reserved

Mode Selector

Reserved

Radar Scope

Reserved

Local Operations

Reserved

Data Server

Reserved

Command Reference

Toggle Commands (prefix: `)

Command Description
`T Toggle Text
`R Toggle Radar
`L Toggle Lightning
`A Toggle Alerts

Currently Loaded File (prefix: CLF)

Command Description
CLF OV Overwrite the currently loaded file with one from your local machine.
CLF RELOAD Reload the displayed data from the file buffer.