# 84. Mutace: Kalibrovat a vyčistit YieldDataset

Kalibrace "YieldDataset" je funkce, která upravuje rozložení hodnot v souladu s matematickými principy a zvyšuje celkovou integritu dat. Posiluje kvalitu rozhodování a činí dataset užitečným pro další podrobnou analýzu.

Běžné použití této funkce zahrnuje:

* Synchronizaci dat, když více kombajnů pracovalo současně nebo během několika dnů, čímž se zajistí konzistence.
* Zvýšení homogenity a přesnosti datasetu vyhlazením odchylek.
* Odstranění šumu v datech a zbytečných informací, které mohou zamlžit poznatky.
* Eliminaci otáček nebo abnormálních geometrií, které mohou zkreslovat skutečné vzorce a trendy na poli.
* Upravení výnosových dat tak, aby odpovídala zavedeným průměrům nebo součtům pro každý atribut.

Pro podrobnější prozkoumání a příklady se, prosím, odkažte na naši [Kalibrace a čištění výnosů](/geopard-tutorials/cze/agronomie/kalibrace-a-cisteni-vynosu.md) use case.

### Původní YieldDataset s atributem WetMass

Na zobrazeném 30ha poli pracovaly paralelně pět kombajnů. Kalibrace jednoho z kombajnů nebyla synchronizována s ostatními, což mělo za následek <mark style="color:oranžová;">oranžová</mark> místy, což naznačuje, že je potřeba další `KALIBRACE` Kromě toho je zde řada otoček <mark style="color:červené;">červené</mark> místy blíže okrajům "Pole", které je třeba odstranit.

<figure><img src="/files/f445d8ea3529e9f8d46d2cca224531c77cf71c8c" alt=""><figcaption><p>Původní YieldDataset s atributem WetMass</p></figcaption></figure>

### Kalibrovaný a vyčištěný YieldDataset s atributem WetMass

Výsledek níže ukazuje dataset po použití automatických `KALIBROVAT` a `VYČISTIT` operací s použitím výchozích parametrů. Výsledný "YieldDataset" se stal homogenním, bez odlehlých hodnot nebo náhlých změn mezi sousedními geometriemi.

<figure><img src="/files/0a80117864969b9a2d2f6d3b73533fdeea2ce6de" alt=""><figcaption><p>Kalibrovaný a vyčištěný YieldDataset s atributem WetMass</p></figcaption></figure>

### Možnosti: podle stop vs průměr/součet vs podmíněná

**Kalibrace podle stop** odpovídá stopám stroje. Každá stopa stroje je zpracována jako samostatná oblast pro účely kalibrace. Tým GeoPard doporučuje tento postup jako standardní přístup.

**Kalibrace podle průměru/součtu** se zaměřuje na redistribuci hodnot atributů. Pokud jsou geoprostorové vzorce správné, ale absolutní čísla se liší od skutečných hodnot, je tato metoda užitečná. Pro optimální výsledky GeoPard doporučuje kombinovat ji s kalibrací podle stop: nejprve použít kalibraci podle stop a potom upravit na známé průměrné/souhrnné hodnoty.

**Podmíněná kalibrace** upravuje hodnoty atributů na základě poskytnutých minimálních a maximálních prahů. Tato metoda je zvláště cenná, když jsou geoprostorové vzorce přesné, ale rozložení hodnot vyžaduje úpravy, zejména pokud existují známé min a max hodnoty. Pro nejlepší výsledky GeoPard doporučuje spojit ji s kalibrací podle stop: začít kalibrací podle stop a poté upravit tak, aby odpovídala známým minimálním a maximálním hodnotám.

### Tipy

{% hint style="warning" %}
**Tip pro anomálie v datech**

Pokud uživatel narazí na anomálie v datech, například hodnoty na nebo blízko nuly, nebo neobvykle velké hodnoty (například průměr 10 s maximem 8000), doporučuje se pracovní postup **Čištění & Kalibrace** Je doporučeno použít tento workflow. Je nakonfigurován pomocí parametrů `akce: [CLEAN, CALIBRATE]`.&#x20;

