# Dissertation research data deposit (TUdatalib)

Documentation and indexes for the supplementary research-data package of the dissertation *Planning of Decentralized Energy Converters of Industrial Energy Systems at Brownfield Production Sites under Deep Uncertainty* (Michael Frank, TU Darmstadt).

**Live item (v14+):** [tudatalib/4593.14](https://tudatalib.ulb.tu-darmstadt.de/handle/tudatalib/4593.14) — UUID `a535ba20-c1dc-474e-b62b-5faef06100a9`.

## Scope

**In scope:** artefacts referenced by the dissertation PDF:

- Systematic literature review CSV exports (`table_251104_slr_overall_frank.zip`, Section 3.2)
- Optimization run bundles (`2026-*_*.zip`) for pinch, conventional, antifragile, and screening campaigns
- Plot registry bundles (`PLOT-*.zip`) and embedded plot IDs inside run zips
- ETA Research Factory time series and supplier scenario inputs
- WorldCat query automation script (Section 3.2 footnote)

**Out of scope:** raw institutional data not permitted for republication; executable software (published on Zenodo under MIT); the deferred Chapter 8 stress production matrix (`hpc_ch8_prod_32sc_tac`) until a curated bundle is supplied.

## How to cite

1. Prefer the registered **DOI** once TUdatalib mints the final version DOI (update `\DataRepoDOIURL` in `common/macros.tex`).
2. Until then, cite the **handle**: `https://tudatalib.ulb.tu-darmstadt.de/handle/tudatalib/4593.14`.

## Licence

- **Research data (this deposit):** **CC BY-SA-NC 4.0 International** in TUdatalib metadata — aligned with TUPrints. Do not attach MIT licence files to this dataset.
- **Software:** MIT on GitLab/Zenodo; cross-linked below and in `related_identifiers.csv`.

## File index and integrity

`file_index.csv` lists ORIGINAL-bundle bitstreams (`name`, `uuid`, `size_bytes`, `md5`, `content_href`). Regenerate after each archived version:

```powershell
python tools/fetch_tudatalib_file_index.py
```

Companion files uploaded with new versions: `README.md`, `file_index.csv`, `ai_tools_register.csv`, `related_identifiers.csv`.

## Data dictionary

| Pattern | Description |
|---------|-------------|
| `2026-*_*.zip` | Curated run archives: `config.json`, `metadata.yaml`, `results/`, `plots/` |
| `PLOT-*.zip` | Standalone plot bundles (internal plot registry IDs) |
| `table_251104_slr_overall_frank.zip` | Eight SLR CSV tables (WoS, ScienceDirect, IEEE, WorldCat, Elicit RQ1–4) |
| `data_260717_eta_full_year.csv` | ETA Research Factory full-year demands and ambient conditions |
| `table_260717_scenario_s1-s2-s3.zip` | Gas/electricity price and CO₂ scenario trajectories S1–S3 |
| `worldcat_automation.user.js` | Tampermonkey script for WorldCat literature query reproduction |

## Related software (Zenodo community)

All packages belong to [decentralized-industrial-energy-systems](https://zenodo.org/communities/decentralized-industrial-energy-systems). Full GitLab + DOI mapping: `related_identifiers.csv`.

| Package | Version | DOI |
|---------|---------|-----|
| eta-components | v1.2.5 | [10.5281/zenodo.20623140](https://doi.org/10.5281/zenodo.20623140) |
| eta-mistral | v1.0.3 | [10.5281/zenodo.20597555](https://doi.org/10.5281/zenodo.20597555) |
| eta-incerto | v1.3.5 | [10.5281/zenodo.20622830](https://doi.org/10.5281/zenodo.20622830) |
| eta-stress | v1.0.7 | [10.5281/zenodo.20623492](https://doi.org/10.5281/zenodo.20623492) |
| RODMO | v0.2.0 | [10.5281/zenodo.20592332](https://doi.org/10.5281/zenodo.20592332) |
| pinch-variant-generation-thermal-crosslinking | v0.1.1 | [10.5281/zenodo.20597676](https://doi.org/10.5281/zenodo.20597676) |
| conventional-optimization-under-uncertainty | v0.1.2 | [10.5281/zenodo.20624765](https://doi.org/10.5281/zenodo.20624765) |
| antifragile-optimization-under-uncertainty | v0.1.2 | [10.5281/zenodo.20624766](https://doi.org/10.5281/zenodo.20624766) |
| global-sensitivity-and-stress-test-analysis | v0.1.2 | [10.5281/zenodo.20624769](https://doi.org/10.5281/zenodo.20624769) |
| high-performance-computing-operations | v0.2.1 | [10.5281/zenodo.20656103](https://doi.org/10.5281/zenodo.20656103) |

## Automation

| Script | Purpose |
|--------|---------|
| `tools/fetch_tudatalib_file_index.py` | Refresh `file_index.csv` from archived ORIGINAL bundle |
| `tools/publish_selected_to_tudatalib.py` | Dry-run / publish selected files as new version (`@eta-tudata-publish`) |
| `tools/sync_tudatalib_workspace_metadata.py` | Regenerate `tudatalib_metadata_ui_checklist.md` |
| `tools/publish_eta_software_to_zenodo.py` | Zenodo software releases (separate from this data deposit) |

Credentials: `C:\Users\M.Frank\.cursor\tudatalib-mcp\.env` (item UUID `a535ba20-c1dc-474e-b62b-5faef06100a9`).

## Provenance

Record dissertation git commit and run IDs in each TUdatalib version summary. Major run bundles reference RODMO directories under `research-and-optimization-data-management-organizer/runs/`.