Open-science records · Zenodo v0.2.1: 10.5281/zenodo.22102736 · Zenodo Concept DOI: 10.5281/zenodo.22102735 · OSF Registration DOI: 10.17605/OSF.IO/FMCYQ
Complete public research record · English

What the project is, why it exists, where it stands, why it pauses here, and what comes next.

A plain-language, step-by-step guide from Türkiye's electricity problem and EPİAŞ data layer to the current evidence boundary, present deliverables and the path toward a defensible journal paper.

EPİAŞ dataMulti-task forecasting+1 h · +6 h · +24 hCalibrated uncertaintyReproducible research
Current scientific status — v0.2.1 empirical open-science milestone: the January 2024 real-data EPİAŞ audit and corrective generation-accounting audit are complete, the v0.2.1 software snapshot is archived on Zenodo, and the project lifecycle is recorded in an accepted public OSF Open-Ended Registration. No confirmatory model-performance claim is made. The confirmatory holdout remains undefined and untouched.
1 · The project in one minute

What is Türkiye Grid Foundation Model?

Türkiye's electricity system produces several hourly signals that are related but not identical. One describes how much electricity is consumed. Another describes generation from solar, wind, hydro, geothermal, biomass, gas, coal and other sources. A third is the hourly day-ahead market clearing price, known in Türkiye as PTF.

Instead of treating these as unrelated forecasting problems, the project asks whether one shared temporal representation can learn useful common structure across them. The first design forecasts consumption, renewable generation and PTF at +1, +6 and +24 hours.

The real scientific question: When does sharing information across coupled grid tasks improve out-of-time prediction and uncertainty, and when does it create negative transfer?

2 · Why does the project exist?

A forecasting system can look impressive while answering a weak question. Electricity has strong seasonality; prices change regime; renewable output can ramp sharply; random time splitting can leak future information; and an over-large experiment can become too expensive to finish.

The repository therefore follows one rule: build research controls before opening final evidence. Data contracts, leakage-resistant windows, baselines, uncertainty tools, tests, a compute-safe smoke path and publication structure are created first. The final holdout comes later.

3 · What goes into the project?

InputPlain-language meaningResearch role
Real-time consumptionHourly electricity demand.Primary load target and system context.
Source-level generationSolar, wind, hydro, geothermal, biomass, gas, coal and other fields.Renewable target, generation mix and regime features.
MCP / PTFHourly day-ahead clearing price in TRY/MWh.Price target and market-state signal.
Calendar featuresHour, weekday and annual-cycle encodings.Seasonality without future leakage.

The software targets official EPİAŞ Transparency Platform REST services. Credentials stay in environment variables and never enter Git history. Raw third-party records are not redistributed by default; reproducibility is preserved through retrieval instructions, source identifiers, manifests and hashes.

4 · How does it work step by step?

EPİAŞ authentication
Bounded acquisition
Schema + missingness audit
Hourly alignment
Feature engineering
Chronological split
168-hour windows
Baselines + shared Transformer
Uncertainty calibration
Paired evaluation
Regime analysis
Frozen evidence archive

Why 168 hours?

One week exposes a full daily and weekly cycle before each forecast origin. It is compact, interpretable and affordable.

Why +1, +6 and +24 hours?

They separate short-, medium- and day-ahead behavior. Transfer may help at one horizon and hurt at another.

Why three tasks together?

Load, renewables and price are coupled yet distinct. That creates both useful-transfer potential and negative-transfer risk.

5 · What model exists today?

The v0.1 model is intentionally compact. Hourly multivariate inputs are projected into a shared representation, receive positional encoding, pass through a Transformer encoder and feed multi-horizon heads. Each output supplies a central forecast and positive uncertainty scale. Split-conformal utilities can then calibrate empirical prediction intervals on a separate calibration period.

Why not begin with a giant model? Parameter count is not evidence. A compact reference makes the first controlled experiment affordable, reproducible and falsifiable. Larger PatchTST-, TimesNet-, masked-pretraining or mixture-of-experts variants can be compared later against a known baseline.

6 · What has been completed, exactly?

ComponentStatusWhat that means
Repository architectureCompletedResearch package, configs, scripts, tests and documentation are present.
EPİAŞ REST clientCompletedTGT authentication and bounded acquisition paths are implemented.
Feature & window pipelineCompletedHourly alignment, calendar features and leakage-resistant 168-hour windows exist.
Shared TransformerCompletedCompact multi-task, multi-horizon model is implemented.
Uncertainty layerCompletedProbabilistic scale output and split-conformal utilities are implemented.
Tests + synthetic smoke trainingCompletedSoftware behavior is tested; synthetic output is not empirical evidence.
GitHub CI + PagesCompletedAutomated testing and public documentation are deployed.
Real historical EPİAŞ auditNextCoverage, missingness, schema stability and timezone integrity must be measured.
Exploratory benchmarkNot yetStrong baselines and runtime budget must be selected without final-holdout evidence.
Frozen protocol / OSFNot yetHypotheses, dates, seeds, tests and exclusions are not frozen or registered.
Confirmatory resultsNot yetNo paper-level model-performance claim exists.
Journal manuscript + DOIFuturePublication follows only after frozen evidence exists.

7 · Why has the project paused here?

