Xeno-Canto Bird Recordings Extended (A-M) ML analysis Tool 🐦

This README provides detailed instructions on how to use the tool for the Xeno-Canto Bird Recordings Extended (A-M) dataset. Follow these steps to prepare your bird recordings for further analysis or machine learning applications.

📋 Prerequisites Ensure you have downloaded the Xeno-Canto Bird Recordings Extended (A-M) dataset. You can acquire this dataset from the official Xeno-Canto website or any verified source.

🚀 Getting Started No special installation is required for this tool, assuming Python and the necessary libraries (numpy, PIL, tensorflow, sklearn, matplotlib) are installed. If you lack these libraries, please install them using pip or conda.

🛠️ Usage Instructions Step 1: Download the Dataset Acquire the Xeno-Canto Bird Recordings Extended (A-M) dataset and store it on your local machine. Step 2: Configure Paths Modify the script paths to point to your Xeno-Canto files (input) and the desired output directory for spectrograms:

Input Path Configuration: Locate the section in the script where the dataset's root directory is defined and update it to your dataset's path:

Update the input path

dataset_root = "path/to/your/xeno-canto/files"

Output Path Configuration: Adjust the output path in the script to point to your preferred directory for storing the generated spectrograms:

Update the output path

output_path = "path/to/save/spectrograms"

Step 3: Execute the Script Run the modified script to process the recordings. The spectrograms will be saved in the designated output directory.

ℹ️ Additional Information Verify that you have sufficient storage space for the spectrograms, as their size can significantly increase based on the dataset's volume and the defined resolution.

Thank you for using the Xeno-Canto Bird Recordings tool! 🎉