# babiii10/mspandas architecture

> Architecture diagram of the GitHub repository babiii10/mspandas, 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/babiii10/mspandas
- Repository: https://github.com/babiii10/mspandas

## Overview

MS-PANDA is an untargeted omics analysis tool with two user-facing workflows: build a biological-liquid reference map, then use that map to detect, match, and normalize measurements from a new sample. The tree exposes parameter-export and MS-DIAL parameter-modification scripts for both workflows, conversion command-line scripts, and a reference-map grouping implementation. README evidence establishes the overall workflows, but the available excerpts do not show how these scripts invoke one another, so internal orchestration links are omitted.

Main entry points: [`lib/NewReferenceMap/Python_files/exportDefaultParam.py`](https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Python_files/exportDefaultParam.py) (Export defaults), [`lib/NewReferenceMap/Python_files/modify_ParamMsdialNewReferenceMap.py`](https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Python_files/modify_ParamMsdialNewReferenceMap.py) (Set MS-DIAL parameters), [`lib/NewReferenceMap/Python_files/msconverter_command_line.py`](https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Python_files/msconverter_command_line.py) (Convert raw data), [`lib/NewReferenceMap/Rcpp_files/Gouping_Massif_Between_Sample.cpp`](https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Rcpp_files/Gouping_Massif_Between_Sample.cpp) (Group across samples)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_reference["Reference map"]
  node_map_export["Export defaults"]
  node_map_params["Set MS-DIAL parameters"]
  node_map_convert["Convert raw data"]
  node_map_group["Group across samples"]
  node_reference_map[("Reference map")]
end

subgraph group_analysis["New sample analysis"]
  node_sample_export["Export parameters"]
  node_sample_params["Set MS-DIAL parameters"]
  node_sample_convert["Convert raw data"]
  node_normalized_results["Normalized sample results"]
end

node_user(("Researcher"))
node_msdial["MS-DIAL"]

node_user -->|"build reference"| node_map_export
node_user -->|"analyze sample"| node_sample_export
node_user -->|"configure map"| node_map_params
node_user -.->|"prepare map data"| node_map_convert
node_user -.->|"develop map"| node_map_group
node_user -.->|"configure analysis"| node_sample_params
node_user -.->|"prepare sample data"| node_sample_convert
node_user -->|"run analysis"| node_msdial
node_user -->|"use map"| node_reference_map
node_reference_map -->|"match and normalize"| node_normalized_results

click node_map_export "https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Python_files/exportDefaultParam.py"
click node_map_params "https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Python_files/modify_ParamMsdialNewReferenceMap.py"
click node_map_convert "https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Python_files/msconverter_command_line.py"
click node_map_group "https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Rcpp_files/Gouping_Massif_Between_Sample.cpp"
click node_sample_export "https://github.com/babiii10/mspandas/blob/Web/lib/AnalysisNewSample/Python_files/export.parameters.py"
click node_sample_params "https://github.com/babiii10/mspandas/blob/Web/lib/AnalysisNewSample/Python_files/modify_ParamMsdial.py"
click node_sample_convert "https://github.com/babiii10/mspandas/blob/Web/lib/AnalysisNewSample/Python_files/msconverter_command_line.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_map_export,node_map_params,node_map_convert,node_map_group,node_reference_map toneBlue
class node_sample_export,node_sample_params,node_sample_convert,node_normalized_results toneAmber
class node_user,node_msdial toneIndigo
```

## Components

### Reference map

- [Export defaults](https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Python_files/exportDefaultParam.py): `lib/NewReferenceMap/Python_files/exportDefaultParam.py`
- [Set MS-DIAL parameters](https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Python_files/modify_ParamMsdialNewReferenceMap.py): `lib/NewReferenceMap/Python_files/modify_ParamMsdialNewReferenceMap.py`
- [Convert raw data](https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Python_files/msconverter_command_line.py): `lib/NewReferenceMap/Python_files/msconverter_command_line.py`
- [Group across samples](https://github.com/babiii10/mspandas/blob/Web/lib/NewReferenceMap/Rcpp_files/Gouping_Massif_Between_Sample.cpp): `lib/NewReferenceMap/Rcpp_files/Gouping_Massif_Between_Sample.cpp`
- **Reference map**

### New sample analysis

- [Export parameters](https://github.com/babiii10/mspandas/blob/Web/lib/AnalysisNewSample/Python_files/export.parameters.py): `lib/AnalysisNewSample/Python_files/export.parameters.py`
- [Set MS-DIAL parameters](https://github.com/babiii10/mspandas/blob/Web/lib/AnalysisNewSample/Python_files/modify_ParamMsdial.py): `lib/AnalysisNewSample/Python_files/modify_ParamMsdial.py`
- [Convert raw data](https://github.com/babiii10/mspandas/blob/Web/lib/AnalysisNewSample/Python_files/msconverter_command_line.py): `lib/AnalysisNewSample/Python_files/msconverter_command_line.py`
- **Normalized sample results**

### Other components

- **Researcher**
- **MS-DIAL**

## Connections

- Researcher → Export defaults: build reference
- Researcher → Export parameters: analyze sample
- Researcher → Set MS-DIAL parameters: configure map
- Researcher → Convert raw data: prepare map data
- Researcher → Group across samples: develop map
- Researcher → Set MS-DIAL parameters: configure analysis
- Researcher → Convert raw data: prepare sample data
- Researcher → MS-DIAL: run analysis
- Researcher → Reference map: use map
- Reference map → Normalized sample results: match and normalize
