# openneurodatasets/ds005613 architecture

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

## Overview

NEBULA101 is a research dataset, not primarily an application: it publishes behavioral and neuroimaging assessments for 101 participants in BIDS form. Its user-facing path is researchers accessing the dataset; the repository also contains scripts for constructing BIDS data, modality-specific preprocessing, and quality assessment. The README documents validation code and its output locations, but no source excerpts were provided, so internal calls and specific data handoffs cannot be verified; those connections are omitted.

Main entry points: [`derivatives/validation`](https://github.com/openneurodatasets/ds005613/tree/main/derivatives/validation) (Validation results), [`code/validation/beh`](https://github.com/openneurodatasets/ds005613/tree/main/code/validation/beh) (Behavioral checks), [`code/validation`](https://github.com/openneurodatasets/ds005613/tree/main/code/validation) (MRI quality checks), [`sub-pp001/ses-01/beh`](https://github.com/openneurodatasets/ds005613/tree/main/sub-pp001/ses-01/beh) (Behavioral assessments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dataset["Dataset"]
  node_bidsdata[("BIDS participant data")]
  node_behavioral[("Behavioral assessments")]
  node_neuroimaging[("Neuroimaging data")]
end

subgraph group_creation["Dataset creation"]
  node_bids_creation["BIDS dataset creation<br/>[create_nebula.py]"]
  node_behavior_creation["Behavior scoring"]
  node_phenotype["Phenotype generation<br/>[make_phenotype.py]"]
  node_heuristic["DICOM conversion rules<br/>[heuristic.py]"]
end

subgraph group_processing["Preprocessing"]
  node_anat_prep["Anatomical preparation"]
  node_func_prep["Functional preparation"]
  node_dwi_prep["Diffusion preparation<br/>[1_dwi_prep.py]"]
end

subgraph group_quality["Quality assessment"]
  node_behavior_checks["Behavioral checks"]
  node_data_checks["BIDS and missing-data checks"]
  node_mri_checks["MRI quality checks"]
  node_validation_results["Validation results"]
end

node_researchers(("Researchers"))

node_researchers -->|"accesses"| node_bidsdata
node_behavioral -.->|"quality assessed"| node_behavior_checks
node_neuroimaging -.->|"quality assessed"| node_mri_checks
node_data_checks -->|"results stored"| node_validation_results
node_behavior_checks -->|"results stored"| node_validation_results
node_mri_checks -->|"results stored"| node_validation_results

click node_bidsdata "https://github.com/openneurodatasets/ds005613/tree/main/sub-pp001/ses-01"
click node_behavioral "https://github.com/openneurodatasets/ds005613/tree/main/sub-pp001/ses-01/beh"
click node_neuroimaging "https://github.com/openneurodatasets/ds005613/tree/main/sub-pp001/ses-01"
click node_bids_creation "https://github.com/openneurodatasets/ds005613/blob/main/code/create_nebula/create_nebula.py"
click node_behavior_creation "https://github.com/openneurodatasets/ds005613/tree/main/code/preprocessing/0_beh"
click node_phenotype "https://github.com/openneurodatasets/ds005613/blob/main/code/create_nebula/make_phenotype.py"
click node_heuristic "https://github.com/openneurodatasets/ds005613/blob/main/code/heudiconv/heuristic.py"
click node_anat_prep "https://github.com/openneurodatasets/ds005613/tree/main/code/preprocessing/1_anat"
click node_func_prep "https://github.com/openneurodatasets/ds005613/blob/main/code/preprocessing/3_func/fsl/1_preproc1/1_loop_fsl_preproc1.py"
click node_dwi_prep "https://github.com/openneurodatasets/ds005613/blob/main/code/preprocessing/4_dwi/fsl/1_dwi_prep.py"
click node_behavior_checks "https://github.com/openneurodatasets/ds005613/tree/main/code/validation/beh"
click node_data_checks "https://github.com/openneurodatasets/ds005613/tree/main/code/validation/data_checks"
click node_mri_checks "https://github.com/openneurodatasets/ds005613/tree/main/code/validation"
click node_validation_results "https://github.com/openneurodatasets/ds005613/tree/main/derivatives/validation"

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_bidsdata,node_behavioral,node_neuroimaging toneBlue
class node_bids_creation,node_behavior_creation,node_phenotype,node_heuristic toneAmber
class node_anat_prep,node_func_prep,node_dwi_prep toneMint
class node_behavior_checks,node_data_checks,node_mri_checks,node_validation_results toneRose
class node_researchers toneIndigo
```

## Components

### Dataset

- [BIDS participant data](https://github.com/openneurodatasets/ds005613/tree/main/sub-pp001/ses-01): `sub-pp001/ses-01`
- [Behavioral assessments](https://github.com/openneurodatasets/ds005613/tree/main/sub-pp001/ses-01/beh): `sub-pp001/ses-01/beh`
- [Neuroimaging data](https://github.com/openneurodatasets/ds005613/tree/main/sub-pp001/ses-01): `sub-pp001/ses-01`

### Dataset creation

- [BIDS dataset creation](https://github.com/openneurodatasets/ds005613/blob/main/code/create_nebula/create_nebula.py): `code/create_nebula/create_nebula.py`
- [Behavior scoring](https://github.com/openneurodatasets/ds005613/tree/main/code/preprocessing/0_beh): `code/preprocessing/0_beh`
- [Phenotype generation](https://github.com/openneurodatasets/ds005613/blob/main/code/create_nebula/make_phenotype.py): `code/create_nebula/make_phenotype.py`
- [DICOM conversion rules](https://github.com/openneurodatasets/ds005613/blob/main/code/heudiconv/heuristic.py): `code/heudiconv/heuristic.py`

### Preprocessing

- [Anatomical preparation](https://github.com/openneurodatasets/ds005613/tree/main/code/preprocessing/1_anat): `code/preprocessing/1_anat`
- [Functional preparation](https://github.com/openneurodatasets/ds005613/blob/main/code/preprocessing/3_func/fsl/1_preproc1/1_loop_fsl_preproc1.py): `code/preprocessing/3_func/fsl/1_preproc1/1_loop_fsl_preproc1.py`
- [Diffusion preparation](https://github.com/openneurodatasets/ds005613/blob/main/code/preprocessing/4_dwi/fsl/1_dwi_prep.py): `code/preprocessing/4_dwi/fsl/1_dwi_prep.py`

### Quality assessment

- [Behavioral checks](https://github.com/openneurodatasets/ds005613/tree/main/code/validation/beh): `code/validation/beh`
- [BIDS and missing-data checks](https://github.com/openneurodatasets/ds005613/tree/main/code/validation/data_checks): `code/validation/data_checks`
- [MRI quality checks](https://github.com/openneurodatasets/ds005613/tree/main/code/validation): `code/validation`
- [Validation results](https://github.com/openneurodatasets/ds005613/tree/main/derivatives/validation): `derivatives/validation`

### Other components

- **Researchers**

## Connections

- Researchers → BIDS participant data: accesses (evidence: `README`)
- Behavioral assessments → Behavioral checks: quality assessed
- Neuroimaging data → MRI quality checks: quality assessed
- BIDS and missing-data checks → Validation results: results stored (evidence: `README`)
- Behavioral checks → Validation results: results stored (evidence: `README`)
- MRI quality checks → Validation results: results stored (evidence: `README`)
