6. استخدام الطبقات المتجهية

تلميح

تحتاج مقتطفات الشيفرة في هذه الصفحة إلى عمليات الاستيراد التالية إذا كنت خارج وحدة تحكم pyqgis:

from qgis.core import (
  QgsApplication,
  QgsDataSourceUri,
  QgsCategorizedSymbolRenderer,
  QgsClassificationRange,
  QgsPointXY,
  QgsProject,
  QgsExpression,
  QgsField,
  QgsFields,
  QgsFeature,
  QgsFeatureRequest,
  QgsFeatureRenderer,
  QgsGeometry,
  QgsGraduatedSymbolRenderer,
  QgsMarkerSymbol,
  QgsMessageLog,
  QgsRectangle,
  QgsRendererCategory,
  QgsRendererRange,
  QgsSymbol,
  QgsVectorDataProvider,
  QgsVectorLayer,
  QgsVectorFileWriter,
  QgsWkbTypes,
  QgsSpatialIndex,
  QgsVectorLayerUtils
)

from qgis.core.additions.edit import edit

from qgis.PyQt.QtGui import (
    QColor,
)

يلخّص هذا القسم إجراءات مختلفة يمكن تنفيذها على الطبقات المتجهية.

يعتمد معظم العمل هنا على دوال الصنف QgsVectorLayer.

6.1. استرجاع المعلومات عن البيانات الوصفية

يمكنك استرجاع معلومات عن الحقول المرتبطة بطبقة متجهية باستدعاء fields() على كائن من نوع QgsVectorLayer:

vlayer = QgsVectorLayer("testdata/data/data.gpkg|layername=airports", "Airports layer", "ogr")
for field in vlayer.fields():
    print(field.name(), field.typeName())

fid Integer64
id Integer64
scalerank Integer64
featurecla String
type String
name String
abbrev String
location String
gps_code String
iata_code String
wikipedia String
natlscale Real

توفر الدالتان displayField() و mapTipTemplate() معلومات عن الحقل والقالب المستخدمين في التبويب خصائص العرض.

عند تحميل طبقة متجهية، يختار QGIS دائمًا حقلًا ليكون Display Name، بينما يكون HTML Map Tip فارغًا افتراضيًا. وباستخدام هاتين الدالتين يمكنك الحصول على كليهما بسهولة:

vlayer = QgsVectorLayer("testdata/data/data.gpkg|layername=airports", "Airports layer", "ogr")
print(vlayer.displayField())

name

ملاحظة

إذا غيّرت Display Name من حقل إلى تعبير، فعليك استخدام displayExpression() بدلًا من displayField().

6.2. التكرار على الطبقة المتجهية

التكرار على معالم طبقة متجهية من أكثر المهام شيوعًا. فيما يلي مثال على شيفرة أساسية بسيطة لتنفيذ هذه المهمة وعرض بعض المعلومات عن كل معلم. ويُفترض أن المتغير layer يحتوي على كائن من نوع QgsVectorLayer.

# "layer" is a QgsVectorLayer instance
layer = iface.activeLayer()
features = layer.getFeatures()

for feature in features:
    # retrieve every feature with its geometry and attributes
    print("Feature ID: ", feature.id())
    # fetch geometry
    # show some information about the feature geometry
    geom = feature.geometry()
    geomSingleType = QgsWkbTypes.isSingleType(geom.wkbType())
    if geom.type() == QgsWkbTypes.PointGeometry:
        # the geometry type can be of single or multi type
        if geomSingleType:
            x = geom.asPoint()
            print("Point: ", x)
        else:
            x = geom.asMultiPoint()
            print("MultiPoint: ", x)
    elif geom.type() == QgsWkbTypes.LineGeometry:
        if geomSingleType:
            x = geom.asPolyline()
            print("Line: ", x, "length: ", geom.length())
        else:
            x = geom.asMultiPolyline()
            print("MultiLine: ", x, "length: ", geom.length())
    elif geom.type() == QgsWkbTypes.PolygonGeometry:
        if geomSingleType:
            x = geom.asPolygon()
            print("Polygon: ", x, "Area: ", geom.area())
        else:
            x = geom.asMultiPolygon()
            print("MultiPolygon: ", x, "Area: ", geom.area())
    else:
        print("Unknown or invalid geometry")
    # fetch attributes
    attrs = feature.attributes()
    # attrs is a list. It contains all the attribute values of this feature
    print(attrs)
    # for this test only print the first feature
    break

Feature ID:  1
Point:  <QgsPointXY: POINT(7 45)>
[1, 'First feature']

6.3. تحديد المعالم

في QGIS لسطح المكتب، يمكن تحديد المعالم بطرق مختلفة: إذ يمكن للمستخدم النقر على معلم، أو رسم مستطيل على لوحة الخريطة، أو استخدام مرشِّح تعبير. وعادةً ما تُبرَز المعالم المحددة بلون مختلف (الأصفر افتراضيًا) للفت انتباه المستخدم إلى التحديد.

قد يكون من المفيد أحيانًا تحديد المعالم برمجيًا أو تغيير اللون الافتراضي.

لتحديد جميع المعالم، يمكن استخدام الدالة selectAll():

# Get the active layer (must be a vector layer)
layer = iface.activeLayer()
layer.selectAll()

للتحديد باستخدام تعبير، استخدم الدالة selectByExpression():

# Assumes that the active layer is points.shp file from the QGIS test suite
# (Class (string) and Heading (number) are attributes in points.shp)
layer = iface.activeLayer()
layer.selectByExpression('"Class"=\'B52\' and "Heading" > 10 and "Heading" <70', QgsVectorLayer.SetSelection)

لتغيير لون التحديد يمكنك استخدام الدالة setSelectionColor() من QgsMapCanvas كما هو موضح في المثال التالي:

iface.mapCanvas().setSelectionColor( QColor("red") )

لإضافة معالم إلى قائمة المعالم المحددة لطبقة معينة، يمكنك استدعاء select() وتمرير قائمة معرّفات المعالم إليها:

selected_fid = []

# Get the first feature id from the layer
feature = next(layer.getFeatures())
if feature:
    selected_fid.append(feature.id())

# Add that features to the selected list
layer.select(selected_fid)

لمسح التحديد:

layer.removeSelection()

6.3.1. الوصول إلى البيانات الوصفية

يمكن الإشارة إلى البيانات الوصفية بأسمائها:

print(feature['name'])

First feature

بدلًا من ذلك، يمكن الإشارة إلى البيانات الوصفية بفهرسها. وهذا أسرع قليلًا من استخدام الاسم. على سبيل المثال، للحصول على السمة الثانية:

print(feature[1])

First feature

6.3.2. التكرار على المعالم المحددة

إذا كنت تحتاج إلى المعالم المحددة فقط، فيمكنك استخدام الدالة selectedFeatures() من الطبقة المتجهية:

selection = layer.selectedFeatures()
for feature in selection:
    # do whatever you need with the feature
    pass

6.3.3. التكرار على مجموعة فرعية من المعالم

إذا أردت التكرار على مجموعة فرعية معينة من المعالم في طبقة، مثل تلك الواقعة داخل منطقة معينة، فعليك إضافة كائن من نوع QgsFeatureRequest إلى استدعاء getFeatures(). إليك مثالًا:

