# letiziafiorucci/tragico architecture

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

- Interactive diagram: https://gitdiagram.com/letiziafiorucci/tragico
- Repository: https://github.com/letiziafiorucci/tragico

## Overview

TRAGICO is a Python collection for extracting and analyzing parameters from Bruker 1D and pseudo-2D NMR spectra. Users adapt or run the example workflows, which call routines for spectrum modeling, fitting, integration, and intensity analysis; outputs include fitted parameters and analysis plots. Shared functions support spectrum handling and interactive selection. The README identifies the scripts’ roles, and excerpts show example calls, the shared import, Bruker reading, and fitting behavior. Unsampled portions limit certainty about the detailed internal sequence and output-writing relationships.

Main entry points: [`f_fit.py`](https://github.com/letiziafiorucci/tragico/blob/main/f_fit.py) (Fit and integrate), [`main4test.py`](https://github.com/letiziafiorucci/tragico/blob/main/main4test.py) (Run examples), [`f_functions.py`](https://github.com/letiziafiorucci/tragico/blob/main/f_functions.py) (Spectrum utilities), [`manuscript_listings.py`](https://github.com/letiziafiorucci/tragico/blob/main/manuscript_listings.py) (Paper listings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_examples["Example workflows"]
  node_main_examples["Run examples<br/>[main4test.py]"]
  node_paper_examples["Paper listings"]
end

subgraph group_analysis["NMR analysis"]
  node_analysis_functions["Fit and integrate<br/>[f_fit.py]"]
  node_analysis_results["Fit results<br/>[f_fit.py]"]
end

subgraph group_support["Spectrum support"]
  node_shared_functions["Spectrum utilities<br/>[f_functions.py]"]
end

node_user(("Researcher"))
node_bruker_data[("Bruker spectra")]

node_user -->|"runs examples"| node_main_examples
node_main_examples -->|"calls analysis"| node_analysis_functions
node_paper_examples -->|"demonstrates calls"| node_analysis_functions
node_analysis_functions -->|"imports utilities"| node_shared_functions
node_shared_functions -->|"reads spectra"| node_bruker_data
node_analysis_functions -.->|"produces fits"| node_analysis_results

click node_main_examples "https://github.com/letiziafiorucci/tragico/blob/main/main4test.py"
click node_paper_examples "https://github.com/letiziafiorucci/tragico/blob/main/manuscript_listings.py"
click node_analysis_functions "https://github.com/letiziafiorucci/tragico/blob/main/f_fit.py"
click node_shared_functions "https://github.com/letiziafiorucci/tragico/blob/main/f_functions.py"
click node_analysis_results "https://github.com/letiziafiorucci/tragico/blob/main/f_fit.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_main_examples,node_paper_examples toneBlue
class node_analysis_functions,node_analysis_results,node_bruker_data toneAmber
class node_shared_functions toneMint
class node_user toneIndigo
```

## Components

### Example workflows

- [Run examples](https://github.com/letiziafiorucci/tragico/blob/main/main4test.py): `main4test.py`
- [Paper listings](https://github.com/letiziafiorucci/tragico/blob/main/manuscript_listings.py): `manuscript_listings.py`

### NMR analysis

- [Fit and integrate](https://github.com/letiziafiorucci/tragico/blob/main/f_fit.py): `f_fit.py`
- [Fit results](https://github.com/letiziafiorucci/tragico/blob/main/f_fit.py): `f_fit.py`

### Spectrum support

- [Spectrum utilities](https://github.com/letiziafiorucci/tragico/blob/main/f_functions.py): `f_functions.py`

### Other components

- **Researcher**
- **Bruker spectra**

## Connections

- Researcher → Run examples: runs examples (evidence: `README.md`)
- Run examples → Fit and integrate: calls analysis (evidence: `main4test.py`)
- Paper listings → Fit and integrate: demonstrates calls (evidence: `manuscript_listings.py`)
- Fit and integrate → Spectrum utilities: imports utilities (evidence: `f_fit.py`)
- Spectrum utilities → Bruker spectra: reads spectra (evidence: `f_functions.py`)
- Fit and integrate → Fit results: produces fits (evidence: `f_fit.py`)