# 収量較正とクレンジング

GeoPardを使用して **収量データをクリーン化する** と **収量モニターデータセットを較正する**。ゾーン、施用処方、解析に信頼できる収量マップを取得します。このワークフローは外れ値、反転走行（ターンアラウンド）、欠損属性、および複数台の収穫機からの収量データを処理します。これには **米国農務省（USDA）の収量クリーニングプロトコル** が含まれ、 **Yield Editorの代替** ワークフローをサポートします。

{% embed url="<https://youtu.be/Tk5lubolnHQ>" %}
収量データのクリーニングと較正のビデオチュートリアル。オプション間の違いを説明します。
{% endembed %}

この較正プロセスは次の点で重要です：

1. **データの一貫性の確保**: 複数の収穫機が協調して、あるいは異なる日に作業することは珍しくありません。この機能はそれらのデータが整合するようにします。
2. **データの均質化**: 収量データはばらつきが出ることがあります。較正は不要なスパイクや急落を抑え、なめらかで一貫したデータにします。
3. **ノイズの除去**: 他のデータと同様に、収量データにもノイズや無関係な情報が含まれることがあります。分析の妨げにならないよう除去します。
4. **ジオメトリの合理化**: ターンアラウンドや奇妙なジオメトリパターンは実際の洞察を歪める可能性があります。較正はこれらを解消し、データが実際の圃場状況を反映するように設計されています。
5. **圃場境界での切り取り**: 収穫機は隣接するエリアで作業することが多いです。正確な解析結果のためには、指定した境界内のデータのみを考慮することが重要です。

{% hint style="info" %}
Yield CalibrationインターフェースはGeoPardのYield Clean/Calibrate用APIエンドポイントを使用します（[GeoPard API: YieldDatasetを較正およびクリーン化](/geopard-tutorials/jpn/apidokyumento/geopard-apirikuesuto/84-mytshon-yielddataset-woshitekurnappu.md)）。これにより `較正` と `クリーニング` UI上またはAPI経由で操作を実行します。
{% endhint %}

## クイック概要

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><img src="/files/8c533f9225e04009bbdaa4e9d46a6f1f36624d2a" alt=""></td><td></td><td></td><td></td></tr><tr><td><img src="/files/23b957a14415c00b1266a5ca0f1644c23166960c" alt=""></td><td></td><td></td><td></td></tr><tr><td><img src="/files/53c00735c9c83084791f4d7549a77d7ffd5bc365" alt=""></td><td></td><td></td><td></td></tr><tr><td><img src="/files/3d8afea67032e3fd9480bf591307453c1af38953" alt=""></td><td></td><td></td><td></td></tr><tr><td><img src="/files/7967b2062eceb614609f5c11ae7e74b105ddf7dc" alt=""></td><td></td><td></td><td></td></tr><tr><td><img src="/files/1fa327c0d34bc3ef7c6a92bb32cd26f8835580f0" alt=""></td><td></td><td></td><td></td></tr></tbody></table>

{% file src="/files/a98955ced8450d6da24e8df55fbace7ab62907df" %}
収量クリーニングPDFパンフレットをダウンロード
{% endfile %}

## 実際の事例

農業の領域では、破損した収量データセットが重大な課題を引き起こすことがあります。以下はそのようなデータセットに直面した実例です。GeoPardの高度な較正およびクリーニングアルゴリズムにより、これらのデータセットは効果的に精練・最適化されました。

{% hint style="info" %}
記録された収量データが欠落している領域に対処し、収量マップの完全性を達成するために、GeoPardの合成（シンセティック）収量マップ手法の利用を検討してください。この手法は欠損データを復元し、完全な収量解析を実現します。詳細はこちら [こちら](/geopard-tutorials/jpn/nong-xue/mappu-2.md).
{% endhint %}

### 複数台の収穫機の協調作業

<figure><img src="/files/ba34a3c278db3b931c2fbfd5c4e109897787f2e0" alt=""><figcaption><p>例1：複数台の収穫機の協調作業</p></figcaption></figure>

