24.1.12. أدوات مصمّم النماذج

تحذير

لا تتوفر هذه الأدوات إلا في مصمّم النماذج، وليست متاحة في صندوق أدوات المعالجة.

24.1.12.1. حساب تعبير

Added in 3.34

تحسب نتيجة تعبير QGIS وتُغني عن استخدام التعبير نفسه عدة مرات داخل النموذج عندما تكون النتيجة نفسها مطلوبة أكثر من مرة. كما تتيح حالات استخدام لم تكن ممكنة بغير ذلك. فعلى سبيل المثال، يمكنك توليد قيمة طابع زمني مرة واحدة واستخدامها عدة مرات داخل النموذج، إذ لو أُعيد حساب الطابع الزمني في كل مرة لاختلفت القيم أثناء تشغيل النموذج.

المعاملات

Label	اﻷسم	النوع	وصف
المدخلات	INPUT	[expression]	التعبير المراد حسابه

المخرجات

Label	اﻷسم	النوع	وصف
القيمة	OUTPUT	[Result Value]	قيمة النتيجة المحسوبة، ويختلف نوع بيانات المخرجات بحسب التعبير المستخدم في الخوارزمية.

شيفرة Python

معرّف الخوارزمية: native:calculateexpression

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.2. فرع شرطي

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

المعاملات

Label	اﻷسم	النوع	وصف
الحقل	BRANCH	[string]	اسم الشرط
الحقل	CONDITION	[expression]	التعبير المراد تقييمه

المخرجات

لا شيء.

شيفرة Python

معرّف الخوارزمية: native:condition

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.3. إنشاء مجلد

تُنشئ مجلدًا جديدًا في نظام الملفات. تُنشأ المجلدات بشكل تعاودي، إذ تُنشأ جميع المجلدات الأب اللازمة بالترتيب لتكوين مسار المجلد الكامل المحدد. لن تظهر أي أخطاء إذا كان المجلد موجودًا مسبقًا.

المعاملات

Label	اﻷسم	النوع	وصف
مسار المجلد	PATH	[string]	مسار المجلد المراد إنشاؤه

المخرجات

Label	اﻷسم	النوع	وصف
المخرجات	OUTPUT	[folder]	المجلد المُنشأ

شيفرة Python

معرّف الخوارزمية: native:createdirectory

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.4. مرشّح المعالم

ترشّح المعالم من الطبقة المدخلة وتعيد توجيهها إلى مخرج واحد أو عدة مخرجات. إذا لم تكن تعرف أسماء سمات مشتركة بين جميع الطبقات المدخلة المحتملة، فلا تكون التصفية ممكنة إلا على الشكل الهندسي للمعالم وآليات السجلات العامة، مثل $id و uuid.

المعاملات

Label	اﻷسم	النوع	وصف
الطبقة المدخلة	INPUT	[vector: any]	الطبقة المدخلة.
المخرجات والمرشّحات (واحد أو أكثر)	OUTPUT_<name of the filter>	[same as input]	الطبقات الناتجة مع المرشّحات (بعدد المرشّحات).

المخرجات

Label	اﻷسم	النوع	وصف
المخرجات (واحد أو أكثر)	native:filter_1:OUTPUT_<name of filter>	[same as input]	الطبقات الناتجة التي تحتوي على المعالم المرشَّحة (بعدد المرشّحات).

شيفرة Python

معرّف الخوارزمية: native:filter

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.5. ترشيح الطبقات حسب النوع

ترشّح الطبقات حسب نوعها. تُوجَّه الطبقات الواردة إلى مخرجات مختلفة بحسب ما إذا كانت طبقة متجهية أو شبكية.

المعاملات

Label	اﻷسم	النوع	وصف
الطبقة المدخلة	INPUT	[layer]	طبقة خريطة عامة

المخرجات

Label	اﻷسم	النوع	وصف
المعالم المتجهية اختياري	VECTOR	[vector]	طبقة متجهية من المدخلات، إن كانت متوافقة
الطبقة الشبكية اختياري	RASTER	[raster]	طبقة شبكية من المدخلات، إن كانت متوافقة

