top of page
IMG_0718.jpg

PROCESSING ACOUSTICS IN SONOBAT 4

Select the acoustic survey type for which you have data

​

​

​

SonoBat 30 is now the only version of SonoBat receiving classifier and program updates and the only version to conform to NABat's current stationary and mobile acoustic metadata fields. The following guidance is customized for SonoBat 30 users. Visit SonoBat 30 updates page https://sonobat.com/updates/ for information on the most current program build and classifier series, and instructions for updating a currently installed SonoBat 30 installation.  

 

Updates to SonoBat 4 are no longer supported by the software manufacturer, therefore, the guidance provided for SonoBat 4 is final as of February 1, 2025 and may not reflect future changes to NABat acoustic metadata. 

​

​ATTRIBUTE FILES

1. Open the SonoBat Data Wizard and select the NABat Attributer from the drop-down menu in the top left of the window. Click the folder icon in the top right of the window and navigate to the folder containing the .wav files you intend to attribute (this should be a folder for a single deployment). Next, determine if you would like to Copy and Attribute to Output Folder or Rename and Attribute in place using the dropdown option. Specify an output directory in the Output Folder section where attributed files will be saved. The right panel of the application displays the GUANO metadata present in your selected acoustic files. This will be updated as NABat metadata fields are assigned in the Data Wizard.​​

 

​2. Click the NABat Metadata button to access the NABat metadata pop-up window. For stationary acoustic data, the Mobile Transect option must be set to False.

​

NOTE: the NABat Attributer metadata fields available in SonoBat 4 do not reflect the current metadata fields required and/or accepted by NABat as of Fall 2024. Only fill out the fields on the Location/Time (required) dropdown in the NABat Metadata pop-up window as the other metadata drop-down fields are outdated.

​​

3. Once you have added only the NABat Location/Time (required) fields, click Finish. ​​

 

4. Repeat the above steps for all NABat stationary metadata fields that are required or for which you have data. 
 

5. Select the Attribute Files button in the bottom center of the window.​​

​

​​

​

SCRUB NOISE FILES

1. Click the folder icon in the top right corner of the Data Wizard window and navigate to the folder containing your attributed .wav files.

​​

2. Click the drop-down menu in the top left and select Batch File Scrubber.

​​

3. Select medium from the filter options and ensure the appropriate frequency filter is selected.

​​

4. Click Scrub in the bottom left of the window.​

​

​​

​

ASSIGN SPECIES IDs

1. Open SonoBat 4.x.x North America and click the SonoBatch button in the lower left corner.

​

2. Click the folder icon in the top center of the window and navigate to the folder containing the files you intend to process.

​

3. Select the classifier most appropriate for your location using the drop-down menus on the left side of the window.

​​

4. Ensure Append species codes to filenames? is NOT selected.​

​​

5. Select autofilter in areas without low-frequency bat species and auto-low in areas with low-frequency bats present.

​​​

6. Set acceptable call quality to 0.80.

​​​​

7. Set sqnc decision threshold to 0.90.

​​​​

8. Set max number of calls to consider to 16.

​​​​​

9. Click Process in the bottom center of the window.

​

​

​

EXPORT METADATA INTO BULK UPLOAD TEMPLATE

​The following steps can be used to export metadata from all processed deployments simultaneously, resulting in a single CSV with metadata from numerous sites. Simply select the parent folder that contains all of your processed deployments and follow the steps outlined below. The presence of non .wav files in the folder will not interfere with this process. SonoBat will ignore non .wav files.​

​

1. Open SonoBat 4.x.x North America and select the regional and subregional classifier appropriate for your survey location. Click the I understand button to access the applications primary user interface.

​

2. Click the SonoVet button in the lower left corner to access the Project Vetter pop-up window.

​

3. Click the Add to Project button and navigate to the folder containing .wav files that have been attributed and processed in the above steps.

​

4. Click the Settings tab on the top menu bar and then click the Load Layout button to load the NABat metadata form. Be sure to select the appropriate SonoBat form for your software version. SonoBat project forms are available for download here.

​​

​5. Click the Vetting Table tab from the top menu bar. Ensure all required fields have values and that all fields for which you have entered data are filled.​

​

6. If everything is correct, click the Export tab from the top menu bar. Select a destination folder to save the metadata file and select Use current layout – and Output null as " " or Output null as an empty cell from the dropdown menu in the bottom center of the window. DO NOT select NABat Summary for export – this summary format does not reflect the NABat metadata updates. 

