> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autocleaneeg.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Derivatives: Subject-Specific Reports

> Explore the per-subject reports, logs, and visualizations generated by AutoCleanEEG for quality control.

Each subject’s `eeg/` folder contains **reports and visualizations** generated during preprocessing.\
These outputs provide transparency, allow quality control, and make it easier to share results with collaborators who may not run the pipeline themselves.

## Example Layout

```

sub-451559/eeg/
├── 128\_Rest\_EyesOpen\_D1004\_autoclean\_report.pdf
├── 128\_Rest\_EyesOpen\_D1004\_processing\_log.csv
├── 128\_Rest\_EyesOpen\_D1004\_psd\_topo\_figure.png
├── 128\_Rest\_EyesOpen\_D1004\_raw\_vs\_cleaned\_overlay.png
├── 128\_Rest\_EyesOpen\_D1004-ica.fif
├── FlaggedChs.tsv
└── sub-451559\_task-restingstatetutorialica\_components\_all.pdf

```

## File Descriptions

| File                               | Purpose                                                                                    | Example                                                                                                |
| ---------------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
| **`*_autoclean_report.pdf`**       | Full QC report with preprocessing summary and visualizations.                              | [View Report](/outputs/attachments/128_Rest_EyesOpen_D1004_autoclean_report.pdf)                       |
| **`*_processing_log.csv`**         | Run-specific log of preprocessing parameters (see [Processing Log](../processing-log.md)). | [View Log](/outputs/attachments/128_Rest_EyesOpen_D1004_processing_log.csv)                            |
| **`*_psd_topo_figure.png`**        | Power spectral density (PSD) topography plot comparing raw vs. cleaned data.               | [View PSD Plot](/outputs/attachments/128_Rest_EyesOpen_D1004_psd_topo_figure.png)                      |
| **`*_raw_vs_cleaned_overlay.png`** | Overlay of raw and cleaned signals for visual inspection.                                  | [View Overlay](/outputs/attachments/128_Rest_EyesOpen_D1004_raw_vs_cleaned_overlay.png)                |
| **`*-ica.fif`**                    | ICA decomposition weights in MNE format (stored separately from EEG).                      | [Download ICA](/outputs/attachments/128_Rest_EyesOpen_D1004-ica.fif)                                   |
| **`FlaggedChs.tsv`**               | List of channels flagged as bad during preprocessing.                                      | [View Flagged Channels](/outputs/attachments/FlaggedChs.tsv)                                           |
| **`*_ica_components_all.pdf`**     | Report showing ICA components and which were removed.                                      | [View ICA Components](/outputs/attachments/sub-451559_task-restingstatetutorialica_components_all.pdf) |

## Visual Examples

### PSD Topography Comparison

<img src="https://mintcdn.com/cincibrainlab/XNYNx-DHiBdod59R/outputs/attachments/128_Rest_EyesOpen_D1004_psd_topo_figure.png?fit=max&auto=format&n=XNYNx-DHiBdod59R&q=85&s=a27ade7436769f4c41e850e3a4218c30" alt="Power spectral density topography comparison" style={{ borderRadius: '0.5rem', marginTop: '0.75rem' }} width="4500" height="6000" data-path="outputs/attachments/128_Rest_EyesOpen_D1004_psd_topo_figure.png" />

### Raw vs Cleaned Signal Overlay

<img src="https://mintcdn.com/cincibrainlab/NZCo8tVICBHj8yDr/outputs/attachments/128_Rest_EyesOpen_D1004_raw_vs_cleaned_overlay.png?fit=max&auto=format&n=NZCo8tVICBHj8yDr&q=85&s=748ffb6dbbb74bb2dbdc0b98b0a99d6c" alt="Raw vs cleaned EEG signal overlay" style={{ borderRadius: '0.5rem', marginTop: '0.75rem' }} width="931" height="1008" data-path="outputs/attachments/128_Rest_EyesOpen_D1004_raw_vs_cleaned_overlay.png" />

## Why These Matter

* **Quality Control (QC):** Each run produces both text logs and figures for visual inspection.
* **Transparency:** Reports can be shared with collaborators or archived with publications.
* **Reproducibility:** The `.csv` log and `.fif` ICA weights make it possible to rerun or reapply ICA later.

<Info>
  Subject-level reports are intended for **human review**.\
  They complement the standardized outputs in `derivatives/` and task‑root `exports/`.
</Info>