Step 4: Ecological Analysis¶
Overview¶
After labeling mini-scenes with behaviors, you can perform various ecological analyses to generate insights from your behavioral data. The KABR tools framework supports multiple types of analysis including time budgets, social interactions, and behavioral transitions.
Time Budget Analysis¶
Time budget analysis shows how animals allocate their time across different behaviors during observation periods.
Example Analysis¶
Figure 1: Example flight path and video clip from KABR dataset: two male Grevy's zebras observed for 10 minutes on 01/18/23.
Figure 2: Overall time budget for duration of 10 minute observation.
Figure 3: Gantt chart for each zebra (3 minute duration).
Implementation¶
See the time budgets notebook for the code to create these visualizations.
Social Interactions¶
Social interaction analysis examines how different species and individuals interact within the same environment, including proximity patterns and mixed-species associations.
Implementation¶
See the social interactions notebook for the code to create these visualizations.
Behavior Transitions¶
Behavioral transition analysis reveals patterns in how animals move between different behavioral states over time, providing insights into behavioral sequences and decision-making processes.
Implementation¶
See the behavior transitions notebook for the code to create these visualizations.
Case Studies¶
Explore real-world applications in the case studies directory:
- Grevy's Landscape Analysis - Landscape-scale behavioral analysis.
- Mixed Species Social - Multi-species interaction analysis.
- Zebra Behavior Transitions - Behavioral transition patterns.
Key Metrics Generated¶
The analysis pipeline can generate several key ecological metrics:
- Time Budgets - Proportion of time spent in each behavioral category.
- Behavioral Transitions - Probability matrices of behavior changes.
- Social Interactions - Proximity and interaction frequency between individuals.
- Habitat Associations - Relationship between behaviors and spatial locations.
- Group Composition Dynamics - Changes in group structure over time.
Visualization Tools¶
The framework includes tools for creating publication-ready visualizations:
- Gantt charts for individual behavioral timelines.
- Heat maps for behavioral transition probabilities.
- Spatial plots for habitat use patterns.
- Social network diagrams for interaction patterns.
- Time series plots for behavioral trends.
Next Steps¶
For additional customization and advanced features, see Optional Steps which covers fine-tuning YOLO models and additional utility tools.