​​

7. Click Save to File.

​​

8. The resulting .txt file must be converted to a .csv file. To convert the file in Excel, open a new workbook, drag and drop your .txt file directly into your new workbook.​

​​

10. The specific software version must now be manually added. Highlight the Software Type column, and using the find/replace function, replace SonoBat with SonoBat 4.x, depending on your specific software version.​

​

11. Click FileSave As, and select the folder where you intend to save the metadata spreadsheet. Give the file a unique and descriptive name and select CSV (Comma delimited) from the Save as type dropdown.​

 

12. In order for the NABat system to read your metadata, the column headers created by SonoBat must be replaced with the metadata field names from the most up-to-date NABat template. To do so, follow directions in the next section.​​​

​

​

​

FORMATTING THE NABAT METADATA TEMPLATE

NABat stationary acoustic metadata fields were updated Fall of 2024. Because updates to SonoBat 4 are no longer supported by the software manufacturer, the SonoBat 4 NABat Attributer does not reflect the most up-to-date NABat metadata. Therefore, a scripted solution to format data from SonoBat 4 for NABat upload is provided below. 

​

1. Click the R Script button below to download a .pdf version of the script. Open R studio and copy and paste the script into the upper left window. Adapt the code to your computer path and file names. Click Run until you reach the end of the code. A new CSV file should now be written and saved to your local working directory with a unique filename.

​

2. You must manually enter information for all required NABat metadata fields into your newly created .csv. You can review the stationary acoustic required metadata fields by downloading the bulk upload template here.

 

3. Once all required fields are populated, your metadata are now ready for upload to the NABat Partner Portal.

​

Attribute Files: SonoBat 4
Scrub Noise Files: SonoBat 4
Assign Species IDs: SonoBat 4
Export Metadata Into Bulk Upload Template: SonoBat 4
Formatting the NABat Metadata Template: SonoBat 4

​ATTRIBUTE FILES

​1. Open the SonoBat Data Wizard and select NABat Attributer from the drop-down menu in the top left of the window. Click the folder icon in the top right of the window and navigate to the folder containing the .wav files you intend to attribute (this should be a folder for a single deployment). Next, determine if you would like to Copy and Attribute to Output Folder or Rename and Attribute in place using the dropdown option. Specify an output directory in the Output Folder section where attributed files will be saved. The right panel of the application displays the GUANO metadata present in your selected acoustic files. This will be updated as NABat metadata fields are assigned in the Data Wizard.

 

NOTE: The NABat Attributer metadata fields available in SonoBat 4 do not reflect the current metadata fields required and accepted by NABat as of Fall 2024. Only fill out the fields in the Location/Time (required) dropdown in the NABat Metadata pop-up window as the other metadata drop-down fields are outdated. 

​

2. Click the NABat Metadata button and enter metadata in the popup window that appears. Select True to confirm that you are processing mobile transect data.

 

NOTE: The NABat system will estimate the location based on user-provided spatial information for the route, timestamps of each file, and the start/end times of the survey. In this case, it is critical that users provide a spatial object (a KML or GEOJSON file) for the route prior to uploading NABat metadata, ensure timestamps are provided for each file, provide start and end times of the route, and leave the GRTS Cell Id column of the metadata upload blank. Instructions on uploading or drawing a spatial object for mobile transect routes are as follows: ​​If transects pass through > 1 grid cell and you have a record of the X,Y location where each call was recorded (using an external GPS or a GPS enabled detector), leave the Start/End GPS and NABat Grid Cell Id fields blank. The NABat system will use the X,Y locations to auto-assign the correct grid cell id to each call. Otherwise, calls recorded outside the primary cell will produce a lat/long-grid cell mismatch error.​​​

​

​3. Click Finish in the bottom right.

​

4. Once you have added only the NABat Location/Time (required) fields, select Attribute Files in the bottom center of the window.

​

​​

​

SCRUB NOISE FILES

1. Click the folder icon in the top right corner of the Data Wizard window and navigate to the folder containing your .wav files.

​

2. Click the drop-down menu in the top left and select Batch File Scrubber.

​

3. Select Thorough: more carefully scans.

​

4. Select medium from the filter options and ensure the appropriate frequency filter is selected.

​​

5. Click Scrub in the bottom left of the window.

​​

