An interactive Dash app to analyze nestling growth using biological models
Project description
🐣 Nestling Growth App
The Nestling Growth App is a web-based tool designed for ornithologists, ecologists, and researchers working on nestling development. It allows users to visualize and model growth metrics such as weight, wing, and tarsus length using classic biological growth functions:
- Logistic
- Gompertz
- Richards
- Von Bertalanffy
- Extreme Value Function (EVF)
It includes language support (English, Spanish, Portuguese) and dynamic content based on user selection.
✨ Features
✔ Upload your own CSV with growth data
✔ Dynamically select variables (e.g., weight, wing, tarsus)
✔ Automatically fits multiple growth models
✔ Exports results (tables and graphs) as CSV and PNG
✔ Interactive interface with tabs for Weight and Wing & Tarsus
✔ Multilingual: 🇬🇧 English, 🇪🇸 Español, 🇵🇹 Português
📥 Input Format
Your CSV must include:
- A column for day (e.g.,
Day,Age,Día, etc.) - At least one of the following:
Weight,Wing, orTarsus
📤 Output
- Growth curves with fitted models
- AIC/BIC comparison tables
- Model parameters including k and T
- Exportable graphs (PNG, 300dpi) and results table (CSV)
📦 Installation (One Time Setup)
Just install once using one of the following methods. After that, you can launch the app anytime by running:
nestling-app
✅ Option 1: PyPI (recommended)
pip install nestling-growth-app
✅ Option 2: Install directly from GitHub
pip install git+https://github.com/jorgelizarazo94/NestlingGrowthApp.git
🧪 Option 3: Conda environment (clean setup)
conda create -n nestlings python=3.9 -y
conda activate nestlings
pip install git+https://github.com/jorgelizarazo94/NestlingGrowthApp.git
🧑💻 Option 4: Clone the repository
git clone https://github.com/jorgelizarazo94/NestlingGrowthApp.git
cd NestlingGrowthApp
pip install -e .
Then launch the app with:
nestling-app
Once started, the app will open automatically or can be accessed via:
http://localhost:8050
🌐 Live Deployment
You can try the online version (if available) here:
🔗 Nestling Growth App on Render
🗂️ Folder Structure
NestlingGrowthApp/
│
├── nestling_app/
│ ├── api/
│ │ ├── app.py # Main Dash app
│ │ ├── translations.py # Multilingual content
│ │ └── assets/ # Images and logo
│ ├── models/
│ │ └── growth_models.py # Growth models
│ ├── components/ # (Optional) Modular UI parts
│ ├── data/ # Example datasets
├── setup.py
├── README.md
├── requirements.txt
📊 Example Datasets
Sample data for testing is available here:
📁 Sample Data Folder
📬 Contact
For questions, suggestions, or collaborations:
📧 jorge.lizarazo.b@gmail.com
🐛 GitHub Issues
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nestling_growth_app-0.1.9.tar.gz.
File metadata
- Download URL: nestling_growth_app-0.1.9.tar.gz
- Upload date:
- Size: 701.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
437ced5c0aceb1cda88d9743343f10cc2417c537a9b68dfe5d46391ebc5bd94a
|
|
| MD5 |
a946b9055f050b117cb538a43bb7cf3e
|
|
| BLAKE2b-256 |
c8ea344803cd4d696ebb404e9614d35890c360494ad5a722a2ad151effdd57a1
|
File details
Details for the file nestling_growth_app-0.1.9-py3-none-any.whl.
File metadata
- Download URL: nestling_growth_app-0.1.9-py3-none-any.whl
- Upload date:
- Size: 698.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
65a019a726b117ab10db137480e1b174e3c2eaa0a5533c5b6c834818649e3432
|
|
| MD5 |
4a036f357a476f3f0617e35e9ade7e00
|
|
| BLAKE2b-256 |
a8ca84719209c5a53e0250ef171b31060b529af212edaee2f51cb7b04e774d67
|