-
Notifications
You must be signed in to change notification settings - Fork 3
Raster Tools Copy
This tool copies raster geodata to a new location. It also allows you to change some of the format/attributes of the raster geodata when copying. For more detailed help see ESRI Help for the ‘Copy Raster (Data Management)’ 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 rasters you want to clip. 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 Rasters' that contains the full path to the raster items you want to copy.
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 ‘CopyRasterTool_date_time’, where ‘date’ and ‘time’ are the date and time that the tool was run.
Config Keyword (optional): Specifies the storage parameters (configuration) for a file or enterprise geodatabase. Configuration keywords are set up by your database administrator.
Background Value (optional): Use this option to remove the unwanted values created around the raster data. The value specified will be distinguished from other valuable data in the raster dataset. For example, a value of zero along the raster dataset's borders will be distinguished from zero values within the raster dataset. The pixel value specified will be set to NoData in the output raster dataset. For file-based rasters and geodatabase rasters, the Ignore Background Value must be set to the same value as NoData in order for the background value to be ignored. Enterprise and geodatabase rasters will work without this extra step.
No Data Value (optional): All the pixels with the specified value will be set to NoData in the output raster dataset.
1 Bit to 8 Bit (optional): Choose whether the input 1-bit raster dataset will be converted to an 8-bit raster dataset. In this conversion the value 1 in the input raster dataset will be changed to 255 in the output raster dataset. This is useful when importing a 1-bit raster dataset to a geodatabase. One-bit raster datasets have 8-bit pyramid layers when stored in a file system, but in a geodatabase, 1-bit raster datasets can only have 1-bit pyramid layers, which makes the display unpleasant. By converting the data to 8 bit in a geodatabase, the pyramid layers are built as 8 bit instead of 1 bit, resulting in a proper raster dataset in the display.
- NONE — No conversion will be done. This is the default.
- OneBitTo8Bit — The input raster will be converted.
Colour Map to RGB (optional): If the input raster geodata has a colour map, the output raster geodata can be converted to a three-band output raster dataset. This is useful when mosaicking rasters with different colour maps. Select from:
- NONE — No conversion will occur. This is the default.
- ColormapToRGB — The input geodata will be converted.
Pixel Type (optional): Determines the bit depth of the output raster dataset. If left unspecified, the output bit depth will be the same as the input. There will be no rescaling of the raster values when a different pixel type is chosen. If the pixel type is demoted (lowered), the raster values outside the valid range for that pixel depth will be truncated and lost. Select from:
| Pixel type | Description | Value range allowed |
|---|---|---|
| 1_BIT | A 1-bit unsigned integer | The values can be 0 or 1 |
| 2_BIT | A 2-bit unsigned integer | The values supported can be from 0 to 3 |
| 4_BIT | A 4-bit unsigned integer | The values supported can be from 0 to 15 |
| 8_BIT_UNSIGNED | An unsigned 8-bit data type | The values supported can be from 0 to 255 |
| 8_BIT_SIGNED | A signed 8-bit data type | The values supported can be from -128To 127 |
| 16_BIT_UNSIGNED | A 16-bit unsigned data type | The values can range from 0 to 65,535 |
| 16_BIT_SIGNED | A 16-bit signed data type | The values can range from -32,768To 32,767 |
| 32_BIT_UNSIGNED | A 32-bit unsigned data type | The values can range from 0 to 4,294,967,295 |
| 32_BIT_SIGNED | A 32-bit signed data type | The values can range from -2,147,483,648 to 2,147,483,647 |
| 32_BIT_FLOAT | A 32-bit data type supporting decimals | Floating point (decimals) with large range |
| 64_BIT | A 64-bit data type supporting decimals | Floating point (decimals) with very large range |
- TIP: The size of the output raster data, on your hard drive, will be determined by the pixel type. The pixel types outlined above are listed in order from smallest file size to largest. We recommend you use the smallest pixel type possible to avoid using up more space on your storage device than is necessary.
Scale Pixel Value (optional): When the output is a different pixel type than the input (such as 16-bit to 8-bit) you can choose to have the values scaled to fit into the new range; otherwise, the values that do not fit into the new pixel range will be discarded. If scaling up, such as 8-bit to 16-bit, the minimum and maximum of the 8-bit values will be scaled to the minimum and maximum in the 16-bit range. If scaling down, such as 16-bit to 8-bit, the minimum and maximum of the 16-bit values will be scaled to the minimum and maximum in the 8-bit range. Select from:
- NONE — The pixel values will remain the same and will not be scaled. Any values that do not fit within the value range will be discarded. This is the default.
- ScalePixelValue — The pixel values will be scaled to the new pixel type. When you scale your pixel depth, your raster will display the same, but the values will be scaled to the new bit depth that was specified.
RGB to Colour Map (optional): You can convert an 8-bit, 3-band (RGB) raster dataset, to a single-band raster geodata with a colour map. This operation will suppress colour noise that is often found in scanned images by examining the statistics for the raster geodata and classifying the values into 255 quantiles. This is ideal for screen captures, scanned maps, or scanned documents. This is not recommended for satellite or aerial imagery or thematic raster data. Select from:
- NONE — The output will remain as a 3-band (RGB) raster dataset. No conversion to a colour map will occur. This is the default.
- RGBToColormap — A single-band raster dataset, with a colour map using 255 colours will be created.
Transform: Choose whether to apply the transformation, associated with the raster, to the output. Select from:
- NONE — Do not apply any associated transformations to the output.
- Transform — Apply the associated transformation to the output.
Output File Workspace (optional): If you want the output geodata files to be saved in a different location to the ‘Output Workspace’ you can select a new location (folder or File Geodatabase, depending on the output file type). The result tables will still be written to the ‘Output Workspace’ specified above.
Output Filename Prefix (optional): Any text you enter in this input box will be added as a prefix (at the beginning) for all output file names.
Output Filename Suffix (optional): Any text you enter in this input box will be added as a suffix (at the end) for all output file names.