Zuchtwerte (EBV)

Die /api/ebv-Endpunkte bieten Zugriff auf die Ergebnisse der genetischen Bewertung: Berechnungsläufe, EBV pro Königin und konsolidierte Ergebnisse.

Runs

Methode	Route	Beschreibung
GET	/api/ebv/runs	Liste der Runs (?status, ?limit, ?offset)
GET	/api/ebv/runs/[id]	Run-Detail + Artefakte + Zusammenfassung

Jeder Run stellt eine vollständige Ausführung der genetischen Pipeline dar. Mögliche Status sind: pending, running, completed, failed.

Ergebnisse

Methode	Route	Beschreibung
GET	/api/ebv/latest	Neueste Ergebnisse (?trait, ?entity_type, ?sort, ?order)
GET	/api/ebv/queens/[id]	EBV einer Königin (?run_id, ?history=true)

EBV-Antwortformat

{
  "trait": "honey",
  "raw_value": 2.45,
  "normalized_value": 112,
  "reliability_r2": 0.68,
  "run_id": "uuid-des-runs",
  "entity_type": "queen"
}

Feld	Beschreibung
trait	Merkmalsname (honey, gentleness, vigor, wintering, swarming, comb_sitting, hyg6, hyg24)
raw_value	Roher EBV-Wert
normalized_value	BeeBreed-normalisierter Wert (100 + 10 x (roh - Mittelwert) / Standardabweichung)
reliability_r2	Sicherheit r² (0 bis 1)
run_id	Kennung des Berechnungslaufs
entity_type	Entitätstyp (queen oder worker)

Der Parameter ?history=true auf /api/ebv/queens/[id] liefert den EBV-Verlauf über alle Runs, um die Entwicklung im Zeitverlauf zu visualisieren.

Compute (nur Admin)

Die Compute-Endpunkte lösen die verschiedenen Stufen der genetischen Pipeline aus. Sie erfordern Admin-Authentifizierung (HMAC-Cookie).

Methode	Route	Beschreibung
POST	/api/env/compute	Umwelt-Pipeline (Geokodierung + Wetter)
POST	/api/xgb/compute	XGBoost-Korrektur (Umwelteffekt)
POST	/api/ebv/compute	BLUPF90 (kontinuierliche Merkmale: Honig)
POST	/api/thrg/compute	THRGIBBS + Normalisierung (ordinale Merkmale)
POST	/api/ebv/oneshot	Vollständige Pipeline (env + xgb + blup + thrg)

Admin erforderlich

Compute-Endpunkte erfordern einen gültigen Admin-HMAC-Cookie. Sie lösen aufwändige Berechnungen auf dem Worker aus und sollten nur von Administratoren verwendet werden.

---

Siehe auch: Bewertungen | Königinnen | Export