Click here to see all PAMGuard release notes

 

Latest Beta Version 2.00.14 September 2018

PAMGuard Version 2 contains major updates. You should read and understand the notes listed for Beta Version 2.00.10 before proceeding with installation and use of this version.

Bug Fixes

  1. Bug 381. Logger form loses controls when the order is changed.
  2. Bug 382. Click species check boxes get cleared in toolbar when the Click Classification dialog is closed
  3. Bug 383. Spectrogram max frequency resetting to incorrect value the first time the spectrogram dialog is opened.
  4. Bug 385. Bug in offline toolbar which will crash if the classifier dialog is opened and then closed with no classifiers specified.
  5. Bug 386. Click Detector Sweep Classifier sometimes keeping changed settings even when user tries to cancel or discard changes
  6. Bug 387. Map was stopping displaying data based on the start time of data units. Have changed this to last updated time so that click events will display if they have been recently modified. Otherwise, long events get lost from the display.
  7. Bug 388. Spectrogram annotations not working properly in beta branch. Would make and store mark, but not store snr or notes. Both now fixed for both online and offline operations. Have also added some options controlling SNR measurement period.
  8. Bug 389. Multiple annotations of the same class would not be stored to the database if they had the same class. This was affecting the Spectrogram Annotation module which has now been given two text type annotations.
  9. Bug 391. Click Detector not registering change in multi-threading option.
  10. Bug 392. Click Detector throwing exception if multi-threading is turned off and the Basic Sweep Classifier is testing the amplitude range.
  11. Bug 393. Rocca module not calculating energy, duty cycle, and windowRMS values when manually picking contour points.
  12. Bug 394. Occasional divide-by-0 error in Spectrogram Display time scale.
  13. Bug 395. Problem with hydrophone locator was resulting in an incorrect x position for hydrophone 0.

Upgrades

  1. Better way of coupling scrollers in User Display panels - see new options in main menu.
  2. Added Matched Template Click Classifier. Classifies clicks based on an ideal template to match and a template to reject. An example of this is to classify beaked whale clicks in an environment with dolphin clicks.
  3. Added zoom in/out to Raw Data plugin display in spectrogram.
  4. Added ability to read differential GPS data.
  5. Added check for duplicate settings in the psf file when exiting Pamguard. If duplicate settings are found, user is given the option to leave them in the psf or get rid of them. Duplicate settings are ignored by Pamguard, but can cause the psf file to grow large over time.
  6. New features in PAMGuard Beta mean that psf files created with new versions are not compatible wth earlier versions and all configuration data may be lost if an attempt is made to open newly created psf files with older versions. We have therefore changed the file extension of psf files to .psfx in new Beta releases. Beta releases will still load the older psf files, but when the configuration is saved, the original psf file will remain untouched and data will be written to a psfx file with the same directory and name.
 

Latest Version 1.15.15 July 2018

Bug Fixes

  1. Bug 381. Logger form loses controls when the order is changed.
  2. Bug 382. Click species check boxes get cleared in toolbar when the Click Classification dialog is closed
  3. Bug 383. Spectrogram max frequency resetting to incorrect value the first time the spectrogram dialog is opened.
  4. Bug 384. Map options dialog loses Whistle & Moan Detector information.
  5. Bug 385. Bug in offline toolbar which will crash if the classifier dialog is opened and then closed with no classifiers specified.
  6. Bug 386. Click Detector Sweep Classifier sometimes keeping changed settings even when user tries to cancel or discard changes
  7. Bug 387. Map was stopping displaying data based on the start time of data units. Have changed this to last updated time so that click events will display if they have been recently modified. Otherwise, long events get lost from the display.

Upgrades

  1. Added zoom in/out to Raw Data plugin display in spectrogram.
  2. Added ability to read differential GPS data.
  3. Added check for duplicate settings in the psf file when exiting Pamguard. If duplicate settings are found, user is given the option to leave them in the psf or get rid of them. Duplicate settings are ignored by Pamguard, but can cause the psf file to grow large over time.
 

Version 1.15.14 and Beta Version 2.00.13 June 2018

PAMGuard Version 2.xx contains major updates. You should read and understand the notes listed for Beta Version 2.00.10 before proceeding with installation and use of this version.

