Discharge 1.1.0 Manual


Introduction

Purpose

Discharge will parse the archives generated by Astrogenic's NexStorm and create html reports based upon the data.

Disclaimer

Use at own risk, I am not responsible for any loss of data or damage to (parts of) your computer, internet account, webpages and/or other software installed.

License

Discharge is freeware. You get it all, for ever, for free...

However...

Donations are more than welcome (donate enough and I will buy a StormTracker card and spice up Discharge with some extra data specific to the StormTracker card)

euros:dollars:

Author / Links

The latests version of Discharge is available from http://discharge.supercell.nl. Discharge is written by Daniel van Os, who can be contacted by email at discharge.supercell.nl (replace the first . with the obvious).

Discharge uses data produced by NexStorm, an application for Bolktek lightning detectors written by Astrogenic.

Daniel is not associated with NexStorm (though he recommends NexStorm as the application to use for your Bolteks :)

Manual

If:

- NexStorm is installed properly
- Archiving is turned on
- You have a webbrowser associated with .html files and
- I've done my job properly

All you have to do to generate and view the reports is run discharge.exe and hit that big PROCESS button.

When you hit PROCESS again Discharge will look for new archives and process them if they are available. By clicking RESET you can discard the previous analysis, clicking PROCESS after clicking RESET will reprocess all the archives.

Commandline mode

  • discharge silent_update
    This will run discharge in quiet mode. It will only process new archives.
  • discharge silent_full
    This will run discharge in quiet mode. It will reprocess all archives.

    When running in silent mode all normal settings apply, only the "Open pages after generation" setting is ignored.

    Input Setup

    Discharge needs to know where the NexStorm archive files are. It will make an attempt to find out automatically, but if it fails you must configure this manually. To do so, go to the Input Settings tab and click Select.

    Pick your archive directory and click OK. Notice the checkmark that has now appeared in front of the Overrule label. (You can also select a directory even if Discharge did find the correct location).

    You'll need to click Save Settings before the changes become active.

    Output Setup

    On the Output Settings tab you can select the date format to be used and whether or not Discharge should open the generated pages.

    You also can set the number of entries that should be in the mainlists.

    By entering a location you can personalize the ouput a little, the location will be displayed in the generated menu. As shown in the default value you can add some html tags.

    If you add an URL in the StormVue box, a link will appear in main menu. This will will either open as as subpage of the Discharge pages or in the topmost browser window. You can add the URL relative to the location of the menu, or a full http://...... path.

    Again, you'll need to click Save Settings before the changes become active.

    Destination Setup

    Okay, it's nice that you can view these numbers, but I'll bet you want to share the pages with the rest of the world. Discharge can copy or FTP the results for you. On the Destination Settings tab you can select which should be used.

    Enter the hostname or IP address of your server and the port to be used (21 will do normally). Enter your login name and you password (this will be stored unreadable in the discharge.ini file). You can also add a subdirectory where the files should be stored. You'll probably want to leave the Passive Mode on, but if the upload doesn't work you might try switching it of.

    In the Copy Target area you can select a local folder on your computer to which the generated files should be copied.

    Once more: you must click Save Settings before any changes become active

    The Output

    Summary

    This sums up the underlying results whose meaning is explained below.

    Per Day

    Here you'll get an overview of the days which had the most strikes between 0:00 and 0:00 local time. You can click on a date in the top 5 to view a graph of the day's activity.

    Per Hour

    Here you'll get an overview of the hours which had the most strikes. Note that totals are for whole hours only. So if there has been an active storm between 1:30 and 2:30, producing 400 strikes from 1:30 till 2:00 and 800 strikes between 200 and 2:30, you'll get two entries, not one.

    Per Minute

    Here you'll get an overview of the minutes which had the most strikes. Again, totals are for whole minutes only, not a shifting 60 second window.

    Per Second

    Here you'll get an overview of the seconds which had the most strikes.

    Bursts

    This one shows the longest bursts recorded. A burst is defined (by me :) as a series of strikes occuring within a 5.0 degree window for which the interval between two consecutive strikes does not exceed 0.1 seconds. Every now and then you'll see the same timestamp twice, this happens when simultanious bursts occur in different directions.

    Direction Analysis

    This shows the number of strikes recorded per degree of direction. Slow rising and sinking lines are probably due to climatology: they indicate where most storms occur. Sharp spikes and dips might indicate interference: sources of false strikes or blind spots for the antenna.

    Noise Analysis

    This shows the number of noises per 5 minute periods during the day (summarized over all available days) You must have stored noises in your archive for this to work.

    The Future

    I have some more ideas and improvements in mind, but you can help as well. For example by:

    - Reporting bugs
    - Requesting functionality
    - Donating

    (Something tells me that a combination of the latter two might do wonders, though no guarantees are given :)