\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\*\*\*\*\*\*\*\*\*\*\*\*\*\* English Below \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*


This folder contains a dataset of 10 European bird species, carefully labeled and mixed with other sound samples at a controlled signal-to-noise ratio (SNR).

----------------------------------------

Directory structure

The project is organized into four main directories:

 	- File_origin  
 	- File_cleaned_normalised  
 	- File_mixed  
 	- Programs_used  

----------------------------------------

📁 File_origin

├── BirdOnly  
 	This folder contains raw samples from the Xeno-Canto database (only recordings rated *A* or *B*).  
 	Each subfolder corresponds to a labeled species class.  

 	- Total number of classes: 10 (European species only).  
 	- Each `.mp3` file has a corresponding annotation file with the same name and the `_Annotation.xml` extension.  

Annotation format:

<Annotation>
    <Start_s>start time of the vocalization (in seconds)</Start_s>
    <End_s>end time of the vocalization (in seconds)</End_s>
    <FqMin_Hz>minimum frequency of the vocalization</FqMin_Hz>
    <FqMax_Hz>maximum frequency of the vocalization</FqMax_Hz>
    <AmplMin_V>minimum amplitude (between 0 and -0.5)</AmplMin_V>
    <AmplMax_V>maximum amplitude (between 0 and 0.5)</AmplMax_V>
    <Id>class identifier</Id>
</Annotation>


The mapping between identifiers and species names is defined in the file: labelMap.xml

> 🔸 Note:  
> The `_More_Classes` folder contains 10 additional classes, but their annotations are automatically generated and may be inaccurate (not human-validated).

----------------------------------------

├── Noise-ESC-50  
 	Sound samples (5 seconds each) from the ESC-50 dataset, containing non-bird sounds.

├── Noise-Pixabay  
 	Sound samples of rain and wind from the Pixabay platform.

└── Noise-Quebec  
 	Sound samples of forest noise recorded in Quebec.

----------------------------------------

📁 File_cleaned_normalised

├── Bird  
 	Contains bird samples from *File_origin*, cleaned from their environmental background.  
 	(*Annotation files remain unchanged.*)

└── Noise  
 	Contains noise samples from *File_origin*, cleaned and normalized.

----------------------------------------

📁 File_mixed   🔹 (Probably the folder you are looking for) 🔹

 	This folder contains all bird samples mixed with environmental and non-bird sounds,  
 	in a biologically consistent manner and with controlled SNR.

----------------------------------------

📁 Programs_used

 	List and description of scripts used to:  
- extract files via the Xeno-Canto API,  
- clean the recordings according to their annotations,  
- and mix the bird sounds with the selected noise samples.





\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

\*\*\*\*\*\*\*\*\*\*\*\* Explications Français \*\*\*\*\*\*\*\*\*\*\*\*\*

\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

Ce dossier contient un dataset de 10 espèces d’oiseaux européens, soigneusement labellisées et mixées avec d’autres échantillons sonores à rapport signal/bruit (SNR) contrôlé.


----------------------------------------

Structure du dossier


Le projet est organisé en quatre répertoires principaux :

- File_origin  
- File_cleaned_normalised  
- File_mixed  
- Programs_used  


----------------------------------------



📁 File\_origin


├── BirdOnly 

 	Ce dossier contient les échantillons bruts issus de la base Xeno-Canto (seulement les enregistrements de score A ou B).
 	Chaque sous-dossier correspond à une classe d’espèce labellisée.

- Nombre total de classes : 10 (espèces européennes uniquement).
- Chaque fichier audio .mp3 possède un fichier d’annotation associé portant le même nom et l’extension _Annotation.xml.


Format d’annotation :

<Annotation>
    <Start_s>start time of the vocalization (in seconds)</Start_s>
    <End_s>end time of the vocalization (in seconds)</End_s>
    <FqMin_Hz>minimum frequency of the vocalization</FqMin_Hz>
    <FqMax_Hz>maximum frequency of the vocalization</FqMax_Hz>
    <AmplMin_V>minimum amplitude (between 0 and -0.5)</AmplMin_V>
    <AmplMax_V>maximum amplitude (between 0 and 0.5)</AmplMax_V>
    <Id>class identifier</Id>
</Annotation>

La correspondance entre les identifiants et les noms d’espèces est définie dans le fichier : *labelMap.xml*



🔸 Remarque : 	Le dossier \_More\_Classes contient 10 classes supplémentaires, mais leurs annotations sont automatiques et potentiellement erronées (non validées humainement).


├── Noise-ESC-50  
 	Échantillons de bruits non ornithologiques (5 secondes chacun) issus de la base ESC-50.



├── Noise-Pixabay  
 	Échantillons de pluie et vent provenant de la plateforme Pixabay.


└── Noise-Quebec  
 	Échantillons de bruits de forêt enregistrés au Québec.


----------------------------------------

📁 File\_cleaned\_normalised

├── Bird  
 	Contient les échantillons d’oiseaux issus de *File\_origin*, nettoyés de leur environnement sonore. *Les fichiers d’annotation sont inchangés.*



└── Noise  
 	Contient les échantillons de bruit issus de *File\_origin*, également nettoyés et normalisés.

----------------------------------------


📁 File\_mixed   🔹 (Probablement le dossier que vous recherchez) 🔹  

 	Ce dossier contient l’ensemble des échantillons d’oiseaux mixés avec des bruits environnementaux et non ornithologiques, de manière biologiquement cohérente et à SNR contrôlé.


----------------------------------------


📁 Programs\_used

 	Liste et description des scripts utilisés pour : 
- extraire les fichiers via l’API Xeno-Canto,
- nettoyer les enregistrements selon leurs annotations,
- et mélanger les sons d’oiseaux avec les bruits souhaités.