| 1 | <?xml version="1.0" encoding="utf-8"?> |
|---|
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
|---|
| 3 | <html xmlns="http://www.w3.org/1999/xhtml"><head><link rel="stylesheet" type="text/css" href="81help.css?format=raw" /><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Convert ArcGIS Rasters Listed in Table to Polygon Outlines</title></head><body><table style="margin-top:-1em; margin-bottom:0; padding:0; margin-left:-1em"><tr><td style="background:white"><img width="875" height="70" alt="ArcToolbox banner" src="AHBanner_ArcToolbox.gif?format=raw" /></td></tr></table><h1>Convert ArcGIS Rasters Listed in Table to Polygon Outlines</h1><p></p><p>Converts the ArcGIS rasters listed in a table to lines that outline groups of adjacent raster cells having the same value.</p><br /><p><h2><img width="11" height="11" border="0" src="sm_arrow_down.gif?format=raw" /> Command line syntax</h2></p><div Class="expand" id="id103142">ArcGISRasterToPolygonOutlinesArcGISTable_GeoEco <table> <inputRasterField> <outputFeatureClassField> {simplify} {field} {projectedCoordinateSystem} {geographicTransformation} {NEAREST | BILINEAR | CUBIC} {projectedCellSize} {registrationPoint} {clippingDataset} {clippingRectangle} {mapAlgebraExpression} {where} {orderBy;orderBy...} {directions;directions...} {skipExisting} {basePath} <br /><br /><b>Parameters</b><br /><table width="100%" border="0" cellpadding="5"><tbody><tr><th width="40%"><b>Expression</b></th><th width="60%"><b>Explanation</b></th></tr><tr><td class="info"><table></td><td class="info" align="left"><p>Table to query.</p></td></tr><tr><td class="info"><inputRasterField></td><td class="info" align="left"><p>Field containing the rasters to convert.</p><p>The rasters will be converted to polygon feature classes using the |
|---|
| 4 | ArcGIS Raster to Polygon tool, and then to line features using the |
|---|
| 5 | Feature to Line tool. The Raster to Polygon tool can only convert |
|---|
| 6 | integer rasters to polygons. If the input rasters are floating-point |
|---|
| 7 | rasters, you must use the Map Algebra Expression parameter to convert |
|---|
| 8 | them to integer rasters.</p></td></tr><tr><td class="info"><outputFeatureClassField></td><td class="info" align="left"><p>Field containing the output line feature classes.</p><p>One feature class will be created per raster. Missing directories the |
|---|
| 9 | output paths will be created if they do not exist.</p></td></tr><tr><td class="info">{simplify}</td><td class="info" align="left"><p>Determines if the output polygons will be smoothed into simpler |
|---|
| 10 | shapes or conform to the input raster's cell edges.</p><ul><li><p>True - The polygons will be smoothed into simpler shapes. This is |
|---|
| 11 | the default.</p></li></ul><ul><li><p>False - The polygons will conform to the input raster's cell edges.</p></li></ul></td></tr><tr><td class="info">{field}</td><td class="info" align="left"><p>The field used to assign values from the cells in the input raster |
|---|
| 12 | to the lines in the output dataset. It can be an integer or a |
|---|
| 13 | string field.</p></td></tr><tr><td class="info">{projectedCoordinateSystem}</td><td class="info" align="left"><p>New coordinate system to project the raster to.</p><p>The raster may only be projected to a new coordinate system if the |
|---|
| 14 | original projection is defined. An error will be raised if you specify |
|---|
| 15 | a new coordinate system without defining the original coordinate |
|---|
| 16 | system.</p><p>The ArcGIS Project Raster tool is used to perform the projection. The |
|---|
| 17 | documentation for that tool recommends that you also specify a cell |
|---|
| 18 | size for the new coordinate system.</p><p>I have noticed that for certain coordinate systems the ArcGIS 9.2 |
|---|
| 19 | Project Raster tool seems to clip the projected raster to an arbitrary |
|---|
| 20 | extent that is too small. For example, when projecting a global MODIS |
|---|
| 21 | Aqua 4 km chlorophyll image in geographic coordinates to |
|---|
| 22 | Lambert_Azimuthal_Equal_Area with central meridian of -60 and latitude |
|---|
| 23 | of origin of -63, the resulting image is clipped to show only |
|---|
| 24 | one-quarter of the planet. This problem does not occur when Project |
|---|
| 25 | Raster is invoked interactively from the ArcGIS user interface; it |
|---|
| 26 | only occurs when the tool is invoked programmatically (the |
|---|
| 27 | ProjectRaster_management method of the geoprocessor). Thus you may |
|---|
| 28 | not see it when you use Project Raster yourself but it may happen when |
|---|
| 29 | you use MGET tools that invoke Project Raster as part of their |
|---|
| 30 | geoprocessing operations.</p><p>If you encounter this problem, you can work around it like this:</p><ul><li><p>First, run this tool without specifying a new coordinate system, to |
|---|
| 31 | obtain the raster in the original coordinate system.</p></li></ul><ul><li><p>In ArcCatalog, use the Project Raster tool to project the raster to |
|---|
| 32 | the new coordinate system. Verify that the entire raster is present, |
|---|
| 33 | that it has not been clipped to an extent that is too small.</p></li></ul><ul><li><p>In ArcCatalog, look up the extent of the projected raster by |
|---|
| 34 | right-clicking on it in the catalog tree, selecting Properties, and |
|---|
| 35 | scrolling down to Extent.</p></li></ul><ul><li><p>Now, before running the MGET tool that projects the raster, set the |
|---|
| 36 | Extent environment setting to the values you looked up. If you are |
|---|
| 37 | invoking the MGET tool interactively from ArcCatalog or ArcMap, |
|---|
| 38 | click the Environments button on the tool's dialog box, open General |
|---|
| 39 | Settings, change the Extent drop-down to "As Specified Below", and |
|---|
| 40 | type in the values you looked up. If you're invoking it from a |
|---|
| 41 | geoprocessing model, right-click on the tool in the model, select |
|---|
| 42 | Make Variable, From Environment, General Settings, Extent. This will |
|---|
| 43 | place Extent as a variable in your model, attached to the MGET tool. |
|---|
| 44 | Open the Extent variable, change it to "As Specified Below" and type |
|---|
| 45 | in the values you looked up. If you're invoking the MGET tool |
|---|
| 46 | programmatically, you must set the Extent property of the |
|---|
| 47 | geoprocessor to the values you looked up. Please see the ArcGIS |
|---|
| 48 | documentation for more information about this and Environment |
|---|
| 49 | settings in general.</p></li></ul><ul><li><p>Run the MGET tool. The extent of the raster should now be the |
|---|
| 50 | proper size.</p></li></ul></td></tr><tr><td class="info">{geographicTransformation}</td><td class="info" align="left"><p>A transformation method used to convert between the original |
|---|
| 51 | coordinate system and the new coordinate system.</p><p>This parameter is a new option introduced by ArcGIS 9.2. You must have |
|---|
| 52 | ArcGIS 9.2 to use this parameter.</p><p>This parameter is only needed when you specify that the raster should |
|---|
| 53 | be projected to a new coordinate system and that new system uses a |
|---|
| 54 | different datum than the original coordinate system, or there is some |
|---|
| 55 | other difference between the two coordinate systems that requires a |
|---|
| 56 | transformation. To determine if a transformation is needed, I |
|---|
| 57 | recommend the following procedure:</p><ul><li><p>First, run this tool without specifying a new coordinate system, to |
|---|
| 58 | obtain the raster in the original coordinate system.</p></li></ul><ul><li><p>Next, use the ArcGIS 9.2 Project Raster tool on the raster to |
|---|
| 59 | project it to the desired coordinate system. If a geographic |
|---|
| 60 | transformation is needed, that tool will prompt you for one. Write |
|---|
| 61 | down the exact name of the transformation you used.</p></li></ul><ul><li><p>Finally, if a transformation was needed, type in the exact name into |
|---|
| 62 | this tool, rerun it, and verify that the raster was projected as you |
|---|
| 63 | desired.</p></li></ul></td></tr><tr><td class="info">{NEAREST | BILINEAR | CUBIC}</td><td class="info" align="left"><p>The resampling algorithm to be used to project the original raster |
|---|
| 64 | to a new coordinate system. The ArcGIS Project Raster tool is used to |
|---|
| 65 | perform the projection and accepts the following values:</p><ul><li><p>NEAREST - nearest neighbor interpolation</p></li></ul><ul><li><p>BILINEAR - bilinear interpolation</p></li></ul><ul><li><p>CUBIC - cubic convolution</p></li></ul><p>You must specify one of these algorithms to project to a new |
|---|
| 66 | coordinate system. An error will be raised if you specify a new |
|---|
| 67 | coordinate system without selecting an algorithm.</p></td></tr><tr><td class="info">{projectedCellSize}</td><td class="info" align="left"><p>The cell size of the projected coordinate system. Although this |
|---|
| 68 | parameter is optional, to receive the best results, the ArcGIS |
|---|
| 69 | documentation recommends you always specify it when projecting to a |
|---|
| 70 | new coordinate system.</p></td></tr><tr><td class="info">{registrationPoint}</td><td class="info" align="left"><p>The x and y coordinates (in the output space) used for pixel |
|---|
| 71 | alignment.</p><p>This parameter is a new option introduced by ArcGIS 9.2. You must have |
|---|
| 72 | ArcGIS 9.2 to use this parameter. It is ignored if you do not specify |
|---|
| 73 | that the raster should be projected to a new coordinate system.</p></td></tr><tr><td class="info">{clippingDataset}</td><td class="info" align="left"><p>Existing feature class, raster, or other geographic dataset having |
|---|
| 74 | the extent to which the raster should be clipped.</p><p>WARNING: If you use this tool from in an ArcGIS geoprocessing model |
|---|
| 75 | and you select a dataset by clicking the folder icon and browsing to |
|---|
| 76 | the dataset, your selection may mysteriously disappear from this text |
|---|
| 77 | box after you close the tool. This is a bug in ArcGIS. To work around |
|---|
| 78 | it, drag and drop the desired dataset into the model. This will create |
|---|
| 79 | a layer in the model for that dataset. Then select that layer in this |
|---|
| 80 | tool by clicking the drop-down box rather than clicking the folder |
|---|
| 81 | icon. The selected layer should not disappear when you close the |
|---|
| 82 | tool.</p></td></tr><tr><td class="info">{clippingRectangle}</td><td class="info" align="left"><p>Rectangle to which the raster should be clipped.</p><p>If a projected coordinate system was specified, the clipping is |
|---|
| 83 | performed after the projection and the rectangle's coordinates should |
|---|
| 84 | be specified in the new coordinate system. If no projected coordinate |
|---|
| 85 | system was specified, the coordinates should be specified in the |
|---|
| 86 | original coordinate system.</p><p>The ArcGIS Clip tool is used to perfom the clip. The clipping |
|---|
| 87 | rectangle must be passed to this tool as a string of four numbers |
|---|
| 88 | separated by spaces. The ArcGIS user interface automatically formats |
|---|
| 89 | the string properly; when invoking this tool from the ArcGIS UI, |
|---|
| 90 | you need not worry about the format. But when invoking it |
|---|
| 91 | programmatically, take care to provide a properly-formatted string. |
|---|
| 92 | The numbers are ordered LEFT, BOTTOM, RIGHT, TOP. For example, if the |
|---|
| 93 | raster is in a geographic coordinate system, it may be clipped to 10 |
|---|
| 94 | W, 15 S, 20 E, and 25 N with the string:</p><dl><dt></dt><dd><p>10 15 20 25</p></dd></dl><p>Integers or decimal numbers may be provided.</p></td></tr><tr><td class="info">{mapAlgebraExpression}</td><td class="info" align="left"><p>Map algebra expression to execute on the raster.</p><p><b>WARNING:</b> The ArcGIS Geoprocessing Model Builder may randomly and |
|---|
| 95 | silently delete the value of this parameter. This is a bug in ArcGIS. |
|---|
| 96 | Before running a model that you have saved, open this tool and |
|---|
| 97 | validate that the parameter value still exists.</p><p>The expression is executed after the converted raster is projected and |
|---|
| 98 | clipped (if those options are specified). Use the case-sensitive |
|---|
| 99 | string inputRaster to represent the raster that you now want to |
|---|
| 100 | perform map algebra upon. For example, to convert the raster to an |
|---|
| 101 | integer raster and add 1 to all of the cells, use this expression:</p><dl><dt></dt><dd><pre>int(inputRaster) + 1</pre></dd></dl><p>The string inputRaster is case-sensitive. Prior to executing the map |
|---|
| 102 | algebra expression, the string is replaced with the path to a |
|---|
| 103 | temporary raster that represents the raster being generated. The final |
|---|
| 104 | expression must be less than 4000 characters long or ArcGIS will |
|---|
| 105 | report an error.</p><p>The ArcGIS Single Output Map Algebra tool is used to execute the map |
|---|
| 106 | algebra expression. You must have a license for the ArcGIS Spatial |
|---|
| 107 | Analyst extension in order to perform map algebra.</p><p>Map algebra syntax can be very picky. Here are some tips that will |
|---|
| 108 | help you succeed with this tool:</p><ul><li><p>Before using this tool, construct and test out your map algebra |
|---|
| 109 | expression using the ArcGIS Single Output Map Algebra tool. Then |
|---|
| 110 | paste the expression into this tool and edit it to use the |
|---|
| 111 | inputRaster variable rather than the test value you used with Single |
|---|
| 112 | Output Map Algebra.</p></li></ul><ul><li><p>If you do develop your expression directly in this tool, start with |
|---|
| 113 | a very simple expression. Verify that it works properly, add a |
|---|
| 114 | little to it, and verify again. Repeat this process until you have |
|---|
| 115 | built up the complete expression.</p></li></ul><ul><li><p>Always separate mathematical operators from raster paths using |
|---|
| 116 | spaces. In the example above, the / operator contains a space on |
|---|
| 117 | either side. Follow this pattern. In some circumstances, ArcGIS will |
|---|
| 118 | fail to process raster algebra expressions that do not separate |
|---|
| 119 | raster paths from operators using spaces. The reported error message |
|---|
| 120 | usually does not indicate that this is the problem, and tracking it |
|---|
| 121 | down can be very frustrating.</p></li></ul></td></tr><tr><td class="info">{where}</td><td class="info" align="left"><p>SQL WHERE clause expression that specifies the subset of rows to |
|---|
| 122 | process. If this parameter is not provided, all of the rows will be |
|---|
| 123 | processed. If this parameter is provided but the underlying database |
|---|
| 124 | does not support WHERE clauses, an error will be raised.</p><p>The exact syntax of this expression depends on the underlying |
|---|
| 125 | database. ESRI recommends you reference fields using the following |
|---|
| 126 | syntax:</p><ul><li><p>If you're querying ArcInfo coverages, shapefiles, INFO tables or |
|---|
| 127 | dBASE tables (.dbf files), enclose field names in double quotes in |
|---|
| 128 | the SQL expression: "MY_FIELD".</p></li></ul><ul><li><p>If you're querying Microsoft Access tables or personal |
|---|
| 129 | geodatabase tables, enclose field names in square brackets: |
|---|
| 130 | [MY_FIELD].</p></li></ul><ul><li><p>If you're querying ArcSDE geodatabase tables, an ArcIMS feature |
|---|
| 131 | class, or an ArcIMS image service sublayer, don't enclose field |
|---|
| 132 | names: MY_FIELD.</p></li></ul></td></tr><tr><td class="info">{orderBy;orderBy...}</td><td class="info" align="left"><p>Fields that will be used to sort the rows (i.e., the columns |
|---|
| 133 | specified in the ORDER BY clause of a SQL SELECT statement). If no |
|---|
| 134 | fields are provided, the rows will be sorted in the default order |
|---|
| 135 | determined by the underlying database. If this parameter is provided |
|---|
| 136 | but this computer is not running ArcGIS 9.2 or later or the underlying |
|---|
| 137 | database does not support ORDER BY clauses, an error will be raised.</p><p>In addition to specifying the ORDER BY fields, you must also specify |
|---|
| 138 | the sort direction for each field.</p></td></tr><tr><td class="info">{directions;directions...}</td><td class="info" align="left"><p>List of strings, either 'Ascending' or 'Descending', that specify |
|---|
| 139 | the sort directions for the ORDER BY fields. If this parameter is |
|---|
| 140 | provided but this computer is not running ArcGIS 9.2 or later or the |
|---|
| 141 | underlying database does not support ORDER BY clauses, an error will |
|---|
| 142 | be raised.</p></td></tr><tr><td class="info">{skipExisting}</td><td class="info" align="left"><p>If True, conversion will be skipped for feature classes that already exist.</p></td></tr><tr><td class="info">{basePath}</td><td class="info" align="left"><p>Base path to prepend to relative paths.</p><p>If a base path is provided, it will be prepended to any relative paths |
|---|
| 143 | that are obtained from the fields that list the inputs (and outputs, |
|---|
| 144 | if this tool has outputs). If a base path is not provided, the |
|---|
| 145 | workspace containing the table will be prepended instead.</p></td></tr></tbody></table></div><p><h2><img width="11" height="11" border="0" src="sm_arrow_down.gif?format=raw" /> Scripting syntax</h2></p><div Class="expand" id="TEST">ArcGISRasterToPolygonOutlinesArcGISTable_GeoEco (table, inputRasterField, outputFeatureClassField, simplify, field, projectedCoordinateSystem, geographicTransformation, resamplingTechnique, projectedCellSize, registrationPoint, clippingDataset, clippingRectangle, mapAlgebraExpression, where, orderBy, directions, skipExisting, basePath) <br /><br /><b>Parameters</b><br /><table width="100%" border="0" cellpadding="5"><tbody><tr><th width="40%"><b>Expression</b></th><th width="60%"><b>Explanation</b></th></tr><tr><td class="info">Table (Required) </td><td class="info" align="left"><p>Table to query.</p></td></tr><tr><td class="info">Input raster field (Required) </td><td class="info" align="left"><p>Field containing the rasters to convert.</p><p>The rasters will be converted to polygon feature classes using the |
|---|
| 146 | ArcGIS Raster to Polygon tool, and then to line features using the |
|---|
| 147 | Feature to Line tool. The Raster to Polygon tool can only convert |
|---|
| 148 | integer rasters to polygons. If the input rasters are floating-point |
|---|
| 149 | rasters, you must use the Map Algebra Expression parameter to convert |
|---|
| 150 | them to integer rasters.</p></td></tr><tr><td class="info">Output line feature class field (Required) </td><td class="info" align="left"><p>Field containing the output line feature classes.</p><p>One feature class will be created per raster. Missing directories the |
|---|
| 151 | output paths will be created if they do not exist.</p></td></tr><tr><td class="info">Simplify polygons (Optional) </td><td class="info" align="left"><p>Determines if the output polygons will be smoothed into simpler |
|---|
| 152 | shapes or conform to the input raster's cell edges.</p><ul><li><p>True - The polygons will be smoothed into simpler shapes. This is |
|---|
| 153 | the default.</p></li></ul><ul><li><p>False - The polygons will conform to the input raster's cell edges.</p></li></ul></td></tr><tr><td class="info">Field (Optional) </td><td class="info" align="left"><p>The field used to assign values from the cells in the input raster |
|---|
| 154 | to the lines in the output dataset. It can be an integer or a |
|---|
| 155 | string field.</p></td></tr><tr><td class="info">Project to new coordinate system (Optional) </td><td class="info" align="left"><p>New coordinate system to project the raster to.</p><p>The raster may only be projected to a new coordinate system if the |
|---|
| 156 | original projection is defined. An error will be raised if you specify |
|---|
| 157 | a new coordinate system without defining the original coordinate |
|---|
| 158 | system.</p><p>The ArcGIS Project Raster tool is used to perform the projection. The |
|---|
| 159 | documentation for that tool recommends that you also specify a cell |
|---|
| 160 | size for the new coordinate system.</p><p>I have noticed that for certain coordinate systems the ArcGIS 9.2 |
|---|
| 161 | Project Raster tool seems to clip the projected raster to an arbitrary |
|---|
| 162 | extent that is too small. For example, when projecting a global MODIS |
|---|
| 163 | Aqua 4 km chlorophyll image in geographic coordinates to |
|---|
| 164 | Lambert_Azimuthal_Equal_Area with central meridian of -60 and latitude |
|---|
| 165 | of origin of -63, the resulting image is clipped to show only |
|---|
| 166 | one-quarter of the planet. This problem does not occur when Project |
|---|
| 167 | Raster is invoked interactively from the ArcGIS user interface; it |
|---|
| 168 | only occurs when the tool is invoked programmatically (the |
|---|
| 169 | ProjectRaster_management method of the geoprocessor). Thus you may |
|---|
| 170 | not see it when you use Project Raster yourself but it may happen when |
|---|
| 171 | you use MGET tools that invoke Project Raster as part of their |
|---|
| 172 | geoprocessing operations.</p><p>If you encounter this problem, you can work around it like this:</p><ul><li><p>First, run this tool without specifying a new coordinate system, to |
|---|
| 173 | obtain the raster in the original coordinate system.</p></li></ul><ul><li><p>In ArcCatalog, use the Project Raster tool to project the raster to |
|---|
| 174 | the new coordinate system. Verify that the entire raster is present, |
|---|
| 175 | that it has not been clipped to an extent that is too small.</p></li></ul><ul><li><p>In ArcCatalog, look up the extent of the projected raster by |
|---|
| 176 | right-clicking on it in the catalog tree, selecting Properties, and |
|---|
| 177 | scrolling down to Extent.</p></li></ul><ul><li><p>Now, before running the MGET tool that projects the raster, set the |
|---|
| 178 | Extent environment setting to the values you looked up. If you are |
|---|
| 179 | invoking the MGET tool interactively from ArcCatalog or ArcMap, |
|---|
| 180 | click the Environments button on the tool's dialog box, open General |
|---|
| 181 | Settings, change the Extent drop-down to "As Specified Below", and |
|---|
| 182 | type in the values you looked up. If you're invoking it from a |
|---|
| 183 | geoprocessing model, right-click on the tool in the model, select |
|---|
| 184 | Make Variable, From Environment, General Settings, Extent. This will |
|---|
| 185 | place Extent as a variable in your model, attached to the MGET tool. |
|---|
| 186 | Open the Extent variable, change it to "As Specified Below" and type |
|---|
| 187 | in the values you looked up. If you're invoking the MGET tool |
|---|
| 188 | programmatically, you must set the Extent property of the |
|---|
| 189 | geoprocessor to the values you looked up. Please see the ArcGIS |
|---|
| 190 | documentation for more information about this and Environment |
|---|
| 191 | settings in general.</p></li></ul><ul><li><p>Run the MGET tool. The extent of the raster should now be the |
|---|
| 192 | proper size.</p></li></ul></td></tr><tr><td class="info">Geographic transformation (Optional) </td><td class="info" align="left"><p>A transformation method used to convert between the original |
|---|
| 193 | coordinate system and the new coordinate system.</p><p>This parameter is a new option introduced by ArcGIS 9.2. You must have |
|---|
| 194 | ArcGIS 9.2 to use this parameter.</p><p>This parameter is only needed when you specify that the raster should |
|---|
| 195 | be projected to a new coordinate system and that new system uses a |
|---|
| 196 | different datum than the original coordinate system, or there is some |
|---|
| 197 | other difference between the two coordinate systems that requires a |
|---|
| 198 | transformation. To determine if a transformation is needed, I |
|---|
| 199 | recommend the following procedure:</p><ul><li><p>First, run this tool without specifying a new coordinate system, to |
|---|
| 200 | obtain the raster in the original coordinate system.</p></li></ul><ul><li><p>Next, use the ArcGIS 9.2 Project Raster tool on the raster to |
|---|
| 201 | project it to the desired coordinate system. If a geographic |
|---|
| 202 | transformation is needed, that tool will prompt you for one. Write |
|---|
| 203 | down the exact name of the transformation you used.</p></li></ul><ul><li><p>Finally, if a transformation was needed, type in the exact name into |
|---|
| 204 | this tool, rerun it, and verify that the raster was projected as you |
|---|
| 205 | desired.</p></li></ul></td></tr><tr><td class="info">Projection resampling technique (Optional) </td><td class="info" align="left"><p>The resampling algorithm to be used to project the original raster |
|---|
| 206 | to a new coordinate system. The ArcGIS Project Raster tool is used to |
|---|
| 207 | perform the projection and accepts the following values:</p><ul><li><p>NEAREST - nearest neighbor interpolation</p></li></ul><ul><li><p>BILINEAR - bilinear interpolation</p></li></ul><ul><li><p>CUBIC - cubic convolution</p></li></ul><p>You must specify one of these algorithms to project to a new |
|---|
| 208 | coordinate system. An error will be raised if you specify a new |
|---|
| 209 | coordinate system without selecting an algorithm.</p></td></tr><tr><td class="info">Cell size for projected coordinate system (Optional) </td><td class="info" align="left"><p>The cell size of the projected coordinate system. Although this |
|---|
| 210 | parameter is optional, to receive the best results, the ArcGIS |
|---|
| 211 | documentation recommends you always specify it when projecting to a |
|---|
| 212 | new coordinate system.</p></td></tr><tr><td class="info">Registration point for projected coordinate system (Optional) </td><td class="info" align="left"><p>The x and y coordinates (in the output space) used for pixel |
|---|
| 213 | alignment.</p><p>This parameter is a new option introduced by ArcGIS 9.2. You must have |
|---|
| 214 | ArcGIS 9.2 to use this parameter. It is ignored if you do not specify |
|---|
| 215 | that the raster should be projected to a new coordinate system.</p></td></tr><tr><td class="info">Clip to extent of geographic dataset (Optional) </td><td class="info" align="left"><p>Existing feature class, raster, or other geographic dataset having |
|---|
| 216 | the extent to which the raster should be clipped.</p><p>WARNING: If you use this tool from in an ArcGIS geoprocessing model |
|---|
| 217 | and you select a dataset by clicking the folder icon and browsing to |
|---|
| 218 | the dataset, your selection may mysteriously disappear from this text |
|---|
| 219 | box after you close the tool. This is a bug in ArcGIS. To work around |
|---|
| 220 | it, drag and drop the desired dataset into the model. This will create |
|---|
| 221 | a layer in the model for that dataset. Then select that layer in this |
|---|
| 222 | tool by clicking the drop-down box rather than clicking the folder |
|---|
| 223 | icon. The selected layer should not disappear when you close the |
|---|
| 224 | tool.</p></td></tr><tr><td class="info">Clip to rectangle (Optional) </td><td class="info" align="left"><p>Rectangle to which the raster should be clipped.</p><p>If a projected coordinate system was specified, the clipping is |
|---|
| 225 | performed after the projection and the rectangle's coordinates should |
|---|
| 226 | be specified in the new coordinate system. If no projected coordinate |
|---|
| 227 | system was specified, the coordinates should be specified in the |
|---|
| 228 | original coordinate system.</p><p>The ArcGIS Clip tool is used to perfom the clip. The clipping |
|---|
| 229 | rectangle must be passed to this tool as a string of four numbers |
|---|
| 230 | separated by spaces. The ArcGIS user interface automatically formats |
|---|
| 231 | the string properly; when invoking this tool from the ArcGIS UI, |
|---|
| 232 | you need not worry about the format. But when invoking it |
|---|
| 233 | programmatically, take care to provide a properly-formatted string. |
|---|
| 234 | The numbers are ordered LEFT, BOTTOM, RIGHT, TOP. For example, if the |
|---|
| 235 | raster is in a geographic coordinate system, it may be clipped to 10 |
|---|
| 236 | W, 15 S, 20 E, and 25 N with the string:</p><dl><dt></dt><dd><p>10 15 20 25</p></dd></dl><p>Integers or decimal numbers may be provided.</p></td></tr><tr><td class="info">Execute map algebra expression (Optional) </td><td class="info" align="left"><p>Map algebra expression to execute on the raster.</p><p><b>WARNING:</b> The ArcGIS Geoprocessing Model Builder may randomly and |
|---|
| 237 | silently delete the value of this parameter. This is a bug in ArcGIS. |
|---|
| 238 | Before running a model that you have saved, open this tool and |
|---|
| 239 | validate that the parameter value still exists.</p><p>The expression is executed after the converted raster is projected and |
|---|
| 240 | clipped (if those options are specified). Use the case-sensitive |
|---|
| 241 | string inputRaster to represent the raster that you now want to |
|---|
| 242 | perform map algebra upon. For example, to convert the raster to an |
|---|
| 243 | integer raster and add 1 to all of the cells, use this expression:</p><dl><dt></dt><dd><pre>int(inputRaster) + 1</pre></dd></dl><p>The string inputRaster is case-sensitive. Prior to executing the map |
|---|
| 244 | algebra expression, the string is replaced with the path to a |
|---|
| 245 | temporary raster that represents the raster being generated. The final |
|---|
| 246 | expression must be less than 4000 characters long or ArcGIS will |
|---|
| 247 | report an error.</p><p>The ArcGIS Single Output Map Algebra tool is used to execute the map |
|---|
| 248 | algebra expression. You must have a license for the ArcGIS Spatial |
|---|
| 249 | Analyst extension in order to perform map algebra.</p><p>Map algebra syntax can be very picky. Here are some tips that will |
|---|
| 250 | help you succeed with this tool:</p><ul><li><p>Before using this tool, construct and test out your map algebra |
|---|
| 251 | expression using the ArcGIS Single Output Map Algebra tool. Then |
|---|
| 252 | paste the expression into this tool and edit it to use the |
|---|
| 253 | inputRaster variable rather than the test value you used with Single |
|---|
| 254 | Output Map Algebra.</p></li></ul><ul><li><p>If you do develop your expression directly in this tool, start with |
|---|
| 255 | a very simple expression. Verify that it works properly, add a |
|---|
| 256 | little to it, and verify again. Repeat this process until you have |
|---|
| 257 | built up the complete expression.</p></li></ul><ul><li><p>Always separate mathematical operators from raster paths using |
|---|
| 258 | spaces. In the example above, the / operator contains a space on |
|---|
| 259 | either side. Follow this pattern. In some circumstances, ArcGIS will |
|---|
| 260 | fail to process raster algebra expressions that do not separate |
|---|
| 261 | raster paths from operators using spaces. The reported error message |
|---|
| 262 | usually does not indicate that this is the problem, and tracking it |
|---|
| 263 | down can be very frustrating.</p></li></ul></td></tr><tr><td class="info">Where clause (Optional) </td><td class="info" align="left"><p>SQL WHERE clause expression that specifies the subset of rows to |
|---|
| 264 | process. If this parameter is not provided, all of the rows will be |
|---|
| 265 | processed. If this parameter is provided but the underlying database |
|---|
| 266 | does not support WHERE clauses, an error will be raised.</p><p>The exact syntax of this expression depends on the underlying |
|---|
| 267 | database. ESRI recommends you reference fields using the following |
|---|
| 268 | syntax:</p><ul><li><p>If you're querying ArcInfo coverages, shapefiles, INFO tables or |
|---|
| 269 | dBASE tables (.dbf files), enclose field names in double quotes in |
|---|
| 270 | the SQL expression: "MY_FIELD".</p></li></ul><ul><li><p>If you're querying Microsoft Access tables or personal |
|---|
| 271 | geodatabase tables, enclose field names in square brackets: |
|---|
| 272 | [MY_FIELD].</p></li></ul><ul><li><p>If you're querying ArcSDE geodatabase tables, an ArcIMS feature |
|---|
| 273 | class, or an ArcIMS image service sublayer, don't enclose field |
|---|
| 274 | names: MY_FIELD.</p></li></ul></td></tr><tr><td class="info">Order By fields (Optional) </td><td class="info" align="left"><p>Fields that will be used to sort the rows (i.e., the columns |
|---|
| 275 | specified in the ORDER BY clause of a SQL SELECT statement). If no |
|---|
| 276 | fields are provided, the rows will be sorted in the default order |
|---|
| 277 | determined by the underlying database. If this parameter is provided |
|---|
| 278 | but this computer is not running ArcGIS 9.2 or later or the underlying |
|---|
| 279 | database does not support ORDER BY clauses, an error will be raised.</p><p>In addition to specifying the ORDER BY fields, you must also specify |
|---|
| 280 | the sort direction for each field.</p></td></tr><tr><td class="info">Order By directions (Optional) </td><td class="info" align="left"><p>List of strings, either 'Ascending' or 'Descending', that specify |
|---|
| 281 | the sort directions for the ORDER BY fields. If this parameter is |
|---|
| 282 | provided but this computer is not running ArcGIS 9.2 or later or the |
|---|
| 283 | underlying database does not support ORDER BY clauses, an error will |
|---|
| 284 | be raised.</p></td></tr><tr><td class="info">Skip existing outputs (Optional) </td><td class="info" align="left"><p>If True, conversion will be skipped for feature classes that already exist.</p></td></tr><tr><td class="info">Base path (Optional) </td><td class="info" align="left"><p>Base path to prepend to relative paths.</p><p>If a base path is provided, it will be prepended to any relative paths |
|---|
| 285 | that are obtained from the fields that list the inputs (and outputs, |
|---|
| 286 | if this tool has outputs). If a base path is not provided, the |
|---|
| 287 | workspace containing the table will be prepended instead.</p></td></tr></tbody></table></div></body></html> |
|---|