Модуль ui.Chart.image содержит набор функций для сокращения объектов Image по регионам и отрисовки диаграмм на основе результатов. Выбор функции определяет расположение данных на диаграмме, то есть то, что определяет значения по осям X и Y и что определяет ряд. Используйте следующие описания и примеры функций, чтобы определить, какая функция и тип диаграммы лучше всего подходят для ваших целей.
Функции диаграмм
Используйте следующие диаграммы в качестве визуального руководства, чтобы понять, как каждая функция упорядочивает результаты уменьшения области изображения на диаграмме, то есть какие элементы определяют значения x, значения y и серии.
Регионы сокращения наносятся на график вдоль оси X и помечаются значениями выбранного свойства объекта. Серии определяются названиями полос, результаты уменьшения регионов которых наносятся на график по оси Y.
Полосы наносятся вдоль оси X. Серии обозначаются значениями свойства объекта. Уменьшение региона, определяемого геометрией соответствующих объектов серии, наносится на график по оси Y.
Полосы данных наносятся вдоль оси X. Серии представлены уникальными значениями в диапазоне классов. Положение по оси Y определяется результатами сокращения региона для пикселей, составляющих каждую серию.
Гистограмма частоты для значений выбранных диапазонов.
- Ось X: интервалы гистограммы для значений выбранных диапазонов.
- Ось Y: частота пикселей, соответствующих каждому сегменту гистограммы.
Пример данных
В следующих примерах используется FeatureCollection, состоящий из трех объектов экорегиона, которые определяют регионы, по которым нужно сократить данные изображения. Данные Image – это климатические нормы PRISM, где полосы описывают климатические переменные за месяц, например количество осадков в июле или среднюю температуру в январе.
Подробнее о том, как был создан этот объект…
ui.Chart.image.byRegion
Столбчатая
В этом примере полосы изображения, представляющие среднюю месячную температуру, уменьшаются до среднего значения среди пикселей, пересекающих каждый из трех экорегионов. Результаты представлены в виде столбцов по месяцам для каждого экорегиона, где высота столбца указывает на соответствующую среднюю месячную температуру.
Редактор кода (JavaScript)
// 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', чтобы результаты были представлены в виде абсолютных значений.
Редактор кода (JavaScript)
// 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' });
Точечная диаграмма
Средние температуры января и июля для случайной выборки местоположений в штате Колорадо нанесены на график в зависимости от высоты над уровнем моря. Выборка ЦМР выполняется с помощью функции sample, которая возвращает FeatureCollection со свойствами геометрии и высоты. Полученный объект FeatureCollection затем используется в качестве аргумента для параметра regions функции ui.Chart.image.byRegion.
Ряды определяются выбранными полосами входного изображения климатических норм.
Редактор кода (JavaScript)
// 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. Результаты получены путем сокращения региона изображения, где каждая полоса представляет собой сетку климатических норм, описывающих месячные осадки и температуру; полосы, представляющие температуру и осадки в июне, являются подмножеством. Поскольку осадки и температура измеряются в разных единицах, используются две оси Y, для чего задаются параметры series и vAxes. Обратите внимание на использование параметра series.targetAxisIndex, который определяет, какая переменная будет нанесена на правую и левую оси Y. Для каждой серии используются свои символы (точки и столбцы), чтобы было проще различать переменные с разными единицами измерения.
Редактор кода (JavaScript)
// 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().
Редактор кода (JavaScript)
// 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 });
Круговая диаграмма
Среднемесячное количество осадков отображается как доля от среднего общего годового количества осадков для лесного экорегиона. Полосы изображений, представляющие месячные осадки, являются подмножеством набора данных о климатических нормах и уменьшены до среднего значения пикселей, пересекающих экорегион.
Редактор кода (JavaScript)
// 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. Попробуйте использовать в качестве начальных значений 0,4 и 0,6.
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', чтобы сгладить линии.
Редактор кода (JavaScript)
// 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.
Редактор кода (JavaScript)
// 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);