واحد ui.Chart.image شامل مجموعهای از توابع برای کاهش اشیاء Image براساس منطقه(ها) و ارائه نمودارها از نتایج است. انتخاب تابع، ترتیب دادهها را در نمودار تعیین میکند، یعنی آنچه مقادیر محور x و y را تعریف میکند و آنچه مجموعه را تعریف میکند. از شرحها و مثالهای تابع زیر برای تعیین بهترین تابع و نوع نمودار برای هدفتان استفاده کنید.
توابع نمودار
از نمودارهای طرح زیر بهعنوان راهنمای تصویری برای درک نحوه عملکرد هر تابع برای مرتبسازی نتایج کاهش ناحیه تصویر در نمودار استفاده کنید؛ یعنی چه عناصری مقادیر x، مقادیر y، و سریها را تعریف میکنند.
مناطق کاهش در امتداد محور x رسم میشوند و با مقادیر ویژگی انتخابشده برچسبگذاری میشوند. سریها با نامهای باندی تعریف میشوند که نتایج کاهش منطقه آنها در امتداد محور y رسم شده است.
باندها در امتداد محور x رسم میشوند. مجموعهها براساس مقادیر مشخصه عارضه برچسبگذاری میشوند. کاهش منطقه تعریفشده توسط هندسه ویژگیهای سری مربوطه در امتداد محور y رسم میشود.
نوارهای داده در امتداد محور x رسم میشوند. مجموعهها با مقادیر یکتا در باند کلاس نشان داده میشوند. موقعیت محور Y با نتایج کاهش منطقه برای پیکسلهای تشکیلدهنده هر سری تعریف میشود.
هیستوگرام فراوانی برای مقادیر باندهای انتخابشده.
- محور X: دستههای هیستوگرام برای مقادیر باندهای انتخابشده
- محور Y: فراوانی پیکسلهای واجدشرایط برای هر سطل هیستوگرام
دادههای نمونه
مثالهای زیر به FeatureCollection متشکل از سه
ویژگی بومناحیه متکی هستند که مناطقی را تعریف میکنند که دادههای تصویر براساس آنها کاهش مییابد. دادههای
Image هنجارهای اقلیمی PRISM هستند که در آنها باندها متغیرهای اقلیمی را
در هر ماه توصیف میکنند؛ مثلاً بارش ژوئیه یا میانگین دمای ژانویه.
با نحوه ایجاد این دارایی آشنا شوید.
ui.Chart.image.byRegion
نمودار ستونی
در این مثال، نوارهای تصویر نشاندهنده میانگین دمای ماهانه به میانگین بین پیکسلهای متقاطع هریک از سه بومناحیه کاهش مییابد. نتایج بهصورت ستونهایی برای هر ماه براساس بومناحیه ترسیم میشوند، که در آن ارتفاع ستون نشاندهنده میانگین دمای ماهانه مربوطه است.
ویرایشگر کد (جاوا اسکریپت)
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Load PRISM climate normals image collection; convert images to bands. var normClim = ee.ImageCollection('OREGONSTATE/PRISM/Norm91m').toBands(); // Define the chart and print it to the console. var chart = ui.Chart.image .byRegion({ image: normClim.select('[0-9][0-9]_tmean'), regions: ecoregions, reducer: ee.Reducer.mean(), scale: 500, xProperty: 'label' }) .setSeriesNames([ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ]) .setChartType('ColumnChart') .setOptions({ title: 'Average Monthly Temperature by Ecoregion', hAxis: {title: 'Ecoregion', titleTextStyle: {italic: false, bold: true}}, vAxis: { title: 'Temperature (°C)', titleTextStyle: {italic: false, bold: true} }, colors: [ '604791', '1d6b99', '39a8a7', '0f8755', '76b349', 'f0af07', 'e37d05', 'cf513e', '96356f', '724173', '9c4f97', '696969' ] }); print(chart);
نمودار میلهای
نمودار ستونی قبلی را میتوان با تغییر دادن ورودی .setChartType() از 'ColumnChart' به 'BarChart' بهصورت نمودار میلهای ارائه کرد.
var chart = ui.Chart.image .byRegion({ image: normClim.select('[0-9][0-9]_tmean'), regions: ecoregions, reducer: ee.Reducer.mean(), scale: 500, xProperty: 'label' }) .setSeriesNames([ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ]) .setChartType('BarChart') .setOptions({ title: 'Average Monthly Temperature by Ecoregion', hAxis: { title: 'Temperature (°C)', titleTextStyle: {italic: false, bold: true} }, vAxis: {title: 'Ecoregion', titleTextStyle: {italic: false, bold: true}}, colors: [ '604791', '1d6b99', '39a8a7', '0f8755', '76b349', 'f0af07', 'e37d05', 'cf513e', '96356f', '724173', '9c4f97', '696969' ] });
نمودار ستونی پشتهای
گزینه نمودار isStacked مشخص میکند که ستونهای نمودار پشتهای هستند یا نه.
چندین گزینه
برای چیدن ارائه شده است. مثالهای زیر استفاده از گزینههای
'absolute' و 'relative' را نشان میدهند.
مطلق
نمودار میلهای پشتهای مطلق مجموع یک متغیر عددی را
با افزایشهای یک سری متغیر طبقهای مشارکتکننده مرتبط میکند. برای مثال، در
این نمونه، کل بارش بهعنوان انباشت بارش ماهانه
درطول یک سال، براساس بومناحیه رسم شده است. مجموع بارش ماهانه از نوارهای تصویر مشتق میشود، که هر نوار نشاندهنده شبکهای از میانگین مجموع بارش برای یک ماه معین است، که به میانگین پیکسلهای متقاطع هریک از سه بومناحیه کاهش مییابد. گزینه نمودار isStacked روی 'absolute' تنظیم شده است تا
نتایج را بهعنوان مقادیر مطلق قالببندی کند.
ویرایشگر کد (جاوا اسکریپت)
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Load PRISM climate normals image collection; convert images to bands. var normClim = ee.ImageCollection('OREGONSTATE/PRISM/Norm91m').toBands(); // Define the chart and print it to the console. var chart = ui.Chart.image .byRegion({ image: normClim.select('[0-9][0-9]_ppt'), regions: ecoregions, reducer: ee.Reducer.mean(), scale: 500, xProperty: 'label' }) .setSeriesNames([ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ]) .setChartType('ColumnChart') .setOptions({ title: 'Average Monthly Precipitation by Ecoregion', hAxis: {title: 'Ecoregion', titleTextStyle: {italic: false, bold: true}}, vAxis: { title: 'Precipitation (mm)', titleTextStyle: {italic: false, bold: true} }, colors: [ '604791', '1d6b99', '39a8a7', '0f8755', '76b349', 'f0af07', 'e37d05', 'cf513e', '96356f', '724173', '9c4f97', '696969' ], isStacked: 'absolute' }); print(chart);
خویشاوند
نمودار میلهای پشتهای مطلق قبلی را با تغییر دادن گزینه نمودار isStacked از 'absolute' به 'relative' به نمودار میلهای پشتهای نسبی تبدیل کنید. نمودار میلهای پشتهای نسبی، نسبت سری متغیر رستهای مشارکتکننده را به کل متغیر عددی مرتبط میکند.
برای مثال، در این نمونه، بارش ماهانه بهعنوان نسبتی از کل بارش سالانه، براساس بومناحیه، ترسیم شده است.
var chart = ui.Chart.image .byRegion({ image: normClim.select('[0-9][0-9]_ppt'), regions: ecoregions, reducer: ee.Reducer.mean(), scale: 500, xProperty: 'label' }) .setSeriesNames([ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ]) .setChartType('ColumnChart') .setOptions({ title: 'Average Monthly Precipitation by Ecoregion', hAxis: {title: 'Ecoregion', titleTextStyle: {italic: false, bold: true}}, vAxis: { title: 'Precipitation (mm)', titleTextStyle: {italic: false, bold: true} }, colors: [ '604791', '1d6b99', '39a8a7', '0f8755', '76b349', 'f0af07', 'e37d05', 'cf513e', '96356f', '724173', '9c4f97', '696969' ], isStacked: 'relative' });
نمودار پراکندگی
میانگین دمای ژانویه و ژوئیه برای نمونهای تصادفی از مکانها در ایالت کلرادو بهعنوان تابعی از ارتفاع رسم شده است. یک DEM بااستفاده از تابع sample نمونهبرداری میشود که یک FeatureCollection با ویژگی هندسی و ارتفاعی برمیگرداند. سپس از FeatureCollection حاصل بهعنوان شناسه برای پارامتر regions تابع ui.Chart.image.byRegion استفاده میشود.
مجموعهها براساس باندهای انتخابشده از تصویر هنجارهای اقلیمی ورودی تعریف میشوند.
ویرایشگر کد (جاوا اسکریپت)
// Load SRTM elevation data. var elev = ee.Image('CGIAR/SRTM90_V4').select('elevation'); // Subset Colorado from the TIGER States feature collection. var colorado = ee.FeatureCollection('TIGER/2018/States') .filter(ee.Filter.eq('NAME', 'Colorado')); // Draw a random sample of elevation points from within Colorado. var samp = elev.sample( {region: colorado, scale: 30, numPixels: 500, geometries: true}); // Load PRISM climate normals image collection; convert images to bands. var normClim = ee.ImageCollection('OREGONSTATE/PRISM/Norm91m').toBands(); // Define the chart and print it to the console. var chart = ui.Chart.image .byRegion({ image: normClim.select(['01_tmean', '07_tmean']), regions: samp, reducer: ee.Reducer.mean(), scale: 500, xProperty: 'elevation' }) .setSeriesNames(['Jan', 'Jul']) .setChartType('ScatterChart') .setOptions({ title: 'Average Monthly Colorado Temperature by Elevation', hAxis: { title: 'Elevation (m)', titleTextStyle: {italic: false, bold: true} }, vAxis: { title: 'Temperature (°C)', titleTextStyle: {italic: false, bold: true} }, pointSize: 4, dataOpacity: 0.6, colors: ['1d6b99', 'cf513e'], }); print(chart);
نمودار ترکیبی
برای سه بومناحیه در یک ee.FeatureCollection، میانگین دما و بارش مربوطه برای ماه ژوئن رسم شده است. نتایج از کاهش منطقهای تصویری بهدست میآید که هر باند آن شبکهای از هنجارهای اقلیمی است که بارش و دمای ماهانه را توصیف میکند؛ باندهایی که دما و بارش ژوئن را نشان میدهند زیرمجموعه هستند. ازآنجاکه بارش
و دما واحدهای متفاوتی دارند،
با تنظیم گزینههای series و vAxes
از دو محور y
استفاده میشود. به استفاده از گزینه
series.targetAxisIndex برای تعریف اینکه کدام متغیر در محور y راست
و چپ رسم میشود توجه کنید. از نمادهای مختص سری (نقطهها و ستونها) برای تشخیص آسانتر دو متغیر با واحدهای مختلف استفاده میشود.
ویرایشگر کد (جاوا اسکریپت)
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Load PRISM climate normals image collection; convert images to bands. var normClim = ee.ImageCollection('OREGONSTATE/PRISM/Norm91m').toBands(); // Define the chart and print it to the console. var chart = ui.Chart.image .byRegion({ image: normClim.select(['06_tmean', '06_ppt']), regions: ecoregions, reducer: ee.Reducer.mean(), scale: 500, xProperty: 'label' }) .setSeriesNames(['Precipitation', 'Temperature']) .setChartType('ColumnChart') .setOptions({ title: 'Average June Temperature and Precipitation by Ecoregion', series: { 0: {targetAxisIndex: 1, type: 'bar', color: '1d6b99'}, 1: { targetAxisIndex: 0, type: 'line', lineWidth: 0, pointSize: 10, color: 'e37d05' } }, hAxis: {title: 'Ecoregion', titleTextStyle: {italic: false, bold: true}}, vAxes: { 0: { title: 'Temperature (°C)', baseline: 0, titleTextStyle: {italic: false, bold: true, color: 'e37d05'} }, 1: { title: 'Precipitation (mm)', titleTextStyle: {italic: false, bold: true, color: '1d6b99'} }, }, bar: {groupWidth: '40%'}, }); print(chart);
ui.Chart.image.regions
راهاندازی نمونه
تابع ui.Chart.image.regions فهرستی را میپذیرد که به شما امکان میدهد برچسب و ترتیب نامهای باند را در امتداد محور x با اختصاص دادن مقادیر عددی به آنها کنترل کنید. نمودارهای زیر از این گزینه برای تنظیم نام باندها بهعنوان برچسب ماه و مرتبسازی آنها بهترتیب زمانی برای میانگین بارش ماهانه استفاده میکنند.
نمودار ستونی
این نمودار کل میانگین بارش در ماه را برای سه بومناحیه نشان میدهد.
نتایج از کاهش منطقهای تصویری بهدست میآید که در آن هر باند شبکهای از میانگین کل بارش برای یک ماه معین است. نوارها در امتداد محور x رسم میشوند و مناطق مجموعه را تعریف میکنند. به عملیات سمت کارخواه که برای تعریف ورودیهای گزینههای نمودار xLabels و ticks برای ترتیب سفارشی محور x استفاده میشود توجه کنید؛ عملیات کارخواه لازم است زیرا گزینههای ارائهشده به تابع setOptions باید اشیای سمت کارخواه باشند (برای درک تفاوت، به کارخواه درمقابل سرور مراجعه کنید). برای
تبدیل به نمودار میلهای، از 'BarChart' بهعنوان ورودی .setChartType() استفاده کنید.
ویرایشگر کد (جاوا اسکریپت)
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Load PRISM climate normals image collection, convert images to bands, and // subset precipitation bands. var precip = ee.ImageCollection('OREGONSTATE/PRISM/Norm91m') .toBands() .select('[0-9][0-9]_ppt'); // Define a dictionary that associates band names with values and labels. var precipInfo = { '01_ppt': {v: 1, f: 'Jan'}, '02_ppt': {v: 2, f: 'Feb'}, '03_ppt': {v: 3, f: 'Mar'}, '04_ppt': {v: 4, f: 'Apr'}, '05_ppt': {v: 5, f: 'May'}, '06_ppt': {v: 6, f: 'Jun'}, '07_ppt': {v: 7, f: 'Jul'}, '08_ppt': {v: 8, f: 'Aug'}, '09_ppt': {v: 9, f: 'Sep'}, '10_ppt': {v: 10, f: 'Oct'}, '11_ppt': {v: 11, f: 'Nov'}, '12_ppt': {v: 12, f: 'Dec'} }; // Organize precipitation information into objects for defining x values and // their tick labels. Note that chart options provided to the .setOptions() // function must be client-side objects, which is why a client-side for // loop is used to iteratively populate lists from the above dictionary. var xPropVals = []; // List to codify x-axis band names as values. var xPropLabels = []; // Holds dictionaries that label codified x-axis values. for (var key in precipInfo) { xPropVals.push(precipInfo[key].v); xPropLabels.push(precipInfo[key]); } // Define the chart and print it to the console. var chart = ui.Chart.image .regions({ image: precip, regions: ecoregions, reducer: ee.Reducer.mean(), scale: 5e3, seriesProperty: 'label', xLabels: xPropVals }) .setChartType('ColumnChart') .setOptions({ title: 'Average Ecoregion Precipitation by Month', hAxis: { title: 'Month', titleTextStyle: {italic: false, bold: true}, ticks: xPropLabels }, vAxis: { title: 'Precipitation (mm)', titleTextStyle: {italic: false, bold: true} }, colors: ['f0af07', '0f8755', '76b349'], }); print(chart);
نمودار خطی
نمودار ستونی قبلی را میتوان با تغییر دادن ورودی .setChartType() از 'ColumnChart' به 'LineChart' بهصورت نمودار خطی ارائه کرد.
var chart = ui.Chart.image .regions({ image: precip, regions: ecoregions, reducer: ee.Reducer.mean(), scale: 500, seriesProperty: 'label', xLabels: xPropVals }) .setChartType('LineChart') .setOptions({ title: 'Average Ecoregion Precipitation by Month', hAxis: { title: 'Month', titleTextStyle: {italic: false, bold: true}, ticks: xPropLabels }, vAxis: { title: 'Precipitation (mm)', titleTextStyle: {italic: false, bold: true} }, colors: ['f0af07', '0f8755', '76b349'], lineSize: 5 });
نمودار مساحتی
نمودار ستونی قبلی را میتوان با تغییر دادن ورودی .setChartType() از 'ColumnChart' به 'AreaChart' بهصورت نمودار مساحتی ارائه کرد.
var chart = ui.Chart.image .regions({ image: precip, regions: ecoregions, reducer: ee.Reducer.mean(), scale: 500, seriesProperty: 'label', xLabels: xPropVals }) .setChartType('AreaChart') .setOptions({ title: 'Average Ecoregion Precipitation by Month', hAxis: { title: 'Month', titleTextStyle: {italic: false, bold: true}, ticks: xPropLabels }, vAxis: { title: 'Precipitation (mm)', titleTextStyle: {italic: false, bold: true} }, colors: ['f0af07', '0f8755', '76b349'], lineSize: 5 });
نمودار دایرهای
میانگین بارش ماهانه بهصورت نسبتی از میانگین کل بارش سالانه برای بومناحیه جنگلی نمایش داده میشود. نوارهای تصویر نشاندهنده بارش ماهانه زیرمجموعهای از مجموعه دادههای هنجارهای اقلیمی هستند و به میانگین پیکسلهای متقاطع با بومناحیه کاهش مییابند.
ویرایشگر کد (جاوا اسکریپت)
// Import the example feature collection, subset the forest ecoregion. var forest = ee.FeatureCollection('projects/google/charts_feature_example') .filter(ee.Filter.eq('label', 'Forest')); // Load PRISM climate normals image collection, convert images to bands. var normClim = ee.ImageCollection('OREGONSTATE/PRISM/Norm91m').toBands(); // Define x-axis labels to replace default band names. var monthNames = [ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ]; // Define the chart and print it to the console. var chart = ui.Chart.image .regions({ image: normClim.select('[0-9][0-9]_ppt'), regions: forest, reducer: ee.Reducer.mean(), scale: 5e3, seriesProperty: 'label', xLabels: monthNames }) .setChartType('PieChart') .setOptions({ title: 'Average Monthly Precipitation for Forest Ecoregion', colors: [ '604791', '1d6b99', '39a8a7', '0f8755', '76b349', 'f0af07', 'e37d05', 'cf513e', '96356f', '724173', '9c4f97', '696969' ] }); print(chart);
نمودار دونات
با تنظیم گزینه نمودار
pieHole
نمونه نمودار دایرهای را به نمودار دوناتی تبدیل کنید. ۰٫۴ و ۰٫۶ را بهعنوان مقادیر اولیه امتحان کنید.
var chart = ui.Chart.image .regions({ image: normClim.select('[0-9][0-9]_ppt'), regions: forest, reducer: ee.Reducer.mean(), scale: 5e3, seriesProperty: 'label', xLabels: monthNames }) .setChartType('PieChart') .setOptions({ title: 'Average Monthly Precipitation for Forest Ecoregion', colors: [ '604791', '1d6b99', '39a8a7', '0f8755', '76b349', 'f0af07', 'e37d05', 'cf513e', '96356f', '724173', '9c4f97', '696969' ], pieHole: 0.4 });
ui.Chart.image.byClass
نمودار خطی
تابع ui.Chart.image.byClass آمار مقدار باند را برای پیکسلهای درون مناطق طبقهبندیشده «باند کلاس» رسم میکند. در این مثال، از آن برای نمایش نمایه طیفی سه بومناحیه استفاده میشود. ویژگیهای بومناحیه شطرنجی میشوند و بهعنوان باند به تصویر بازتاب سطحی (SR) MODIS اضافه میشوند. برای هر کلاس بومناحیه و باند بازتاب، میانگین پیکسل مربوطه محاسبه و روی محور y رسم میشود. طول موجهای مرکزی باندهای MODIS SR
تیکها و برچسبهای محور x را تعریف میکنند. توجه داشته باشید که گزینه نمودار خطی
curveType
روی 'function' تنظیم شده است تا خطوط هموار شوند.
ویرایشگر کد (جاوا اسکریپت)
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Convert ecoregion feature collection to a classified image. var regionsBand = ecoregions .reduceToImage({properties: ['value'], reducer: ee.Reducer.first()}) .rename('class'); // Define a MODIS surface reflectance composite. var modisSr = ee.ImageCollection('MODIS/061/MOD09A1') .filter(ee.Filter.date('2018-06-01', '2018-09-01')) .select('sur_refl_b0[0-7]') .mean(); // Reorder reflectance bands by ascending wavelength and // add the classified ecoregions image as a band to the SR collection and var modisSrClass = modisSr.select([2, 3, 0, 1, 4, 5, 6]).addBands(regionsBand); // Define a list of MODIS SR wavelengths for x-axis labels. var wavelengths = [469, 555, 655, 858, 1240, 1640, 2130]; // Define the chart and print it to the console. var chart = ui.Chart.image .byClass({ image: modisSrClass, classBand: 'class', region: ecoregions, reducer: ee.Reducer.mean(), scale: 500, classLabels: ['Desert', 'Forest', 'Grassland'], xLabels: wavelengths }) .setChartType('ScatterChart') .setOptions({ title: 'Ecoregion Spectral Signatures', hAxis: { title: 'Wavelength (nm)', titleTextStyle: {italic: false, bold: true}, viewWindow: {min: wavelengths[0], max: wavelengths[6]} }, vAxis: { title: 'Reflectance (x1e4)', titleTextStyle: {italic: false, bold: true} }, colors: ['f0af07', '0f8755', '76b349'], pointSize: 0, lineSize: 5, curveType: 'function' }); print(chart);
ui.Chart.image.histogram
هیستوگرام مقادیر پیکسل در منطقهای در اطراف سالت لیک سیتی، یوتا، ایالات متحده برای سه باند بازتاب سطحی MODIS نمایش داده میشود.
ویرایشگر کد (جاوا اسکریپت)
// Define a MODIS surface reflectance composite. var modisSr = ee.ImageCollection('MODIS/061/MOD09A1') .filter(ee.Filter.date('2018-06-01', '2018-09-01')) .select(['sur_refl_b01', 'sur_refl_b02', 'sur_refl_b06']) .mean(); // Define a region to calculate histogram for. var histRegion = ee.Geometry.Rectangle([-112.60, 40.60, -111.18, 41.22]); // Define the chart and print it to the console. var chart = ui.Chart.image.histogram({image: modisSr, region: histRegion, scale: 500}) .setSeriesNames(['Red', 'NIR', 'SWIR']) .setOptions({ title: 'MODIS SR Reflectance Histogram', hAxis: { title: 'Reflectance (x1e4)', titleTextStyle: {italic: false, bold: true}, }, vAxis: {title: 'Count', titleTextStyle: {italic: false, bold: true}}, colors: ['cf513e', '1d6b99', 'f0af07'] }); print(chart);