افتح خريطة جزائرية قديمة، أو مخططًا مسحيًّا، أو تقرير بئر، وستجد على الأرجح أن الإحداثيات مكتوبة في Nord Sahara 1959، وهو المرجع الجيوديسي (datum) الجزائري الكلاسيكي المبني على الإهليلج Clarke 1880 (RGS). أما هاتفك وجهاز GPS وأغلب خرائط الويب فتعمل بـ WGS 84. إذا وضعت نقطة Nord Sahara على خريطة WGS 84 دون تحويل، فستقع في مكان خاطئ، بفارق لا يمكن تجاهله.

الجواب المعتاد هو "استعمل PROJ وانتهى الأمر"، وهذا هو الجواب الصحيح في العمل الحقيقي. لكنني أردت أن أفهم ما الذي يحدث فعلًا بين المجموعتين من الأرقام. والنتيجة هي nord-sahara-wgs84: مكتبة صغيرة مكتوبة بـ Python فقط مع أداة سطر أوامر (CLI)، بلا أي اعتماديات وقت التشغيل، تنفّذ التحويل كاملًا خطوة بخطوة، وتتحقق من كل رقم مقابل PROJ.

هذا مشروع تعليمي. الهدف كان كتابة الرياضيات بشكل واضح يمكن قراءته، ثم إثبات أنها صحيحة.

ماذا يقدّم

تحويل المرجع في الاتجاهين. يحوّل بين Nord Sahara 1959 (EPSG:4307) و WGS 84 (EPSG:4326) في كلا الاتجاهين.

إسقاط UTM على المرجعين. يحوّل أيضًا من وإلى مناطق UTM من 29N إلى 32N، على Nord Sahara 1959 (من EPSG:30729 إلى 30732) وعلى WGS 84 (من EPSG:32629 إلى 32632). يمكنك الانتقال مباشرة من إحداثيات مُسقطة على مرجع إلى إحداثيات مُسقطة على المرجع الآخر.

كل التحويلات المنشورة. قاعدة بيانات EPSG لا تنشر أي شبكة (grid من نوع NTv2 أو ما يشبهه) لـ Nord Sahara 1959، بل مجموعات معاملات Helmert فقط. المكتبة تتضمن العشر كلها، بالقيم كما نُشرت تمامًا. وهي ليست متساوية:

  • EPSG 10296 (الافتراضي) و 5660 تحويلان بسبعة معاملات (Position Vector) بدقة منشورة قدرها 1 متر على كامل الجزائر.
  • EPSG 1815 مجموعة بسبعة معاملات خاصة بـ District 3، بدقة 5 أمتار.
  • الباقي إزاحات مركزية (geocentric translations) بثلاثة معاملات، بدقة تتراوح من 5 أمتار لمناطق رخص محددة (Ahnet و Hassi Mouina) إلى 44 مترًا لليابسة الجزائرية و 100 متر لـ In Amenas و Hassi Bir Reikaz و Ain Tsila.

الافتراضي 10296 هو نفسه الذي يضعه PROJ في المرتبة الأولى لهذا الزوج. والخيار --op auto يختار أدق عملية تحتوي منطقةُ استعمالها النقطةَ المطلوبة.

وهناك جملة في الـ README تستحق التكرار: الدقة المنشورة تعبّر عن مدى مطابقة المعاملات للعلاقة الحقيقية بين المرجعين. هي ليست خاصية من خصائص الكود.

أداة CLI مع وضع CSV. الأمر ns59 يحوّل نقطة واحدة أو تدفق CSV كاملًا، ويمرّر الأعمدة الإضافية كما هي.

طريقة الاستعمال

يحتاج Python 3.13 أو أحدث. انسخ المستودع وشغّله من مجلده بواسطة uv:

