# yaman-ajaj/curvature_estimation_bacterianearsurface_0610 architecture

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

- Interactive diagram: https://gitdiagram.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610
- Repository: https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610

## Overview

This repository is a MATLAB pipeline for estimating 2D trajectory curvature, validating methods against synthetic ground truth, tuning parameters, and comparing results. The documented workflow runs from synthetic-data generation or supplied tracks through near-surface track analysis and curvature estimation to saved results, validation, and visualization. The README documents the main calls and data flow; no source excerpts were provided, so relationships beyond those documented are omitted.

Main entry points: [`analyzeAllTracks.m`](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/analyzeAllTracks.m) (Track analyzer), [`curvatureResults_Clean_circlefit_step1_20260927_163525.mat`](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvatureResults_Clean_circlefit_step1_20260927_163525.mat) (Curvature results), [`groundTruthComparison.m`](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/groundTruthComparison.m) (Ground-truth comparison), [`run_sweep_tests.m`](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/run_sweep_tests.m) (Parameter sweeps)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Trajectory data"]
  node_generator["Synthetic generator"]
  node_synthetic[("Synthetic tracks")]
  node_input_tracks[("Input tracks")]
  node_analyzer["Track analyzer<br/>[analyzeAllTracks.m]"]
  node_results[("Curvature results")]
end

subgraph group_estimate["Curvature estimation"]
  node_circle_fit["Circle fitting"]
  node_tangent["Tangent-angle method"]
  node_central_diff["Central differences"]
  node_local_poly["Local polynomial"]
  node_spline_methods["Spline methods"]
  node_spline_smoothing["Trajectory smoothing"]
end

subgraph group_validate["Validation and tuning"]
  node_ground_truth[("Known curvature<br/>[groundTruth.mat]")]
  node_comparison["Ground-truth comparison"]
  node_sweeps["Parameter sweeps<br/>[run_sweep_tests.m]"]
end

subgraph group_present["Comparison and visualization"]
  node_method_compare["Method comparison"]
  node_plots["Track visualizations"]
  node_track_plot["Comparative track plots"]
end

node_researcher(("Researcher"))

node_researcher -->|"generates data"| node_generator
node_generator -->|"saves tracks"| node_synthetic
node_researcher -->|"runs analysis"| node_analyzer
node_synthetic -->|"provides tracks"| node_analyzer
node_input_tracks -->|"provides tracks"| node_analyzer
node_analyzer -->|"runs selected method"| node_circle_fit
node_analyzer -->|"runs selected method"| node_tangent
node_analyzer -->|"runs selected method"| node_central_diff
node_analyzer -->|"runs selected method"| node_local_poly
node_analyzer -->|"runs selected method"| node_spline_methods
node_spline_methods -->|"smooths path"| node_spline_smoothing
node_analyzer -->|"saves results"| node_results
node_comparison -->|"loads results"| node_results
node_comparison -->|"checks error"| node_ground_truth
node_sweeps -->|"measures RMSE"| node_ground_truth
node_sweeps -.->|"runs method"| node_circle_fit
node_method_compare -->|"compares results"| node_results
node_plots -->|"visualizes tracks"| node_input_tracks
node_track_plot -->|"plots curvature"| node_results
node_researcher -->|"inspects errors"| node_comparison
node_researcher -->|"tunes parameters"| node_sweeps
node_researcher -->|"views results"| node_plots