شيفرة Python

معرّف الخوارزمية: native:filterlayersbytype

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.6. تحميل طبقة إلى المشروع

تحمّل طبقة إلى المشروع الحالي.

المعاملات

Label	اﻷسم	النوع	وصف
الطبقة	INPUT	[layer]	الطبقة المراد تحميلها في مفتاح الخريطة
اسم الطبقة المحمّلة	NAME	[string]	اسم الطبقة المحمّلة

المخرجات

Label	اﻷسم	النوع	وصف
الطبقة	OUTPUT	[same as input]	الطبقة المحمّلة (بعد إعادة تسميتها)

شيفرة Python

معرّف الخوارزمية: native:loadlayer

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.7. إطلاق استثناء

تُطلق استثناءً وتلغي تنفيذ النموذج. يمكن تخصيص رسالة الاستثناء، كما يمكن اختياريًا تحديد شرط قائم على تعبير. عند استخدام شرط تعبير، لا يُطلق الاستثناء إلا إذا كانت نتيجة التعبير صحيحة (true). أما النتيجة الخاطئة (false) فتعني عدم إطلاق أي استثناء، ويمكن أن يستمر تنفيذ النموذج دون انقطاع.

المعاملات

Label	اﻷسم	النوع	وصف
الرسالة	MESSAGE	[string]	الرسالة المراد عرضها
الشرط اختياري	CONDITION	[expression]	التعبير المراد تقييم صحته

المخرجات

رسالة في لوحة السجل.

شيفرة Python

معرّف الخوارزمية: native:raiseexception

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.8. إطلاق رسالة

تُطلق رسالة معلومات في السجل. يمكن تخصيص الرسالة، كما يمكن اختياريًا تحديد شرط قائم على تعبير. عند استخدام شرط تعبير، لا تُسجَّل الرسالة إلا إذا كانت نتيجة التعبير صحيحة (true). أما النتيجة الخاطئة (false) فتعني عدم تسجيل أي رسالة.

المعاملات

Label	اﻷسم	النوع	وصف
رسالة المعلومات	MESSAGE	[string]	الرسالة المراد عرضها
الشرط اختياري	CONDITION	[expression]	التعبير المراد تقييم صحته

المخرجات

رسالة في لوحة السجل.

شيفرة Python

معرّف الخوارزمية: native:raisemessage

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.9. إطلاق تحذير

تُطلق رسالة تحذير في السجل. يمكن تخصيص رسالة التحذير، كما يمكن اختياريًا تحديد شرط قائم على تعبير. عند استخدام شرط تعبير، لا يُسجَّل التحذير إلا إذا كانت نتيجة التعبير صحيحة (true). أما النتيجة الخاطئة (false) فتعني عدم تسجيل أي تحذير.

المعاملات

Label	اﻷسم	النوع	وصف
الرسالة	MESSAGE	[string]	الرسالة المراد عرضها
الشرط اختياري	CONDITION	[expression]	التعبير المراد تقييم صحته

المخرجات

رسالة في لوحة السجل.

شيفرة Python

معرّف الخوارزمية: native:raisewarning

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.10. إعادة تسمية طبقة

تعيد تسمية طبقة.

المعاملات

Label	اﻷسم	النوع	وصف
الطبقة	INPUT	[layer]	الطبقة المراد إعادة تسميتها
الاسم الجديد	NAME	[string]	الاسم الجديد للطبقة

المخرجات

Label	اﻷسم	النوع	وصف
الطبقة	OUTPUT	[same as input]	الطبقة الناتجة (بعد إعادة تسميتها)

شيفرة Python

معرّف الخوارزمية: native:renamelayer

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.11. حفظ السجل في ملف

تحفظ سجل تنفيذ النموذج في ملف. ويمكن اختياريًا حفظ السجل بصيغة HTML منسّقة.

