Radiometric footprint recalculation

Available with Standard or Advanced license.

When you need to recalculate the footprint to remove pixel values from a mosaic dataset, you can use the Build Footprints tool. For example, the footprint was originally the entire dimension of the image, but it was since rotated, and you want it to reflect the actual valid pixel values of the images.

A raster dataset footprint
An example of a raster dataset footprint is shown.

Some of the Build Footprints tool parameters can be modified to affect the footprint output. For example, there may be a range of pixel values on the high and low ends of the data values that you don't want included. Normally, these pixel values can be defined, but if the data is stored with lossy compression, the values will have variability. For example, instead of all null data values of 0, the values may be 0–3.

Recommended parameter settings

The following table describes the parameters that can be altered to radiometrically adjust the footprints:

ParameterDescription

Minimum data value

Exclude pixels with a value less than this number.

For example, with 8-bit data, the values can range from 0 to 255. A value around 0 represents very dark colors, such as black border pixels. When you specify 1, the only value less than 1 is 0, so all 0 values will be considered invalid data and will be removed from the perimeter of the footprint. If the imagery is compressed using a lossy compression method, define a value slightly greater than 1 to remove all the black pixels. When dark areas, such as shadows, have been incorrectly removed from the footprint, this value should be decreased.

Maximum data value

Exclude pixels with a value greater than this number.

For example, with 8-bit data, the values can range from 0 to 255. A value around 255 represents very bright colors, such as white clouds and snow. If you specify 245, all values between 246 and 255 will be removed from the perimeter of the footprint.

Approximate number of vertices

Choose between 4 and 10,000. More vertices will improve accuracy but can extend processing time. A value of -1 will calculate all vertices. More vertices will increase accuracy but also the processing time.

The minimum value is 4 and the maximum value is 10,000. The greater this value, the more accurate and irregular the polygon and the longer the processing time.

A value of -1 will show all the vertices in the footprint, so your polygon footprint will not be generalized.

Shrink distance

Clip the footprint by this distance. This can eliminate artifacts from using lossy compression, which causes the edges of the image to overlap into NoData areas.

Shrinking of the polygon is used to counteract effects of lossy compression, which causes edges of the image to overlap into NoData areas.

Request size

Set the resampled extent (in columns and rows) for the raster when building footprints. Greater image resolution provides more detail in the raster dataset but increases the processing time. A value of -1 will compute the footprint at the original resolution.

You can increase or decrease this value based on the complexity of your raster data. Greater image resolution provides more detail in the raster dataset and thereby increases the processing time.

A value of -1 will not resample the footprint, so it will compute the footprint at the native pixel size.

Minimum region size

Avoid small holes in your imagery when using pixel values to create a mask. For example, your imagery may have a range of values from 0 to 255, and to mask clouds, you've excluded values from 245 to 255, which may cause other, noncloud pixels to be masked as well. If those areas are smaller than the number of pixels specified here, they will not be masked out.

This value is specified in pixels, and it is directly related to the request size, not to the pixel resolution of the source raster.

Maintain sheet edges

Check this parameter when using raster datasets that have been tiled or that line up along seams with little or no overlap. An analysis of the image edges is performed so that the sheet edges are not removed.

The tables below describe various types of datasets that may have NoData borders and the recommended parameter settings.

Caution:

The shrink distance below is defined by pixels, but the units of the parameter must be entered in the units of the mosaic dataset's coordinate system. For example, if the units are meters, each pixel is 10 meters, and the recommended shrink distance is 3, enter 30.

Regular and clipped to sheets

These parameters are used for datasets in which the data pixels in each image form a rotated rectangular area. The resulting imagery will be clipped to a new sheet or tile. The datasets are typically created by reprojection of images or scenes, and cut to map sheets or tiles with little or no overlap. The parameters are set so that the footprint will contain only a few vertices. An analysis of the edges is performed to maintain the sheet or tile boundaries.

ParameterNo or lossless compressionLossy compressed

Minimum data value

1

10

Maximum data value

254

245

Approximate number of vertices

4

4

Shrink distance

2 pixels

6 pixels

Request size

1000

1000

Maintain sheet edges

Yes

Yes

Irregular and clipped to sheets

These parameters are used for datasets in which the data pixels do not form rectangular areas. The resulting imagery can be cut into map sheets or tiles. The datasets are typical for imagery along pipelines or other linear corridors. The pixel areas cover the linear feature, and the images are then mosaicked and divided into tiles. The parameters are set to allow a larger number of vertices to define the border. An analysis of edges of the resulting footprint is performed to maintain the sheet or tile boundaries.