git clone https://github.com/AbdeldjalilChougui/nord-sahara-wgs84.git cd nord-sahara-wgs84 uv sync uv run ns59 convert --from ns59 --to wgs84 3.0588 36.7538 # lon lat # 3.058054140 36.753905322 uv run ns59 convert --from ns59-utm31 --to wgs84-utm31 -v 500000 4070000 uv run ns59 convert --from 30732 --to 4326 --op auto 712000 3530000 # best local operation printf "x,y,name\n500000,4000000,well-1\n" | uv run ns59 convert --from 30731 --to 32631 --csv uv run ns59 ops # published transformations uv run ns59 crs # supported CRSs 

ومن Python:

from nord_sahara_wgs84 import convert, ns59_to_wgs84 r = convert(500000, 4070000, "EPSG:30731", "EPSG:32631") # easting/northing in, out print(r.x, r.y, r.operation.name) lat, lon, h = ns59_to_wgs84(36.7538, 3.0588, op=1253) # pick an EPSG operation 

انتبه لترتيب المحاور. الدالة convert تأخذ دائمًا x ثم y، أي (lon, lat) أو (easting, northing)، مثل always_xy=True في PROJ. أما الدالتان الأدنى مستوى ns59_to_wgs84 و wgs84_to_ns59 فتأخذان (lat, lon).

يمكن تسمية أنظمة الإحداثيات (CRS) برمز EPSG أو باسم مختصر: ns59 و wgs84 و ns59-utm31 و wgs84-utm32 وهكذا.

ما بنيته من الصفر

تحويل المرجع يبدو من الخارج استدعاء دالة واحدة. لكنه من الداخل سلسلة من أربع خطوات، وقد كتبت كل واحدة منها.

  1. من UTM إلى إحداثيات جغرافية على إهليلج المصدر، إذا كان الإدخال مُسقطًا. إسقاط Transverse Mercator يستعمل متسلسلة Krüger حتى الرتبة n⁶ بصياغة Karney (2011). الدقة في حدود النانومتر داخل المنطقة، وأقل من المليمتر على بعد عدة درجات خارجها.
  2. من جغرافية إلى مركزية (ECEF) على Clarke 1880 (RGS): a = 6 378 249.145 m و 1/f = 293.465. يتحول خط العرض وخط الطول إلى X و Y و Z بالأمتار انطلاقًا من مركز الإهليلج.
  3. تحويل Helmert في ECEF. الطريقة EPSG 9606 (position vector) تستعمل مصفوفة الدوران الخطّية (linearised)، مع دورانات بالثواني القوسية ومعامل مقياس بـ ppm. والطريقة EPSG 9603 تستعمل الإزاحات فقط. الاتجاه العكسي يطبّق منقول المصفوفة، كما يفعل PROJ.
  4. من مركزية إلى جغرافية على WGS 84، ببداية Bowring ثم تكرار النقطة الثابتة، ثم إلى UTM إذا كان الهدف مُسقطًا.

ما تعلّمته

إزاحة المرجع تحدث في ثلاثة أبعاد، حتى للنقاط ثنائية الأبعاد. لا يمكن إزاحة خط العرض وخط الطول مباشرة. تمرّ عبر X و Y و Z المركزية، تطبّق Helmert هناك، ثم تعود. وكما في EPSG و PROJ، هذه العمليات تعمل في مجال geog2D: الارتفاع الإهليلجي المُدخل يدخل في الخطوة المركزية لكنه يعود كما هو. الارتفاعات لا تُحوَّل.

"أي تحويل؟" سؤال حقيقي. قبل هذا المشروع كنت أتصوّر أن التحويل من Nord Sahara إلى WGS 84 معادلة واحدة. هو في الواقع عشر عمليات منشورة، بدقة تتراوح من 1 متر إلى 100 متر، وبمناطق استعمال تتراوح من كامل الجزائر إلى منطقة رخصة واحدة. قد تختلف أداتان بعشرات الأمتار وتكون كلتاهما "صحيحة"، لأنهما تستعملان عمليتين مختلفتين.

