Click here to see all PAMGuard release notes


Latest 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


  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.


  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.


Latest Stable Version 1.15.11 May 2017

Bug Fixes

  1. Bug 317. Rocca Module Data Purging. The ROCCA module was not performing data purging when using classifiers developed for Hawaii/Temperate Pacific/North Atlantic datasets. This has been corrected.
  2. Bug 320. Pamguard stopped reading Click Detector Event data from database when target motion analysis information was encountered. Corrected.
  3. Bug 321. Problem reading Soundtrap 4 files. Fixed.


  1. Added Copy-to-Clipboard button to Warning dialogs, to store error messages and stack trace information on the Windows clipboard. This information can then be easily pasted into emails, text documents, etc when contacting Pamguard support.
  2. Enhancements and bug fixes made to Difar module during 2017 ACE voyage.
  3. Rocca Module: added StartHr, ProportionWhists and ProportionClicks parameters to Event classifier
  4. The installer now allows the user to enter command line switches/parameters to be included in *.ini files.