doc/alegro_eic_mapping.md

Alegro EIC Code Mapping

Real ENTSO-E Transmission Asset EIC

Source: ENTSO-E Allocated EIC Codes Registry (allocated-eic-codes.xml)

EIC Code: 22T201903146---W
Long Name: ALEGRO DC
Display Name: L_LIXHE_OBERZ
Type: International transmission asset
Status: Active (A05)
Last Updated: 2021-08-11

JAO Custom Alegro EICs (FBMC Market Coupling)

JAO uses 8 custom Alegro constraint EICs for market coupling optimization. These are NOT transmission asset EICs from ENTSO-E - they are virtual constraints.

JAO Custom EIC	Constraint Name	Purpose
ALEGRO_EXTERNAL_BE_IMPORT	External Constraint BE_AL_import	BE import capacity constraint
ALEGRO_EXTERNAL_BE_EXPORT	External Constraint BE_AL_export	BE export capacity constraint
ALEGRO_EXTERNAL_DE_IMPORT	External Constraint DE_AL_import	DE import capacity constraint
ALEGRO_EXTERNAL_DE_EXPORT	External Constraint DE_AL_export	DE export capacity constraint
ALEGRO_INTERNAL_BE_IMPORT	BE_AL_import	Internal BE import constraint
ALEGRO_INTERNAL_BE_EXPORT	BE_AL_export	Internal BE export constraint
ALEGRO_INTERNAL_DE_IMPORT	DE_AL_import	Internal DE import constraint
ALEGRO_INTERNAL_DE_EXPORT	DE_AL_export	Internal DE export constraint

Mapping Strategy

For JAO Features

• Use JAO custom EICs (8 constraints)
• Each generates ~20 features (shadow prices, binding frequency, LTA, etc.)
• Total: ~160 Alegro JAO features

For ENTSO-E Outage Features

• Use real transmission asset EIC: 22T201903146---W
• Query BE-DE border outages, filter to this EIC
• Generate 4 outage features:
  1. alegro_outage_binary: Current outage indicator (0/1)
  2. alegro_outage_planned_7d: Planned outage next 7 days (forward-looking)
  3. alegro_outage_planned_14d: Planned outage next 14 days (forward-looking)
  4. alegro_outage_capacity_mw: MW capacity offline

Data Reality (Nov 2025)

• Historical outages (Oct 2023 - Nov 2025): ZERO found in ENTSO-E
• Expected: Alegro achieves 93-98% availability → very few outages
• Production Impact: Outage features will be mostly zeros
• Forward-Looking Value: Planned outages (when they occur) are critical future covariates

Automated Collection

Script: scripts/collect_alegro_outages_automated.py

Method:

1. Query BE-DE border transmission outages (documentType A78)
2. Parse ZIP/XML response
3. Extract Asset_RegisteredResource.mRID elements
4. Filter to Alegro EIC: 22T201903146---W
5. Extract outage periods with timestamps
6. Separate planned (A53) vs forced (A54) outages
7. Filter to future outages for forecasting

Status: Production-ready automated collection Result: Zero outages found (realistic for high-availability HVDC)

Next Steps

1. Accept that Alegro outage features may be sparse (zeros)
2. Keep automated collection in production pipeline
3. Generate outage features with zero-filling for periods without outages
4. Monitor for future planned outages (forward-looking covariates)

---

Created: 2025-11-09 Last Updated: 2025-11-09 Automated Collection: ✅ Complete