6. NABat requests that users provide metadata for scrubbed NOISE files. However, SonoBat automatically ignores any folder labeled Noise FilesDeleted Files, or Scrubbed Files. To ensure scrubbed files load in the SonoVet table, rename folders containing scrubbed files as NOTBAT before loading folders into SonoVet.

​

​​

​

ASSIGN SPECIES IDs

1. Open SonoBat 4 North America and click the SonoBatch button in the lower left corner.

​

2. Click the folder icon in the top center of the window and navigate to the folder containing the files you intend to process.

​

3. Select the classifier most appropriate for your location using the drop-down menus on the left side of the window.

​​

4. Ensure Append species codes to filenames? is NOT selected.​

​​

5. Select autofilter in areas without low-frequency bat species and auto-low in areas with low-frequency bats present.

​​​

6. Set acceptable call quality to 0.80.

​​​​

7. Set sqnc decision threshold to 0.90.

​​​​

8. Set max number of calls to consider to 16.

​​​​​

9. Click Process in the bottom center of the window.

​

​

​

EXPORT METADATA INTO BULK UPLOAD TEMPLATE

​The following steps can be used to export metadata from all processed deployments simultaneously, resulting in a single CSV with metadata from numerous sites. Simply select the parent folder that contains all of your processed deployments and follow the steps outlined below. The presence of non .wav files in the folder will not interfere with this process. SonoBat will ignore non .wav files.​

​

1. Open SonoBat 4.x.x North America and select the regional and subregional classifier appropriate for your survey location. Click the I understand button to access the applications primary user interface.

​

2. Click the SonoVet button in the lower left corner to access the Project Vetter pop-up window.

​

3. Click the Add to Project button and navigate to the folder containing .wav files that have been attributed and processed in the above steps.

​

4. Click the Settings tab on the top menu bar and then click the Load Layout button to load the NABat metadata form. Be sure to select the appropriate SonoBat form for your software version. SonoBat project forms are available for download here.

​​

​5. Click the Vetting Table tab from the top menu bar. Ensure all required fields have values and that all fields for which you have entered data are filled.​

​

6. If everything is correct, click the Export tab from the top menu bar. Select a destination folder to save the metadata file and select Use current layout – and Output null as " " or Output null as an empty cell from the dropdown menu in the bottom center of the window. DO NOT select NABat Summary for export – this summary format does not reflect the NABat metadata updates. 

​​

7. Click Save to File.

​​

8. The resulting .txt file must be converted to a .csv file. To convert the file in Excel, open a new workbook, drag and drop your .txt file directly into your new workbook.​

​​

10. The specific software version must now be manually added. Highlight the Software Type column, and using the find/replace function, replace SonoBat with SonoBat 4.x, depending on your specific software version.​

​

11. Click FileSave As, and select the folder where you intend to save the metadata spreadsheet. Give the file a unique and descriptive name and select CSV (Comma delimited) from the Save as type dropdown.​

 

12. In order for the NABat system to read your metadata, the column headers created by SonoBat must be replaced with the metadata field names from the most up-to-date NABat template. To do so, follow directions in the next section.​​​

​

​​

​

FORMATTING THE NABAT METADATA TEMPLATE

NABat stationary acoustic metadata fields were updated Fall of 2024. Because updates to SonoBat 4 are no longer supported by the software manufacturer, the SonoBat 4 NABat Attributer does not reflect the most up-to-date NABat metadata. Therefore, a scripted solution to format data from SonoBat 4 for NABat upload is provided below. 

​

1. Click the R Script button below to download a .pdf version of the script. Open R studio and copy and paste the script into the upper left window. Adapt the code to your computer path and file names. Click Run until you reach the end of the code. A new CSV file should now be written and saved to your local working directory with a unique filename.

​

2. You must manually enter information for all required NABat metadata fields into your newly created .csv. You can review the stationary acoustic required metadata fields by downloading the bulk upload template here.

 

3. Once all required fields are populated, your metadata are now ready for upload to the NABat Partner Portal.

​​​

​

​

​

Attribute Files SonoBat 4_Mobile
Scrub Noise Files SonoBat 4_Mobile
Assign Species IDs SonoBat 4_Mobile
Export Metadata Into Template_Mobile
Formatting the Metadata Template_Mobile
NABat_Circle_color_map only.jpg

2018 by Bat Conservation International in partnership with the NABat Program

bottom of page