استخدام بيئة البرمجة النصية

ملاحظة:‏

تتوفر بيئة برمجة Insights النصية في Insights in ArcGIS Enterprise وInsights desktop. يمكن أن يكون الاتصال الأساسي إما Insights in ArcGIS Enterprise أو Insights in ArcGIS Online

يمكن تعطيل موصلات Jupyter Kernel Gateway لمؤسسة Insights in ArcGIS Enterprise أثناء عملية التثبيت. اتصل بالمسؤول إذا كانت اتصالات Jupyter Kernel Gateway غير متوفرة. لمزيد من المعلومات، راجع موضوع تثبيت Insights in ArcGIS Enterprise.

بعد إجراء الاتصال بـ Jupyter Kernel Gateway، يمكن الوصول إلى بيئة البرمجة النصية والاستعانة بها في إنشاء البرامج النصية وتشغيلها في Python وR. تتكون بيئة البرمجة النصية من خلية In[ ]، حيث يتم تحميل البرامج النصية أو كتابتها وخلية Out[ ]، حيث يتم عرض النتائج وشريط الأدوات.

فتح بيئة البرمجة النصية

لاستخدام بيئة البرمجة النصية، يتعين عليك أولاً إعداد Jupyter Kernel Gateway وإنشاء اتصال بالبوابة. بمجرد إعداد الاتصال بالبوابة، أكمل الخطوات التالية لفتح بيئة البرمجة النصية والبدء في كتابة البرامج النصية:

1. افتح مُصنّفًا. أضف بيانات إلى مصنفك، عند الضرورة.

   تلميح:

   يمكنك أيضًا تحميل البيانات من داخل بيئة البرمجة النصية.

2. انقر فوق زر البرمجة النصية في شريط أدوات المُصنّف.
3. إذا لم يُحفظ أي اتصال في المصنف سابقًا، فعليك بالقيام بأي مما يلي:
   • في Insights desktop، إذا تم فتح نافذة اتصال Jupyter Kernel Gateway جديد، فهذا يعني أنك لم تقم بإنشاء اتصال بالبوابة. أدخل عنوان URL وعنوان مأخذ ويب في البوابة لإنشاء الاتصال. راجع الاتصال ببوابة kernel لمزيد من المعلومات.
   • في Insights in ArcGIS Enterprise، إذا فُتحت نافذة اتصال Kernel Gateway، فحدد اتصال Kernel Gateway موجود من قائمة اسم البيئة. يمكنك أيضًا إنشاء اتصال جديد على علامة تبويب إضافة جديد. راجع الاتصال ببوابة kernel لمزيد من المعلومات.

   تُفتح بيئة البرمجة النصية ويُضاف عنوان البرامج النصية إلى جزء البيانات.

4. استخدم قائمة تحديد Kernel لاختيار الـ kernel الذي تستخدمه في البرامج النصية. بناءً على اتصال بوابة kernel الذي تستخدمه، ستكون الخيارات إما Python أو R أو كلاهما.

   يتم تحديث بيئة البرمجة النصية لتضمين خلية إدخال[ ] وشريط الأدوات.

أصبحت بيئة البرمجة النصية جاهزة الآن لإنشاء البرامج النصية وتحميلها وتشغيلها.

يتم حفظ البرنامج النصي تلقائيًا تحت عنوان البرامج النصية في جزء البيانات باسم Insights Script. يمكن إعادة تسمية البرنامج النصي باستخدام زر إعادة تسمية البرنامج النصي.

تتوفر أيضًا الخيارات التالية للبرنامج النصي باستخدام زر خيارات مجموعة البيانات :

• فتح—تحميل البرنامج النصي إلى خلية In[ ].
• تشغيل—تشغيل البرنامج النصي دون فتح بيئة البرمجة النصية.
• تنزيل—تنزيل البرنامج النصي كملف Jupyter Notebook (.ipynb).
• مشاركة—مشاركة البرنامج النصي لإنشاء عنصر برنامج نصي Insights (متاح في Insights in ArcGIS Enterprise) .
• إزالة—إزالة البرنامج النصي من جزء البيانات.

تحرير أحد البرامج النصية

يمكن تحرير البرامج النصية من خلايا إدخال[ ]، حتى بعد تنفيذ الخلية. لتحرير برنامج نصي، انقر فوق الخلية، وقم بعمليات التحرير، ثم قم بتشغيل الخلية. يتم إنشاء خلية Out[ ] جديدة بالنتائج التي تم تحريرها.