areaOfInterest = QgsRectangle(450290,400520, 450750,400780)

request = QgsFeatureRequest().setFilterRect(areaOfInterest)

for feature in layer.getFeatures(request):
    # do whatever you need with the feature
    pass

لأجل السرعة، كثيرًا ما يُجرى التقاطع باستخدام المستطيل المحيط بالمعلم فقط. لكن هناك علامة ExactIntersect تضمن ألّا تُعاد إلا المعالم المتقاطعة فعلًا:

request = QgsFeatureRequest().setFilterRect(areaOfInterest) \
                             .setFlags(QgsFeatureRequest.ExactIntersect)

باستخدام setLimit() يمكنك تحديد عدد المعالم المطلوبة. إليك مثالًا:

request = QgsFeatureRequest()
request.setLimit(2)
for feature in layer.getFeatures(request):
    print(feature)

<qgis._core.QgsFeature object at 0x7f9b78590948>
<qgis._core.QgsFeature object at 0x7faef5881670>

إذا كنت تحتاج إلى مرشِّح قائم على البيانات الوصفية بدلًا من المرشِّح المكاني (أو بالإضافة إليه) كما في الأمثلة أعلاه، فيمكنك بناء كائن من نوع QgsExpression وتمريره إلى مُنشئ QgsFeatureRequest. إليك مثالًا:

# The expression will filter the features where the field "location_name"
# contains the word "Lake" (case insensitive)
exp = QgsExpression('location_name ILIKE \'%Lake%\'')
request = QgsFeatureRequest(exp)

راجع التعبيرات والتصفية وحساب القيم للاطلاع على تفاصيل الصياغة التي يدعمها QgsExpression.

يمكن استخدام الطلب لتحديد البيانات المسترجعة لكل معلم، بحيث يُعيد المُكرِّر جميع المعالم لكنه يُعيد بيانات جزئية لكل منها.

# Only return selected fields to increase the "speed" of the request
request.setSubsetOfAttributes([0,2])

# More user friendly version
request.setSubsetOfAttributes(['name','id'],layer.fields())

# Don't return geometry objects to increase the "speed" of the request
request.setFlags(QgsFeatureRequest.NoGeometry)

# Fetch only the feature with id 45
request.setFilterFid(45)

# The options may be chained
request.setFilterRect(areaOfInterest).setFlags(QgsFeatureRequest.NoGeometry).setFilterFid(45).setSubsetOfAttributes([0,2])

6.4. تعديل الطبقات المتجهية

تدعم معظم مزوّدات البيانات المتجهية تحرير بيانات الطبقة. وأحيانًا لا تدعم إلا مجموعة فرعية من إجراءات التحرير الممكنة. استخدم الدالة capabilities() لمعرفة مجموعة الوظائف المدعومة.

caps = layer.dataProvider().capabilities()
# Check if a particular capability is supported:
if caps & QgsVectorDataProvider.DeleteFeatures:
    print('The layer supports DeleteFeatures')

The layer supports DeleteFeatures

للاطلاع على قائمة بجميع القدرات المتاحة، يُرجى الرجوع إلى API Documentation of QgsVectorDataProvider.

لطباعة الوصف النصي لقدرات الطبقة في قائمة مفصولة بفواصل، يمكنك استخدام capabilitiesString() كما في المثال التالي:

caps_string = layer.dataProvider().capabilitiesString()
# Print:
# 'Add Features, Delete Features, Change Attribute Values, Add Attributes,
# Delete Attributes, Rename Attributes, Fast Access to Features at ID,
# Presimplify Geometries, Presimplify Geometries with Validity Check,
# Transactions, Curved Geometries'

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

ملاحظة

إذا كنت تعمل داخل QGIS (سواء من وحدة التحكم أو من إضافة)، فقد يكون من الضروري فرض إعادة رسم لوحة الخريطة لرؤية التغييرات التي أجريتها على الشكل الهندسي أو النمط أو البيانات الوصفية:

# If caching is enabled, a simple canvas refresh might not be sufficient
# to trigger a redraw and you must clear the cached image for the layer
if iface.mapCanvas().isCachingEnabled():
    layer.triggerRepaint()
else:
    iface.mapCanvas().refresh()

6.4.1. إضافة معالم

أنشئ بعض نسخ QgsFeature ومرّر قائمة بها إلى الدالة addFeatures() الخاصة بالمزوّد QgsVectorDataProvider. وستُعيد قيمتين: النتيجة (True أو False) وقائمة المعالم المضافة (يُعيِّن مخزن البيانات معرّفاتها).

لإعداد البيانات الوصفية للمعلم، يمكنك إما تهيئة المعلم بتمرير كائن من نوع QgsFields (يمكنك الحصول عليه من الدالة fields() الخاصة بالطبقة المتجهية) أو استدعاء initAttributes() مع تمرير عدد الحقول التي تريد إضافتها.

if caps & QgsVectorDataProvider.AddFeatures:
    feat = QgsFeature(layer.fields())
    feat.setAttributes([0, 'hello'])
    # Or set a single attribute by key or by index:
    feat.setAttribute('name', 'hello')
    feat.setAttribute(0, 'hello')
    feat.setGeometry(QgsGeometry.fromPointXY(QgsPointXY(123, 456)))
    (res, outFeats) = layer.dataProvider().addFeatures([feat])

6.4.2. حذف معالم

لحذف بعض المعالم، يكفي تقديم قائمة بمعرّفاتها.

if caps & QgsVectorDataProvider.DeleteFeatures:
    res = layer.dataProvider().deleteFeatures([5, 10])

6.4.3. تعديل معالم

يمكن إما تغيير الشكل الهندسي للمعلم أو تغيير بعض بياناته الوصفية. يغيّر المثال التالي أولًا قيم البيانات الوصفية ذات الفهرسين 0 و1، ثم يغيّر الشكل الهندسي للمعلم.

fid = 100   # ID of the feature we will modify

if caps & QgsVectorDataProvider.ChangeAttributeValues:
    attrs = { 0 : "hello", 1 : 123 }
    layer.dataProvider().changeAttributeValues({ fid : attrs })

if caps & QgsVectorDataProvider.ChangeGeometries:
    geom = QgsGeometry.fromPointXY(QgsPointXY(111,222))
    layer.dataProvider().changeGeometryValues({ fid : geom })

نصيحة

فضِّل الصنف QgsVectorLayerEditUtils لتحرير الأشكال الهندسية فقط

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

6.4.4. تعديل الطبقات المتجهية باستخدام مخزن التحرير المؤقت

عند تحرير البيانات المتجهية داخل تطبيق QGIS، عليك أولًا بدء وضع التحرير لطبقة معينة، ثم إجراء بعض التعديلات، وأخيرًا حفظ التغييرات (أو التراجع عنها). ولا تُكتب أي تغييرات تجريها حتى تحفظها --- بل تبقى في مخزن التحرير المؤقت للطبقة في الذاكرة. ويمكن استخدام هذه الوظيفة برمجيًا أيضًا --- فهي مجرد طريقة أخرى لتحرير الطبقة المتجهية تكمّل الاستخدام المباشر لمزوّدات البيانات. استخدم هذا الخيار عند توفير أدوات واجهة رسومية لتحرير الطبقة المتجهية، إذ يتيح ذلك للمستخدم أن يقرر الحفظ أو التراجع، ويتيح استخدام التراجع/الإعادة. وعند حفظ التغييرات، تُحفظ جميع التغييرات الموجودة في مخزن التحرير المؤقت في مزوّد البيانات.