Bug Fixes

  1. Bug 367. When adding a click to an event that already contained that click, the click was being duplicated in the subtable. (Beta version only)
  2. Bug 368. Whistles from the Whistle & Moan Detector no longer show up on the FX display overlay. (Beta version only)
  3. Bug 369. Map options not showing up in viewer mode when right-clicking on map. (Beta version only)
  4. Bug 370. Rocca crashing when receiving detections from Whistle and Moan Detector.
  5. Bug 371. Rocca loses FFT channel selection when opening params dialog.
  6. Bug 372. Rocca database record incorrectly lists Whistle Classifier file for Clicks.
  7. Bug 373. Incorrect GPS headings in the database are propagated through Pamguard and cause problems with mapping and TMA.
  8. Bug 374. Bearing Errors in Target Motion-3D Loc' calculations.
  9. Bug 375. Low Frequency Clicks not working.
  10. Bug 376. Error when using a serialised data map which spans a period of time in which Pamguard modules have changed.
  11. Bug 377. changes to click events in Viewer Mode not getting saved to database.
  12. Bug 378. TMA dialog not displaying current Model type, and unclear when event not selected.
  13. Bug 379. Channel boxes were being cleared whenever the Decimator settings window was opened.

Upgrades

  1. Soundtrap module - bug fixes and more intuitive user interface when importing Soundtrap data. Also changed the default date/time format to ISO8601 standard. (Beta version only)
  2. A number of upgrades and fixes to the Localiser algorithms, including expanding to work with whistles.
  3. Added option to export all settings and parameters as an XML-formatted file. Note that this required changes to the structure of the Array Manager, and as such any settings (psf) files created with this version of Pamguard cannot be used in older versions. Older psf files can be loaded with this version, but will be converted.
  4. Many updates to the Video Range module. Will currently only work with landmarks. (Beta version only)

Version 1.15.13d and Beta Version 2.00.12c March 2018

PAMGuard Version 2.xx contains major updates. You should read and understand the notes listed for Beta Version 2.00.10 (below) before proceeding with installation and use of this version.

Bug Fixes

  1. Bug 355. Pamguard crashed when database module was present and Rocca tried to load classifier
  2. Bug 356. Ishmael Localiser losing raw audio before it had time to localise
  3. Bug 357. Difar storing Tracked Group latitude in both GroupLatitude and GroupLongitude database columns
  4. Bug 358. Clip Generator not storing overlapping detections properly
  5. Bug 359. Pamguard crashes when selecting auto-scale option in Noise Monitor module
  6. Bug 360. LTSA not loading in viewer mode (Beta version only)
  7. Bug 362. Bug in maximum likelihood bearing estimator grid search (Beta version only)
  8. Bug 363. Rocca throwing exception if user boxes a whistle close to the beginning of a file
  9. Bug 364. LTSA bug - get correct fft length and hop into datablock and output stream
  10. Bug 365. Lose spectrogram settings when converting data from Core to Beta versions (Beta version only)
  11. Bug 366. Rocca manual whistle contour extraction throws error when trying to classify a boxed whistle

Upgrades

  1. During conversion from Core to Beta versions, if there are any problems matching database units to binary store units the UID values will now be set to negative numbers instead of leaving them null. The user is warned about this and encouraged to manually fix the database. (Beta version only)

Version 1.15.13 and Beta Version 2.00.12 January 2018

PAMGuard Version 2.xx contains major updates. You should read and understand the notes listed for Beta Version 2.00.10 (below) before proceeding with installation and use of this version.

Bug Fixes

  1. Bug 341. Temporary objects created in the Rocca module were not being discarded, and could cause memory issues in large datasets.
  2. Bug 342. Rocca was not properly loading a previously-saved EncounterStats file.
  3. Bug 343. Fixed threading issue between Rocca and Click Detector.
  4. Bug 344. Database subtable items were being duplicated when running offline batch processing.  (Beta version only)
  5. Bug 345. Offline Click Event reporting twice as many clicks as there actually were.  (Beta version only)
  6. Bug 346. Click Classifier not properly checking frequency ranges for invalid entries.
  7. Bug 347. Pamguard crashes when loading a Sound Acquisition module when Java 7 is installed on computer. Caused by JFLAC library, which has been recompiled to correct issue.
  8. Bug 348. Map plot overlay menu not updating.
  9. Bug 349. Clip Generator overlay graphics sometimes crashing on map.
  10. Bug 352. Click Detector event marking was not correctly removing clicks from the events tables in the database.  (Beta version only)
  11. Bug 353. Data load information dialog was not updating correctly, particularly when grouped data was relinked to super detections.  (Beta version only)
  12. Bug 354. Whistle Classifier was crashing if user accidentally entered invalid parameters. Have added diagnostics to prevent this.

Upgrades

  1. Can now add echoes to simulated sound acquisition. (Beta version only)
  

Version 1.15.12b and Beta Version 2.00.11c October 2017

PAMGuard Version 2.xx contains major updates. You should read and understand the notes listed for Beta Version 2.00.10 (below) before proceeding with installation and use of this version.