تصدير البرنامج النصي

يمكن تصدير البرامج النصية التي تتم كتابتها في بيئة البرمجة النصية وحفظها كبرنامج نصي لـ .pyPythonأو برنامج .R نصي لـ R. يمكن تصدير برنامج نصي من بيئة برمجة نصية بتحديد خلية أو أكثر والنقر على زر تصدير .

تتوفر خيارات التصدير التالية عند حفظ برنامج نصي:

• تنزيل الخلايا المحددة—يحفظ فقط البرنامج النصي في خلايا In[ ] المحددة.
• تنزيل المحفوظات—تحفظ البرنامج النصي من جميع خلايا In[ ] في بيئة البرمجة النصية كملف Jupyter Notebook (.ipynb).

سيتم حفظ البرامج النصية المُصدّرة في مجلد التنزيل الافتراضي على جهاز الكمبيوتر.

تحميل برنامج نصي

يمكن إنشاء البرامج النصية مباشرة في بيئة البرمجة النصية بالكتابة في خلية In[ ]. يمكن أيضًا تحميل البرامج النصية الموجودة في بيئة البرمجة النصية باستخدام الخطوات التالية:

1. افتح بيئة البرمجة النصية، إذا لزم الأمر، واختر kernel الصحيح للبرنامج النصي الذي ستقوم بتشغيله.
2. انقر فوق زر استيراد ملفعلى شريط أدوات بيئة البرمجة النصية.
3. استعرض البرنامج النصي الذي تريد تشغيله وقم بفتحه.

   سيفتح البرنامج النصي في خلية إدخال[ ].

4. انقر فوق زر تشغيل على شريط أدوات بيئة البرمجة النصية.

يتم تشغيل البرنامج النصي وتظهر النتائج في خلية إخراج[ ].

يمكن أيضًا تحميل البرامج النصية، المحفوظة في جزء البيانات، إلى بيئة البرمجة النصية. لتحميل برنامج نصي من جزء البيانات، استخدم الخطوات التالية:

1. قم بتوسيع عنوان البرامج النصية في جزء البيانات.
2. انقر فوق زر خيارات مجموعة البياناتلمشاهدة البرنامج النصي الذي ترغب في تحميله.
3. انقر على فتح.

   سيفتح البرنامج النصي في خلية إدخال[ ].

إنشاء بطاقة صورة

يمكن تصدير نتائج البرامج النصية، مثل المخططات من خلية Out[ ] لإنشاء بطاقة صورة على صفحة Insights الخاصة بك. لتصدير خلية، يتعين عليك تشغيل البرنامج النصي باستخدام زر تشغيل، وتحديد خلية Out[ ] ومن ثم انقر فوق زر إنشاء بطاقة لنقل الصورة من أحدث خلية Out[ ] إلى بطاقة صورة.

ملاحظة:‏

بطاقات الصور التي تم إنشاؤها من البرامج النصية ثابتة ولا تحتوي على نفس الإمكانات التفاعلية للخريطة والمخطط وبطاقات الجدول التي تم إنشاؤها في Insights.

حفظ البرنامج النصي الخاص بك إلى نموذج

يمكن إضافة البرنامج النصي ببيئة البرمجة النصية إلى النموذج الخاص بك كبرمجة Insights نصية باستخدام زر إضافة إلى نموذج . يمكن تحرير البرنامج النصي Insights من تحليل العرض . لمزيد من المعلومات حول تحديث نموذج في Insights، راجع إعادة تنفيذ التحليل.

مسح أو إغلاق بيئة البرمجة النصية

يمكن مسح البرنامج النصي بما في ذلك جميع خلايا In[ ] وOut[ ] باستخدام زر إعادة التشغيل. لا يمكن التراجع عن مسح بيئة البرمجة النصية.

يتم إغلاق بيئة البرامج النصية بالنقر فوق زر إغلاق أو استعرض صفحة أخرى داخل Insights.

إذا كنت بحاجة إلى التبديل بين صفحة Insights ووحدة التحكم، من الأفضل تجرية تصغير بيئة البرمجة النصية باستخدام زر التصغير بدلاً من إغلاقها حتى لا تفقد البرامج النصية.