الدوال مشابهة لتلك التي رأيناها في المزوّد، لكنها تُستدعى على كائن QgsVectorLayer بدلًا منه.

لكي تعمل هذه الدوال، يجب أن تكون الطبقة في وضع التحرير. لبدء وضع التحرير، استخدم الدالة startEditing(). ولإيقاف التحرير، استخدم الدالة commitChanges() أو rollBack(). فالأولى ستحفظ جميع تغييراتك في مصدر البيانات، بينما ستتجاهلها الثانية ولن تعدّل مصدر البيانات إطلاقًا.

لمعرفة ما إذا كانت الطبقة في وضع التحرير، استخدم الدالة isEditable().

إليك بعض الأمثلة التي توضح كيفية استخدام دوال التحرير هذه.

from qgis.PyQt.QtCore import QMetaType

feat1 = feat2 = QgsFeature(layer.fields())
fid = 99
feat1.setId(fid)

# add two features (QgsFeature instances)
layer.addFeatures([feat1,feat2])
# delete a feature with specified ID
layer.deleteFeature(fid)

# set new geometry (QgsGeometry instance) for a feature
geometry = QgsGeometry.fromWkt("POINT(7 45)")
layer.changeGeometry(fid, geometry)
# update an attribute with given field index (int) to a given value
fieldIndex =1
value ='My new name'
layer.changeAttributeValue(fid, fieldIndex, value)

# add new field
layer.addAttribute(QgsField("mytext", QMetaType.Type.QString))
# remove a field
layer.deleteAttribute(fieldIndex)

لكي يعمل التراجع/الإعادة بشكل صحيح، يجب تغليف الاستدعاءات المذكورة أعلاه في أوامر تراجع. (إذا لم يكن التراجع/الإعادة يهمك وتريد تخزين التغييرات فورًا، فسيكون عملك أسهل عبر التحرير باستخدام مزوّد البيانات.)

إليك كيفية استخدام وظيفة التراجع:

layer.beginEditCommand("Feature triangulation")

# ... call layer's editing methods ...

if problem_occurred:
  layer.destroyEditCommand()
  # ... tell the user that there was a problem
  # and return

# ... more editing ...

layer.endEditCommand()

ستُنشئ الدالة beginEditCommand() أمرًا داخليًا "نشطًا" وستسجّل التغييرات اللاحقة في الطبقة المتجهية. ومع استدعاء endEditCommand() يُدفع الأمر إلى مكدّس التراجع، وسيتمكن المستخدم من التراجع عنه أو إعادته من الواجهة الرسومية. وفي حال حدوث خطأ أثناء إجراء التغييرات، ستزيل الدالة destroyEditCommand() الأمر وتتراجع عن جميع التغييرات التي أُجريت أثناء نشاط هذا الأمر.

يمكنك أيضًا استخدام العبارة with edit(layer) لتغليف الحفظ والتراجع في كتلة شيفرة أوضح دلالةً كما هو موضح في المثال أدناه:

with edit(layer):
  feat = next(layer.getFeatures())
  feat[0] = 5
  layer.updateFeature(feat)

سيستدعي هذا تلقائيًا commitChanges() في النهاية. وإذا وقع أي استثناء، فسيُنفّذ rollBack() للتراجع عن جميع التغييرات. وفي حال مواجهة مشكلة داخل commitChanges() (عندما تُعيد الدالة False) سيُطلق استثناء QgsEditError.

6.4.5. إضافة الحقول وإزالتها

لإضافة حقول (بيانات وصفية)، عليك تحديد قائمة بتعريفات الحقول. ولحذف الحقول يكفي تقديم قائمة بفهارس الحقول.

from qgis.PyQt.QtCore import QMetaType

if caps & QgsVectorDataProvider.AddAttributes:
    res = layer.dataProvider().addAttributes(
        [QgsField("mytext", QMetaType.Type.QString),
        QgsField("myint", QMetaType.Type.Int)])

if caps & QgsVectorDataProvider.DeleteAttributes:
    res = layer.dataProvider().deleteAttributes([0])

# Alternate methods for removing fields
# first create temporary fields to be removed (f1-3)
layer.dataProvider().addAttributes([QgsField("f1", QMetaType.Type.Int),
                                    QgsField("f2", QMetaType.Type.Int),
                                    QgsField("f3", QMetaType.Type.Int)])
layer.updateFields()
count=layer.fields().count() # count of layer fields
ind_list=list((count-3, count-2)) # create list

# remove a single field with an index
layer.dataProvider().deleteAttributes([count-1])

# remove multiple fields with a list of indices
layer.dataProvider().deleteAttributes(ind_list)

بعد إضافة الحقول أو إزالتها في مزوّد البيانات، يجب تحديث حقول الطبقة لأن التغييرات لا تنتقل تلقائيًا.

layer.updateFields()

نصيحة

احفظ التغييرات مباشرةً باستخدام with أمر قائم عليها

باستخدام with edit(layer): ستُحفظ التغييرات تلقائيًا باستدعاء commitChanges() في النهاية. وإذا وقع أي استثناء، فسيُنفّذ rollBack() للتراجع عن جميع التغييرات. راجع تعديل الطبقات المتجهية باستخدام مخزن التحرير المؤقت.

6.5. استخدام الفهرس المكاني

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

تخيّل الطبقة التي لا تملك فهرسًا مكانيًا كدليل هاتف أرقامه غير مرتبة وغير مفهرسة. فالطريقة الوحيدة للعثور على رقم هاتف شخص معين هي القراءة من البداية حتى تعثر عليه.

لا تُنشأ الفهارس المكانية افتراضيًا لطبقة QGIS المتجهية، لكن يمكنك إنشاؤها بسهولة. وهذا ما عليك فعله:

• أنشئ فهرسًا مكانيًا باستخدام الصنف QgsSpatialIndex:

  index = QgsSpatialIndex()
  

• أضف المعالم إلى الفهرس --- يأخذ الفهرس كائن QgsFeature ويضيفه إلى بنية البيانات الداخلية. ويمكنك إنشاء الكائن يدويًا أو استخدام كائن ناتج عن استدعاء سابق للدالة getFeatures() الخاصة بالمزوّد.

  index.addFeature(feat)
  

• بدلًا من ذلك، يمكنك تحميل جميع معالم الطبقة دفعة واحدة باستخدام التحميل المجمَّع

  index = QgsSpatialIndex(layer.getFeatures())
  

• بعد ملء الفهرس المكاني ببعض القيم، يمكنك إجراء بعض الاستعلامات

  # returns array of feature IDs of five nearest features
  nearest = index.nearestNeighbor(QgsPointXY(25.4, 12.7), 5)
  
  # returns array of IDs of features which intersect the rectangle
  intersect = index.intersects(QgsRectangle(22.5, 15.3, 23.1, 17.2))
  

يمكنك أيضًا استخدام الفهرس المكاني QgsSpatialIndexKDBush. وهذا الفهرس مشابه لـ QgsSpatialIndex القياسي لكنه:

• يدعم فقط المعالم النقطية المفردة

• ثابت (لا يمكن إضافة معالم أخرى إلى الفهرس بعد إنشائه)

• أسرع بكثير!

• يتيح الاسترجاع المباشر لنقاط المعالم الأصلية، دون الحاجة إلى طلبات معالم إضافية

• يدعم عمليات بحث حقيقية قائمة على المسافة، أي إعادة جميع النقاط الواقعة ضمن نصف قطر معين من نقطة البحث

6.6. الصنف QgsVectorLayerUtils

يحتوي الصنف QgsVectorLayerUtils على بعض الدوال المفيدة جدًا التي يمكنك استخدامها مع الطبقات المتجهية.

على سبيل المثال، تُعِدّ الدالة createFeature() كائن QgsFeature لإضافته إلى طبقة متجهية مع الحفاظ على جميع القيود المحتملة والقيم الافتراضية لكل حقل:

vlayer = QgsVectorLayer("testdata/data/data.gpkg|layername=airports", "Airports layer", "ogr")
feat = QgsVectorLayerUtils.createFeature(vlayer)

تتيح لك الدالة getValues() الحصول بسرعة على قيم حقل أو تعبير:

vlayer = QgsVectorLayer("testdata/data/data.gpkg|layername=airports", "Airports layer", "ogr")
# select only the first feature to make the output shorter
vlayer.selectByIds([1])
val = QgsVectorLayerUtils.getValues(vlayer, "NAME", selectedOnly=True)
print(val)

(['Sahnewal'], True)

6.7. إنشاء الطبقات المتجهية

هناك عدة طرق لتوليد مجموعة بيانات لطبقة متجهية:

• الصنف QgsVectorFileWriter: صنف ملائم لكتابة الملفات المتجهية على القرص، إما باستدعاء ساكن للدالة writeAsVectorFormatV3() التي تحفظ الطبقة المتجهية كاملة، أو بإنشاء نسخة من الصنف وإجراء استدعاءات للدالة الموروثة addFeature(). ويدعم هذا الصنف جميع الصيغ المتجهية التي يدعمها GDAL (مثل GeoPackage وShapefile وGeoJSON وKML وغيرها).

• الصنف QgsVectorLayer: يُنشئ نسخة من مزوّد بيانات يفسّر المسار (url) المقدَّم لمصدر البيانات للاتصال بالبيانات والوصول إليها. ويمكن استخدامه لإنشاء طبقات مؤقتة قائمة على الذاكرة (memory) والاتصال بمجموعات بيانات GDAL المتجهية (ogr) وقواعد البيانات (postgres و spatialite و mysql و mssql) وغيرها (wfs و gpx و delimitedtext...).

6.7.1. من نسخة من QgsVectorFileWriter

# SaveVectorOptions contains many settings for the writer process
save_options = QgsVectorFileWriter.SaveVectorOptions()
transform_context = QgsProject.instance().transformContext()
# Write to a GeoPackage (default)
error = QgsVectorFileWriter.writeAsVectorFormatV3(layer,
                                                  "testdata/my_new_file.gpkg",
                                                  transform_context,
                                                  save_options)
if error[0] == QgsVectorFileWriter.NoError:
    print("success!")
else:
  print(error)

# Write to an ESRI Shapefile format dataset using UTF-8 text encoding
save_options = QgsVectorFileWriter.SaveVectorOptions()
save_options.driverName = "ESRI Shapefile"
save_options.fileEncoding = "UTF-8"
transform_context = QgsProject.instance().transformContext()
error = QgsVectorFileWriter.writeAsVectorFormatV3(layer,
                                                  "testdata/my_new_shapefile",
                                                  transform_context,
                                                  save_options)
if error[0] == QgsVectorFileWriter.NoError:
    print("success again!")
else:
  print(error)

# Write to an ESRI GDB file
save_options = QgsVectorFileWriter.SaveVectorOptions()
save_options.driverName = "FileGDB"
# if no geometry
save_options.overrideGeometryType = QgsWkbTypes.Unknown
save_options.actionOnExistingFile = QgsVectorFileWriter.CreateOrOverwriteLayer
save_options.layerName = 'my_new_layer_name'
transform_context = QgsProject.instance().transformContext()
gdb_path = "testdata/my_example.gdb"
error = QgsVectorFileWriter.writeAsVectorFormatV3(layer,
                                                gdb_path,
                                                transform_context,
                                                save_options)
if error[0] == QgsVectorFileWriter.NoError:
  print("success!")
else:
  print(error)

يمكنك أيضًا تحويل الحقول لجعلها متوافقة مع صيغ مختلفة باستخدام FieldValueConverter. على سبيل المثال، لتحويل أنواع المتغيرات المصفوفية (كما في Postgres) إلى نوع نصي، يمكنك القيام بما يلي:

LIST_FIELD_NAME = 'xxxx'

class ESRIValueConverter(QgsVectorFileWriter.FieldValueConverter):

  def __init__(self, layer, list_field):
    QgsVectorFileWriter.FieldValueConverter.__init__(self)
    self.layer = layer
    self.list_field_idx = self.layer.fields().indexFromName(list_field)

  def convert(self, fieldIdxInLayer, value):
    if fieldIdxInLayer == self.list_field_idx:
      return QgsListFieldFormatter().representValue(layer=vlayer,
                                                    fieldIndex=self.list_field_idx,
                                                    config={},
                                                    cache=None,
                                                    value=value)
    else:
      return value

  def fieldDefinition(self, field):
    idx = self.layer.fields().indexFromName(field.name())
    if idx == self.list_field_idx:
      return QgsField(LIST_FIELD_NAME, QMetaType.Type.QString)
    else:
      return self.layer.fields()[idx]

converter = ESRIValueConverter(vlayer, LIST_FIELD_NAME)
opts = QgsVectorFileWriter.SaveVectorOptions()
opts.fieldValueConverter = converter

يمكن أيضًا تحديد نظام إحداثيات مرجعي وجهة --- فإذا مُرِّرت نسخة صالحة من QgsCoordinateReferenceSystem كمعامل رابع، تُحوَّل الطبقة إلى ذلك النظام.

لمعرفة أسماء برامج التشغيل (drivers) الصالحة، يُرجى استدعاء الدالة supportedFiltersAndFormats() أو الرجوع إلى supported formats by OGR --- ويجب عليك تمرير القيمة الموجودة في عمود "Code" كاسم لبرنامج التشغيل.

يمكنك اختياريًا تحديد ما إذا كنت تريد تصدير المعالم المحددة فقط، أو تمرير خيارات إنشاء إضافية خاصة ببرنامج التشغيل، أو إخبار أداة الكتابة بعدم إنشاء البيانات الوصفية... وهناك عدد من المعاملات (الاختيارية) الأخرى؛ راجع توثيق QgsVectorFileWriter للتفاصيل.

6.7.2. مباشرةً من المعالم

from qgis.PyQt.QtCore import QMetaType

# define fields for feature attributes. A QgsFields object is needed
fields = QgsFields()
fields.append(QgsField("first", QMetaType.Type.Int))
fields.append(QgsField("second", QMetaType.Type.QString))

