Skip to main content

Disponible en: Spanish

Traitly is an open-source Python tool for automated, high-throughput fruit phenotyping from digital images. Using computer vision methods, it quantifies morphological, symmetry, and color traits across both internal structures and the external appearance of the fruit.

It supports both single-image analysis and batch processing workflows, making it easy to handle large image datasets with just a few lines of code, which is especially useful in plant breeding programs and research.


What can Traitly do?

Traitly processes fruit images to measure:

  • Fruit morphology: Area, perimeter, circularity, dimensions, and aspect ratio
  • Locule anatomy: Locule number, size distribution, and spatial arrangement
  • Pericarp structure: Thickness, uniformity (CV), and surface irregularity (lobedness)
  • Color phenotypes: Multi-channel analysis (RGB, HSV, Lab) across different fruit regions

Usage

Traitly can be used from Python, the command line (CLI), or as a web application (Shiny App). For more details:


Publications & Presentations

Posters related to Traitly can be found in this folder:

These materials provide additional methodological details and results from research derived from our package.


Citation

We are working on a manuscript describing this software and its applications, expected to be submitted in Spring–Summer 2026. In the meantime, if you use Traitly in your research, please cite it as:

Torres-Meraz, M. A., Lopez-Moreno, H., & Zalapa, J. (2026). Traitly: A Python Toolkit for High-Throughput Fruit Phenotyping. Zenodo. https://doi.org/10.5281/zenodo.18738366


Contact

For questions or comments about the project, feel free to reach out to:

We are open to collaborations, including adding new traits, and creating tutorials or workflows for specific crops or plant tissues.


Contributions

Inspired by All Contributors, we recognize all kinds of contributions, not just code:

Contributor Role
 María Meraz 💻 🚧 📓 ✅ 🐛 📖 ⚠️ 💬 👀 🌍
 Héctor López 📖 📓 ✅ 🤔 🐛 🔣 🌍
Juan Zalapa 🔣
 Álvaro Guerrero 🐛

Acknowledgements ♡

We thank the developers of OpenCV, Ultralytics, EasyOCR, NumPy, Pandas, Matplotlib, and Shiny, as well as all open-source libraries that made this project possible.

Metadata

Release files for traitly 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for traitly 0.2.1
File Size Uploaded
traitly-0.2.1.tar.gz 1.5 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for traitly 0.2.1
File Interpreter ABI Platform
traitly-0.2.1-py3-none-any.whl Python 3 none any Details

Total release size: 2.6 MB

Release files / traitly-0.2.1.tar.gz

Download URL traitly-0.2.1.tar.gz
Size 1.5 MB
Tags Source
SHA-256 checksum
How to use checksums
3a0ab6f9e7f79937b2a0f600868d367918e693f117dca47cd6f6535709a69d3c
BLAKE2b-256 checksum
How to use checksums
5d5b53ea0356c95ccbf9073e8b6f057a036577e9179051dabb4ee31275fa9880
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Release files / traitly-0.2.1-py3-none-any.whl

Download URL traitly-0.2.1-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
b7f8a8cf104cb858750cc9c7880d4a98e3b06fcd9c0144deb2c5e4d35e75969b
BLAKE2b-256 checksum
How to use checksums
7481cfaabf6c68a9f6efc176222ef23ca8894c5efa98796801c9e19e24c3d82c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.7

Release history Release notifications | RSS feed

0.2.2

2 release files

This release

0.2.1 This release

2 release files

0.2.0

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page