---
license: cc-by-nc-sa-4.0
---

# T. cruzi Detection Model

## Overview
This repository contains an object detection model trained using the TensorFlow Object Detection API for detecting *Trypanosoma cruzi* parasites in microscopic images. The model is based on SSD MobileNet V2 architecture and has been developed by Spotlab.

This model is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).


**Model ID:** 2xmn544x

## Model Details
- **Architecture:** SSD MobileNet V2
- Training data: published on [zenodo](https://zenodo.org/records/15007339)
    | Sample type       | Training Image | Training Label | Validation Image | Validation Label |
    | ----------------- | -------------- | -------------- | ---------------- | ---------------- |
    | Human CSF         | 261            | 512            | 68               | 191              |
    | Human Blood thick | 61             | 55             | 26               | 14               |
    | Human Blood thin  | 156            | 95             | 154              | 64               |
    | Mice Blood thin   | 570            | 2648           | 105              | 503              |
    | Total             | 1048           | 3310           | 353              | 772              |
- **Performance:**
    | Metrics   | Human | Mice |
    | --------- | ----- | ---- |
    | Precision | 86    | 95.8 |
    | Recall    | 87    | 85   |
    | F1 score  | 86.5  | 90.1 |
## Usage Instructions
### Prepare the app
1. Download huggingSpot from google play store
2. Download model using model URL and API KEY
3. 
<p align="center">
  <img src="https://cdn-uploads.huggingface.co/production/uploads/6509bcfc7e0d56c2717248be/SFFEvw8TPK-FWPqW5rLgg.png" alt="download_app" width="45%"/>
  <img src="https://cdn-uploads.huggingface.co/production/uploads/6509bcfc7e0d56c2717248be/QAcQvyQ85MB0QA_9KzdiO.png" alt="download_model" width="45%"/>
</p>


### Image Preparation
1. **Increase the zoom** until the inner square is clearly visible in the preview
2. Once the inner square appears, the model is ready for detection

### Example Images
Here are examples of properly prepared images for detection:

![Properly zoomed image](https://cdn-uploads.huggingface.co/production/uploads/6509bcfc7e0d56c2717248be/IlBC8azAMOgBjlAp4Dbmc.jpeg)
![Circumferentialview](https://cdn-uploads.huggingface.co/production/uploads/6509bcfc7e0d56c2717248be/gN4UzPYwHZ25HhG2xc-By.jpeg))


### Example Predictions
The model can detect T. cruzi parasites with high accuracy:


![pred1](https://cdn-uploads.huggingface.co/production/uploads/6509bcfc7e0d56c2717248be/abc3uPK89Q9l-QRoyiZs5.png)
![pred2](https://cdn-uploads.huggingface.co/production/uploads/6509bcfc7e0d56c2717248be/2Eqh9mnjlWzd7pv-snFI0.png)