A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://developers.arcgis.com/javascript/latest/visualization/high-density-data/binning/ below:

Binning | Overview | ArcGIS Maps SDK for JavaScript 4.33

Argo float locations aggregated at a fixed bin level of 3. Level 3 is probably more useful at regional extents, but the global view can be a nice way to show density at a higher resolution. Binning allows you to see the density of features based on a geographic grid of cells.

What is binning?

Binning aggregates data to predefined cells, effectively representing feature data as a gridded polygon layer. Typically, bins are styled with a continuous color ramp and labeled with the count of features contained by the bin. The JS API uses the public domain geohash geocoding system to create the bins.

This is an effective way to show the density of features. Unlike clustering, binning shows feature density in geographic space, not screen space.

Binning allows you to effectively visualize where features stack on top of another or are in very close proximity to each other. Use the swipe widget above to compare a layer of points with a binned version of the same data.

Note

Binning can only be configured in a MapView.

Why is binning useful?

Large layers can be deceptive. What appears to be just a few points can in reality be several thousand. Binning allows you to visually represent the density of features in a geographic grid of cells.

For example, the following map shows the locations of thousands of Argo floats (similar to a buoy). Regions A and B both have a high density of features, making them impossible to compare without additional help.

Region A and region B both have a high density of features. It is impossible to tell how many points overlap in each area.

However, when binning is enabled, the user can now clearly compare the density of both regions.

Binning allows the user to easily compare the density of overlapping features at a glance. Warning

Binning should only be used as a visualization technique to reduce visual clutter because of many overlapping features or to provide a quick preview of feature density. It should not be used as a means of performing statistical analysis of data.

How binning works

Binning is configured on the featureReduction property of the layer. You can enable binning with minimal code by setting the featureReduction type to binning.

Use dark colors for code blocks Copy

1
2
3
layer.featureReduction = {
  type: "binning"
};

Since binning does not have a default renderer, you won't be able to see the bins without explicitly defining a renderer. The featureReduction property gives you control over many other binning properties, including the following:

Binning polylines and polygons

Binning is typically used to visualize large point layers, but may be used with any geometry type (since version 4.31). In the case of binning polyline or polygon features, the centroid of the line or polygon is used to determine the bin in which it is placed. This may lead to some features being placed in (or excluded from) unexpected bins. Because of this, special considerations should be taken when binning lines and polygons.

Tip

Use the following guidelines when binning lines or polygons:

See the Binning polylines for a good example of a binned polyline layer.

Examples Basic binning

The following example demonstrates how to enable binning and configure the renderer, labels, and a popup for displaying the feature count inside each bin. You must select a fixedBinLevel between 1-9 when enabling binning. Choose a bin level based on the data extent. The following table describes suggested bin levels given your data extent.

Fixed bin level Suggested data extent 1-3 Global extents. 3-5 Regional extents (e.g. countries and states). 5-7 Local communities (e.g. counties and cities). 7-9 Hyper local areas (e.g. neighborhoods and buildings).

You must also define aggregate fields to make the binning visualization meaningful. An aggregate field determines how to represent data from the underlying layer in its aggregate form (i.e. the bin). For example, to create an aggregate field for feature count inside the bin, use the count statistic type.

Use dark colors for code blocks Copy

1
2
3
4
5
6
7
8
layer.featureReduction = {
  type: "binning",
  fixedBinLevel: 2,
  fields: [{
    name: "aggregateCount",
    statisticType: "count"
  }]
};

This can now be used in the renderer, labels, and popup for each bin. These properties are configured just as they would be on any other layer type, except they must refer to aggregate fields defined in FeatureReductionBinning.fields instead of the underlying layer's fields. Typically, bins are styled with a continuous color visual variable as demonstrated in this example.

Argo float locations aggregated at a fixed bin level of 2. This is a great resolution for global data.

Expand

Use dark colors for code blocks Copy

32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70 70

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
      const featureReduction = {
        type: "binning",
        fixedBinLevel: 2,
        fields: [
          {
            name: "aggregateCount",
            alias: "Total count",
            statisticType: "count",
          },
        ],
        renderer: {
          type: "simple",
          symbol: {
            type: "simple-fill",
            color: [0, 255, 71, 1],
            outline: null,
            outline: {
              color: colors[0],
              width: 0,
            },
          },
          visualVariables: [
            {
              type: "color",
              field: "aggregateCount",
              legendOptions: {
                title: "Number of floats",
              },
              stops: [
                { value: 0, color: colors[0] },
                { value: 25, color: colors[1] },
                { value: 50, color: colors[2] },
                { value: 75, color: colors[3] },
                { value: 100, color: colors[4] },
              ],
            },
          ],
        },
Alternate binning styles

Bins can be styled with any renderer suitable for a polygon layer. This example demonstrates how to visualize bins based on two aggregate fields. The aggregate count is visualized with a size visual variable, and the average number of people injured in each crash is visualized using a color visual variable.

Car crashes (2020) aggregated to bins at a fixed level of 6. The size of each symbol indicates the total number of crashes. Color indicates the average number of injured motorists per crash.

Use dark colors for code blocks

54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135 135

Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line. Add line.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
      const featureReduction = {
        type: "binning",
        fixedBinLevel: 6,
        fields: [

          new AggregateField({
            name: "aggregateCount",
            statisticType: "count",
          }),
          new AggregateField({
            name: "AVG_MOTORIST_INJURED",
            alias: "Ratio of motorist injuries to crashes",
            onStatisticField: "NUMBER_OF_MOTORIST_INJURED",
            statisticType: "avg",
          }),

        ],
        renderer: {
          type: "simple",
          symbol: {
            type: "simple-marker",
            color: [0, 255, 71, 1],
            outline: null,
            outline: {
              color: "rgba(153, 31, 23, 0.3)",
              width: 0.3,
            },
          },

          visualVariables: [
            {
              type: "size",
              field: "aggregateCount",
              legendOptions: {
                title: "Total crashes",
              },
              minSize: {
                type: "size",
                valueExpression: "$view.scale",
                stops: [
                  { value: 18055, size: 18 },
                  { value: 36111, size: 12 },
                  { value: 72223, size: 8 },
                  { value: 144447, size: 4 },
                  { value: 288895, size: 2 },
                  { value: 577790, size: 1 },
                ],
              },
              maxSize: {
                type: "size",
                valueExpression: "$view.scale",
                stops: [
                  { value: 18055, size: 48 },
                  { value: 36111, size: 32 },
                  { value: 72223, size: 24 },
                  { value: 144447, size: 18 },
                  { value: 288895, size: 12 },
                  { value: 577790, size: 6 },
                ],
              },
              minDataValue: 10,
              maxDataValue: 300,
            },
            {
              type: "color",
              field: "AVG_MOTORIST_INJURED",
              legendOptions: {
                title: "% of motorists injured per crash",
              },
              stops: [
                { value: 0, color: colors[0], label: "No injuries" },
                { value: 0.1, color: colors[1] },
                { value: 0.3, color: colors[2], label: "30%" },
                { value: 0.5, color: colors[3] },
                { value: 0.75, color: colors[4], label: ">75%" },
              ],
            },
          ],

        },
      };
API support

The following table describes the geometry and view types that are suited well for each visualization technique.

Full support Partial support No support

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4