Das ui.Chart.feature-Modul enthält eine Reihe von Funktionen zum Rendern von Diagrammen aus Feature- und FeatureCollection-Objekten. Die Auswahl der Funktion bestimmt die Anordnung der Daten im Diagramm, d.h., was die Werte der X‑ und Y‑Achse und was die Reihe definiert. Anhand der folgenden Funktionsbeschreibungen und ‑beispiele können Sie die für Ihren Zweck am besten geeignete Funktion und den am besten geeigneten Diagrammtyp ermitteln.
Diagrammfunktionen
Anhand der folgenden Plotdiagramme können Sie sich ein Bild davon machen, wie die einzelnen Funktionen Elemente und ihre Eigenschaften in einem Diagramm anordnen, d.h., welche Elemente X-Werte, Y-Werte und Reihen definieren.
Die Features werden entlang der X-Achse anhand der Werte einer ausgewählten Property dargestellt. Reihen werden durch eine Liste von Eigenschaftsnamen definiert, deren Werte entlang der y-Achse dargestellt werden.
Die Feature-Properties werden nach Name entlang der X-Achse dargestellt. Die Werte der entsprechenden Properties werden entlang der Y-Achse dargestellt. Reihen sind Elemente, die mit Werten einer ausgewählten Property gekennzeichnet sind.
Die Features werden entlang der X-Achse anhand der Werte einer ausgewählten Property dargestellt. Reihen werden durch eindeutige Werte einer bestimmten Property definiert. Die Position auf der Y-Achse wird durch den Wert einer bestimmten Property definiert.
Häufigkeitshistogramm für Werte einer ausgewählten Property.
- X-Achse: Histogramm-Buckets für Werte einer ausgewählten Property
- Y-Achse: Häufigkeit der für jeden Histogramm-Bucket infrage kommenden Features
Beispieldaten
Die folgenden Beispiele basieren auf einer FeatureCollection, die aus drei Ökoregion-Elementen mit Eigenschaften besteht, die Klimanormalwerte beschreiben.
Beispieldaten ansehen
// Define three representative ecoregions in the USA. var desert = ee.Feature( ee.Geometry.Rectangle(-109.21, 31.42, -108.3, 32.03), {label: 'Desert', value: 0}); var forest = ee.Feature( ee.Geometry.Rectangle(-122.73, 43.45, -122.28, 43.91), {label: 'Forest', value: 1}); var grassland = ee.Feature( ee.Geometry.Rectangle(-101.81, 41.7, -100.53, 42.51), {label: 'Grassland', value: 2}); // Combine features into a feature collection. var ecoregions = ee.FeatureCollection([desert, forest, grassland]); // Load PRISM climate normals image collection; convert images to bands. var normClim = ee.ImageCollection('OREGONSTATE/PRISM/Norm81m').toBands(); // Summarize climate normals for each ecoregion feature as a set or properties. ecoregions = normClim.reduceRegions( {collection: ecoregions, reducer: ee.Reducer.mean(), scale: 5e4}); // Add a property for whether January temperature is warm or not. ecoregions = ecoregions.map(function(ecoregion) { return ecoregion.set('warm', ee.Number(ecoregion.get('01_tmean')).gt(0)); });
ui.Chart.feature.byFeature
Säulendiagramm
Die Elemente werden entlang der X-Achse dargestellt und mit den Werten einer ausgewählten Eigenschaft beschriftet. Reihen werden durch benachbarte Spalten dargestellt, die durch eine Liste von Attributnamen definiert sind, deren Werte entlang der Y-Achse dargestellt werden.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Define the chart and print it to the console. var chart = ui.Chart.feature .byFeature({ features: ecoregions.select('[0-9][0-9]_tmean|label'), 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);
Balkendiagramm
Die Elemente werden entlang der Y-Achse dargestellt und mit den Werten einer ausgewählten Property beschriftet. Reihen werden durch benachbarte Balken dargestellt, die durch eine Liste von Attributnamen definiert sind, deren Werte entlang der X-Achse dargestellt werden.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Define the chart and print it to the console. var chart = ui.Chart.feature .byFeature({ features: ecoregions.select('[0-9][0-9]_tmean|label'), 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' ] }); print(chart);
Gestapeltes Säulendiagramm
Absolut
Die Elemente werden entlang der X-Achse dargestellt und mit den Werten einer ausgewählten Eigenschaft beschriftet. Reihen werden durch gestapelte Spalten dargestellt, die durch eine Liste von Property-Namen definiert sind, deren Werte als kumulative Reihensumme entlang der y-Achse dargestellt werden.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Define the chart and print it to the console. var chart = ui.Chart.feature .byFeature({ features: ecoregions.select('[0-9][0-9]_ppt|label'), 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);
Verwandter
Die Elemente werden entlang der X-Achse dargestellt und mit den Werten einer ausgewählten Eigenschaft beschriftet. Reihen werden durch gestapelte Spalten dargestellt, die durch eine Liste von Attributnamen definiert sind, deren Werte entlang der Y-Achse als Prozentsatz der Summe der Reihen dargestellt werden.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Define the chart and print it to the console. var chart = ui.Chart.feature .byFeature({ features: ecoregions.select('[0-9][0-9]_ppt|label'), 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: 'percent' }); print(chart);
Streudiagramm
Die Elemente werden entlang der X-Achse dargestellt und mit den Werten einer ausgewählten Eigenschaft beschriftet. Reihen werden durch Punkte dargestellt, die durch eine Liste von Attributnamen definiert sind, deren Werte entlang der y-Achse dargestellt werden.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Define the chart and print it to the console. var chart = ui.Chart.feature .byFeature({ features: ecoregions, xProperty: 'label', yProperties: ['01_tmean', '07_tmean'] }) .setSeriesNames(['Jan', 'Jul']) .setChartType('ScatterChart') .setOptions({ title: 'Average Monthly Temperature by Ecoregion', hAxis: {title: 'Ecoregion', titleTextStyle: {italic: false, bold: true}}, vAxis: { title: 'Temperature (°C)', titleTextStyle: {italic: false, bold: true} }, pointSize: 10, colors: ['1d6b99', 'cf513e'], }); print(chart);
Kombinationsdiagramm
Die Elemente werden entlang der X-Achse dargestellt und mit den Werten einer ausgewählten Eigenschaft beschriftet. Reihen werden durch Punkte und Spalten dargestellt, die durch eine Liste von Attributnamen definiert sind, deren Werte entlang der Y-Achse dargestellt werden. Für dieses Diagramm werden zwei Achsen und ein reihenspezifisches Styling verwendet.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Define the chart and print it to the console. var chart = ui.Chart.feature .byFeature({ features: ecoregions, xProperty: 'label', yProperties: ['06_ppt', '06_tmean'] }) .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.feature.byProperty
Beispiel für eine Einrichtung
Die Funktion ui.Chart.feature.byProperty akzeptiert ein Wörterbuch, mit dem Sie das Label und die Reihenfolge der Property-Namen entlang der X-Achse steuern können, indem Sie ihnen numerische Werte zuweisen. In den folgenden kartesischen Rasterdiagrammen wird diese Option verwendet, um Monatslabels festzulegen und Monatsnamen für die durchschnittlichen monatlichen Niederschläge in chronologischer Reihenfolge zu sortieren.
Säulendiagramm
Die Feature-Eigenschaften werden entlang der x-Achse dargestellt, beschriftet und nach einem Wörterbucheintrag sortiert. Die Werte der angegebenen Eigenschaften werden entlang der y-Achse dargestellt. Reihen sind Elemente, die durch Spalten dargestellt und mit Werten einer ausgewählten Property beschriftet werden. Verwenden Sie .setChartType('BarChart'), um ein Balkendiagramm zu erstellen.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Define a dictionary that associates property 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 property information into objects for defining x properties and // their tick labels. var xPropValDict = {}; // Dictionary to codify x-axis property names as values. var xPropLabels = []; // Holds dictionaries that label codified x-axis values. for (var key in precipInfo) { xPropValDict[key] = precipInfo[key].v; xPropLabels.push(precipInfo[key]); } // Define the chart and print it to the console. var chart = ui.Chart.feature .byProperty({ features: ecoregions, xProperties: xPropValDict, seriesProperty: 'label' }) .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);
Liniendiagramm
Die Feature-Eigenschaften werden entlang der x-Achse dargestellt, beschriftet und nach einem Wörterbucheintrag sortiert. Die Werte der angegebenen Eigenschaften werden entlang der y-Achse dargestellt. Reihen sind Elemente, die durch Linien dargestellt und mit Werten einer ausgewählten Property beschriftet werden.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Define a dictionary that associates property 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 property information into objects for defining x properties and // their tick labels. var xPropValDict = {}; // Dictionary to codify x-axis property names as values. var xPropLabels = []; // Holds dictionaries that label codified x-axis values. for (var key in precipInfo) { xPropValDict[key] = precipInfo[key].v; xPropLabels.push(precipInfo[key]); } // Define the chart and print it to the console. var chart = ui.Chart.feature .byProperty({ features: ecoregions, xProperties: xPropValDict, seriesProperty: 'label' }) .setChartType('ScatterChart') .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, pointSize: 0 }); print(chart);
Flächendiagramm
Die Feature-Eigenschaften werden entlang der x-Achse dargestellt, beschriftet und nach einem Wörterbucheintrag sortiert. Die Werte der angegebenen Eigenschaften werden entlang der y-Achse dargestellt. Reihen sind Elemente, die durch Linien und schattierte Bereiche dargestellt und mit Werten einer ausgewählten Eigenschaft gekennzeichnet sind.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Define a dictionary that associates property 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 property information into objects for defining x properties and // their tick labels. var xPropValDict = {}; // Dictionary to codify x-axis property names as values. var xPropLabels = []; // Holds dictionaries that label codified x-axis values. for (var key in precipInfo) { xPropValDict[key] = precipInfo[key].v; xPropLabels.push(precipInfo[key]); } // Define the chart and print it to the console. var chart = ui.Chart.feature .byProperty({ features: ecoregions, xProperties: xPropValDict, seriesProperty: 'label' }) .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, pointSize: 0, curveType: 'function' }); print(chart);
Kreisdiagramm
Der Kreis ist ein Feature und jeder Ausschnitt ist ein Property-Label, dessen Wert als Prozentsatz der Summe aller Werte der Properties dargestellt wird, aus denen der Kreis besteht.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Subset the forest ecoregion feature and select the monthly precipitation // properties, rename them as abbreviated months. var thisForest = ecoregions.filter(ee.Filter.eq('label', 'Forest')) .select(Object.keys(precipInfo), [ '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.feature .byProperty({ features: thisForest, xProperties: [ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ] }) .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);
Ringdiagramm
Sie können ein Tortendiagramm in ein Donut-Diagramm umwandeln, indem Sie die Diagrammoption pieHole festlegen. Werte zwischen 0,4 und 0,6 eignen sich für die meisten Diagramme am besten.
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Subset the forest ecoregion feature and select the monthly precipitation // properties, rename them as abbreviated months. var thisForest = ecoregions.filter(ee.Filter.eq('label', 'Forest')) .select(Object.keys(precipInfo), [ '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.feature .byProperty({ features: thisForest, xProperties: [ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ] }) .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, }); print(chart);
ui.Chart.feature.groups
Säulendiagramm
Die Elemente werden entlang der X-Achse dargestellt und mit den Werten einer ausgewählten Eigenschaft beschriftet.
Reihen werden durch Spalten dargestellt, die durch die eindeutigen Werte einer bestimmten Eigenschaft definiert sind. Die Position auf der Y-Achse wird durch den Wert einer bestimmten Property definiert. Dieses Diagramm kann in ein Streudiagramm geändert werden, indem Sie den Diagrammtyp auf 'ScatterChart' (.setChartType('ScatterChart')) festlegen. Wenn die Zeit die Variable der X-Achse ist, können Sie auch ein Liniendiagramm verwenden: .setChartType('LineChart').
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Define the chart and print it to the console. var chart = ui.Chart.feature .groups({ features: ecoregions, xProperty: 'label', yProperty: '01_tmean', seriesProperty: 'warm' }) .setSeriesNames(['Warm', 'Cold']) .setChartType('ColumnChart') .setOptions({ title: 'Average January Temperature by Ecoregion', hAxis: {title: 'Ecoregion', titleTextStyle: {italic: false, bold: true}}, vAxis: { title: 'Jan temp (°C)', titleTextStyle: {italic: false, bold: true} }, bar: {groupWidth: '80%'}, colors: ['cf513e', '1d6b99'], isStacked: true }); print(chart);
ui.Chart.feature.histogram
Die x-Achse wird durch Wertebereiche für den Wertebereich einer ausgewählten Property definiert. Die y-Achse ist die Anzahl der Elemente im jeweiligen Bereich.
// Load PRISM climate normals image collection; convert images to bands. var normClim = ee.ImageCollection('OREGONSTATE/PRISM/Norm81m').toBands(); // Make a point sample of climate variables for a region in western USA. var region = ee.Geometry.Rectangle(-123.41, 40.43, -116.38, 45.14); var climSamp = normClim.sample(region, 5000); // Define the chart and print it to the console. var chart = ui.Chart.feature .histogram({features: climSamp, property: '07_ppt', maxBuckets: 30}) .setOptions({ title: 'July Precipitation Distribution for NW USA', hAxis: { title: 'Precipitation (mm)', titleTextStyle: {italic: false, bold: true} }, vAxis: { title: 'Pixel count', titleTextStyle: {italic: false, bold: true} }, colors: ['1d6b99'], legend: {position: 'none'} }); print(chart);