Run a Pattern Matching Job
Overview
VIDEO TUTORIAL: Run a Pattern Matching Job
For a detailed video on how to create a template and run a Pattern Matching job, please check out our WildLabs Tech Tutors talk here.
Tip: Pattern Matching runs optimally on both Firefox and Chrome.
Best Practices
- For testing templates and parameters (e.g. threshold), use playlists with less than 500 recordings.
- Do not run a pattern matching job with a large playlist (>500 recordings) until you are confident in the template and parameters.
- Example: A project with 100,000 recordings and 20 species. We expect that the project may include 3-4 pattern matching training jobs (<500 recordings) per species for testing purposes. Then run 1 final pattern matching job per species with a playlist of 100,000 recordings.
Getting Started
To create a pattern matching job you’ll need to first create a Template.
1. In the main menu, click Analysis.
2. Select Pattern Matching and then click + button to create a new Pattern Matching job and provide the following information:
- Name: name to identify the job.
- Template: the template to search for matches of.
- Playlist: the playlist to analyze.
- Matches per recordings: the maximum number of matches per recording. The highest-scoring matches are saved.
- Matches per site: the maximum number of matches per site. The highest-scoring matches are saved.
- Threshold: similarity (i.e. correlation) threshold.
Tip: Low threshold values (~0.1 – 0.15) will likely include many false positives, but may capture variations in the call type. In contrast, a high threshold value (~<0.25) will reduce the number of false positives.
3. Click Create to initiate the job.
4. In the main menu, click Jobs to inspect the job status. Processing time will depend on the amount of currently active jobs on the platform, but typically Pattern Matching jobs will take ~5 minutes to classify ~ 80,000 recordings.
Validation of Results
1. Once the job has completed, in the main menu, click Analysis.
2. Select the row corresponding to your job.
3. You can listen to detections by clicking the play button (yellow square). To open the original recording, click on the Visualizer icon (orange square). To validate detections as a true or false positive, click on their images, select a validation from the drop-down next to Validate as and select Submit.
4. Detections validated as Present will appear as Present under the Visualizer > Species Presence Validation Tab. Absent validations do not appear here, due to the possibility of the sound being present elsewhere in the recording.
Tip: To accelerate the assessment of presence or absence of a species at a location, click in the Search box and use one of the filters such as the best matches per site and/or day.
5. The detection and validation metadata is available in CSV format by clicking on the Download icon.
