نظرة عامة على الرسم البياني

أداة تحرير الرموز البرمجية لبرنامج Earth Engine JavaScript تتكامل بسلاسة مع رسومات Google البيانية لعرض البيانات في جداول بشكل ملائم من خلال وظائف ui.Chart. يمكن عرض الرسومات البيانية بشكل تفاعلي في وحدة تحكّم "محرر الرموز البرمجية" وui.Panel تطبيقات المصغّرة وفي علامات التبويب المستقلة للمتصفّح.

قوائم الأكثر رواجًا في DataTable

يستخدم Earth Engine Google Visualization API لإتاحة إنشاء الرسوم البيانية. تقبل واجهة برمجة التطبيقات DataTable، وهو جدول ثنائي الأبعاد حيث تكون الصفوف هي الملاحظات والأعمدة هي سمات الملاحظات. يتم استخراج جميع الرسوم البيانية في Earth Engine من DataTable، وتتيح لك أداة ui.Chart تقديم DataTable مباشرةً. وتوفّر هذه الطريقة أكبر فرصة لتخصيص الرسم البياني، ولكن قد تكون أقل ملاءمةً من طرق إنشاء الرسوم البيانية لعناصر معيّنة في Earth Engine (راجِع القسم التالي). اطّلِع على مزيد من المعلومات حول إنشاء الرسوم البيانية من DataTable:

الرسوم البيانية للأجسام في Earth Engine

يوفّر التطبيق المصغّر ui.Chart طرقًا مساعدة لإنشاء DataTable و عرض الرسوم البيانية من عناصر Image وImageCollection وFeature وFeatureCollection وArray وList. تقبل كل دالة نوع بيانات معيّنًا وتشمل methods لتقليل البيانات إلى تنسيق جدولي في مجموعة متنوعة من الترتيبات التي تحدّد تعيين البيانات إلى سلاسل الرسوم البيانية ومحوريها.

يُرجى الانتقال إلى الروابط التالية لمعرفة كيفية إنشاء رسم بياني لكل نوع من أنواع البيانات:

أنواع الرسوم البيانية

يمكن إنشاء مجموعة متنوعة من أنواع الرسوم البيانية، مثل: الرسم البياني بالنقاط المبعثرة والرسم البياني الخطي والرسم البياني الشريطي والرسم البياني الدائري والمخطّط التكراري. على وجه التحديد، يمكن إنشاء أي نوع من الرسوم البيانية المتوفّر في حزمة corechart في "رسومات Google البيانية". استخدِم الطريقة ui.Chart.setChartType() لضبط نوع الرسم البياني. تتضمّن كل صفحة مرتبطة في قسمَي الرسوم البيانية لعناصر Earth Engine و رسومات بيانية DataTable أمثلة على إنشاء أنواع متعددة من الرسوم البيانية.

استخدِم السلاسل التالية كمدخلات لطريقة ui.Chart.setChartType():

'ScatterChart'
'LineChart'
'ColumnChart'
'BarChart'
'PieChart'
'AreaChart'

يُرجى الاطّلاع على المثال أدناه:

var data = ee.List([0, 1, 2, 3, 4, 5]);
var chart = ui.Chart.array.values(data, 0, data)
  .setChartType('ColumnChart');
print(chart);

العرض والتنزيل

يمكن عرض التطبيقات المصغّرة ui.Chart بثلاث طرق:

var data = ee.List([0, 1, 2, 3, 4, 5]);
var chart = ui.Chart.array.values(data, 0, data);
print(chart);

var data = ee.List([0, 1, 2, 3, 4, 5]);
var chart = ui.Chart.array.values(data, 0, data);
var chartPanel = ui.Panel(chart);
Map.add(chartPanel);
  • في علامة تبويب متصفّح منفصلة، انقر على رمز النافذة المنبثقة () في أعلى يسار التطبيق المصغّر ui.Chart المعروض. تقدّم الصفحة الجديدة عرضًا في النافذة الكاملة وخيارات لتنزيل الرسم البياني كرسم رسومات تشكل (PNG أو SVG) أو ملف CSV للبيانات الأساسية.

التفاعل

تكون الرسوم البيانية تفاعلية تلقائيًا. مرِّر مؤشر الماوس فوق النقاط والخطوط والأشرطة وما إلى ذلك للاطّلاع على قيم x وy والسلسلة المتعلّقة بها. يمكن تكبير/تصغير المحاور وتحريكها اختياريًا من خلال تفعيل وظيفة "المستكشف" في الرسم البياني.

التصميم

يمكن تخصيص "رسومات Google البيانية" بشكل كبير من خلال سمات التصميم. استخدِم الطريقة ui.Chart.setOptions() لضبط سمات نمط الرسم البياني. راجِع دليل تصميم الرسم البياني للاطّلاع على التفاصيل الكاملة.

القيود

لن تعرِض دوال ui.Chart سوى 5,000 ميزة. إذا كان FeatureCollection أو ImageCollection أو Array أو List يتضمّن المزيد من العناصر، ننصحك بالتفكير في الطرق التي يمكنك من خلالها الحد من البيانات. إذا كانت لديك سلسلة زمنية طويلة تتضمن معدّل تكرار مرتفع، جرِّب استخدام فترة زمنية أقصر أو أخذ عيّنات زمنية أو إنشاء مركبات زمنية. إذا كانت المشكلة مرتبطة بموقع جغرافي، جرِّب استخدام مجموعة فرعية عشوائية. إذا كنت تعمل بالبكسل في قائمة أو صفيف، جرِّب استخدام نطاق أكبر قليلاً أو منطقة أصغر.

قد يتعذّر إنشاء رسم بياني في حال كانت العمليات الحسابية تستغرق وقتًا طويلاً بسبب حدود التفاعل في "محرِّر الرموز". إذا انتهت مهلة طلب الرسم البياني، حاوِل تصدير الخطوات الوسيطة لتحليلك وإعادة إنشاء الرسم البياني من مواد العرض التي تم تصديرها.