{% hint style="info" %}
複雑なシナリオに対処する際は、最適な精度のために2段階の較正プロセスを推奨します。まずMachine ID属性を使って初回較正を実行します。その後、シミュレートされた（合成）機体経路のチェックボックスを使用して2回目の較正を行ってください。この層状アプローチにより、複雑なケースを効果的に管理するための徹底的で精密な較正が保証されます。
{% endhint %}

<figure><img src="/files/3a3c815ed3e0dcd3ae5774483e8d3b499fe955ec" alt=""><figcaption><p>例2：複数台の収穫機の協調作業</p></figcaption></figure>

<figure><img src="/files/b85aa43e4896078575be196fb1cabb54fc223ed9" alt=""><figcaption><p>例3：複数台の収穫機の協調作業</p></figcaption></figure>

### Jターン、停止、装備幅の半分を使用

<figure><img src="/files/a8af0ea79bd2d917e017997d7cca0102740156b4" alt=""><figcaption><p>例1：Uターン、停止、装備幅の半分を使用</p></figcaption></figure>

<figure><img src="/files/03ad0c3b307d0cf05f68c30977b6c55581abb595" alt=""><figcaption><p>例2：Uターン、停止、装備幅の半分を使用</p></figcaption></figure>

### 異常に大きな記録値

<figure><img src="/files/473c28a555d5ac6b5a9a40a3e90644c114c0d481" alt=""><figcaption><p>例1：異常に大きな記録値</p></figcaption></figure>

<figure><img src="/files/e4adaac97eb140e15f349f851aa3a6d0eb1925f9" alt=""><figcaption><p>例2：異常に大きな記録値</p></figcaption></figure>

<figure><img src="/files/281cdaa720b0f02c746ec8f14b3c2812e29ae234" alt=""><figcaption><p>例3：異常に大きな記録値</p></figcaption></figure>

<figure><img src="/files/dff3a7961082c1bd70eae3c12eac8c3f9760c0bf" alt=""><figcaption><p>例4：異常に大きな記録値</p></figcaption></figure>

<figure><img src="/files/d59dac8a7663401408a539223e43d1292e990dc4" alt=""><figcaption><p>例5：異常に大きな記録値</p></figcaption></figure>

### 圃場境界を越えたデータ

<figure><img src="/files/987302518ba82bee108d9e066f98c59daffb3c6f" alt=""><figcaption><p>例：圃場境界を越えたデータ</p></figcaption></figure>

### 提供された平均収量値を用いた較正

<figure><img src="/files/5d80078a7f9981172eb6da0e9efc1162cc9c861a" alt=""><figcaption><p>例：提供された平均収量値（28 t/ha）を用いた較正</p></figcaption></figure>

### 異常のある属性を無視して収量属性をクリーン化する

収量データセットには時折、水分（モイスチャー）、速度、標高、その他の二次（非収量）属性に不規則性が含まれることがあります。CleanやCalibrateの処理を実行する際には、これらの異常を無視することが不可欠です。これはGeoPardのYield Clean-Calibrateインターフェースを用いて効率的に達成できます。

<figure><img src="/files/4d10eeba7eeca155b5306258a271caf31e083362" alt=""><figcaption><p>例：モイスチャー属性の異常</p></figcaption></figure>

<figure><img src="/files/f164b14519144bfc90811602db7b4f132860f16b" alt=""><figcaption><p>例：モイスチャーの異常を無視して収量データをクリーン化する例</p></figcaption></figure>

### USDA収量クリーニングプロトコル

このオプションは次の場合に使用してください： **繰り返し可能で標準準拠の収量エディターワークフロー**。これは次の用途に最適化されています： **大規模な収量モニターデータのクリーニング** での使用向けです。

<figure><img src="/files/dc298f444b6c2b94e89652af6646f5cc0ded062b" alt=""><figcaption><p>例：USDAプロトコルを適用した収量データのクリーニング</p></figcaption></figure>