Upřednostnění čištění dat před kalibrací zajistí odstranění chyb, chybějících hodnot nebo nekonzistencí a tím zvýší kvalitu a přesnost dat.
{% endhint %}

{% hint style="warning" %}
**Tip pro data bez počátečních chyb**&#x20;

Pro datasety, které jsou zpočátku bez chyb, chybějících hodnot nebo nekonzistencí, a když je známo, že se podílelo více kombajnů, zvažte pracovní postup **Kalibrace & Čištění** Tento workflow je nakonfigurován pomocí parametrů `akce:  [CALIBRATE, CLEAN]`.

Vyčištění dat po kalibraci pomáhá dataset dále vylepšit a případně odstranit artefakty zavedené během kalibrace.
{% endhint %}

### Dokumentace: Detaily mutace

Výchozí standardní konfigurace povoluje automatickou kalibraci a čištění "YieldDataset".

{% code overflow="wrap" lineNumbers="true" %}

```graphql
mutace AutoCalibrateYieldDataset {
  calibrateYieldDataset(vstup: {
    fieldUuid: "<placeholder_of_field_uuid>"
    yieldDatasetUuid: "<placeholder_of_dataset_uuid>"
    akce: {
      calibrateAction: {
        calibrationAttributes:["WetMass", "VRYIELDVOL"]
        conditionPathwiseCalibration: {
          calibrationBasis: "WetMass"
          maxHomogeneityRegion: true
          syntheticMachinePath: true
        }
      }
      cleanAction: {
        condtionAutoClean: {
          targetAttribute: "WetMass"
        }
      }
      
      akce:  [CALIBRATE, CLEAN]
    }
  }) {
    uuid
    fieldUuid
    originalUuid
    statusCode
    statusMessage
  }
}
```

{% endcode %}

Pokročilejší příklad poskytuje ruční kontrolu rozsahů min/max a zahrnuje další atributy.

{% code overflow="wrap" lineNumbers="true" %}

```graphql
mutace CustomCalibrateYieldDataset {
  calibrateYieldDataset(vstup: {
    fieldUuid: "<placeholder_of_field_uuid>"
    yieldDatasetUuid: "<placeholder_of_dataset_uuid>"
    akce: {
      calibrateAction: {
        calibrationAttributes:["WetMass", "VRYIELDVOL"]
        smoothWindowSize: 11
        conditionPathwiseCalibration: {
          calibrationBasis: "Machine"
          maxHomogeneityRegion: true
          syntheticMachinePath: false
        }
        conditionAvgTotalCalibration:[{
          calibrationAttribute: "WetMass"
          average:8.0
        }]
      }
      cleanAction: {
        condtionAutoClean: {
          targetAttribute: "WetMass"
        }
        conditionMinMaxClean: [{
          cleanAttribute: "Distance"
          min: 1.5
          max: 10.0
        }]
      }
      akce:  [CALIBRATE, CLEAN]
    }
  }) {
    uuid
    fieldUuid
    originalUuid
    statusCode
    statusMessage
  }
}
```

{% endcode %}

{% hint style="info" %}
Chcete-li dodržet protokol USDA pro tuto `VYČISTIT` operaci, musíte buď uvést VŠECHNY sloupce v `cleanAction` -> `conditionMinMaxClean` nebo specifikovat jejich část v `cleanAction` -> `conditionMinMaxClean` a zbylé v `condtionAutoClean` -> `excludedAttributes`.
{% endhint %}

Vstupní parametry:

* `akce` jako pole, které vám umožní vybrat *korekční akce a jejich pořadí* aplikace; podporované hodnoty zahrnují `VYČISTIT` a `KALIBROVAT`.
* `calibrateAction` jako objekt obsahující konfigurační detaily vztahující se k `KALIBROVAT` operaci.&#x20;
  * `calibrationAttributes` jako pole atributů vyžadujících kalibraci, obvykle spojených se sloupcem výnosu.
  * `smoothWindowSize` jako liché celé číslo, které vyhlazuje výsledné hodnoty a snižuje náhlé skoky hodnot.
  * `conditionPathwiseCalibration` jako objekt s **Kalibrace podle stop** odpovídá stopám stroje. Každá stopa stroje je zpracována jako samostatná oblast pro účely kalibrace.
    * `calibrationBasis` jako řetězec představující atribut použitý jako základ pro kalibraci.
    * `maxHomogeneityRegion` jako boolean, který indikuje, zda se jako referenční oblast pro kalibraci používá oblast s maximální homogenitou.
    * `syntheticMachinePath` jako boolean, který indikuje simulaci tras strojů; je užitečný, když chybí přesný atribut trasy stroje a je potřeba simulace založená na časových razítkách nebo podobném atributu.
  * `conditionAvgTotalCalibration` jako objekt s **Kalibrace podle průměru/součtu** se zaměřuje na redistribuci hodnot atributů. Pokud jsou geoprostorové vzorce správné, ale absolutní čísla se liší od skutečných hodnot, je tato metoda užitečná.
    * `calibrationAttribute` jako řetězec představující atribut, který má být kalibrován.
    * `average` jako číslo představující průměrné hodnoty atributu; hodnoty atributu by měly odpovídat tomuto průměru. Měla by být použita pouze jedna možnost, buď `average` nebo `total`, měla by být použita najednou pouze jedna možnost.
    * `total` jako číslo představující celkový součet hodnot atributu; souhrn těchto hodnot by měl odpovídat tomuto součtu. Měla by být použita pouze jedna možnost, buď `average` nebo `total`, měla by být použita najednou pouze jedna možnost.
  * `conditionMinMaxCalibration` jako objekt s **Podmíněná** kalibrace upravuje hodnoty atributů na základě poskytnutých minimálních a maximálních prahů.
    * `calibrationAttribute` jako řetězec představující atribut, který má být kalibrován.
    * `min` jako číslo představující minimální hodnoty atributu, sloužící jako nejnižší rozsah pro kalibraci.
    * `minIncluded` jako boolean indikující, zda zahrnout minimální hodnotu či ne
    * `max` jako číslo představující maximální hodnoty atributu, sloužící jako nejvyšší rozsah pro kalibraci.
    * `maxIncluded` jako boolean indikující, zda zahrnout maximální hodnotu či ne.
* `cleanAction` jako objekt, který zahrnuje konfigurační specifika vázaná k `VYČISTIT` operaci.
  * `conditionAutoClean` jako objekt, který zahrnuje konfigurace specifické pro algoritmus auto-clean.
    * `targetAttribute` jako řetězec představující cílové hodnoty výnosu.
    * `excludedAttributes` jako pole řetězců definujících atributy, které neovlivňují operaci čištění.
  * `conditionMinMaxClean` jako pole objektů obsahujících popsaná pravidla čištění, každý objekt zahrnuje následující parametry.
    * cleanAttribute jako řetězec určující název sloupce pro pravidlo.
    * `min` jako číslo udávající minimální hodnotu.
    * `max` jako číslo udávající maximální hodnotu.

{% hint style="info" %}
Pro zobrazení vstupů a přístup k nejnovějším dostupným hodnotám výčtů (například `operace`), doporučuje se využít [Altair](/geopard-tutorials/cze/api-dokumentace/zaciname-s-api-geopardu.md).
{% endhint %}

### Dokumentace: dotaz na YieldDataset

Jako spotřebitel GeoPard API můžete získat podrobnosti o opravách aplikovaných na YieldDatasety prostřednictvím atributů `appliedCorrections` a `appliedCorrectionsVersion`. První poskytuje seznam provedených oprav (např., `KALIBROVAT` a `VYČISTIT`), pořadí vykonání je určeno jejich sekvencí v poli. Mezitím `appliedCorrectionsVersion` udává verzi použitého algoritmu.

{% code overflow="wrap" lineNumbers="true" %}

```graphql
dotaz DetailsAboutAppliedCalibrations {
  getFields (filtr: {fieldUuid: "<placeholder_of_field_uuid>"}){
    fields {
      uuid
      yieldDatasets  {
        uuid
        appliedCorrections
        appliedCorrectionsVersion
      }
    }
  }
}
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.geopard.tech/geopard-tutorials/cze/api-dokumentace/prehled-pozadavku-api-geopardu/84.-mutace-kalibrovat-a-vycistit-yielddataset.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.