ParameterNo or lossless compressionLossy compressed

Minimum data value

1

10

Maximum data value

254

245

Approximate number of vertices

30

30

Shrink distance

6 pixels

6 pixels

Request size

1500

1500

Maintain sheet edges

Yes

Yes

Rotated rectangle

These parameters are used for images that form a rotated rectangle. The datasets are typically created when individual scenes or map sheets have been rotated and the sides of the footprint remain straight. The parameters are set to define the footprint by only four vertices.

ParameterNo or lossless compressionLossy compressed

Minimum data value

1

1

Maximum data value

254

245

Approximate number of vertices

4

4

Shrink distance

2 pixels

6 pixels

Request size

1000

1000

Maintain sheet edges

No

No

Reprojected rectangle

These parameters are used for rotated images that have been reprojected, which form rectangular footprints with curved edges. The datasets are typically created when individual scenes or map sheets have been reprojected. The parameters are set to define the footprint with a sufficient number of vertices to represent the curves.

ParameterNo or lossless compressionLossy compressed

Minimum data value

1

10

Maximum data value

254

245

Approximate number of vertices

20

20

Shrink distance

2 pixels

6 pixels

Request size

2000

2000

Maintain sheet edges

No

No

Orthorectified image in flat terrain

These parameters are used when the origin of the raster dataset is a scene or image that has been orthorectified to a flat terrain. The edges of the images form simple curves caused by smooth changes in the elevation.

ParameterNo or lossless compressionLossy compressed

Minimum data value

1

10

Maximum data value

254

245

Approximate number of vertices

30

30

Shrink distance

9 pixels

9 pixels

Request size

2000

2000

Maintain sheet edges

No

No

Orthorectified image in hilly terrain

These parameters are used when the raster dataset is being orthorectified in an area that encounters large changes in elevation. The edges of the images are irregular, caused by sudden changes in the elevation. More vertices are required to define the footprints.

ParameterNo or lossless compressionLossy compressed

Minimum data value

1

10

Maximum data value

254

245

Approximate number of vertices

200

200

Shrink distance

9 pixels

50 pixels

Request size

2000

2000

Maintain sheet edges

No

No

Minimum region size

A suggested default for this parameter was not specified in the tables above because of the potential complexity of this value. Consider what the raster data is and how detailed the footprint needs to be.

A footprint is designed to define the area of the raster dataset you want to view. A footprint is typically the extent of the raster dataset; however, it can be modified so a user cannot view part of the raster dataset.

The minimum and maximum data values are used to specify the valid data. Pixel values outside the range of values used to create a region will create a hole in the footprint polygon. For example, if you have a raster dataset with pixel values from 0 to 255, you can define the valid range as 10–255. The pixels from 0 to 9 will result in holes in the footprint. However, the image may have pixels from 0 to 9 that you want to retain because they represent valid features. For example, if the rooftop of a home has pixel values from 0 to 9, ensure that these do not result in holes in the footprint; whereas larger features, such as large clouds, do.

The area of the hole is compared to the area computed using the minimum region size. If the area of the hole is smaller than the area computed by minimum region size, the hole is removed from the footprint.

In the diagram below, the gray pixel values represent the valid data values. The orange pixels represent three regions in the image containing values you potentially want excluded. The yellow boxes represent the area defined by the minimum region size. Since the two small orange regions on the left are smaller than the minimum region size (the yellow border), the pixels are retained in the image. However, the large orange region on the right is larger than the minimum region size, so those pixels are excluded from the mosaicked image in the mosaic dataset.

Diagram showing region size
Areas larger than the minimum region size will remain excluded from the mosaicked image.

Consider the request size when specifying the minimum region size, because the request size determines the resolution or detail in the raster used to recompute the footprint. Typically, you will use a request size that is smaller than the dimensions of the original source raster. This will impact the region size. For example, to preserve the rooftop area, consider the roof's pixel dimensions in the source image and its dimensions in the request size. If the roofs are 50 by 50 pixels in the source image and the request size represents an image that has 50 percent fewer pixels in its x and y dimensions, the rooftops may be represented by a feature that is only 25 by 25 pixels in dimension. Correctly defining the request size versus the minimum region allows you to retain valid data while eliminating unwanted pixels by including them in the footprint.

Related topics