""" create an instance of vector file writer, which will create the vector file.
Arguments:
1. path to new file (will fail if exists already)
2. field map
3. geometry type - from WKBTYPE enum
4. layer's spatial reference (instance of
   QgsCoordinateReferenceSystem)
5. coordinate transform context
6. save options (driver name for the output file, encoding etc.)
"""

crs = QgsProject.instance().crs()
transform_context = QgsProject.instance().transformContext()
save_options = QgsVectorFileWriter.SaveVectorOptions()
save_options.driverName = "ESRI Shapefile"
save_options.fileEncoding = "UTF-8"

writer = QgsVectorFileWriter.create(
  "testdata/my_new_shapefile.shp",
  fields,
  QgsWkbTypes.Point,
  crs,
  transform_context,
  save_options
)

if writer.hasError() != QgsVectorFileWriter.NoError:
    print("Error when creating shapefile: ",  writer.errorMessage())

# add a feature
fet = QgsFeature()

fet.setGeometry(QgsGeometry.fromPointXY(QgsPointXY(10,10)))
fet.setAttributes([1, "text"])
writer.addFeature(fet)

# delete the writer to flush features to disk
del writer

6.7.3. من نسخة من QgsVectorLayer

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

يدعم المزوّد الحقول من الأنواع string وint وdouble.

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

يُنشأ مزوّد الذاكرة بتمرير "memory" كسلسلة المزوّد إلى مُنشئ QgsVectorLayer.

يأخذ المُنشئ أيضًا عنوان URI يحدد نوع الشكل الهندسي للطبقة، وهو أحد ما يلي: "Point" أو "LineString" أو "Polygon" أو "MultiPoint" أو "MultiLineString" أو "MultiPolygon" أو "None".

يمكن لعنوان URI أيضًا أن يحدد نظام الإحداثيات المرجعي والحقول وفهرسة مزوّد الذاكرة. والصيغة هي:

crs=definition

يحدد نظام الإحداثيات المرجعي، حيث يمكن أن يكون definition بأي من الصيغ التي تقبلها QgsCoordinateReferenceSystem.createFromString()

index=yes

يحدد أن المزوّد سيستخدم فهرسًا مكانيًا

field=name:type(length,precision) (أي: الاسم:النوع(الطول،الدقة))

يحدد سمة من سمات الطبقة. للسمة اسم، واختياريًا نوع (integer أو double أو string) وطول ودقة. ويمكن أن تكون هناك تعريفات متعددة للحقول.

يتضمن المثال التالي لعنوان URI جميع هذه الخيارات

"Point?crs=epsg:4326&field=id:integer&field=name:string(20)&index=yes"

توضّح الشيفرة المثال التالية إنشاء مزوّد ذاكرة وملأه بالبيانات

from qgis.PyQt.QtCore import QDateTime, QMetaType, Qt

# create layer
vl = QgsVectorLayer("Point", "temporary_points", "memory")
pr = vl.dataProvider()

# add fields
pr.addAttributes([QgsField("name", QMetaType.Type.QString),
                    QgsField("age",  QMetaType.Type.Int),
                    QgsField("size", QMetaType.Type.Double),
                    QgsField("birthday", QMetaType.Type.QDateTime)])
vl.updateFields() # tell the vector layer to fetch changes from the provider

# add a feature
fet = QgsFeature()
fet.setGeometry(QgsGeometry.fromPointXY(QgsPointXY(10,10)))
fmt = Qt.DateFormat.ISODate
t = QDateTime.fromString("2000-01-01T12:00:00", fmt)
fet.setAttributes(["Johnny", 2, 0.3, t])
pr.addFeatures([fet])

# update layer's extent when new features have been added
# because change of extent in provider is not propagated to the layer
vl.updateExtents()

أخيرًا، لنتحقق مما إذا كان كل شيء قد سار على ما يرام

# show some stats
print("fields:", len(pr.fields()))
print("features:", pr.featureCount())
e = vl.extent()
print("extent:", e.xMinimum(), e.yMinimum(), e.xMaximum(), e.yMaximum())

# iterate over features
features = vl.getFeatures()
for fet in features:
    print("F:", fet.id(), fet.attributes(), fet.geometry().asPoint())

fields: 4
features: 1
extent: 10.0 10.0 10.0 10.0
F: 1 ['Johnny', 2, 0.3, PyQt5.QtCore.QDateTime(2000, 1, 1, 12, 0)] <QgsPointXY: POINT(10 10)>

6.8. مظهر الطبقات المتجهية (الترميز)

عند رسم طبقة متجهية، يتحدد مظهر البيانات من خلال أداة الرسم و الرموز المرتبطة بالطبقة. والرموز أصناف تتولى رسم التمثيل المرئي للمعالم، بينما تحدد أدوات الرسم الرمز الذي سيُستخدم لمعلم معين.

يمكن الحصول على أداة الرسم لطبقة معينة كما هو موضح أدناه:

renderer = layer.renderer()

وباستخدام هذا المرجع، دعونا نستكشفها قليلًا

print("Type:", renderer.type())

Type: singleSymbol

هناك عدة أنواع معروفة من أدوات الرسم متاحة في مكتبة QGIS الأساسية:

النوع	الصنف	وصف
singleSymbol	QgsSingleSymbolRenderer	يرسم جميع المعالم بالرمز نفسه
categorizedSymbol	QgsCategorizedSymbolRenderer	يرسم المعالم باستخدام رمز مختلف لكل فئة
graduatedSymbol	QgsGraduatedSymbolRenderer	يرسم المعالم باستخدام رمز مختلف لكل نطاق من القيم

قد توجد أيضًا بعض أنواع أدوات الرسم المخصصة، لذا لا تفترض أبدًا أن هذه الأنواع هي الوحيدة. يمكنك الاستعلام من QgsRendererRegistry الخاص بالتطبيق لمعرفة أدوات الرسم المتاحة حاليًا:

print(QgsApplication.rendererRegistry().renderersList())

['nullSymbol', 'singleSymbol', 'categorizedSymbol', 'graduatedSymbol', 'RuleRenderer', 'pointDisplacement', 'pointCluster', 'mergedFeatureRenderer', 'invertedPolygonRenderer', 'heatmapRenderer', '25dRenderer', 'embeddedSymbol']

يمكن الحصول على تفريغ لمحتويات أداة الرسم في صورة نصية --- وقد يكون ذلك مفيدًا لتصحيح الأخطاء

renderer.dump()

SINGLE: MARKER SYMBOL (1 layers) color 190,207,80,255

6.8.1. أداة رسم الرمز المفرد

يمكنك الحصول على الرمز المستخدم في الرسم باستدعاء الدالة symbol() وتغييره باستخدام الدالة setSymbol() (ملاحظة لمطوّري C++: تتولى أداة الرسم ملكية الرمز.)

يمكنك تغيير الرمز المستخدم في طبقة متجهية معينة باستدعاء setSymbol() مع تمرير نسخة من الرمز المناسب. ويمكن إنشاء رموز طبقات النقاط و الخطوط و المضلعات باستدعاء الدالة createSimple() من الأصناف المقابلة QgsMarkerSymbol و QgsLineSymbol و QgsFillSymbol.

يحدد القاموس المُمرَّر إلى createSimple() خصائص نمط الرمز.