المعاملات

Label	اﻷسم	النوع	وصف
استخدام HTML	USE_HTML	[Boolean] الافتراضي: False	استخدام تنسيق HTML

المخرجات

Label	اﻷسم	النوع	وصف
الملف	OUTPUT	[string]	وجهة حفظ السجل

شيفرة Python

معرّف الخوارزمية: native:savelog

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.12. تعيين متغير للمشروع

تعيّن متغير تعبير للمشروع الحالي.

المعاملات

Label	اﻷسم	النوع	وصف
اسم المتغير	NAME	[string]	اسم المتغير
قيمة المتغير	VALUE	[string]	القيمة المراد تخزينها

المخرجات

لا شيء.

شيفرة Python

معرّف الخوارزمية: native:setprojectvariable

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.13. ضمّ السلاسل النصية

تضمّ سلسلتين نصيتين في سلسلة واحدة داخل مصمّم نماذج المعالجة.

المعاملات

Label	اﻷسم	النوع	وصف
المدخل 1	INPUT_1	[string]	السلسلة النصية الأولى
المدخل 2	INPUT_2	[string]	السلسلة النصية الثانية

المخرجات

Label	اﻷسم	النوع	وصف
الضمّ	CONCATENATION	[string]	السلسلة النصية الناتجة عن الضمّ

شيفرة Python

معرّف الخوارزمية: native:stringconcatenation

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.12.14. نطاق عازل بمسافة متغيرة

تحذير

هذه الخوارزمية مهملة وقد تُزال في أي وقت. يُفضَّل استخدام خوارزمية Buffer (النطاق العازل) بدلًا منها.

تحسب منطقة نطاق عازل لجميع المعالم في الطبقة المدخلة.

يُحدَّد حجم النطاق العازل لكل معلم بواسطة سمة، مما يسمح بأن يكون للمعالم المختلفة أحجام مختلفة من النطاق العازل.

شاهد أيضا

Buffer (النطاق العازل)

المعاملات

Label	اﻷسم	النوع	وصف
الطبقة المدخلة	INPUT	[vector: any]	الطبقة المتجهية المدخلة
حقل المسافة	DISTANCE	[tablefield: numeric]	السمة التي تحدد نصف قطر النطاق العازل
المقاطع	SEGMENTS	[numeric: integer] الافتراضي: 5	يتحكم في عدد المقاطع الخطية المستخدمة لتقريب ربع الدائرة عند إنشاء الإزاحات المستديرة.
دمج النتيجة	DISSOLVE	[boolean] الافتراضي: False	اختر دمج النطاق العازل النهائي، لينتج عن ذلك معلم واحد يغطي جميع المعالم المدخلة. شكل 24.30 نطاق عازل عادي ونطاق عازل مدموج
نمط نهاية الخط	END_CAP_STYLE	[enumeration] الافتراضي: Round	يتحكم في طريقة معالجة نهايات الخطوط في النطاق العازل. شكل 24.31 أنماط النهايات المستديرة والمسطّحة والمربّعة
نمط الوصل	JOIN_STYLE	[enumeration] الافتراضي: Round	يحدد ما إذا كان يجب استخدام وصلات مستديرة أو حادّة (miter) أو مشطوفة عند إزاحة الزوايا في الخط.
حدّ الوصل الحادّ (Miter)	MITER_LIMIT	[numeric: double] الافتراضي: 2.0	لا ينطبق إلا على أنماط الوصل الحادّ (miter)، ويتحكم في أقصى مسافة عن منحنى الإزاحة تُستخدم عند إنشاء وصلة حادّة.

المخرجات

Label	اﻷسم	النوع	وصف
النطاق العازل	OUTPUT	[vector: polygon]	طبقة متجهية مضلعة للنطاق العازل.

شيفرة Python

معرّف الخوارزمية: qgis:variabledistancebuffer

import processing
processing.run("algorithm_id", {parameter_dictionary})

يُعرض معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. ويوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.