click node_generator "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/create_synthetic_trajectories.m"
click node_synthetic "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/Fake_synthetic_trajectories_Clean.mat"
click node_analyzer "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/analyzeAllTracks.m"
click node_results "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvatureResults_Clean_circlefit_step1_20260927_163525.mat"
click node_circle_fit "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvature_estimation_leastSquaresCircle.m"
click node_tangent "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvatureEstimationTangentAngle.m"
click node_central_diff "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvature_estimation_centralDiff.m"
click node_local_poly "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvature_estimation_localPoly.m"
click node_spline_methods "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvature_estimation_splineDerivative.m"
click node_spline_smoothing "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/smoothTrajectorySpline.m"
click node_ground_truth "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/groundTruth.mat"
click node_comparison "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/groundTruthComparison.m"
click node_sweeps "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/run_sweep_tests.m"
click node_method_compare "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/compareCurvatureVariationAcrossResultFiles.m"
click node_plots "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/Plot_Trajectories.m"
click node_track_plot "https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/plotTrackByIndexComparative.m"

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_generator,node_synthetic,node_input_tracks,node_analyzer,node_results toneBlue
class node_circle_fit,node_tangent,node_central_diff,node_local_poly,node_spline_methods,node_spline_smoothing toneAmber
class node_ground_truth,node_comparison,node_sweeps toneMint
class node_method_compare,node_plots,node_track_plot toneRose
class node_researcher toneIndigo
```

## Components

### Trajectory data

- [Synthetic generator](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/create_synthetic_trajectories.m): `create_synthetic_trajectories.m`
- [Synthetic tracks](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/Fake_synthetic_trajectories_Clean.mat): `Fake_synthetic_trajectories_Clean.mat`
- **Input tracks**
- [Track analyzer](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/analyzeAllTracks.m): `analyzeAllTracks.m`
- [Curvature results](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvatureResults_Clean_circlefit_step1_20260927_163525.mat): `curvatureResults_Clean_circlefit_step1_20260927_163525.mat`

### Curvature estimation

- [Circle fitting](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvature_estimation_leastSquaresCircle.m): `curvature_estimation_leastSquaresCircle.m`
- [Tangent-angle method](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvatureEstimationTangentAngle.m): `curvatureEstimationTangentAngle.m`
- [Central differences](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvature_estimation_centralDiff.m): `curvature_estimation_centralDiff.m`
- [Local polynomial](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvature_estimation_localPoly.m): `curvature_estimation_localPoly.m`
- [Spline methods](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/curvature_estimation_splineDerivative.m): `curvature_estimation_splineDerivative.m`
- [Trajectory smoothing](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/smoothTrajectorySpline.m): `smoothTrajectorySpline.m`

### Validation and tuning

- [Known curvature](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/groundTruth.mat): `groundTruth.mat`
- [Ground-truth comparison](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/groundTruthComparison.m): `groundTruthComparison.m`
- [Parameter sweeps](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/run_sweep_tests.m): `run_sweep_tests.m`

### Comparison and visualization

- [Method comparison](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/compareCurvatureVariationAcrossResultFiles.m): `compareCurvatureVariationAcrossResultFiles.m`
- [Track visualizations](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/Plot_Trajectories.m): `Plot_Trajectories.m`
- [Comparative track plots](https://github.com/yaman-ajaj/curvature_estimation_bacterianearsurface_0610/blob/main/plotTrackByIndexComparative.m): `plotTrackByIndexComparative.m`

### Other components

- **Researcher**

## Connections

- Researcher → Synthetic generator: generates data (evidence: `README.md`)
- Synthetic generator → Synthetic tracks: saves tracks (evidence: `README.md`)
- Researcher → Track analyzer: runs analysis (evidence: `README.md`)
- Synthetic tracks → Track analyzer: provides tracks (evidence: `README.md`)
- Input tracks → Track analyzer: provides tracks (evidence: `README.md`)
- Track analyzer → Circle fitting: runs selected method (evidence: `README.md`)
- Track analyzer → Tangent-angle method: runs selected method (evidence: `README.md`)
- Track analyzer → Central differences: runs selected method (evidence: `README.md`)
- Track analyzer → Local polynomial: runs selected method (evidence: `README.md`)
- Track analyzer → Spline methods: runs selected method (evidence: `README.md`)
- Spline methods → Trajectory smoothing: smooths path (evidence: `README.md`)
- Track analyzer → Curvature results: saves results (evidence: `README.md`)
- Ground-truth comparison → Curvature results: loads results (evidence: `README.md`)
- Ground-truth comparison → Known curvature: checks error (evidence: `README.md`)
- Parameter sweeps → Known curvature: measures RMSE (evidence: `README.md`)
- Parameter sweeps → Circle fitting: runs method
- Method comparison → Curvature results: compares results (evidence: `README.md`)
- Track visualizations → Input tracks: visualizes tracks (evidence: `README.md`)
- Comparative track plots → Curvature results: plots curvature (evidence: `README.md`)
- Researcher → Ground-truth comparison: inspects errors (evidence: `README.md`)
- Researcher → Parameter sweeps: tunes parameters (evidence: `README.md`)
- Researcher → Track visualizations: views results (evidence: `README.md`)
