Skip to main content

An interactive Dash app to analyze nestling growth using biological models

Project description

Nestling Growth App

🐣 Nestling Growth App

DOI

Standalone Version (No installation required)

Download the executable version: 👉 Download Windows App (.exe)

Instructions:

  1. Download the ZIP file
  2. Extract it
  3. Double-click the .exe file
  4. The app will open automatically in your browser

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, or Tarsus

📤 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nestling_growth_app-0.2.0.tar.gz (702.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nestling_growth_app-0.2.0-py3-none-any.whl (699.3 kB view details)

Uploaded Python 3

File details

Details for the file nestling_growth_app-0.2.0.tar.gz.

File metadata

  • Download URL: nestling_growth_app-0.2.0.tar.gz
  • Upload date:
  • Size: 702.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.8

File hashes

Hashes for nestling_growth_app-0.2.0.tar.gz
Algorithm Hash digest
SHA256 e88441f8795a8d53118414ce9a8fd73a113abba15fc1b1fc3f234331f4a1f0c2
MD5 be45cfe1e6d672f142860a53a2977bfb
BLAKE2b-256 13ef15cdf4088a4b1e000935d2719c3644ee2b268ca4b4dcaafaa79c2408a574

See more details on using hashes here.

File details

Details for the file nestling_growth_app-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for nestling_growth_app-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0e117ebc42711ed325250bea01e6213394f1970491b80b96c24560b3ebbef929
MD5 07ba06e64e08f2fdb646ace6104af519
BLAKE2b-256 4d637b39ef2ba5ebc03608983913df1821366be5b955deebfb81d9c2a919ef22

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page