Bug Fixes

  1. Bug 322. Fixed problem with Log event average and click templates not showing.
  2. Bug 323. Difar module. Fixed a couple of small bugs in the DIFAR system which caused it to not work if old configuratins were used.
  3. Bug 324. Occassional crashing in the AIS Module, as reported by user. Added warnings and more robust error handling.
  4. Bug 325. Fixed bug in complex addition/subtraction methods.
  5. Bug 328. Fixed bug in NMEA data flow which caused a Null pointer exception. (Beta version only)
  6. Bug 330. Problem with certain FLAC files not being read properly. Upgraded jFLAC library to fix.
  7. Bug 332. Fixed problem with secondary maps (those not in the main display) not displaying detections.
  8. Bug 333. Fixed problem with data end times rounding incorrectly. (Beta version only)
  9. Bug 334. GPS dialog causing Pamguard window to resize.
  10. Bug 335. Loss of UID information from Binary Files after data is modified (Beta version only)
  11. Bug 336. Binary file corruption when max file size is changed.

Upgrades (Standard Version)

  1. Linked Rocca module to the Sound Acquisition Module. When running auto-detectors (Whistle & Moan or Click Detector), Rocca will now automatically change the Event number when the source file changes.
  2. Allow user to set custom date format when using Soundtrap source files
Upgrades (Beta Version)
  1. Added sound playback and other useful information to bar on FX display
  2. Updates/bug fixes to the landmark module.
  3. Added a simulated white noise source which can be moved around in the same way as other sources.
  4. Reworked annotation system, and added annotations to binary storage
  5. Added 3D rotation to map display. Hold down the shift key while clicking and dragging on the map to see this in action.
  6. Added database logging and other updates to the Click Detector trigger function
  7. Added circular movement option to source simulation
  8. Allow user to set custom date format when using Soundtrap source files

  

Beta Version 2.00.10 June 2017

PAMGuard Version 2 contains major updates. You should read and understand these notes before proceeding with installation and use of this version. These changes have been funded under contract to NOAA Fisheries, contract no. WE-133F-16-SE-1126.

Binary File Structural Changes

The Binary File structure has changed to accommodate additional information for each unit of data stored. This means that any data generated with PAMGuard Version 2.00.00 and above will not be compatible with older versions of PAMGuard. If you open older data sets with the PAMGuard Viewer the older data will be converted to the new format (see below for details).

The most significant change in the binary file format is the addition of a Unique Data Identifier (UID) to each unit of data. This is intended to aid in offline analysis by making it easier for the user to link what they are seeing on different PAMGuard displays and also to link with any data post processed in Matlab or other custom analysis software. UID’s are also added to PAMGuard database tables.

Converting Old Data

If old data are opened with the PAMGuard viewer they will automatically be converted. For safety, the original binary files will not be overwritten and the new data will be placed in a new folder on your computer with the same path as the old data, but suffixed with ‘_WithUID’, e.g. if your binary data were previously stored in the folder C:\MySurvey\binarydata the new data will be written to C:\MySurvey\binarydata_WithUID.

The additional UID column will be added to all database tables and populated with unique values. For data which are stored in both the binary files and in database tables, the same UID’s will be used in both data stores.

New Displays

A new time based scrolling display has been added to PAMGuard which can display multiple types of data on the same time axis. It can for instance be used to display bearings to whistles on a bearing-time type display similar to that commonly used in the click detector. Composite display graphs containing data from more than one detector are also possible. For details, see the PAMGuard help file (Displays / Time Display FX). Note that this display is only available if you are running Java 8 or later.

Event Marking and the Detection Group Localiser

A new system of event marking which can be used both online and offline has been added to PAMGuard. Details are in the PAMGuard help file (Displays/Display Marking). Data can be selected on the Map, the Spectrogram Display and the new Time Display FX in a similar way and sent to other PAMGuard modules. The new marking and data selection system works with the new Detection Group Localiser. The Detection Group Localiser extends the functionality which always existed in the click detector to other types of data (e.g. Whistles) so that they can be grouped and tracked using target motion analysis in a similar way. Details of the Detection Group Localiser are in the PAMGuard help files (Localisation/Detection Group Localiser).

Display Colours

A new system for handling display colours has been implemented across all PAMGuard displays. This gives greater flexibility to the user to control how data units are shown. For instance, you might simply want to show clicks in blue and whistles in green. However, for clicks and whistles that have been assigned to a Detection Group, you may want to colour them by the colour assigned to the group.

Using Old PAMGuard Configurations

Old PAMGuard configurations will work with the new version. However please note the following:

  1. New classes will be added to the configuration files, so they will no longer work with older PAMGuard versions.
  2. Display colour options will be lost and most data displayed on the map may default to black. This is due to the above changes to how colours are managed. Changing back to the colours of your choice is relatively simple through the PAMGuard GUI.