Fokwaarden (EBV)

De /api/ebv-endpoints bieden toegang tot genetische evaluatieresultaten: berekeningsruns, EBV per koningin en geconsolideerde resultaten.

Runs

Methode	Route	Beschrijving
GET	/api/ebv/runs	Runs weergeven (?status, ?limit, ?offset)
GET	/api/ebv/runs/[id]	Rundetail + artefacten + samenvatting

Elke run vertegenwoordigt een volledige uitvoering van de genetische pipeline. Mogelijke statussen zijn: pending, running, completed, failed.

Resultaten

Methode	Route	Beschrijving
GET	/api/ebv/latest	Laatste resultaten (?trait, ?entity_type, ?sort, ?order)
GET	/api/ebv/queens/[id]	EBV voor een koningin (?run_id, ?history=true)

EBV-antwoordformaat

{
  "trait": "honey",
  "raw_value": 2.45,
  "normalized_value": 112,
  "reliability_r2": 0.68,
  "run_id": "uuid-of-the-run",
  "entity_type": "queen"
}

Veld	Beschrijving
trait	Kenmerknaam (honey, gentleness, vigor, wintering, swarming, comb_sitting, hyg6, hyg24)
raw_value	Ruwe EBV-waarde
normalized_value	BeeBreed-achtige genormaliseerde waarde (100 + 10 x (ruw - gemiddelde) / std)
reliability_r2	Betrouwbaarheid r² (0 tot 1)
run_id	Berekeningsrun-identificatie
entity_type	Entiteitstype (queen of worker)

De parameter ?history=true op /api/ebv/queens/[id] retourneert de EBV-geschiedenis over alle runs om de evolutie in de tijd te visualiseren.

Berekenen (alleen admin)

De berekeningsendpoints activeren de verschillende fasen van de genetische pipeline. Ze vereisen beheerdersauthenticatie (HMAC-cookie).

Methode	Route	Beschrijving
POST	/api/env/compute	Omgevingspipeline (geocoding + weer)
POST	/api/xgb/compute	XGBoost-correctie (omgevingseffect)
POST	/api/ebv/compute	BLUPF90 (continue kenmerken: honing)
POST	/api/thrg/compute	THRGIBBS + normalisatie (ordinale kenmerken)
POST	/api/ebv/oneshot	Volledige pipeline (env + xgb + blup + thrg)

Admin vereist

Berekeningsendpoints vereisen een geldige admin HMAC-cookie. Ze activeren zware berekeningen op de worker en mogen alleen door beheerders worden gebruikt.

---

Zie ook: Evaluaties | Koninginnen | Export