User interface

The GUI will change often in the beginning so to save time I will just use the description in the readme file.

User interface

        
This version has no menus, only hotkeys and buttons.

    *************** Hotkeys Cheat sheet ***************
    *                                                 *
    *         R     - Switch to Raster mode           *
    *         P     - Switch to PRI mode              *
    *       Mouse   - Draw/move zoombox               *
    *       Wheel   - Scroll plot up/down             *
    *    Ctrl+Wheel - Zoom in/out                     *
    *   Shift+Wheel - Scroll plot left/right          *
    *       Space   - Zoom / align raster             *
    *         X     - Zoom in X axis only             *
    *         Y     - Zoom in Y axis only             *
    *        Esc    - Zoom out / undo mode change     *
    *       Arrow   - Pan plot up/down/left/right     *
    *     PgUp/PgDn - Page plot up/down               *
    *     Home/End  - Go to first/last page           *
    *         A     - Align raster                    *
    *         O     - Set offset                      *
    *         F     - Mark frame                      *
    *         S     - Display statistics              *
    *         H     - Show Histogram                  *
    *         L     - Show PDW List                   *
    *      Ctrl+D   - Create bookmark                 *
    *      Ctrl+B   - Open bookmarks window           *
    *                                                 *
    ***************************************************


Help:         F1
Open file:    CTRL-O
Exit program: ALT-F4

Zooming: Draw zoom rectangle on plot with LMB.
         Move zoombox by also pressing RMB.
         Press SPACE to zoom.
         Press X to zoom in X axis only.
         Press Y to zoom in Y axis only.
         
         Zoom in or out with Ctrl+mouse wheel. 
         Zoomed plot will center on mouse pointer. 

Unzoom:  ESC or Mouse wheel click.

         Unzooming will also go back through manual plot 
         limits entry and changes in plot mode as well as 
         Raster mode line length set with zoombox, but not 
         raster align and offset operations or hotkey plot 
         navigation.

Change to Raster mode: R
         If you have drawn a zoombox the raster line 
         length will be set to the difference in TOA value. 
         Otherwise line length will be the mean PRI. 
         X axis limits are set to default values. 

Change to PRI mode:    P
         X axis limits are set to default values. 

Navigate in plot: Move 1/5 of plot: arrow keys
                  Move 1/1 plot in Y axis: PgUp, PgDn
                  Move to first/last page: Home/End
                  Default zoom: Ctrl+Home
                  Scroll up/down: Mouse wheel
                  Scroll left/right: Shift Mouse wheel

Align Raster: Draw zoombox where an imagined diagonal 
              between the origin and end of the box 
              represents the new alignment. Press A (or 
              LineL button or double-click in the LineL 
              entry) 

Align raster with better precision: Press A (or LineL 
              button) which transforms the zoombox to a 
              line. Continue as above.

Set line length: In Raster mode, draw a zoombox with TOA 
              difference as the desired line length and 
              press "R".
              
              Right-click on the LineL-button for a menu 
              where you can choose line length multiplier 
              or set line length to Frame length or Mean 
              from statistics.
              
              In PRI mode, enter some value into the line 
              length entry and it will automatically switch 
              plot mode to Raster with the set line length.
              
              Also in PRI mode, set line length to Frame or 
              Mean with LineL button right-click menu will 
              also switch to Raster mode. 

Adjust offset: In Raster mode, draw a zoombox on the plot, 
               the left edge where you want the new left 
               edge of the plot, and press O (or click on 
               the Offeset button).

Manual entry of parameters:
               Type in a value in any entry that allows 
               it and press ENTER. If you have changed 
               values in more than one entry they will 
               all be set when you press ENTER.
               
               Manual entry accepts units; you may qualify 
               a numerical value with: s, ms, us, Hz, kHz. 
               A frequency value is automatically converted
               to time. This allows you to enter a PRF in 
               the line length entry, but it works in all 
               entries.
               
               Manual entry accepts multipliers and dividers, 
               Eg. 2*618 or 1236/2
               You can also enter just the factor/divisor and 
               the entry will remember the previous value and 
               calculate the new value correctly, eg. 
               Previous value: 1236
               You enter: *2           /3
               New value: 2472         412