الذهاب والعودة لا يتطابقان تمامًا، وهذا متوقع. النتائج تتفق مع PROJ في حدود 1e-12 درجة تقريبًا. لكن التحويل من NS59 إلى WGS 84 ثم العودة إلى NS59 دقيق في حدود بضعة مليمترات فقط، لأن الارتفاع لا يُنقل عبر الإزاحة، ولأن مصفوفة الدوران الخطّية ليست متعامدة تمامًا. و PROJ يتصرف بالطريقة نفسها. اكتشاف هذا وفهم سببه علّمني أكثر من الحالات التي تطابقت من أول محاولة.

وجود مرجع للمقارنة يجعل العمل صادقًا. تُستعمل pyproj و PROJ في الاختبارات فقط، كمرجع. الأمر uv run pytest يشغّل 52 اختبارًا، منها doctest واحد:

  • كل عملية، في الاتجاهين، مقابل PROJ عند 200 نقطة عشوائية عبر الجزائر لكل عملية (بتسامح 1e-9 درجة، أي نحو 0.1 مم)
  • التحويلات المركزية على الإهليلجين مقابل +proj=cart (في حدود 1 ميكرومتر)
  • UTM من 29N إلى 32N على المرجعين مقابل PROJ، داخل كل منطقة وحتى 3 درجات خارجها (1 مم)، مع اختبارات الذهاب والعودة
  • من مُسقط إلى مُسقط عبر المرجعين مقابل pipeline من PROJ
  • العملية الافتراضية مقابل اختيار PROJ نفسه
  • الـ CLI: نقطة واحدة، دفعة CSV مع الأعمدة الممرَّرة، وحالات الخطأ

أشياء يجب معرفتها

  • المدعوم هو أنظمة الإحداثيات المذكورة أعلاه فقط. إسقاطات Lambert المسماة Nord Algérie و Sud Algérie (EPSG:30791/30792) ومرجعا Voirol 1875/1879 غير متضمنة بعد.
  • لا توجد معالجة للمرجع الرأسي. الارتفاعات إهليلجية وتُمرَّر كما هي.
  • استثناءات مناطق UTM (النرويج و Svalbard) لا تخص هذه المنطقة وغير معالَجة.
  • المكتبة مكتوبة بـ Python فقط، وهي بطيئة مع ملايين النقاط. استعمل PROJ أو pyproj للعمل بالجملة. هذا المشروع موجود ليعرض الرياضيات بوضوح.
  • معاملات التحويل وثوابت الإهليلج وتعريفات أنظمة الإحداثيات ومناطق الاستعمال مأخوذة من EPSG Geodetic Parameter Dataset (IOGP)، من النسخة الموزّعة مع PROJ 9.8. حقوق قاعدة البيانات لـ IOGP: يجوز استعمالها وإعادة توزيعها، لكن لا يجوز تعديلها ثم تقديمها على أنها بيانات EPSG.

لماذا بنيته

Nord Sahara 1959 هو المرجع الذي كُتبت به إحداثيات جزائرية كثيرة، والتحويل إلى WGS 84 يُعامل عادةً كصندوق أسود: تمرّر رمز EPSG وتثق بما يخرج. لا توجد شبكة لهذا المرجع، بل مجموعات معاملات Helmert فقط، وهذا يجعله حالة مناسبة للتنفيذ الكامل. السلسلة قصيرة بما يكفي لكتابتها يدويًّا، و PROJ موجود ليخبرك إن كنت أصبت. أردت نسخة تكون فيها كل خطوة كودًا مقروءًا، ويكون فيها الاختيار بين العمليات العشر ظاهرًا لا مخفيًّا.

احصل على الكود

الكود المصدري والاختبارات وجدول العمليات الكامل على GitHub: https://github.com/AbdeldjalilChougui/nord-sahara-wgs84. الكود برخصة MIT. الملاحظات (issues) وطلبات الدمج (pull requests) مرحّب بها.

نُشر في الأصل على abdeldjalilchougui.biz.