Skip to main content

Crate carbonfr_eligibility

Crate carbonfr_eligibility 

Source
Expand description

§carbonfr-eligibility

Couche A « électrolyseur » de carbon-fr (ADR-0025, méthodologie ADR-0026) : évaluation d’éligibilité au niveau réseau par créneau, sous deux cadres explicitement étiquetés et neutres — rfnbo (renouvelable) et low-carbon (bas-carbone inclusif nucléaire/CCS).

§Neutralité (cardinal, ADR-0025)

carbon-fr expose l’éligibilité au regard de chaque cadre ; il ne tranche pas la « couleur » de l’hydrogène ni le débat renouvelable/nucléaire. La donnée est ouverte et vérifiable ; les conclusions appartiennent à l’utilisateur.

§Périmètre

Support à la décision sur signaux de réseau, pas une certification. Hors périmètre (donnée au niveau du site absente) : gCO₂eq/kgH₂, certification, et additionnalité contractuelle (PPA).

§Architecture

Crate de domaine pur : aucune IO (pas de serde/sqlx/axum/reqwest), time plutôt que chrono, dépend uniquement de carbonfr-core. L’évaluation est totale (jamais de Result : l’indétermination est portée par EligibilitySignal::Indeterminate).

Structs§

EligibilityRuleset
Jeu de paramètres versionné d’un cadre d’éligibilité.
EligibilityVerdict
Verdict d’éligibilité d’un créneau au regard d’un cadre + ruleset.
ShareBacktestReport
Rapport du backtest walk-forward de share-clim@1.
ShareClimatology
Climatologie horaire-de-semaine de la part renouvelable, construite sur un historique de mix national (rte-direct, ADR-0026 décision 9).
ShareEstimate
Part renouvelable d’un créneau, avec provenance et intervalle (ADR-0011).
ShareHorizonError
Erreur par horizon (modèle vs persistance), en points de part (0-1).
ShareMeteoBacktestReport
Rapport du backtest comparatif share-meteo@2 vs share-clim@1 vs persistance — mêmes origines, mêmes cibles (comparaison honnête).
ShareMeteoHorizonError
Erreur par horizon des trois estimateurs, en points de part (0-1).
ShareMeteoModel
Modèle share-meteo@2 construit par origine sur une fenêtre d’apprentissage strictement passée. Pur.
SlotInput
Entrée d’évaluation par créneau : tout ce dont la stratégie pure a besoin.
WeatherIndex
Index météo prévisionnelle pour lectures as-of : par heure cible, les runs triés par run_at croissant.

Enums§

EligibilityFramework
Cadre d’éligibilité servi (binôme neutre, ADR-0025). carbon-fr expose l’éligibilité au regard de chaque cadre ; il ne tranche pas la « couleur » de l’hydrogène.
EligibilitySignal
Signal émis par un pilier sur un créneau.
IndeterminateReason
Pourquoi un pilier n’a pas pu trancher (servi avec le signal — additif).
Pillar
Pilier d’éligibilité (de quel test provient un signal).
RulesetStatus
Statut d’un ruleset au catalogue. Served = résolvable et appliqué ; Planned = présent au catalogue (transparence) mais jamais résolu tant que le droit n’est pas en vigueur (ADR-0006/0020).
ShareSource
Provenance d’une estimation de part renouvelable.
TemporalGranularity
Granularité de la corrélation temporelle RFNBO (mensuelle jusqu’à la bascule, horaire ensuite). Pilier RFNBO ; sans objet pour low-carbon.

Constants§

DEFAULT_ELECTROLYZER_KWH_PER_KG
Consommation électrique de référence d’un électrolyseur (kWh/kgH₂), médiane de la fourchette industrielle 50–55. [FAIT] (fourchette). Paramétrable.
FOSSIL_COMPARATOR_G_PER_MJ
Comparateur fossile GHG de l’hydrogène (gCO₂eq/MJ) — RED II / actes délégués UE. Base commune RFNBO (2023/1185) et bas-carbone (2025/2359). [FAIT]
FR_BIDDING_ZONE
Zone de dépôt (« bidding zone ») — PIÈGE 1 : la corrélation géographique RFNBO s’évalue à la zone nationale (FR = une seule zone), jamais à l’une des 12 sous-régions carbone. Toujours "FR".
H2_LHV_MJ_PER_KG
Pouvoir calorifique inférieur (PCI) de l’hydrogène, MJ/kg. [FAIT]
LOW_CARBON_BUDGET_G_PER_KG
Budget GHG produit d’un H₂ bas-carbone, en gCO₂eq/kgH₂ : 94 × (1 − 0,70) × 120 = 3384. [FAIT] (seuil produit 28,2 gCO₂eq/MJ).
REQUIRED_GHG_REDUCTION
Réduction GHG minimale exigée d’un carburant bas-carbone / RFNBO. [FAIT]
SHARE_FORECAST_MODEL
Identité versionnée du modèle (ADR-0019/0028) : jamais de changement silencieux — une évolution de la formule = nouvelle version + ADR.
SHARE_METEO_MODEL
Identité versionnée du modèle candidat (ADR-0019/0028) : distincte de share-clim@1, jamais de mutation silencieuse.

Functions§

backtest_share
Backtest walk-forward pur de la part renouvelable prévue.
backtest_share_meteo
Backtest walk-forward pur comparant share-meteo@2, share-clim@1 et la persistance sur les mêmes points. history doit couvrir [test.start − lookback, test.end + max(checkpoints)) ; weather porte l’historique multi-run brut (la sélection as-of se fait par origine).
basis_of
Base réglementaire canonique d’un pilier (pour l’auditabilité, y compris Indeterminate). Le seuil bas-carbone est un proxy → indicative-non-regulatory ; les autres dérivent directement des textes UE → regulatory.
best_eligible
Meilleur créneau éligible (score le plus bas), emprunté — sans consommer ni cloner la série.
calibrate_share_bands
Calibre les bandes de résidus par horizon de share-clim@1 (quantiles q/1−q de observé − prévu, en points de part), par walk-forward pur sur calib — même discipline anti-fuite que backtest_share. None si aucune origine exploitable.
calibrate_share_meteo_bands
Calibre les bandes de résidus par horizon de share-meteo@2 (quantiles q/1−q de observé − prévu), walk-forward pur — même discipline anti-fuite et même comblement de seaux vides que calibrate_share_bands.
evaluate
Évalue une série de créneaux contre un ruleset, pour une zone de dépôt.
evaluate_slot
Évalue un créneau unique.
low_carbon_intensity_threshold
Seuil d’intensité électrique bas-carbone dérivé, en gCO₂eq/kWh.
rank_by_score
Trie les verdicts par score croissant (NaN en queue, par sécurité).
renewable_share
Part renouvelable d’un mix dans [0, 1], ou None si la production primaire est nulle.
resolve_ruleset
Résout un ruleset servi par cadre + version optionnelle.
ruleset_catalog
Catalogue complet des rulesets (2 servis + 1 planifié).