<figure><img src="/files/bae23f012088d41bf9bb87945545b3a544f3e2e7" alt=""><figcaption><p>例：USDAプロトコルを適用した収量データのクリーニング</p></figcaption></figure>

## 較正ロジックの説明

### トラック別キャリブレーション

**使用する場合** **トラック別キャリブレーション** フィールドが <mark style="background-color:green;">複数の機械または数日にわたって収穫されたとき、特にストライプやバンディングなどの体系的な差を補正するために使用します。</mark> これは、機械設定、オペレーター、または環境条件の違いが経路ごとに一貫して過小または過大評価を引き起こすシナリオに最適です。

重要なのは、 <mark style="background-color:yellow;">AIは効果的に学習・較正するために、異なる経路、機械ID、収穫日などの変動が必要だということです。</mark>

<figure><img src="/files/26ef34c233b870f79c37275430f00c982824a7d2" alt=""><figcaption><p>例：収量（湿重量）と9台の収穫機</p></figcaption></figure>

**使用しないでください** 単一機で連続して収穫された場合や、収量マップに目に見える空間パターンがない場合はこの方法を使用しないでください。データがまばらである場合や、機械ごとの差分がなく総フィールドレベルの合計値しかない場合も避けてください。

<figure><img src="/files/058d1166e594520fe72388480158ba64607ad7cc" alt="" width="563"><figcaption><p>例：統計的に補正されたデータ分布</p></figcaption></figure>

### 平均または総量による較正

**平均／総量による較正は次のときに最適です** 次の場合： <mark style="background-color:green;">トンや貯蔵施設などの計量所からの記録のように、フィールド全体の収量データに高い信頼性がある場合。</mark> 個々の経路を調整する代わりに、この方法はデータセット全体をスケールして、最終的な平均値または総量が既知の参照値と一致するようにします。全体の数値が信頼できる場合、最も簡単で安全な較正オプションと説明されることが多いです。

いつ **平均／総量による較正を使用するか：**

* **既知の参照値**: 計量所の公式な総収量記録（例：計量台の記録）やフィールドの非常に信頼できる平均収量がある場合にこのロジックを使用してください。
* **全体的なバイアス補正**: 収量マップの空間分布は正しく見えるが、値が全体的にずれている—つまり収量モニターが較正されておらず、フィールド全体で一貫して高すぎるまたは低すぎる値を報告している可能性がある場合に理想的です。
* **均一な収穫条件**: 収穫条件が作業全体で比較的一貫していた場合、この方法が最も効果的です。
* **単一機の一貫性**: フィールド全体で一貫した性能を示した単一の機械による収穫に対してうまく機能します。

<figure><img src="/files/058d1166e594520fe72388480158ba64607ad7cc" alt="" width="563"><figcaption><p>例：平均収量を使用して必要なシフトを行った統計的に補正されたデータ分布</p></figcaption></figure>

次の場合は **平均／総量による較正を使用しないでください：**

* **機械間のバイアス**: フィールドの異なる部分が異なる機械や別の日に収穫され、局所的なバイアスが生じている場合はこの方法を使用しないでください。その場合、フィールド全体をスケーリングしても機械間の根本的な不一致は解決されません。
* **目に見えるアーティファクト**: データに強いストライピング、バンディング、方向性のアーティファクトが見られる場合、この方法ではそれらを解決できません； <mark style="background-color:green;">そのような問題には経路別較正の方が適しています</mark>.
* **不完全なデータ**: フィールドの一部しか収穫されていない、または記録データが不完全な場合はこのロジックを避けてください。総量／平均値が誤解を招く可能性があります。

<figure><img src="/files/ee8922ddb713715cc4ba8a494d40c16d0c044cac" alt="" width="563"><figcaption><p>例：ギャップのある収量データ</p></figcaption></figure>

### 条件付きキャリブレーション

**条件付きキャリブレーション** として機能します <mark style="background-color:green;">事前に定義された現実的な最小値および最大値の範囲内に収量値を維持する安全装置として</mark>.

