StormStation 5 NGX customizations


Configuration parameters

Modifying the default configuration entails editing and modifying the settings.json file located in the StormStation 5 NGX /options subfolder.


The default configuration file looks like this:


    "MapCenter": { "Lat": 36.594299, "Lon": -2.171980 },
    "StationCenter": { "Lat": 36.594299, "Lon": -4.571980 },
    "InitialZoom": 6,
    "DataFileRelativePath": "../svng/data/",
    "DistanceUnit": "km",
    "SymbolSet": 0,
    "NumRings": 6,
    "FirstRing": 50,
    "RingSpacing": 50,
    "RingColor": "rgb(140, 140, 140)",
    "DrawLabels": true,
    "PanelOpacity": 0.75,
    "MapProvider": 11,

    "MapProviderOverlay": 10,
    "StrikeHistoryMinutes": 30,
    "GraphHistoryMinutes": 30,
    "DataSource": "NexStorm",
    "HideUncorrelated": false,
    "ShowTypes": true,

    "ClusteringMinZoom": 6



Configuration parameters must always be enclosed in double quotes, as must text strings and special values. Below we discuss the function of each parameter.


MapCenter - The center of the map in the display window. This can differ from StationCenter (see below). To have the center cross positioned correctly you may have to offset MapCenter a bit to account for the statistics pane overlay. MapCenter contains two sub-parameters, Lat and Lon where you enter latitude and longitude in Degrees Decimal format.


StationCenter - This is the location of the detector and also where the center cross will be drawn on the map and range rings originate from. StationCenter contains two sub-parameters, Lat and Lon where you enter latitude and longitude in Degrees Decimal format.


InitialZoom - Zoom level the map should be in when loaded in a webbrowser. Normally the range is between 2 and 18 but some map providers will have different limits.


DataFileRelativePath - Path to where the JSON datafile is located. This path is relative to the location of the settings.json configuration file.


DistanceUnit - Units for range ring labels and distance measurements. Allowed values are"km" for kilometers and "mi" for miles.


SymbolSet - Which of the three symbol sets to use for rendering strike plots. Allowed range is 0 to 2.


NumRings - Number of range rings, maximum 8. Setting this parameter to 0 will tell StormStation 5 NGX to not draw range rings or the center cross.


FirstRing - The distance to (radius of) the first ring from center (StationCenter), expressed in kilometers or miles depending on the DistanceUnit setting above.


RingSpacing - Distance between first ring and 2nd ring, 2nd ring and 3rd ring etc.


RingColor - RGB triplet representing a color that the range rings will be drawn in. This is a text string that is passed directly to Javascript and must be enclosed in double quotes. (For advanced users, it is also possible to provide an rgba(r,g,b,a) string here).


DrawLabels - Allowed values are true or false. If true, range labels will be drawn on all range rings.


PanelOpacity - Transparency of the statistics panel. Allowed values is in the range of 0.0 (fully transparent) to 1.0 (opaque).


MapProvider - The index of the map provide to use. Map providers are defined in a separate file, mapProviders.js which is located in the same folder as this (settings.json) file. With the included map provider configuration the allowed range is 0 to 13 inclusive. Note that a few layers contain text labels and borders only.


MapProviderOverlay - The index of the map provide overaly to use. Overlays can be used on maps that do not include borders and labels. Overlays are configured identically to Map providers and defined in the same mapProviders.js file.


StrikeHistoryMinutes - Configures how many minutes of historical data to display on the map. Allowed values are 6, 15, 30 and 60.


GraphHistoryMinutes - Configures how many minutes of historical data to include in the statistics presentation. Allowed values are 30, 60, 120, 240, 480 and 720.


DataSource - The source of the original strike data. Should be set to "NexStorm" except in specially licensed application.


HideUncorrelated - Whether uncorrelated strikes should be plotted or not. Allowed values are true and false


ShowTypes - true or false. If true then strike types will be plotted using different symbols and the statistics will differentiate between types. If false, all strikes are plotted using the same symbol and no differentiation is made in the statistics. Note that if ShowTypes is set to true and the detector type in NGX Data Server is set to LD-250 the software will automatically revert to not showing types.


ClusteringMinZoom - Sets the zoom level at which the strike clustering feature will activate.

Changing map size

Changing width and height of the StormStation 5 NGX map window is easy, all you have to do is to change a couple of CSS style parameters in the default stormstation.htm HTML page. Locate the code shown below which would be at line 23 in the default, unmodified HTML file:


<div tabindex="0" class="leaflet-container leaflet-fade-anim" id="map" style="left: 0px; top:0px; width: 650px; height: 430px; position: relative; background-color: black;">


The bolded width and height parameters control the size of the map window. Change the numbers as necessary but keep in mind that the map window cannot be too small because of the clock, statistics and legends panels that are part of the user interface and have fixed width and height. If the map window is too small the panels will start to overlap.