# briancgx/yolov11-based_triatoma_infestans_detection architecture

> Architecture diagram of the GitHub repository briancgx/yolov11-based_triatoma_infestans_detection, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/briancgx/yolov11-based_triatoma_infestans_detection
- Repository: https://github.com/briancgx/yolov11-based_triatoma_infestans_detection

## Overview

##### Main Components
- Data Source: Represent the dataset as an input. The folder project/dataset contains the training images (packaged as a ZIP) that feed into the pipeline.
- Training & Experimentation Environment: Show the experimental layer, including the notebooks (project/notebooks/experimental_notebooks) where preliminary tests and model training experiments are performed.
- Model Repository:
- Production Model: Highlight project/models/production_model that contains the final optimized model (final-model.pt) and the dedicated inference script.
- Inference & Evaluation: Indicate the final inference layer (inference_script.py and production notebook) that takes new input images, processes them with the trained YOLOv11 model, and returns detection results.
- Dependencies & Environment: Although not a runtime component, include a side note for the requirements.txt file which governs the software dependencies.

##### Relationships and Data Flow
- From Data Source (dataset) to the Training/Experimentation environment.
- From the experimental notebooks to the Experimental Models repository, signifying the model training phase.
- A selection process flows from experimental models to the final Production Model.
- The Production Model feeds into the inference system where the inference script and final production notebook demonstrate model deployment and inference.

##### Architectural Patterns & Design Principles
- ML Pipeline: Emphasize the iterative nature of model experimentation (experimentation notebooks → experimental models → production model) to highlight continuous improvement.
- Separation of Concerns: Clearly separate the “experiment/training” stage from the “inference/deployment” stage.
- Modularity: Each component (dataset, training, experimentation, and inference) can be represented as distinct modules/components.

##### Relevant Technologies, Frameworks, or Libraries
- YOLOv11 is the central model architecture.
- Jupyter Notebooks (for experimental and production-level evaluation) are the interactive environments for model training.
- Python is used as indicated by the inference_script.py.

- Clear Labels: Use neat labels to denote "Dataset", "Experimental Training Environment", "Experimental Models", "Production Model & Inference", and "Evaluation".

## Diagram (Mermaid)

```mermaid
flowchart TD
    A("Dataset"):::dataset
    subgraph "Training & Experimentation"
        B("Experimental Notebooks"):::notebook
        C("Experimental Models"):::expModels
    end
    subgraph "Production"
        D1("Production Model"):::production
        D2("Inference Notebook"):::production
        D1 -->|"utilizes"| D2
    end
    E("Dependencies"):::dep
    F("Demo/Showcase"):::demo

    A -->|"feeds"| B
    B -->|"trains"| C
    C -->|"selects"| D1
    D2 -->|"feedback"| B
    D2 -->|"showcases"| F
    E -.->|"requirements"| B

    click A "https://github.com/briancgx/yolov11-based_triatoma_infestans_detection/blob/main/project/dataset/chinche_segmentado.v3i.yolov11.zip"
    click B "https://github.com/briancgx/yolov11-based_triatoma_infestans_detection/tree/main/project/notebooks/experimental_notebooks"
    click C "https://github.com/briancgx/yolov11-based_triatoma_infestans_detection/tree/main/project/models/experimental_models"
    click D1 "https://github.com/briancgx/yolov11-based_triatoma_infestans_detection/tree/main/project/models/production_model"
    click D2 "https://github.com/briancgx/yolov11-based_triatoma_infestans_detection/blob/main/project/notebooks/production_notebook/final_yolov11_inference.ipynb"
    click E "https://github.com/briancgx/yolov11-based_triatoma_infestans_detection/blob/main/requeriments.txt"
    click F "https://github.com/briancgx/yolov11-based_triatoma_infestans_detection/blob/main/demo/demo.mp4"

    classDef dataset fill:#AED6F1,stroke:#1F618D,stroke-width:2px;
    classDef notebook fill:#F9E79F,stroke:#B7950B,stroke-width:2px;
    classDef expModels fill:#A9DFBF,stroke:#229954,stroke-width:2px;
    classDef production fill:#F5B7B1,stroke:#922B21,stroke-width:2px;
    classDef dep fill:#D7BDE2,stroke:#6C3483,stroke-width:2px;
    classDef demo fill:#FAD7A0,stroke:#9A7D0A,stroke-width:2px;
```