あなたは **このロジックを使用すべきです** 極端な外れ値やノイズ、機械停止、旋回によって引き起こされるセンサーのスパイクを<mark style="background-color:green;">除去するためにこのロジックを使用するべきです</mark>。これは「収量がXを超えてはならない」といった特定の農業的期待を適用するのに理想的で、修正を行わずに使用できます。

<figure><img src="/files/239584964ab84f6e5f207b3dae014a9b4e528c8a" alt=""><figcaption></figcaption></figure>

しかし、 **この方法は避けてください** データセットに全体的なバイアスや系統的な機械差がある場合、この方法はデータのスケーリングや空間パターンの修正を行わないため適しません。本質的に値をもっともらしく保ちますが、基礎となる較正オフセットを解決するものではありません。

## 使用戦略

<figure><img src="/files/98443d428d95b9e3af9753a279b6d0c2cc53a4ec" alt=""><figcaption><p>ワンページ収量較正ガイダンス</p></figcaption></figure>

{% file src="/files/03fa80504d5ac2b24283e5ceeeab6caac7d948d0" %}
収量較正ガイダンスのPDFワンページをダウンロード
{% endfile %}

## 最初のステップ

「Yield Calibrate and Clean」モジュールはユーザーインターフェースから直接起動します。主な前提は、収量データセットがアップロードされていることです。各収量データセットの隣に、データセット調整を開始するボタンがあります。

<figure><img src="/files/b2f99d1c9b65b58d789936068f4d8dc4e1b7a4a2" alt=""><figcaption><p>フローを開始</p></figcaption></figure>

<figure><img src="/files/ec069ddcc13332b9d04b7efeb70edd91046413a8" alt="" width="563"><figcaption><p>続行するオプションを選択してください</p></figcaption></figure>

そこから、いくつかの進め方のオプションがあります：

1. **自動処理**：ワンクリック較正のために、GeoPard推奨のデフォルト設定を使用します。
2. **クリーンのみ**：CLEAN操作のみを設定して実行します。これには以下が含まれます：
   1. **GeoPardクリーニング**：AIアルゴリズムによる収量データセットのスマートクリーニング。
   2. **米国農務省（USDA）** （米国農務省）による収量のクリーニングプロトコル。
   3. **条件付きクリーニング**：カスタム属性閾値に基づいてデータをフィルタリングします。
3. **較正のみ**：CALIBRATE操作のみを設定して実行します。これには以下が含まれます：
   1. **calibrationBasis**：各機械走行ごとにAIアルゴリズムを用いて収量を較正します。
   2. **平均／合計**：フィールドの既知の平均または総収量に基づいて収量を調整します。
   3. **条件付き**：期待される範囲を維持するために、設定された最小値および最大値の範囲内で収量を修正します。
4. **較正とクリーン両方**：操作の順序を選択し、パラメータをカスタマイズします。
5. **Yield Editorの代替**：使用する **クリーンのみ → USDA** （または **較正とクリーン両方**）手作業の「Yield Editor」によるクリーンアップワークフローと一致させつつ、大規模に実行するためのものです。検証テストでは、USDAプロトコルによるクリーニングは手動のYield Editor結果と一致し、 **R²（R2）＝0.98** （ほぼ同一の出力）。

## ワンボタンソリューション

{% hint style="warning" %}
**収量データセットに時折内在する異常値に関するヒント。**

もし **attribute** 較正またはクリーニングのために選択されたものが主に **含む** **大部分のジオメトリでゼロ値を**含む場合、これらのジオメトリは最終的な収量データセットから除外されます。

整合性を確保するために、そのような異常を持つ属性は較正対象の属性リストから除外するべきです。
{% endhint %}

{% @arcade/embed url="<https://app.arcade.software/share/gzZZkXqKSAd1eaIKNqDB>" flowId="gzZZkXqKSAd1eaIKNqDB" %}

## 完全ガイダンス

{% hint style="warning" %}
**フローを選択：データ異常に関するヒント**

