The Histogram operation calculates the histogram of a raster, polygon, segment or point map. Histograms list frequency information on the values, classes, or IDs in your map. Results are presented in a histogram window, both as a table and as a graph. Summary information of a histogram of a raster map which uses a value or the Image domain, can be viewed in the properties of the histogram: mean, standard deviation, median, predominant, undefineds and percentage intervals.
Histograms of raster maps that are stored using 1 or 2 bytes per pixel are automatically calculated when needed. Thus, there is no need to perform the Histogram operation separately. You can use this operation to calculate histograms of raster maps stored with 4 or 8 bytes per pixel and to calculate histograms of polygon, segment or point maps.
A raster histogram lists the number of pixels, the percentages, and the areas per value, class or ID. For value maps (map which use a value, the image, the bit or a bool domain), also the cumulative number of pixels and cumulative percentages are calculated. Further,
A polygon histogram lists the number of polygons, the perimeter and area of polygons per class, ID, or value. If the input polygon map is a value map, also the cumulative number of polygons, the cumulative perimeter and cumulative area are calculated.
A segment histogram lists the number of segments and their length per class, ID or value. If the input segment map is a value map, also the cumulative number of segments and the cumulative length are calculated.
A point histogram lists the number of points per class, ID or value. If the input point map is a value map, also the cumulative number of points are calculated.
In the histogram window, histograms are displayed both as a table and as a graph. To protect the results of the histogram calculation, the columns in a histogram are not editable (columns are table-owned and read-only), but you can calculate new columns from the existing ones by typing Table Calculation formulas on the command line of the histogram window.
Input map requirements:
No special input requirements; a histogram can be calculated for any kind of raster, polygon, segment or point map.
Domain of output histogram table:
Always, a dependent output histogram is created with the same name as the input map. The extension of a histogram is determined by the type of input map: .HIS for raster maps, .HSA for polygon maps, .HSI for segment maps and .HSP for point maps.
A raster histogram contains the following columns:
domain |
|
Value |
Column Value appears in histograms of maps which use a value domain, bool domain or the color domain: each occurring value in the map is listed. |
Npix |
The number of pixels with a certain value or meaning (pixel frequencies). |
NpixPct |
The relative amount of pixels with a certain value or meaning as a percentage of the total number of pixels in the map. |
PctNotZero |
Column PctNotZero appears in histograms of images: the relative amount of pixels with a certain value as a percentage of the total number of pixels in the map that do not have value 0. |
PctNotUnd |
Column PctNotUnd appears in histograms of raster maps which use a class, ID, bool or value domain and when the maps actually contain undefined pixels: the relative amount of pixels with a certain value or meaning as a percentage of the total number of pixels in the map that are not undefined. |
NpixCum |
For histograms of images and value maps: the cumulative amount of pixels of pixels with this value or a smaller value. |
NpCumPct |
For histograms of images and value maps: the relative cumulative amount of pixels with this value or a smaller value as a percentage of the total number of pixels in the map (to determine for instance the 1%, 5%, 95%, 99% intervals). |
Area |
The area of pixels with a certain value or meaning as: npix* pixel size * pixel size. |
A polygon histogram contains the following columns:
domain |
|
Value |
Column Value only appears in histograms of maps which use a value domain or a bool domain: each occurring value in the map is listed. |
NrPol |
The number of polygons with a certain value or meaning. |
NPolCum |
For polygon maps which use a value domain: the cumulative number of polygons with this value or a smaller value. |
Perimeter |
The perimeter of polygons with a certain value or meaning. |
PerimeterCum |
For polygon maps which use a value domain: the cumulative perimeter of polygons with this value or a smaller value. |
Area |
The area of polygons with a certain value or meaning. |
AreaCum |
For polygon maps which use a value domain: the cumulative area of polygons with this value or a smaller value. |
A segment histogram contains the following columns:
domain |
|
Value |
Column Value only appears in histograms of maps which use a value domain or a bool domain: each occurring value in the map is listed. |
NrSeg |
The number of segments with a certain value or meaning (segment frequencies). |
NrSegCum |
For segment maps which use a value domain: the cumulative number of segments with this value or a smaller value. |
Length |
The length of segments with a certain value or meaning. |
LengthCum |
For segment maps which use a value domain: the cumulative length of segments with this value or a smaller value. |
A point histogram contains the following columns:
domain |
|
Value |
Column Value only appears in histograms of maps which use a value domain or a bool domain: each occurring value in the map is listed. |
NrPnt |
The number of points with a certain value or meaning (point frequencies). |
NrPntCum |
For point maps which use a value domain: the cumulative number of points with this value or a smaller value. |
Tips:
|
for raster map histograms, |
|
for polygon map histograms, |
|
for segment map histograms, |
|
for point map histograms. |
See also: