top of page
Processing mobile transect data in SonoBat 4

Scroll down for detailed guidance on attributing metadata to recordings, scrubbing noise files, assigning automated species IDs to recordings, and exporting metadata in the NABat bulk upload template. 

Processing mobile transect data in 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.

​

​IMPORTANT NOTE: the NABat Metadata fields available in SonoBat 4 do not reflect the most up-to-date metadata fields required and/or accepted by NABat as of September 2024. Only fill out the “Location/Time (required)” fields in the NABat Metadata pop-up window as the other metadata drop-down fields are obsolete.

​​

2. Click the NABat Metadata button. In the pop-up window, 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) 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 is available here.​

 

If transects pass through > 1 grid cell:​

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 button in the bottom center of the window.
​

Scrub Noise Files:

​

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

​​​

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

​​​

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

​​​

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

​​

Assign Species IDs:

​

9. Open SonoBat 4 western [or eastern] North America and click the SonoBatch button in the lower left corner.

​​

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

​​​

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

​​​

12. Ensure Append species codes to filenames? is NOT selected.

​​​

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

​​

14. Set acceptable call quality to 0.80.

​​​

15. Set sqnc decision threshold to 0.90.

​​​

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

​​​

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

​

Export Metadata into the NABat Bulk Upload Template:

​

The following steps can be used to export metadata from all processed transects simultaneously, resulting in a single CSV with metadata from numerous routes. Simply select the parent folder that contains all of your processed transects 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.

​

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

​

1. Open SonoBat 4 western [or eastern] North America and click the SonoVet button in the lower left corner.

​

2. Click the Add to Project button in the Project Vetter window and navigate to the folder containing .wav files that have been processed, renamed, and which contain all required metadata.

​

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

​

​4. 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.​

​

5. If everything is correct, click the Export tab from the top menu bar. Select a destination folder to save the metadata file and select Output null as " " or Output null as an empty cell from the dropdown menu in the bottom center of the window.

​

6. Click Save to File.

​

7. The resulting .txt file must be converted to a .csv file. To convert the file in Excel, open a new workbook, click the Data tab, then Get Data, From File, and From Text/CSV. Note: depending on your version of Excel, the process may vary slightly.

​

8. In the pop-up window, navigate to the SonoBat text file and click Import. Select Tab as the Delimiter and click Load in the bottom right of the window. Your data will now open in an Excel spreadsheet.​​

​

9. When your data are loaded into an Excel spreadsheet, sort by Audio Recording Name. ​

​

10. 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 NABat template. To do so:

​​

  • Select cell A1 of your spreadsheet and paste in the new column headers listed below.​

  • Click the Data tab in Excel. ​

  • Select the Text to Columns button. ​

  • In the dialogue box, select Delimited as the file type and click Next.

  • Select Comma as the Delimiters and click Finish. ​

  • The headers should now be distributed into the appropriate columns.​​

​

GUANO Fields:

​​

| GRTS Cell Id, Location Name, Survey Start Time, Survey End Time, Detector, Detector Serial Number, Microphone, Microphone Serial Number, Microphone Placement, Contact, Comments, Unusual Occurrences, Event Low Temperature, Event High Temperature, Event Low Relative Humidity, Event High Relative Humidity, Event Low Weather Event, Event High Weather Event, Event Low Wind Speed, Event High Wind Speed, Event Low Cloud Cover, Event High Cloud Cover, Audio Recording Name, Audio Recording Time, Latitude, Longitude, Software Type, Auto ID, Manual Id, Species List​​

​​

11. 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.

​

12. Click File, then Save As, and select the folder where you wish to save the metadata spreadsheet. Give the file a unique and descriptive name and then select CSV (Comma delimited) from the Save as type dropdown.

​

Formatting the NABat Template​:

 

NABat stationary acoustic metadata underwent updates in September 2024. Because updates to SonoBat 4 are no longer supported by the software manufacturer, the NABat Attributer no longer reflects the most up to date NABat metadata. Therefore, NABat provides a scripted solution to format data for upload. Follow the instructions below to format data.​

​

13. Download the below 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 ready for upload. 

​

If you require assistance, please contact a member of the NABat Technical Outreach Team, or book a user support appointment at your convenience.

NABat_Circle_color.png

2018 by Bat Conservation International in partnership with the NABat Program

bottom of page