ユーザーがデータでゼロ付近の値や異常に大きな値（例えば平均が10で最大が8000など）を検出した場合、 **クリーニング＆較正** ワークフローを推奨します。

較正の前にデータのクリーニングを優先することで、エラーや欠損値、不整合を除去し、データ品質と精度を高められます。
{% endhint %}

{% hint style="warning" %}
**フローを選択：初期エラーのないデータに関するヒント**

初期にエラーや欠損値、不整合がなく、複数の収穫機が関与していることが分かっているデータセットの場合は、 **較正＆クリーニング** ワークフロー。

較正後にデータをクリーニングすることで、較正中に導入された可能性のあるアーティファクトを除去し、データセットをさらに洗練できます。
{% endhint %}

{% hint style="warning" %}
**クリーンフロー：収量データセットに時折内在する異常値に関するヒント。**

もし **attribute** 較正またはクリーニングのために選択されたものは主に含む **大部分のジオメトリでゼロ値を含む**含む場合、これらのジオメトリは最終的な収量データセットから除外されます。

整合性を確保するために、そのような異常を持つ属性はクリーン対象の属性リストから除外する必要があります（2）。
{% endhint %}

{% hint style="warning" %}
**流量の較正：収量データセットに固有の場合がある異常値へのヒント。**

もし **attribute** 較正またはクリーニングのために選択されたものが主に **含む** **大部分のジオメトリでゼロ値を**含む場合、これらのジオメトリは最終的な収量データセットから除外されます。

整合性を確保するために、そのような異常を持つ属性は較正対象の属性リストから除外する必要があります（3）。
{% endhint %}

{% @arcade/embed url="<https://app.arcade.software/share/i8Q6uC04nIVjJLLOYELJ>" flowId="i8Q6uC04nIVjJLLOYELJ" %}

## アルゴリズムのバージョン

後処理では、結果が元のデータセットの隣に表示されます。これらは次でマークされています **「較正」** および／または **「クリーン」** ラベルとアルゴリズムのバージョン。

<figure><img src="/files/243f5d19497b0c7ceb74ef8dcfd4a1b6dad148ef" alt=""><figcaption><p>較正＆クリーン実行の結果（バージョン2）</p></figcaption></figure>

{% hint style="info" %}
から `バージョン3.0` クリーン／較正アルゴリズムのバージョン3.0以降では、GeoPardは圃場境界による切り取り機能を導入しました。これにより圃場境界内のジオメトリのみが保持され、統計分布が改善されます。
{% endhint %}

<figure><img src="/files/3ee6c62c1512ef278343e1b89db7f484dd4c02e5" alt=""><figcaption><p>自動処理実行の結果（バージョン3.0）</p></figcaption></figure>

{% hint style="info" %}
から開始して `バージョン4.0`以降、GeoPardのクリーン／較正アルゴリズムには任意の属性の平均値または総値に基づく較正機能が組み込まれました。代表的な適用例は湿重量（WetMass）の較正で、特定の圃場の既知の測定平均収量で調整できるようになりました。
{% endhint %}

<figure><img src="/files/de553576f3a2cdda54513c7771c2ed2b4bdbd5db" alt=""><figcaption><p>平均収量6 t/haを用いた較正実行の結果（バージョン4.0）</p></figcaption></figure>

{% hint style="info" %}
から `バージョン5.0` クリーン／較正アルゴリズムのバージョン5.0以降では、GeoPardは収量向けのUSDA（米国農務省）クリーニングプロトコルを導入しました。USDAは収量、含水率、流量、空間測定が正規化、検証、統計的にフィルタリングされ、機械および圃場で一貫した農業データセットを生成するための正式な農学データ基準を提供します。
{% endhint %}

<figure><img src="/files/dc298f444b6c2b94e89652af6646f5cc0ded062b" alt=""><figcaption><p>USDAプロトコルを用いたクリーニング実行の結果（バージョン5.0）</p></figcaption></figure>


---

# 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/jpn/nong-xue/tokurenjingu.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.