Better example data

example_data/audio/README.md

@@ -0,0 +1,31 @@
+# Example Data - Bat Recordings
+
+This folder contains a selection of 10 bat recordings for use as example data within the _Whombat_ project.
+
+## Source
+
+These recordings were sourced directly from [Xeno-canto](https://www.xeno-canto.org/), a website dedicated to sharing bird and other animal sounds.
+
+## Original Uploaders
+
+The recordings in this dataset were originally uploaded to Xeno-canto by:
+
+- Daniel J Buckley
+- Gloriana Chaverri
+
+## License
+
+The recordings are made available under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/).
+
+## Purpose
+
+This example data is intended to demonstrate the capabilities of _Whombat_ and provide a starting point for users to experiment with the software.
+
+## Disclaimer
+
+Please note that this is a small sample dataset and may not be representative of all bat species or recording conditions.
+For more comprehensive data, please refer to Xeno-canto or other relevant sources.
+
+## Acknowledgements
+
+We extend our sincere gratitude to Daniel J Buckley and Gloriana Chaverri for sharing their valuable recordings on Xeno-canto, making them accessible for research and educational purposes.

example_data/example_xenocanto_dataset.json

@@ -0,0 +1 @@
+{"version":"1.1.0","created_on":"2024-09-28T23:31:51.651030","data":{"uuid":"d2751968-2658-4a10-a9dd-97460e4aafb9","collection_type":"dataset","created_on":"2024-09-28T23:31:51.650056","recordings":[{"uuid":"b53628ac-5cca-560f-ab80-64dc4dade636","path":"XC821988-Lasiurus_blossevillii-2016.02.17-CL01712.wav","duration":2.521124,"channels":1,"samplerate":500000,"hash":"85a1c7ae101e3281b38c2aa9596eea8b","date":"2016-02-17","time":"19:30:00","latitude":8.6617,"longitude":-83.2797,"tags":[0,1,2,3,4,5,6,7,8,9,10],"features":{"altitude":20.0},"owners":["901643b7-abce-5153-ae70-4a6d5104ca98"],"rights":"//creativecommons.org/licenses/by-nc-sa/4.0/"},{"uuid":"a1707bff-866d-54eb-803b-24bf9621cdf8","path":"XC821237-Centronycteris_centralis-2013.01.18-CL00331_B_10.wav","duration":4.91324,"channels":1,"samplerate":375000,"hash":"a679859ac8c64cc5184e07243e0a2ecb","date":"2013-01-18","time":"21:30:00","latitude":8.5777,"longitude":-83.4858,"tags":[11,12,2,13,14,4,15,6,7,8,9,10],"features":{"altitude":200.0},"owners":["901643b7-abce-5153-ae70-4a6d5104ca98"],"rights":"//creativecommons.org/licenses/by-nc-sa/4.0/"},{"uuid":"cf9fec77-7545-5423-8418-d32165ee6ffd","path":"XC882096-Diclidurus-albus_ind2.wav","duration":2.7418933333333335,"channels":1,"samplerate":375000,"hash":"f19afeac29354c29e916aacdbeffeb8d","date":"2024-03-14","time":"18:00:00","tags":[16,17,2,18,19,14,20,21,6,7,8,9,10],"features":{"altitude":30.0},"owners":["901643b7-abce-5153-ae70-4a6d5104ca98"],"rights":"//creativecommons.org/licenses/by-nc-sa/4.0/"},{"uuid":"756e2f6d-2ff6-5d44-b5b4-db7b5105f7e4","path":"XC821730-Rhynchonycteris_naso-2016.02.17-CL01709.wav","duration":3.926628,"channels":1,"samplerate":500000,"hash":"6352445d6c76491c81c2b4e30c979513","date":"2016-02-17","time":"19:30:00","latitude":8.6617,"longitude":-83.2797,"tags":[22,23,2,3,4,5,6,7,8,9,10],"features":{"altitude":20.0},"owners":["901643b7-abce-5153-ae70-4a6d5104ca98"],"rights":"//creativecommons.org/licenses/by-nc-sa/4.0/"},{"uuid":"76884231-4650-5a7b-a105-010564cf1b60","path":"XC826219-Pteronotus_mesoamericanus-2013.02.15-CL00816.wav","duration":3.464144,"channels":1,"samplerate":375000,"hash":"f78af3410f01b8d71110f8397ddd8e04","date":"2013-02-14","time":"20:00:00","latitude":8.6627,"longitude":-83.6497,"tags":[24,25,2,26,4,5,6,7,8,9,10],"features":{"altitude":100.0},"owners":["901643b7-abce-5153-ae70-4a6d5104ca98"],"rights":"//creativecommons.org/licenses/by-nc-sa/4.0/"},{"uuid":"b52a1dd8-b02a-5c50-9358-5efaba918f20","path":"XC820302-Noctilio_leporinus-2013.01.08-CL00088_A_15.wav","duration":3.584041666666667,"channels":1,"samplerate":384000,"hash":"989c3a878406f355b63d3a9ac969e224","date":"2013-01-08","time":"21:00:00","latitude":8.4815,"longitude":-83.5945,"tags":[27,28,2,29,4,5,6,7,8,30,31],"features":{"altitude":30.0},"owners":["8bd4eb23-e3d1-52e6-8081-4ff926374501"],"rights":"//creativecommons.org/licenses/by-nc-sa/4.0/"},{"uuid":"f3830bc3-69dd-5743-8a79-51ae1d3426b0","path":"XC824040-Carollia_castanea-2013.01.17-CL00312_A_15.wav","duration":1.0069583333333334,"channels":1,"samplerate":384000,"hash":"f13d71060354a2fb177329eac07ad433","date":"2013-01-17","time":"23:30:00","latitude":8.5776,"longitude":-83.4858,"tags":[32,33,2,13,19,14,4,5,6,7,8,30,31],"features":{"altitude":200.0},"owners":["48dfc89c-24c9-54ee-ab3b-648439446845"],"rights":"//creativecommons.org/licenses/by-nc-sa/4.0/"},{"uuid":"959ad982-4ca2-5192-a007-208eada7fcb0","path":"XC826196-Carollia_perspicillata-2013.02.15-CL00827.wav","duration":2.9400106666666668,"channels":1,"samplerate":375000,"hash":"dc274401b364ea90022af2ded192907a","date":"2013-02-15","time":"20:00:00","latitude":8.6627,"longitude":-83.6497,"tags":[34,35,2,26,4,5,6,7,8,9,10],"features":{"altitude":100.0},"owners":["901643b7-abce-5153-ae70-4a6d5104ca98"],"rights":"//creativecommons.org/licenses/by-nc-sa/4.0/"},{"uuid":"62b4d938-6a19-59b5-95f4-feda6113ba2e","path":"XC826198-Carollia_sowelli-2013.02.15-CL00829.wav","duration":1.4607466666666666,"channels":1,"samplerate":375000,"hash":"6a89032b3f62e5c8d8b3b76f3f7be233","date":"2013-02-15","time":"20:00:00","latitude":8.6627,"longitude":-83.6497,"tags":[36,37,2,26,4,5,6,7,8,9,10],"features":{"altitude":100.0},"owners":["901643b7-abce-5153-ae70-4a6d5104ca98"],"rights":"//creativecommons.org/licenses/by-nc-sa/4.0/"},{"uuid":"4340f36b-883b-54ce-a421-7e10cb7f1232","path":"XC823144-Desmodus_rotundus-2013.01.16-CL00262_A_30.wav","duration":2.297859375,"channels":1,"samplerate":384000,"hash":"3c82548a0c51c60b89674b508fc238df","date":"2013-01-16","time":"22:30:00","latitude":8.5776,"longitude":-83.4858,"tags":[38,39,2,13,19,14,4,5,6,7,8,30,31],"features":{"altitude":200.0},"owners":["48dfc89c-24c9-54ee-ab3b-648439446845"],"rights":"//creativecommons.org/licenses/by-nc-sa/4.0/"}],"tags":[{"id":0,"key":"species","value":"Lasiurus blossevillii"},{"id":1,"key":"common_name","value":"Southern Red Bat"},{"id":2,"key":"country","value":"Costa Rica"},{"id":3,"key":"location","value":"Playa Nicuesa Rainforest Lodge"},{"id":4,"key":"recording_method","value":"hand-release"},{"id":5,"key":"quality","value":"A"},{"id":6,"key":"animal_seen","value":"True"},{"id":7,"key":"playback_used","value":"False"},{"id":8,"key":"auto","value":"no"},{"id":9,"key":"device","value":"Avisoft UltraSoundGate 116Hme"},{"id":10,"key":"microphone","value":"CM16/CMPA"},{"id":11,"key":"species","value":"Centronycteris centralis"},{"id":12,"key":"common_name","value":"Thomas's Shaggy Bat"},{"id":13,"key":"location","value":"Puerto Jiménez, Puerto Jiménez, Provincia de Puntarenas"},{"id":14,"key":"life_stage","value":"adult"},{"id":15,"key":"quality","value":"B"},{"id":16,"key":"species","value":"Diclidurus albus"},{"id":17,"key":"common_name","value":"Northern Ghost Bat"},{"id":18,"key":"location","value":"Finca 63, Puntarenas Province"},{"id":19,"key":"sex","value":"female"},{"id":20,"key":"recording_method","value":"emerging from roost"},{"id":21,"key":"quality","value":"D"},{"id":22,"key":"species","value":"Rhynchonycteris naso"},{"id":23,"key":"common_name","value":"Proboscis Bat"},{"id":24,"key":"species","value":"Pteronotus mesoamericanus"},{"id":25,"key":"common_name","value":"Mesoamerican Common Mustached Bat"},{"id":26,"key":"location","value":"Bahía Drake (near  Rancho Quemado), Osa, Provincia de Puntarenas"},{"id":27,"key":"species","value":"Noctilio leporinus"},{"id":28,"key":"common_name","value":"Greater Bulldog Bat"},{"id":29,"key":"location","value":"Pavo, Provincia de Puntarenas"},{"id":30,"key":"device","value":"Pettersson D1000X"},{"id":31,"key":"microphone","value":"Advanced electret"},{"id":32,"key":"species","value":"Carollia castanea"},{"id":33,"key":"common_name","value":"Chestnut Short-tailed Bat"},{"id":34,"key":"species","value":"Carollia perspicillata"},{"id":35,"key":"common_name","value":"Seba's Short-tailed Bat"},{"id":36,"key":"species","value":"Carollia sowelli"},{"id":37,"key":"common_name","value":"Sowell's Short-tailed Bat"},{"id":38,"key":"species","value":"Desmodus rotundus"},{"id":39,"key":"common_name","value":"Common Vampire Bat"}],"users":[{"uuid":"901643b7-abce-5153-ae70-4a6d5104ca98","name":"Gloriana Chaverri"},{"uuid":"8bd4eb23-e3d1-52e6-8081-4ff926374501","name":"Sébastien J. Puechmaille"},{"uuid":"48dfc89c-24c9-54ee-ab3b-648439446845","name":"Daniel J Buckley"}],"name":"Example Xenocanto Dataset","description":"An example dataset of recordings from Xenocanto."}}