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.2

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.2
File Size Uploaded
traitly-0.2.2.tar.gz 12.9 MB Details

Built distribution (wheel)

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

Total release size: 25.3 MB

Release files / traitly-0.2.2.tar.gz

Download URL traitly-0.2.2.tar.gz
Size 12.9 MB
Tags Source
SHA-256 checksum
How to use checksums
2b2018139caddd421e30b6962c339e124449100c6eee668d7c6e0119998d4469
BLAKE2b-256 checksum
How to use checksums
1be936cba47a219e8b5cc3d4de5dc2d1f8fb45862d6ed7e02dfb484bcd72b0f1
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.2-py3-none-any.whl

Download URL traitly-0.2.2-py3-none-any.whl
Size 12.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
0fddebe1d9374456fd0ebf5e4005352c38bd404f72e0e683a04026ff47efa555
BLAKE2b-256 checksum
How to use checksums
a14976a2653c7b966306d4f9ab3e60e06feaec3f8e83a82cb6e13e78ae584b5a
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

This release

0.2.2 This release

2 release files

0.2.1

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