Resetting parameters to default values: 
               Double-click in any time limit to set it to
               its default value. 
               
               Click the "<>" button for TOA or PRI to set 
               both start and stop to default values. 

Mark frame:    Draw zoom rectangle where the frame marker is 
               the first pulse in the zoombox ,and press "F"
               
               A frame is the time between two frame markers. 
               
               Extend to previous time by selecting a earlier 
               pulse and pressing "F". Shorten by selecting a
               pulse between start and stop and pressing "F".
               Move to next frame by selecting the last pulse 
               in the next frame and pressing "F".
               
               When a frame is marked statistics for the frame 
               is displayed until other action is taken.

Remove frame markers: Press "F" without zoombox.

Statistics:    Display statistics for a zoom box, a frame or 
               the whole plot by pressing "S". The order of 
               precedence is zoom box, marked frame and plot. 

Histogram:     Show histogram window by pressing "H". 

PDW List:      Show PDW List window by pressing "L".



Measurements:
dY (s):     Difference between zoombox min and max Y value in 
            seconds.

dX (us):    Difference between zoombox min and max X value in 
            microseconds.

Frame (ms): Frame length in milliseconds if a frame is marked

LineL (us): Line length in microseconds when a zoombox or 
            align line is drawn in Raster mode.



Statistics:
Pulses:     Number of pulses selected by zoom box, frame or 
            plot. Note that in Raster mode you get one pulse 
            less as you need two pulses to get one delta-TOA.

Min (us):   Smallest PRI selected. In Raster mode delta-TOA
            is used instead of PRI.

Max (us):   Largest PRI selected. In Raster mode delta-TOA
            is used instead of PRI.

Mean (us):  Mean PRI of pulses in PRI mode or for frame, Mean 
            delta-TOA of pulses in Raster mode. 



Bookmarks:
Create bookmark:    Ctrl+D
            Creates a bookmark containing zoom limits, line 
            length, offset and plot mode.

Recall bookmark:    Ctrl+B
            Opens window for selecting bookmark. 
                    
            Bookmarks ia loaded automatically when a TBD file 
            is opened if a bookmarks file (*.abm) is present. 
            On closing a file or exiting the program, the 
            bookmarks are automatically saved to file, even 
            if there was no bookmarks file to begin with. If 
            all bookmarks were deleted the bookmark file is 
            deleted as well. 

        

Changelog

        
ELINT Alchemist; changes in version 0.4
=======================================

You can now enter parameters with units and multipliers/
dividers. 

When opening a file the program will now look for an 
accompanying bookmarks (*.abm) file and load it. On 
loading a new recording or on exit, any bookmarks will 
be saved to file. If you have deleted all bookmarks, any 
file that was loaded will be deleted. 

Removed line length scrolling as it didn't work well. 

Rewrote left/right scrolling for Raster mode so you can now 
scroll past max/min line length limits, even when fully 
zoomed out. 

Added keyboard shortcuts for zoom out to default zoom 
(fully zzomed out) and go to first/last page. 



ELINT Alchemist; changes in version 0.3
=======================================

Fixed bug with setting line length from PRI mode.

Function for bookmarking zoom limits. There is not yet 
functions for reading or writing bookmarks to file.



ELINT Alchemist; changes in version 0.2
=======================================

Window title bar now displays name of open file.

Fixed bug that would not allow you to mark the first pulse 
in a recording as Frame Start.

Changed reading of TBD files and introduced some error 
correction. 

Added zooming in only X or Y axis with hotkeys X and Y. 

Implemented a right-click menu for the LineL-button for 
multiplying or dividing line length as well as setting line 
length to frame length or mean value from statistics. 

If you enter a value in the Line length entry the plot mode 
will change to Raster automatically. Also; if you use the 
LineL button right-click menu to set line length to Frame 
or Mean the plot mode will change to Raster automatically. 

Added X axis scrolling with Shift+Wheel.

Added line length scrolling with Alt+Wheel. This feature 
will sometimes steal the modifier (Alt) for unknown reasons 
and then not allow Shift+Wheel. Klick in plot to release. 

        

2018-01-10