على سبيل المثال، يمكنك استبدال الرمز المستخدم في طبقة نقاط معينة باستدعاء setSymbol() مع تمرير نسخة من QgsMarkerSymbol، كما في مثال الشيفرة التالي:

symbol = QgsMarkerSymbol.createSimple({'name': 'square', 'color': 'red'})
layer.renderer().setSymbol(symbol)
# show the change
layer.triggerRepaint()

يشير name إلى شكل العلامة، ويمكن أن يكون أيًّا مما يلي:

• circle

• square

• cross

• rectangle

• diamond

• pentagon

• triangle

• equilateral_triangle

• star

• regular_star

• arrow

• filled_arrowhead

• x

للحصول على القائمة الكاملة لخصائص طبقة الرمز الأولى لنسخة رمز ما، يمكنك اتباع الشيفرة المثال:

print(layer.renderer().symbol().symbolLayers()[0].properties())

{'angle': '0', 'cap_style': 'square', 'color': '255,0,0,255,rgb:1,0,0,1', 'horizontal_anchor_point': '1', 'joinstyle': 'bevel', 'name': 'square', 'offset': '0,0', 'offset_map_unit_scale': '3x:0,0,0,0,0,0', 'offset_unit': 'MM', 'outline_color': '35,35,35,255,rgb:0.1372549,0.1372549,0.1372549,1', 'outline_style': 'solid', 'outline_width': '0', 'outline_width_map_unit_scale': '3x:0,0,0,0,0,0', 'outline_width_unit': 'MM', 'scale_method': 'diameter', 'size': '2', 'size_map_unit_scale': '3x:0,0,0,0,0,0', 'size_unit': 'MM', 'vertical_anchor_point': '1'}

قد يكون هذا مفيدًا إذا أردت تعديل بعض الخصائص:

# You can alter a single property...
layer.renderer().symbol().symbolLayer(0).setSize(3)
# ... but not all properties are accessible from methods,
# you can also replace the symbol completely:
props = layer.renderer().symbol().symbolLayer(0).properties()
props['color'] = 'yellow'
props['name'] = 'square'
layer.renderer().setSymbol(QgsMarkerSymbol.createSimple(props))
# show the changes
layer.triggerRepaint()

6.8.2. أداة رسم الرموز المصنَّفة

عند استخدام أداة رسم مصنَّفة، يمكنك الاستعلام عن السمة المستخدمة في التصنيف وتعيينها: استخدم الدالتين classAttribute() و setClassAttribute().

للحصول على قائمة بالفئات

categorized_renderer = QgsCategorizedSymbolRenderer()
# Add a few categories
cat1 = QgsRendererCategory('1', QgsMarkerSymbol(), 'category 1')
cat2 = QgsRendererCategory('2', QgsMarkerSymbol(), 'category 2')
categorized_renderer.addCategory(cat1)
categorized_renderer.addCategory(cat2)

for cat in categorized_renderer.categories():
    print("{}: {} :: {}".format(cat.value(), cat.label(), cat.symbol()))

1: category 1 :: <qgis._core.QgsMarkerSymbol object at 0x7f378ffcd9d8>
2: category 2 :: <qgis._core.QgsMarkerSymbol object at 0x7f378ffcd9d8>

حيث value() هي القيمة المستخدمة للتمييز بين الفئات، و label() نص يُستخدم لوصف الفئة، وتُعيد الدالة symbol() الرمز المُسنَد.

تخزّن أداة الرسم عادةً أيضًا الرمز الأصلي وتدرّج الألوان اللذين استُخدما في التصنيف: الدالتان sourceColorRamp() و sourceSymbol().

6.8.3. أداة رسم الرموز المتدرجة

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

لمعرفة المزيد عن النطاقات المستخدمة في أداة الرسم

graduated_renderer = QgsGraduatedSymbolRenderer()
# Add a few categories
graduated_renderer.addClassRange(QgsRendererRange(QgsClassificationRange('class 0-100', 0, 100), QgsMarkerSymbol()))
graduated_renderer.addClassRange(QgsRendererRange(QgsClassificationRange('class 101-200', 101, 200), QgsMarkerSymbol()))

for ran in graduated_renderer.ranges():
    print("{} - {}: {} {}".format(
        ran.lowerValue(),
        ran.upperValue(),
        ran.label(),
        ran.symbol()
      ))

0.0 - 100.0: class 0-100 <qgis._core.QgsMarkerSymbol object at 0x7f8bad281b88>
101.0 - 200.0: class 101-200 <qgis._core.QgsMarkerSymbol object at 0x7f8bad281b88>

يمكنك مرة أخرى استخدام الدوال classAttribute() (لمعرفة اسم سمة التصنيف) و sourceSymbol() و sourceColorRamp(). وإضافة إلى ذلك، هناك الدالة mode() التي تحدد كيفية إنشاء النطاقات: باستخدام فترات متساوية أو مُكمّمات (quantiles) أو طريقة أخرى.

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

from qgis.PyQt import QtGui

myVectorLayer = QgsVectorLayer("testdata/data/data.gpkg|layername=airports", "Airports layer", "ogr")
myTargetField = 'scalerank'
myRangeList = []
myOpacity = 1
# Make our first symbol and range...
myMin = 0.0
myMax = 50.0
myLabel = 'Group 1'
myColour = QtGui.QColor('#ffee00')
mySymbol1 = QgsSymbol.defaultSymbol(myVectorLayer.geometryType())
mySymbol1.setColor(myColour)
mySymbol1.setOpacity(myOpacity)
myRange1 = QgsRendererRange(myMin, myMax, mySymbol1, myLabel)
myRangeList.append(myRange1)
#now make another symbol and range...
myMin = 50.1
myMax = 100
myLabel = 'Group 2'
myColour = QtGui.QColor('#00eeff')
mySymbol2 = QgsSymbol.defaultSymbol(
     myVectorLayer.geometryType())
mySymbol2.setColor(myColour)
mySymbol2.setOpacity(myOpacity)
myRange2 = QgsRendererRange(myMin, myMax, mySymbol2, myLabel)
myRangeList.append(myRange2)
myRenderer = QgsGraduatedSymbolRenderer('', myRangeList)
myClassificationMethod = QgsApplication.classificationMethodRegistry().method("EqualInterval")
myRenderer.setClassificationMethod(myClassificationMethod)
myRenderer.setClassAttribute(myTargetField)

myVectorLayer.setRenderer(myRenderer)

6.8.4. العمل مع الرموز

لتمثيل الرموز، هناك الصنف الأساسي QgsSymbol مع ثلاثة أصناف مشتقة:

• QgsMarkerSymbol --- للمعالم النقطية

• QgsLineSymbol --- للمعالم الخطية

• QgsFillSymbol --- للمعالم المضلعة

يتكون كل رمز من طبقة رمز واحدة أو أكثر (أصناف مشتقة من QgsSymbolLayer). وطبقات الرمز هي التي تتولى الرسم الفعلي، أما صنف الرمز نفسه فيعمل فقط كحاوية لطبقات الرمز.

عندما تكون لديك نسخة من رمز (من أداة رسم مثلًا)، يمكنك استكشافها: إذ تخبرك الدالة type() ما إذا كان رمز علامة أو خط أو تعبئة. وهناك الدالة dump() التي تُعيد وصفًا موجزًا للرمز. وللحصول على قائمة بطبقات الرمز:

marker_symbol = QgsMarkerSymbol()
for i in range(marker_symbol.symbolLayerCount()):
    lyr = marker_symbol.symbolLayer(i)
    print("{}: {}".format(i, lyr.layerType()))

0: SimpleMarker

لمعرفة لون الرمز استخدم الدالة color()، واستخدم setColor() لتغيير لونه. ومع رموز العلامات يمكنك أيضًا الاستعلام عن حجم الرمز ودورانه باستخدام الدالتين size() و angle(). أما رموز الخطوط فتُعيد فيها الدالة width() عرض الخط.

الحجم والعرض بالمليمترات افتراضيًا، والزوايا بالدرجات.

6.8.4.1. العمل مع طبقات الرموز

كما ذُكر سابقًا، تحدد طبقات الرموز (الأصناف الفرعية من QgsSymbolLayer) مظهر المعالم. وهناك عدة أصناف أساسية لطبقات الرموز للاستخدام العام. ومن الممكن تنفيذ أنواع جديدة من طبقات الرموز وبالتالي تخصيص طريقة رسم المعالم كما تشاء. وتحدد الدالة layerType() صنف طبقة الرمز تحديدًا فريدًا --- والأنواع الأساسية والافتراضية هي أنواع طبقات الرموز SimpleMarker و SimpleLine و SimpleFill.

يمكنك الحصول على قائمة كاملة بأنواع طبقات الرموز التي يمكنك إنشاؤها لصنف معين من طبقات الرموز باستخدام الشيفرة التالية:

from qgis.core import QgsSymbolLayerRegistry
myRegistry = QgsApplication.symbolLayerRegistry()
myMetadata = myRegistry.symbolLayerMetadata("SimpleFill")
for item in myRegistry.symbolLayersForType(QgsSymbol.Marker):
    print(item)

AnimatedMarker
EllipseMarker
FilledMarker
FontMarker
GeometryGenerator
MaskMarker
RasterMarker
SimpleMarker
SvgMarker
VectorField

يدير الصنف QgsSymbolLayerRegistry قاعدة بيانات لجميع أنواع طبقات الرموز المتاحة.

للوصول إلى بيانات طبقة الرمز، استخدم دالتها properties() التي تُعيد قاموسًا من أزواج المفتاح والقيمة للخصائص التي تحدد المظهر. ولكل نوع من طبقات الرموز مجموعة محددة من الخصائص التي يستخدمها. وإضافة إلى ذلك، هناك الدوال العامة color() و size() و angle() و width()، مع نظيراتها الخاصة بالتعيين. وبالطبع لا يتوفر الحجم والزاوية إلا لطبقات رموز العلامات، ولا يتوفر العرض إلا لطبقات رموز الخطوط.

6.8.4.2. إنشاء أنواع مخصصة من طبقات الرموز

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

from qgis.core import QgsMarkerSymbolLayer
from qgis.PyQt.QtGui import QColor

class FooSymbolLayer(QgsMarkerSymbolLayer):

  def __init__(self, radius=4.0):
      QgsMarkerSymbolLayer.__init__(self)
      self.radius = radius
      self.color = QColor(255,0,0)

  def layerType(self):
     return "FooMarker"

  def properties(self):
      return { "radius" : str(self.radius) }

  def startRender(self, context):
    pass

  def stopRender(self, context):
      pass

  def renderPoint(self, point, context):
      # Rendering depends on whether the symbol is selected (QGIS >= 1.5)
      color = context.selectionColor() if context.selected() else self.color
      p = context.renderContext().painter()
      p.setPen(color)
      p.drawEllipse(point, self.radius, self.radius)

  def clone(self):
      return FooSymbolLayer(self.radius)

تحدد الدالة layerType() اسم طبقة الرمز؛ ويجب أن يكون فريدًا بين جميع طبقات الرموز. وتُستخدم الدالة properties() لحفظ الخصائص. ويجب أن تُعيد الدالة clone() نسخة من طبقة الرمز بجميع الخصائص مطابقة تمامًا. وأخيرًا هناك دوال الرسم: تُستدعى startRender() قبل رسم المعلم الأول، و stopRender() عند انتهاء الرسم، وتُستدعى renderPoint() لتنفيذ الرسم. وتكون إحداثيات النقطة (أو النقاط) قد حُوِّلت مسبقًا إلى إحداثيات المخرجات.

بالنسبة للخطوط المتعددة والمضلعات، يكمن الفرق الوحيد في دالة الرسم: إذ ستستخدم renderPolyline() التي تتلقى قائمة بالخطوط، بينما تتلقى renderPolygon() قائمة بنقاط الحلقة الخارجية كمعامل أول وقائمة بالحلقات الداخلية (أو None) كمعامل ثانٍ.

عادةً ما يكون من الملائم إضافة واجهة رسومية لتعيين خصائص نوع طبقة الرمز لتمكين المستخدمين من تخصيص المظهر: ففي مثالنا أعلاه يمكننا السماح للمستخدم بتعيين نصف قطر الدائرة. تنفّذ الشيفرة التالية عنصر واجهة كهذا

from qgis.gui import QgsSymbolLayerWidget

class FooSymbolLayerWidget(QgsSymbolLayerWidget):
    def __init__(self, parent=None):
        QgsSymbolLayerWidget.__init__(self, parent)

        self.layer = None

        # setup a simple UI
        self.label = QLabel("Radius:")
        self.spinRadius = QDoubleSpinBox()
        self.hbox = QHBoxLayout()
        self.hbox.addWidget(self.label)
        self.hbox.addWidget(self.spinRadius)
        self.setLayout(self.hbox)
        self.connect(self.spinRadius, SIGNAL("valueChanged(double)"), \
            self.radiusChanged)

    def setSymbolLayer(self, layer):
        if layer.layerType() != "FooMarker":
            return
        self.layer = layer
        self.spinRadius.setValue(layer.radius)

    def symbolLayer(self):
        return self.layer

    def radiusChanged(self, value):
        self.layer.radius = value
        self.emit(SIGNAL("changed()"))

يمكن تضمين عنصر الواجهة هذا في نافذة حوار خصائص الرمز. فعند تحديد نوع طبقة الرمز في نافذة حوار خصائص الرمز، تُنشئ النافذة نسخة من طبقة الرمز ونسخة من عنصر واجهة طبقة الرمز. ثم تستدعي الدالة setSymbolLayer() لإسناد طبقة الرمز إلى عنصر الواجهة. وفي تلك الدالة يجب أن يحدّث عنصر الواجهة واجهة المستخدم لتعكس خصائص طبقة الرمز. وتستخدم نافذة الخصائص الدالة symbolLayer() لاسترجاع طبقة الرمز مجددًا لاستخدامها في الرمز.

مع كل تغيير في الخصائص، يجب أن يُطلق عنصر الواجهة الإشارة changed() لتتمكن نافذة الخصائص من تحديث معاينة الرمز.

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

سيتعين علينا إنشاء بيانات وصفية (metadata) لطبقة الرمز

from qgis.core import QgsSymbol, QgsSymbolLayerAbstractMetadata, QgsSymbolLayerRegistry

