-
Notifications
You must be signed in to change notification settings - Fork 3
Raster Tools Calculate Statistics
This tool calculates statistics for raster geodata which allows ArcMap to properly stretch and symbolize raster geodata for display. The tool uses the standard ArcGIS ‘Calculate Statistics (Raster)’ tool. For more detailed help see ESRI Help for the ‘Calculate Statistics’ in the Raster Toolbox.
- TIP: If you calculate statistics for a raster that is being displayed in ArcMap you will need to remove and then re-add the geodata layer to view the statistics after it has been built using this tool.
Table for Rasters: This is the input table, usually the results table generated by the Geodata > Search tool, but it can be any table with a field containing the full path to the geodata you want to copy. If the Input Table is a DBF, or a table in an ESRI File Geodatabase, then you can select a subset of rows in ArcMap and only those rows will be processed by the tool.
Field for Raster: Select the field from the 'Table for Geodata' that contains the full path to the geodata items you want to calculate statistics for.
Output Workspace: This is the location for the Grid Garage results table containing the list of geodata processed by the tool as well as any data outputs. If the tool encounters any errors when processing the input geodata then a second results table will be generated, with a ‘_FAIL’ suffix, listing the input geodata that failed and any ESRI error messages.
If you have set the ArcGIS ‘Workspace' parameter in the Geoprocessing > Environment Settings then this path will be used as the default. You can use this default path or click the folder button to select a new output location which can be a folder or File Geodatabase. If you specify a folder then the Results Table will be written to a comma-delimited (CSV) text file, if you specify a File Geodatabase it will be written as a Geodatabase Table.
Result Table Name: You can choose to use the default table name or specify a different name for the Grid Garage results table. The Grid Garage results table reports on a range of different properties for each of the geodata items in the 'Table for Geodata' input table. See the Grid Garage User Manual for a description of all the properties reported on.
If the tool encounters any errors when processing any of the geodata then a second results table will be generated, with a ‘_FAIL’ suffix, listing the input geodata that failed and any ESRI error messages. If you choose a folder for the Output Workspace then the result table will be written to a comma-delimited (CSV) text file which will not allow you to select rows for processing when using the table as input for other Grid Garage Tools.
Result Table file name: The default name will always take the form of ‘CalculateStatisticsRasterTool_date_time’, where ‘date’ and ‘time’ are the date and time that the tool was run.
X Skip Factor (optional): The number of horizontal pixels between samples. The value must be greater than zero and less than or equal to the number of columns in the raster dataset. The default is 1 or the last skip factor used. The skip factors for raster datasets stored in a file geodatabase or an ArcSDE geodatabase are different. First, if the x and y skip factors are different, the smaller skip factor will be used for both the x and y skip factors. Second, the skip factor is related to the pyramid level that most closely fits the skip factor chosen. If the skip factor value is not equal to the number of pixels in a pyramid layer, the number is rounded down to the next pyramid level, and those statistics are used.
Y Skip Factor (optional): The number of vertical pixels between samples. The value must be greater than zero and less than or equal to the number of rows in the raster. The default is 1 or the last y skip factor used. The skip factors for raster datasets stored in a file geodatabase or an ArcSDE geodatabase are different. First, if the x and y skip factors are different, the smaller skip factor will be used for both the x and y skip factors. Second, the skip factor is related to the pyramid level that most closely fits the skip factor chosen. If the skip factor value is not equal to the number of pixels in a pyramid layer, the number is rounded down to the next pyramid level, and those statistics are used.
Ignore Values (optional): The pixel values that are not to be included in the statistics calculation. The default is no value, or the last ignore values used.
Existing Statistics (optional): Specify whether to calculate statistics only where they are missing or regenerate them even if they exist. Options include:
- OVERWRITE — Statistics will be calculated even if they already exist; therefore, existing statistics will be overwritten. This is the default.
- SKIP_EXISTING — Statistics will only be calculated if they do not already exist.
Area of Interest (optional): Specify a feature class that represents area in the geodata from where you want the statistics to be calculated, so they are not generated from the entire dataset.