# harishs-io/lateral_flowimmunoassay_quant architecture

> Architecture diagram of the GitHub repository harishs-io/lateral_flowimmunoassay_quant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harishs-io/lateral_flowimmunoassay_quant
- Repository: https://github.com/harishs-io/lateral_flowimmunoassay_quant

## Overview

This repository is an automated LFIA image-analysis and quantification pipeline. The principal workflow processes assay images, measures control/test signals, aggregates replicates, and produces calibration and analytical-limit reports. It also supports optional YOLO fine-tuning from collected strip samples. The main script excerpt is partial, so some connections are shown as unverified rather than inferred as definite calls.

Main entry points: [`lfia_analyzer.py`](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/lfia_analyzer.py) (Pipeline runner), [`src/detector.py`](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/detector.py) (Model fine-tuning), [`weights/best.pt`](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/weights/best.pt) (YOLO weights), [`src/signal_processing.py`](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/signal_processing.py) (LSPR extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Analysis workflow"]
  node_runner["Pipeline runner<br/>[lfia_analyzer.py]"]
  node_image_input["Assay images"]
  node_concentration["Concentration parsing<br/>[utils.py]"]
  node_aggregation["Replicate aggregation<br/>[lfia_analyzer.py]"]
end

subgraph group_vision["Strip vision"]
  node_localize["Strip localization<br/>[detector.py]"]
  node_yolo["YOLO weights<br/>[best.pt]"]
  node_finetune["Model fine-tuning<br/>[detector.py]"]
  node_hashing["Sample deduplication<br/>[utils.py]"]
  node_dataset[("Training dataset")]
end

subgraph group_quantification["Signal quantification"]
  node_signal["LSPR extraction"]
  node_bands["Band detection"]
  node_integration["Peak integration"]
end

subgraph group_calibration["Calibration and reporting"]
  node_hook["Hook detection<br/>[calibration.py]"]
  node_fit["Weighted 4PL fit<br/>[calibration.py]"]
  node_limits["CLSI limits<br/>[calibration.py]"]
  node_reports["Plots and reports<br/>[lfia_analyzer.py]"]
end

node_operator(("Analyst"))

node_operator -.->|"runs"| node_runner
node_image_input -.->|"provides images"| node_runner
node_runner -.->|"localizes strips"| node_localize
node_yolo -.->|"supplies weights"| node_localize
node_runner -.->|"extracts signal"| node_signal
node_signal -.->|"detects bands"| node_bands
node_bands -.->|"integrates peaks"| node_integration
node_runner -->|"calls integration"| node_integration
node_runner -->|"cleans values"| node_concentration
node_runner -.->|"aggregates replicates"| node_aggregation
node_runner -->|"checks saturation"| node_hook
node_runner -->|"fits calibration"| node_fit
node_runner -->|"calculates limits"| node_limits
node_runner -.->|"writes results"| node_reports
node_runner -->|"offers fine-tuning"| node_finetune
node_finetune -->|"deduplicates samples"| node_hashing
node_finetune -->|"writes training data"| node_dataset
node_finetune -->|"updates weights"| node_yolo

click node_runner "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/lfia_analyzer.py"
click node_localize "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/detector.py"
click node_yolo "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/weights/best.pt"
click node_finetune "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/detector.py"
click node_hashing "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/utils.py"
click node_signal "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/signal_processing.py"
click node_bands "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/signal_processing.py"
click node_integration "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/signal_processing.py"
click node_concentration "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/utils.py"
click node_aggregation "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/lfia_analyzer.py"
click node_hook "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/calibration.py"
click node_fit "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/calibration.py"
click node_limits "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/calibration.py"
click node_reports "https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/lfia_analyzer.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runner,node_image_input,node_concentration,node_aggregation toneBlue
class node_localize,node_yolo,node_finetune,node_hashing,node_dataset toneAmber
class node_signal,node_bands,node_integration toneMint
class node_hook,node_fit,node_limits,node_reports toneRose
class node_operator toneIndigo
```

## Components

### Analysis workflow

- [Pipeline runner](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/lfia_analyzer.py): `lfia_analyzer.py`
- **Assay images**
- [Concentration parsing](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/utils.py): `src/utils.py`
- [Replicate aggregation](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/lfia_analyzer.py): `lfia_analyzer.py`

### Strip vision

- [Strip localization](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/detector.py): `src/detector.py`
- [YOLO weights](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/weights/best.pt): `weights/best.pt`
- [Model fine-tuning](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/detector.py): `src/detector.py`
- [Sample deduplication](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/utils.py): `src/utils.py`
- **Training dataset**

### Signal quantification

- [LSPR extraction](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/signal_processing.py): `src/signal_processing.py`
- [Band detection](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/signal_processing.py): `src/signal_processing.py`
- [Peak integration](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/signal_processing.py): `src/signal_processing.py`

### Calibration and reporting

- [Hook detection](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/calibration.py): `src/calibration.py`
- [Weighted 4PL fit](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/calibration.py): `src/calibration.py`
- [CLSI limits](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/src/calibration.py): `src/calibration.py`
- [Plots and reports](https://github.com/harishs-io/lateral_flowimmunoassay_quant/blob/main/lfia_analyzer.py): `lfia_analyzer.py`

### Other components

- **Analyst**

## Connections

- Analyst → Pipeline runner: runs
- Assay images → Pipeline runner: provides images
- Pipeline runner → Strip localization: localizes strips (evidence: `lfia_analyzer.py`)
- YOLO weights → Strip localization: supplies weights
- Pipeline runner → LSPR extraction: extracts signal (evidence: `lfia_analyzer.py`)
- LSPR extraction → Band detection: detects bands (evidence: `src/signal_processing.py`)
- Band detection → Peak integration: integrates peaks (evidence: `src/signal_processing.py`)
- Pipeline runner → Peak integration: calls integration (evidence: `lfia_analyzer.py`)
- Pipeline runner → Concentration parsing: cleans values (evidence: `lfia_analyzer.py`)
- Pipeline runner → Replicate aggregation: aggregates replicates (evidence: `lfia_analyzer.py`)
- Pipeline runner → Hook detection: checks saturation (evidence: `lfia_analyzer.py`)
- Pipeline runner → Weighted 4PL fit: fits calibration (evidence: `lfia_analyzer.py`)
- Pipeline runner → CLSI limits: calculates limits (evidence: `lfia_analyzer.py`)
- Pipeline runner → Plots and reports: writes results (evidence: `lfia_analyzer.py`)
- Pipeline runner → Model fine-tuning: offers fine-tuning (evidence: `lfia_analyzer.py`)
- Model fine-tuning → Sample deduplication: deduplicates samples (evidence: `src/detector.py`)
- Model fine-tuning → Training dataset: writes training data (evidence: `src/detector.py`)
- Model fine-tuning → YOLO weights: updates weights (evidence: `src/detector.py`)