class FooSymbolLayerMetadata(QgsSymbolLayerAbstractMetadata):

  def __init__(self):
    super().__init__("FooMarker", "My new Foo marker", QgsSymbol.Marker)

  def createSymbolLayer(self, props):
    radius = float(props["radius"]) if "radius" in props else 4.0
    return FooSymbolLayer(radius)

fslmetadata = FooSymbolLayerMetadata()

QgsApplication.symbolLayerRegistry().addSymbolLayerType(fslmetadata)

يجب عليك تمرير نوع الطبقة (نفسه الذي تُعيده الطبقة) ونوع الرمز (marker/line/fill) إلى مُنشئ الصنف الأب. وتتولى الدالة createSymbolLayer() إنشاء نسخة من طبقة الرمز بالخصائص المحددة في القاموس props. وهناك الدالة createSymbolLayerWidget() التي تُعيد عنصر واجهة الإعدادات لهذا النوع من طبقات الرموز.

الخطوة الأخيرة هي إضافة طبقة الرمز هذه إلى السجل --- وبذلك ننتهي.

6.8.5. إنشاء أدوات رسم مخصصة

قد يكون من المفيد إنشاء تنفيذ جديد لأداة رسم إذا أردت تخصيص قواعد اختيار الرموز لرسم المعالم. ومن حالات الاستخدام التي قد ترغب فيها في ذلك: تحديد الرمز من مجموعة من الحقول، أو تغيّر حجم الرموز بحسب مقياس الرسم الحالي، إلخ.

توضّح الشيفرة التالية أداة رسم مخصصة بسيطة تُنشئ رمزَي علامة وتختار أحدهما عشوائيًا لكل معلم

import random
from qgis.core import QgsWkbTypes, QgsSymbol, QgsFeatureRenderer


class RandomRenderer(QgsFeatureRenderer):
  def __init__(self, syms=None):
    super().__init__("RandomRenderer")
    self.syms = syms if syms else [
      QgsSymbol.defaultSymbol(QgsWkbTypes.geometryType(QgsWkbTypes.Point)),
      QgsSymbol.defaultSymbol(QgsWkbTypes.geometryType(QgsWkbTypes.Point))
    ]

  def symbolForFeature(self, feature, context):
    return random.choice(self.syms)

  def startRender(self, context, fields):
    super().startRender(context, fields)
    for s in self.syms:
      s.startRender(context, fields)

  def stopRender(self, context):
    super().stopRender(context)
    for s in self.syms:
      s.stopRender(context)

  def usedAttributes(self, context):
    return []

  def clone(self):
    return RandomRenderer(self.syms)

يحتاج مُنشئ الصنف الأب QgsFeatureRenderer إلى اسم لأداة الرسم (يجب أن يكون فريدًا بين أدوات الرسم). والدالة symbolForFeature() هي التي تقرر الرمز الذي سيُستخدم لمعلم معين. وتتولى startRender() و stopRender() تهيئة رسم الرموز وإنهاءه. ويمكن للدالة usedAttributes() أن تُعيد قائمة بأسماء الحقول التي تتوقع أداة الرسم وجودها. وأخيرًا، يجب أن تُعيد الدالة clone() نسخة من أداة الرسم.

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

from qgis.gui import QgsRendererWidget, QgsColorButton


class RandomRendererWidget(QgsRendererWidget):
  def __init__(self, layer, style, renderer):
    super().__init__(layer, style)
    if renderer is None or renderer.type() != "RandomRenderer":
      self.r = RandomRenderer()
    else:
      self.r = renderer
    # setup UI
    self.btn1 = QgsColorButton()
    self.btn1.setColor(self.r.syms[0].color())
    self.vbox = QVBoxLayout()
    self.vbox.addWidget(self.btn1)
    self.setLayout(self.vbox)
    self.btn1.colorChanged.connect(self.setColor1)

  def setColor1(self):
    color = self.btn1.color()
    if not color.isValid(): return
    self.r.syms[0].setColor(color)

  def renderer(self):
    return self.r

يتلقى المُنشئ نسخًا من الطبقة النشطة (QgsVectorLayer) والنمط العام (QgsStyle) وأداة الرسم الحالية. فإذا لم تكن هناك أداة رسم أو كانت أداة الرسم من نوع مختلف، فستُستبدل بأداة الرسم الجديدة الخاصة بنا، وإلا فسنستخدم أداة الرسم الحالية (التي هي من النوع الذي نحتاجه أصلًا). ويجب تحديث محتويات عنصر الواجهة لإظهار الحالة الحالية لأداة الرسم. وعند قبول نافذة حوار أداة الرسم، تُستدعى الدالة renderer() الخاصة بعنصر الواجهة للحصول على أداة الرسم الحالية --- وستُسنَد إلى الطبقة.

الجزء الأخير الناقص هو البيانات الوصفية (metadata) لأداة الرسم وتسجيلها في السجل، وإلا فلن يعمل تحميل الطبقات التي تستخدم أداة الرسم ولن يتمكن المستخدم من اختيارها من قائمة أدوات الرسم. لننهِ مثال RandomRenderer الخاص بنا

from qgis.core import (
  QgsRendererAbstractMetadata,
  QgsRendererRegistry,
  QgsApplication
)

class RandomRendererMetadata(QgsRendererAbstractMetadata):

  def __init__(self):
    super().__init__("RandomRenderer", "Random renderer")

  def createRenderer(self, element):
    return RandomRenderer()

  def createRendererWidget(self, layer, style, renderer):
    return RandomRendererWidget(layer, style, renderer)

rrmetadata = RandomRendererMetadata()

QgsApplication.rendererRegistry().addRenderer(rrmetadata)

وكما هو الحال مع طبقات الرموز، ينتظر مُنشئ البيانات الوصفية المجردة اسم أداة الرسم، والاسم الظاهر للمستخدمين، واختياريًا اسم أيقونة أداة الرسم. وتمرّر الدالة createRenderer() نسخة QDomElement يمكن استخدامها لاستعادة حالة أداة الرسم من شجرة DOM. وتُنشئ الدالة createRendererWidget() عنصر واجهة الضبط. وليس من الضروري وجودها، أو يمكنها إعادة None إذا لم تكن أداة الرسم مزوّدة بواجهة رسومية.

لربط أيقونة بأداة الرسم، يمكنك إسنادها في مُنشئ QgsRendererAbstractMetadata كوسيط ثالث (اختياري) --- فيصبح مُنشئ الصنف الأساسي في الدالة __init__() الخاصة بـ RandomRendererMetadata

QgsRendererAbstractMetadata.__init__(self,
       "RandomRenderer",
       "Random renderer",
       QIcon(QPixmap("RandomRendererIcon.png", "png")))

يمكن أيضًا ربط الأيقونة في أي وقت لاحق باستخدام الدالة setIcon() من صنف البيانات الوصفية. ويمكن تحميل الأيقونة من ملف (كما هو موضح أعلاه) أو من مورد Qt (تتضمن PyQt5 مترجمًا لملفات .qrc للغة Python).

6.9. موضوعات إضافية

مهام مستقبلية (TODO):

• إنشاء الرموز وتعديلها

• العمل مع الأنماط (QgsStyle)

• العمل مع تدرّجات الألوان (QgsColorRamp)

• استكشاف سجلات طبقات الرموز وأدوات الرسم