ImageryLayer - client side pixel filter

Explore in the sandboxView live

This sample uses an instance of ImageryLayer to visualize global sea temperature by filtering pixel values on the client-side. You can filter out the temperature values on the imagery layer by adjusting the slider thumbs. Filtering is accomplished through the pixelFilter property of the ImageryLayer. The function defined for this property determines how users can dynamically change the raster image on the client-side.

The service data is managed using a multidimensional mosaic dataset. Esri reserves the right to change or remove this service at any time and without notice.

The pixelFilter property is used in this sample to add a custom continuous color ramp to the pixels. The color is determined based on the temperature or the value of the pixel. To assign a color to the pixels, you must loop through all the pixels displayed in the view.

                                                                                                                                                                                                                                                        
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
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
<html>
  <head>
    <meta charset="utf-8" />
    <meta
      name="viewport"
      content="initial-scale=1,maximum-scale=1,user-scalable=no"/>
      <title>ImageryLayer - client side pixel filter | Sample | ArcGIS API for JavaScript 4.20</title>

    <link rel="stylesheet" href="https://js.arcgis.com/4.20/esri/themes/light/main.css" />
    <script src="https://js.arcgis.com/4.20/"></script>

    <style>
      html,
      body,
      #viewDiv {
        padding: 0;
        margin: 0;
        height: 100%;
        width: 100%;
      .slider {
        width: 100%;
        height: 60px;
      #infoDiv {
        padding: 10px;
        width: 500px;
    </style>

    <script>
      require([
        "esri/Map",
        "esri/views/MapView",
        "esri/layers/ImageryLayer",
        "esri/layers/support/DimensionalDefinition",
        "esri/layers/support/MosaicRule",
        "esri/widgets/Slider",
        "esri/core/watchUtils"
      ], function (
        Map,
      ) {
        // The URL to an image layer representing sea temperature
        const url =
          "https://sampleserver6.arcgisonline.com/arcgis/rest/services/ScientificData/SeaTemperature/ImageServer";
        const map = new Map({
          basemap: "dark-gray-vector"
        const view = new MapView({
          container: "viewDiv",
          map: map,
          zoom: 2,
          center: [-32, 28],
          popup: {
            actions: []
        /**********************************************************************************************
         **********************************************************************************************/
        const dimInfo = []; // Define dimensional definition as array
        // Multidimensional information of image service can be viewed at this
        // Service/multiDimensionalInfo
        // DEPTH: show only temperatures at sea surface
          new DimensionalDefinition({
            dimensionName: "StdZ", // Water depth
            values: [0], // Sea surface or 0ft
            isSlice: true
        // TIME: only show temperatures for the week of April 7, 2014
          new DimensionalDefinition({
            dimensionName: "StdTime", // time temp was recorded
            values: [1396828800000], // Week of April 7, 2014
            isSlice: true
        const mr = new MosaicRule({
          multidimensionalDefinition: dimInfo
        const layer = new ImageryLayer({
          url: url,
          pixelFilter: maskPixels,
          mosaicRule: mr,
          // The popup will display the temperature at the clicked location
          popupTemplate: {
            title: "Sea Surface Temperature",
            content: "{Raster.ServicePixelValue}° Celsius"
        // Add sea temperature layer to the map
        // Slider to mask imagery layer based on its pixel values
        const pixelSlider = new Slider({
          container: "pixelSlider",
          min: -3,
          max: 37,
          steps: 1,
          values: [-3, 37],
          visibleElements: {
            labels: true,
            rangeLabels: true
        view.ui.add("infoDiv", "bottom-left");
        pixelSlider.on(["thumb-drag", "thumb-change"], updatePixelFilter);
        let currentMin, currentMax;
        // This function is called when user is moves the slider thumb to
        // the pixel values of imagery layer based on temperature
        // if pixel value lies between slider min and max
        function updatePixelFilter() {
          distance = pixelSlider.values[0];
          currentMin = Math.floor(pixelSlider.values[0]);
          currentMax = Math.floor(pixelSlider.values[1]);
          document.getElementById("pixelVal").innerHTML =
            `Currently displaying locations with sea temperatures from ${currentMin} °C to ${currentMax} °C`;
        // /**********************************************************
        // * The PixelFilter function. This function is used to color the
        // * pixels. By default, each pixel has one band containing
        // * a temperature value. We will replace the single band with
        // * three bands - red, green, and blue to give color to the layer.
        // *********************************************************/
        function maskPixels(pixelData) {
          if (pixelData == null || pixelData.pixelBlock == null) {
            return;
          }
          if (currentMin == null || currentMax == null) {
            // layer is loaded get the min and max temp values from the layer
            updatePixelFilter();
          }

          // The pixelBlock stores the values of all pixels visible in the view
          const pixelBlock = pixelData.pixelBlock;
          // The pixels visible in the view
          const pixels = pixelBlock.pixels;
          let mask = pixelBlock.mask;

          // The number of pixels in the pixelBlock
          const numPixels = pixelBlock.width * pixelBlock.height;

          // Get the min and max values of the data in the current view
          const minVal = pixelData.pixelBlock.statistics[0].minValue;
          const maxVal = pixelData.pixelBlock.statistics[0].maxValue;

          // Calculate the factor by which to determine the red and blue
          // values in the colorized version of the layer
          const factor = 255.0 / (maxVal - minVal);
          if (pixels == null) {
            return;
          }

          // Get the pixels containing temperature values in the only band of the data
          const tempBand = pixels[0];
          const p1 = pixels[0];
          // Create empty arrays for each of the RGB bands to set on the pixelBlock
          const rBand = new Uint8Array(p1.length);
          const gBand = new Uint8Array(p1.length);
          const bBand = new Uint8Array(p1.length);

          if (mask == null) {
            mask = new Uint8Array(p1.length); //mask = new Uint8Array(p1.length);
            mask.fill(1);
            pixelBlock.mask = mask;
          }

          // Loop through all the pixels in the view
          for (let i = 0; i < numPixels; i++) {
            // skip noData pixels
            if (mask[i] ===0) {
              continue;
            }
            const tempValue = tempBand[i];
            const red = (tempValue - minVal) * factor;
            mask[i] =
              p1[i] >= Math.floor(currentMin) && p1[i] <= Math.floor(currentMax)
                ? 1
                : 0;

            //apply color based on temperature value of each pixel
            if (mask[i]) {
              // p[i] = Math.floor((p1[i] - minVal) * factor);
              rBand[i] = red;
              gBand[i] = 0;
              bBand[i] = 255 - red;
            }
          }

          // Set the new pixel values on the pixelBlock
          pixelData.pixelBlock.pixels = [rBand, gBand, bBand]; //assign rgb values to each pixel
          pixelData.pixelBlock.statistics = null;
          pixelData.pixelBlock.pixelType = "u8";
        }
        // Display popup when the layer view loads
        view.whenLayerView(layer).then(function (layerView) {
          watchUtils.whenFalseOnce(layerView, "updating", function (newVal) {
              title: "Sea Surface Temperature",
              content:
                "Click anywhere in the oceans to view the sea temperature at that location.",
              location: view.center
    </script>
  </head>

  <body>
    <div id="viewDiv"></div>
    <div id="infoDiv" class="esri-widget">
      <h4 class="esri-editor__title esri-heading">
        Sea Surface Temperature (°C) on April 7, 2014
      </h4>
      <br />
      <div id="pixelVal"></div>
      <div id="pixelSlider" class="slider"></div>
    </div>
  </body>
</html>

Since the image service has multidimensional information, you can set the multidimensionalDefinition property in the MosaicRule object to apply a pixelFilter based on water temperature at a specific water depth and time.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.