It has not paused because the code failed. Software construction and empirical inference are different phases. If years of real data are inspected first, models are changed after future-period scores are seen, and the hypothesis is written only afterward, a later “confirmatory” claim becomes much weaker.

Research scaffold
      ↓
Real-data audit
      ↓
Exploratory model + runtime study
      ↓
Protocol freeze / optional OSF preregistration
      ↓
Untouched confirmatory holdout
      ↓
Evidence archive + paper

Before freezing the experiment we need to know whether data coverage is stable, whether timestamp or schema changes exist, which baselines are credible and how much compute the complete model × seed × horizon plan costs. The pause protects the scientific value of the next stage.

8 · What does the project deliver today?

Research software

EPİAŞ client, data alignment, feature engineering, forecasting windows, shared Transformer, baselines, losses, uncertainty tools and lightweight training.

Research controls

Chronological evaluation, training-only preprocessing, synthetic/empirical separation, deterministic tests and compute-aware configuration.

Publication infrastructure

Research protocol, reproducibility notes, data documentation, manuscript scaffold, citation metadata, multilingual Pages and publication roadmap.

It does not currently deliver an operational market forecast, trading signal, dispatch instruction or validated claim that the shared Transformer is superior.

9 · What can fool this kind of study?

Temporal leakage

Future periods influencing training, scaling or features can inflate apparent skill.

Holdout tuning

Changing the model after viewing final-test scores destroys the meaning of an untouched test.

Weak baselines

A complex model must beat strong seasonal and task-specific alternatives.

Regime blindness

Average error can hide failure during price spikes, renewable ramps or unusual demand.

Uncalibrated confidence

A probabilistic model may sound confident without delivering promised coverage.

Compute drift

An over-large protocol can become impossible to complete and invite post-hoc compromises.

10 · What would count as scientific success?

Observed outcomeInterpretationWhy it matters
Shared model winsUseful transferEvidence that cross-task representation learning adds predictive value under the frozen design.
Shared model tiesLimited complexity benefitEvidence that extra architecture gives little practical gain for tested horizons/regimes.
Shared model losesNegative transferEvidence that shared representation can damage one or more grid tasks—a scientifically useful boundary.

A null or negative finding is not a failed project if the experiment is controlled. The research object is the hypothesis, not the model's reputation.

11 · What can be added from here?

StageWorkDeliverable
v0.2 — Data AuditBounded real EPİAŞ history; missing hours, duplicates, timezone/DST, schema stability, generation consistency and price outliers.Data audit report, availability map, provenance manifest and hashes.
v0.3 — Exploratory BenchmarkPersistence, seasonal-naive, linear/MLP, recurrent, task-specific and shared Transformer baselines using train/validation only.Exploratory benchmark and measured compute budget.
v0.35 — Modern BaselinesAdd feasible DLinear, N-HiTS/N-BEATS, PatchTST, TimesNet or TFT baselines.Modern comparison matrix.
v0.4 — Regime IntelligenceDefine renewable-share, price-spike, load-ramp, seasonal and unusual-demand regimes.Frozen regime definitions and analysis plan.
v0.45 — ExplainabilityFeature ablation, masking, attention diagnostics and secondary explainability tools.Interpretability evidence.
v0.5 — PretrainingExplore masked time-series pretraining for a shared representation reusable across downstream tasks.Stronger foundation-model direction.
v0.6 — TransferTest low-data adaptation to downstream forecasting, anomaly or regime tasks.Transfer-learning evidence.
v0.7 — Probabilistic SuiteQuantiles, adaptive conformal methods, CRPS and coverage-width trade-offs.Trustworthy uncertainty benchmark.
v0.8 — Stress TestingMissing observations, delayed data, price shocks, renewable ramps and distribution shift.Robustness evidence.
v0.9 — Protocol FreezeFreeze holdout, hypotheses, metrics, tests, seeds, exclusions, multiplicity and compute budget; optionally register on OSF.Immutable confirmatory protocol.
v1.0 — Confirmatory StudyOpen untouched holdout once; preserve predictions, statistics, figures, configs and hashes.Paper-level evidence archive.
v1.1+ — PublicationFinalize manuscript, citable software snapshot, Zenodo DOI and appropriate preprint/journal submission.Citable research record.

12 · The strongest eventual paper

When Does Cross-Task Learning Help Electricity Forecasting? A Reproducible Multi-Task Study of Load, Renewable Generation and Market Price in Türkiye.

The strongest contribution is not a marketing claim that a “foundation model” wins. It is a controlled answer about transfer, horizon dependence, market regimes and calibrated uncertainty, backed by preserved evidence that another researcher can reproduce or challenge.

13 · Research boundary

This repository is research software. It is not an EPİAŞ product, grid-operator tool, production forecasting service, trading recommendation or dispatch controller. Until a frozen real-data study is completed, it should be read as a research platform and experimental design.

Open-science milestone · 26 August 2026

OSF Open-Ended Registration accepted and assigned a DOI

The current research lifecycle state is now archived on OSF as a public, persistent registration. Registration DOI: 10.17605/OSF.IO/FMCYQ. Associated OSF project: osf.io/tz5pw.

The registration time-stamps the completed January 2024 real-data EPİAŞ audit, corrective generation-accounting audit, reproducibility rules, and the boundary between exploratory development and a later confirmatory study. It is not the final confirmatory preregistration; the confirmatory holdout remains undefined and untouched.