Skip to content

Outil pour découper les fichiers TWAV en vue d'un dépôt sur VigieChiro

License

Notifications You must be signed in to change notification settings

CEREMA/TWAV_splitter

Repository files navigation

TWAV_Splitter

Crédits image : https://www.vigienature.fr/fr/chauves-souris

Ce script permet de transformer des fichiers audios T.WAV en .WAV pour une intégration dans la plateforme Vigie-Chiro.

Il s'appuie sur la librairie opensource Audiomoth-utils

A propos du traitement

Démarrage rapide

Installer python
Installer Node.js

Ouvrir une invite de commandes Windows

cd votredossier
git clone https://github.com/CEREMA/TWAV_splitter.git

Cela va créer un dossier TWAV_splitter.

Aller dedans :

cd TWAV_splitter

Lancer le script en choisissant un dossier source (comprenant les T.WAV) et un dossier de sortie (qui comprendra les .WAV):

python TWAV_splitter.py -i <dossier_source> -o <dossier_sortie>

Pour accélérer les traitements, on peut les exécuter en parallèle avec -n

python TWAV_splitter.py -i <dossier_source> -o <dossier_sortie> -n 6

La valeur par défaut de n est 2

Le script va parcourir le dossier source et créer les fichiers découpés dans le dossier de sortie selon la même arborescence.

Les fichiers WAV générés dans le dossier de sortie peuvent alors être versés dans Vigie-Chiro

Tutoriel

Si vous avez des difficultés, vous pouvez vous référer à ce tutoriel pas à pas avec des copies d'écran

Si vous ne parvenez toujours pas résoudre vos soucis, vous pouvez déposer un ticket dans le volet Issues du repo.

Script d'exemple

Le dossier example contient des exemples d'enregistrements audio de chauve-souris.

Le script example.bat fournit un exemple de traitement du dossier example. Vous pouvez l'exécuter.

Il traite les fichiers du dossier example/from pour les transformer dans le dossier example/to selon la même arborescence.

python TWAV_Splitter.py -i example\from -o example\to -n 6

Les fichiers de destination seront écrasés s'ils existent déjà

License

L'outil TWAV_splitter utilise la bibliothèque Audiomoth-utils et est sous la même license que celle-ci, la license MIT.

A propos

Le format T.WAV correspond à des fichiers audio concaténés par les enregistreurs acoustiques AudioMoth®.

Les AudioMoths n'enregistrent que les évènements dont le son dépasse un certain seuil de Décibel et les collent entre-eux ; l'enregistrement est donc discontinu dans le temps.

Il n'est pas possible d'analyser directement un enregistrement T.WAV sur la plateforme Vigie-Chiro. Sseuls les fichiers .WAV sont acceptés.

Pour convertir un fichier T.WAV en .WAV, il est nécessaire de rétablir la vraie chronologie des évènements.

Le fichier T.WAV doit être dé-concaténé afin de séparer les évènements et les horodater correctement.

De plus, pour l'analyse Vigie-Chiro, les évènement ne doivent pas durer plus de 5 secondes ; le fichier T.WAV doit donc être découpé en plusieurs fichiers de 5 secondes ou moins.

On peut alors supprimer le 'T' de ces fichiers dé-concaténés et découpés afin de les convertir en fichiers .WAV classiques (Waveform Audio File Format).

Le script ajoute une fonction expander_tree dans la librairie Audiomoth-utils

About

Outil pour découper les fichiers TWAV en vue d'un dépôt sur VigieChiro

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •