84. Mutation: Kalibrovat a čistit YieldDataset

API volání pro čištění a kalibraci datasetů výnosu

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ů 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 oranžová místy, což naznačuje, že je potřeba další KALIBRACE Kromě toho je zde řada otoček červené místy blíže okrajům "Pole", které je třeba odstranit.

Původní YieldDataset s atributem WetMass

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.

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

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

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].

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.

Tip pro data bez počátečních chyb

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.

Dokumentace: Detaily mutace

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

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
  }
}

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

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
  }
}

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.

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.

  • 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.

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.

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.

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