wingbeats

The data, code and methods used in the paper - Temporal Precision Necessitates Wingbeat-Call Asynchrony in Actively Echolocating Bats

https://github.com/raviumadi/wingbeats

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: biorxiv.org, researchgate.net
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.0%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

The data, code and methods used in the paper - Temporal Precision Necessitates Wingbeat-Call Asynchrony in Actively Echolocating Bats

Basic Info
  • Host: GitHub
  • Owner: raviumadi
  • License: other
  • Language: MATLAB
  • Default Branch: main
  • Size: 53.5 MB
Statistics
  • Stars: 0
  • Watchers: 0
  • Forks: 0
  • Open Issues: 0
  • Releases: 1
Created 12 months ago · Last pushed 12 months ago
Metadata Files
Readme License Citation

README.md

Wingbeat-Call Asynchrony Simulation and Theory

This repository provides the full simulation code, analysis scripts, and supporting functions used in the study of Temporal Precision built on the Responsivity Framework in echolocating bats. It contains modules to explore the temporal dynamics of sonar call timing, wingbeat coordination, and sensory feedback loops in echolocating animals.

This code supports the following manuscripts:

  1. Biosonar Responsivity Sets the Stage for the Terminal Buzz
  2. Temporal Precision Necessitates Wingbeat-Call Asynchrony in Actively Echolocating Bats
  3. Swarm Cohesion in Bats Emerges from Stable Temporal Loops

📁 Repository Structure

/src

Core functions for signal generation, propagation modelling, and acoustic analysis:

  • simulateEcholocationWings.m – primary simulation engine for sonar–wingbeat coupling
  • generateVirtualBatCall.m – generates frequency-modulated bat calls
  • airAttenuationFilter.m, calculateTargetStrength.m, calculateGeometricAttenuation.m, etc. – physical modelling of sound propagation
  • formatLatex*.m – visual formatting for plots with LaTeX labels

/mat

Simulation entry points and experiments scripts:

  • wingbeat_sim.m, wingbeat_sim_loop.m – test cases and multi-run simulations for wingbeat–call synchrony
  • sim_rand_var_run.m – Monte Carlo simulations with randomly sampled biological parameters
  • ssg_demo.m – sonar sound group simulation demo
  • supplementary_analysis.m – statistical and graphical analyses for paper figures
  • temporal_integrity.m – analysis of call–echo timing fidelity

/results

Folder to store figures, .mat files and output summaries from simulations and data processing.

/data

Contains field recordings and/or preprocessed metrics, where applicable.

/doc

Documentation, paper manuscripts, and supporting LaTeX or exportable figures.


🧪 Getting Started

Ensure you have MATLAB R2020b or later. Run the following script to add all folders to the path:

matlab init

📜 License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0).

You are free to share and adapt the material for non-commercial use with appropriate credit.

🧠 Citation

If you use this codebase in part or in full, please cite the corresponding manuscripts or contact the author for further information.

Other Publications

Check my ResearchGate or ORCID for a full list of my research work.

Contact

Drop by my personal website biosonix.io and drop a message if you would like to collaborate or need assistance with the code and development.

Owner

  • Name: Ravi Umadi
  • Login: raviumadi
  • Kind: user
  • Location: Munich

I work with sounds, signals and sense of echolocation.

Citation (citation.cff)

cff-version: 1.2.0
message: "If you use this code, please cite the archive below."
title: "Wingbeat-Call Asynchrony Simulation and Theory"
authors:
  - family-names: Umadi
    given-names: Ravi
    orcid: https://orcid.org/0000-0003-3867-1769
date-released: 2025-07-10
doi: 10.5281/zenodo.15854978
version: "1.0"
license: CC BY-NC 4.0
type: software
repository-code: https://github.com/raviumadi/wingbeats
url: https://doi.org/10.5281/zenodo.15854978

GitHub Events

Total
  • Release event: 1
  • Push event: 2
  • Create event: 2
Last Year
  • Release event: 1
  • Push event: 2
  • Create event: 2