> For the complete documentation index, see [llms.txt](https://docs.geopard.tech/geopard-tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geopard.tech/geopard-tutorials/ar/wthaeq-wajhh-brmjh-alttbyqat/geopard-api-requests-overview/84.-mutation-calibrate-and-clean-yielddataset.md).

# 84. عملية تعديل: معايرة وتنظيف مجموعة بيانات الإنتاجية

استدعاءات واجهة برمجة التطبيقات لتنظيف ومعايرة مجموعات بيانات الإنتاجية

تُعد معايرة "YieldDataset" وظيفةً تصحح توزيع القيم بما يتوافق مع المبادئ الرياضية، مما يعزز سلامة البيانات إجمالًا. كما تحسن جودة اتخاذ القرارات وتجعل مجموعة البيانات قيّمة لإجراء مزيد من التحليلات المتعمقة.

تشمل حالات الاستخدام الشائعة لهذه الوظيفة ما يلي:

* مزامنة البيانات عند عمل عدة حصادات في الوقت نفسه أو على مدى عدة أيام، بما يضمن الاتساق.
* جعل مجموعة البيانات أكثر تجانسًا ودقةً من خلال الحد من التباينات.
* إزالة ضوضاء البيانات والمعلومات الزائدة التي قد تحجب الرؤى.
* إزالة التفافات الحصادات أو الأشكال الهندسية غير الطبيعية التي قد تشوّه الأنماط والاتجاهات الفعلية في الحقل.
* ضبط بيانات الغلة لتتوافق مع المتوسطات أو المجاميع المعتمدة لكل سمة.

للاطلاع على شرح أكثر تفصيلًا وأمثلة، يُرجى الرجوع إلى [حالة استخدام معايرة الغلة وتنظيفها](https://docs.geopard.tech/geopard-tutorials/ar/alzraah/yield-and-trials/yield-calibration-and-cleaning.md) .

### مجموعة بيانات YieldDataset الأصلية مع سمة WetMass

عملت خمس حصادات بالتوازي في الحقل الذي تبلغ مساحته 30 هكتارًا والمبين أدناه. لم تكن معايرة إحدى الحصادات متزامنة مع معايرة الحصادات الأخرى، مما أدى إلى ظهور <mark style="color:برتقالي;">بقع برتقالية</mark> تشير إلى ضرورة إجراء `CALIBRATION` إضافية. بالإضافة إلى ذلك، توجد العديد من <mark style="color:الحمراء;">البقع الحمراء</mark> الناجمة عن التفاف الحصادات بالقرب من حواف "الحقل"، والتي يلزم إزالتها.

<figure><img src="https://2518643298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fj40y3lH0F0ZfJNH2WhTf%2Fimage.png?alt=media&amp;token=6bf7baaa-3cda-4863-98e1-e0a92ff2b765" alt=""><figcaption><p>مجموعة بيانات YieldDataset الأصلية مع سمة WetMass</p></figcaption></figure>

### مجموعة بيانات YieldDataset بعد معايرتها وتنظيفها مع سمة WetMass

تُظهر النتيجة أدناه مجموعة البيانات بعد تطبيق عمليتي `CALIBRATE` و `CLEAN` آليًا باستخدام المعلمات الافتراضية. أصبحت مجموعة بيانات "YieldDataset" الناتجة متجانسة، وخالية من القيم الشاذة أو التغيرات المفاجئة بين الأشكال الهندسية المتجاورة.

<figure><img src="https://2518643298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fu3zjlXg03WoWrjOOT9v7%2Fimage.png?alt=media&amp;token=d298f632-b0fe-462f-a395-64a64c02ea55" alt=""><figcaption><p>مجموعة بيانات YieldDataset بعد معايرتها وتنظيفها مع سمة WetMass</p></figcaption></figure>

### خيارات المعايرة حسب المسار والمتوسط/الإجمالي والشرطية

**المعايرة حسب المسار** تتوافق مع مسارات الآلة. ويُعالج كل مسار للآلة كمنطقة مستقلة لأغراض المعايرة. ويوصي فريق GeoPard باستخدام هذه الطريقة بوصفها النهج القياسي.

**المعايرة حسب المتوسط/الإجمالي** تركز على إعادة توزيع قيم السمات. وتكون هذه الطريقة مفيدة عندما تكون الأنماط الجغرافية المكانية دقيقة، لكن القيم المطلقة تختلف عن القيم الفعلية. وللحصول على أفضل النتائج، توصي GeoPard بدمجها مع المعايرة حسب المسار: ابدأ بتطبيق المعايرة حسب المسار، ثم اضبط القيم لتتوافق مع قيم المتوسط/الإجمالي المعروفة.

**المعايرة الشرطية** تضبط قيم السمات استنادًا إلى الحدين الأدنى والأقصى المحددين. وتكون هذه الطريقة مفيدة على وجه الخصوص عندما تكون الأنماط الجغرافية المكانية دقيقة، لكن توزيع القيم يحتاج إلى ضبط، ولا سيما عند معرفة القيمتين الدنيا والعليا. ولتحقيق أفضل النتائج، توصي GeoPard بدمجها مع المعايرة حسب المسار: ابدأ بالمعايرة حسب المسار، ثم أجرِ تعديلات لمواءمة القيم مع الحدين الأدنى والأقصى المعروفين.

### تلميحات

{% hint style="warning" %}
**تلميح بشأن شذوذ البيانات**

إذا واجه المستخدم حالات شذوذ في البيانات، مثل قيم تساوي الصفر أو تقترب منه، أو قيم كبيرة على نحو غير معتاد (مثلًا، متوسط قدره 10 وقيمة قصوى تبلغ 8000)، فيُنصح باستخدام سير عمل **التنظيف والمعايرة** ويُضبط باستخدام المعلمات `actions: [CLEAN, CALIBRATE]`.

يضمن إعطاء الأولوية لتنظيف البيانات قبل معايرتها إزالة الأخطاء والقيم المفقودة والتناقضات، مما يعزز جودة البيانات ودقتها.
{% endhint %}

{% hint style="warning" %}
**تلميح بشأن البيانات الخالية من الأخطاء الأولية**

إذا كانت مجموعات البيانات خالية في الأصل من الأخطاء والقيم المفقودة والتناقضات، وكان معروفًا استخدام عدة حصادات، فيُستحسن استخدام سير عمل **المعايرة والتنظيف** ويُضبط باستخدام المعلمات `actions: [CALIBRATE, CLEAN]`.

يساعد تنظيف البيانات بعد معايرتها على تنقيح مجموعة البيانات أكثر، إذ قد يزيل أي آثار غير مرغوب فيها نتجت أثناء المعايرة.
{% endhint %}

### التوثيق: تفاصيل عملية التعديل

يتيح الإعداد القياسي الافتراضي المعايرة والتنظيف التلقائيين لمجموعة بيانات "YieldDataset".

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

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

{% endcode %}

يقدّم نموذج أكثر تقدمًا تحكمًا يدويًا في النطاقات الدنيا/العليا، ويضم سمات إضافية.

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

```graphql
mutation CustomCalibrateYieldDataset {
  calibrateYieldDataset(input: {
    fieldUuid: "<placeholder_of_field_uuid>"
    yieldDatasetUuid: "<placeholder_of_dataset_uuid>"
    actions: {
      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
        }]
      }
      actions:  [CALIBRATE, CLEAN]
    }
  }) {
    uuid
    fieldUuid
    originalUuid
    statusCode
    statusMessage
  }
}
```

{% endcode %}

{% hint style="info" %}
لاتّباع بروتوكول وزارة الزراعة الأمريكية (USDA) لعملية `CLEAN` ، يجب إما ذكر جميع الأعمدة ضمن `cleanAction` -> `conditionMinMaxClean` أو تحديد جزء منها ضمن `cleanAction` -> `conditionMinMaxClean` والأعمدة المتبقية ضمن `condtionAutoClean` -> `excludedAttributes`.
{% endhint %}

معلمات الإدخال:

* `actions` كمصفوفة، ما يتيح لك اختيار *إجراءات التصحيح وتسلسل تطبيقها* ؛ وتتضمن القيم المدعومة `CLEAN` و `CALIBRATE`.
* `calibrateAction` ككائن يتضمن تفاصيل الإعدادات المرتبطة بعملية `CALIBRATE` .
  * `calibrationAttributes` كمصفوفة من السمات التي تتطلب المعايرة، وترتبط عادةً بعمود الغلة.
  * `smoothWindowSize` كعدد صحيح فردي يُنعّم قيم النتائج ويقلل القفزات المفاجئة بينها.
  * `conditionPathwiseCalibration` ككائن يتضمن **المعايرة** المسارية، التي تتوافق مع مسارات الآلة. وتُعالج مسارات الآلة كلٌّ على حدة باعتبار كل مسار منطقة مستقلة لأغراض المعايرة.
    * `calibrationBasis` كسلسلة نصية تمثل السمة المستخدمة أساسًا للمعايرة.
    * `maxHomogeneityRegion` كقيمة منطقية تشير إلى ما إذا كانت منطقة التجانس القصوى تُستخدم منطقةً مرجعية للمعايرة.
    * `syntheticMachinePath` كقيمة منطقية تشير إلى محاكاة مسارات الآلة. وتكون مفيدة عند غياب سمة مسار الآلة الدقيقة والحاجة إلى محاكاتها استنادًا إلى الطوابع الزمنية أو سمة مشابهة.
  * `conditionAvgTotalCalibration` ككائن يتضمن **المتوسط/الإجمالي** تركز المعايرة على إعادة توزيع قيم السمات. وتفيد هذه الطريقة إذا كانت الأنماط الجغرافية المكانية دقيقة، لكن القيم المطلقة تختلف عن القيم الفعلية.
    * `calibrationAttribute` كسلسلة نصية تمثل السمة المراد معايرتها.
    * `average` كعدد يمثل متوسط قيم السمة؛ وينبغي أن تتوافق قيم السمة مع هذا المتوسط. يجب استخدام خيار واحد فقط في كل مرة، إما `average` أو `total`.
    * `total` كعدد يمثل مجموع قيم السمة؛ وينبغي أن يطابق مجموع هذه القيم الإجمالي المحدد. يجب استخدام خيار واحد فقط في كل مرة، إما `average` أو `total`.
  * `conditionMinMaxCalibration` ككائن يتضمن **المعايرة** الشرطية، التي تعدّل قيم السمات استنادًا إلى الحدين الأدنى والأقصى المحددين.
    * `calibrationAttribute` كسلسلة نصية تمثل السمة المراد معايرتها.
    * `min` كعدد يمثل أدنى قيم السمة، ويحدد الحد الأدنى لنطاق المعايرة.
    * `minIncluded` كقيمة منطقية تشير إلى ما إذا كان ينبغي تضمين القيمة الدنيا.
    * `max` كعدد يمثل أعلى قيم السمة، ويحدد الحد الأعلى لنطاق المعايرة.
    * `maxIncluded` كقيمة منطقية تشير إلى ما إذا كان ينبغي تضمين القيمة القصوى.
* `cleanAction` ككائن يتضمن تفاصيل الإعدادات المرتبطة بعملية `CLEAN` .
  * `conditionAutoClean` ككائن يتضمن الإعدادات الخاصة بخوارزمية التنظيف التلقائي.
    * `targetAttribute` كسلسلة نصية تمثل قيم الغلة المستهدفة.
    * `excludedAttributes` كقائمة من السلاسل النصية التي تحدد السمات التي لا تؤثر في عملية التنظيف.
  * `conditionMinMaxClean` كقائمة من الكائنات التي تتضمن قواعد التنظيف الموضحة؛ ويشمل كل كائن المعلمات التالية.
    * cleanAttribute كسلسلة نصية تحدد اسم العمود الذي تنطبق عليه القاعدة.
    * `min` كعدد يشير إلى الحد الأدنى للقيمة.
    * `max` كعدد يشير إلى الحد الأقصى للقيمة.

{% hint style="info" %}
لعرض المدخلات والوصول إلى أحدث القيم المتاحة للتعدادات (مثل `operations`)، يُوصى باستخدام [Altair](https://docs.geopard.tech/geopard-tutorials/ar/wthaeq-wajhh-brmjh-alttbyqat/getting-started-with-the-geopard-api.md).
{% endhint %}

### توثيق: استعلام YieldDataset

بصفتك مستخدمًا لواجهة GeoPard API، يمكنك استرجاع تفاصيل التصحيحات المطبقة على مجموعات بيانات الغلة (YieldDatasets) عبر السمتين `appliedCorrections` و `appliedCorrectionsVersion`. توفّر السمة الأولى قائمة بالتصحيحات التي أُجريت (مثل `CALIBRATE` و `CLEAN`), ويُحدَّد ترتيب تنفيذها بحسب تسلسلها في المصفوفة. أما `appliedCorrectionsVersion` فتشير إلى إصدار الخوارزمية المستخدمة.

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

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

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.geopard.tech/geopard-tutorials/ar/wthaeq-wajhh-brmjh-alttbyqat/geopard-api-requests-overview/84.-mutation-calibrate-and-clean-yielddataset.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
