| 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 SIR Files Listed in Table To ArcGIS Rasters</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 SIR Files Listed in Table To ArcGIS Rasters</h1><p></p><p>Converts each SIR file in a table to an ArcGIS raster.</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="id103139">SIRFileToArcGISRasterArcGISTable_GeoEco <table> <sirFileField> <outputRasterField> {projectedCoordinateSystem} {geographicTransformation} {NEAREST | BILINEAR | CUBIC} {projectedCellSize} {registrationPoint} {clippingRectangle} {mapAlgebraExpression} {buildPyramids} {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"><sirFileField></td><td class="info" align="left"><p>Field containing the paths of SIR files.</p><p>The SIR format was designed by the Brigham Young University MERS lab. |
|---|
| 4 | MERS publishes various products derived from scatterometers bourne by |
|---|
| 5 | satellites such as QuikSCAT. These products include sea surface wind |
|---|
| 6 | vectors, sea ice masks, and raw scatterometer sigma-0 values, which |
|---|
| 7 | correlate with the roughness of the ocean surface.</p><p>Compressed files in a supported compression format will be |
|---|
| 8 | automatically decompressed. Archives (e.g. .zip or .tar) must contain |
|---|
| 9 | exactly one file, which must not be in a subdirectory.</p></td></tr><tr><td class="info"><outputRasterField></td><td class="info" align="left"><p>Field containing the output rasters to create.</p></td></tr><tr><td class="info">{projectedCoordinateSystem}</td><td class="info" align="left"><p>New coordinate system to project the output raster to.</p><p>The raster may only be projected to a new coordinate system if the |
|---|
| 10 | original projection is defined. An error will be raised if you specify |
|---|
| 11 | a new coordinate system without defining the original coordinate |
|---|
| 12 | system.</p><p>The ArcGIS Project Raster tool is used to perform the projection. The |
|---|
| 13 | documentation for that tool recommends that you also specify a cell |
|---|
| 14 | size for the new coordinate system.</p><p>I have noticed that for certain coordinate systems the ArcGIS 9.2 |
|---|
| 15 | Project Raster tool seems to clip the projected raster to an arbitrary |
|---|
| 16 | extent that is too small. For example, when projecting a global MODIS |
|---|
| 17 | Aqua 4 km chlorophyll image in geographic coordinates to |
|---|
| 18 | Lambert_Azimuthal_Equal_Area with central meridian of -60 and latitude |
|---|
| 19 | of origin of -63, the resulting image is clipped to show only |
|---|
| 20 | one-quarter of the planet. This problem does not occur when Project |
|---|
| 21 | Raster is invoked interactively from the ArcGIS user interface; it |
|---|
| 22 | only occurs when the tool is invoked programmatically (the |
|---|
| 23 | ProjectRaster_management method of the geoprocessor). Thus you may |
|---|
| 24 | not see it when you use Project Raster yourself but it may happen when |
|---|
| 25 | you use MGET tools that invoke Project Raster as part of their |
|---|
| 26 | 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 |
|---|
| 27 | obtain the output raster in the original coordinate system.</p></li></ul><ul><li><p>In ArcCatalog, use the Project Raster tool to project the raster to |
|---|
| 28 | the new coordinate system. Verify that the entire raster is present, |
|---|
| 29 | 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 |
|---|
| 30 | right-clicking on it in the catalog tree, selecting Properties, and |
|---|
| 31 | scrolling down to Extent.</p></li></ul><ul><li><p>Now, before running the MGET tool that projects the raster, set the |
|---|
| 32 | Extent environment setting to the values you looked up. If you are |
|---|
| 33 | invoking the MGET tool interactively from ArcCatalog or ArcMap, |
|---|
| 34 | click the Environments button on the tool's dialog box, open General |
|---|
| 35 | Settings, change the Extent drop-down to "As Specified Below", and |
|---|
| 36 | type in the values you looked up. If you're invoking it from a |
|---|
| 37 | geoprocessing model, right-click on the tool in the model, select |
|---|
| 38 | Make Variable, From Environment, General Settings, Extent. This will |
|---|
| 39 | place Extent as a variable in your model, attached to the MGET tool. |
|---|
| 40 | Open the Extent variable, change it to "As Specified Below" and type |
|---|
| 41 | in the values you looked up. If you're invoking the MGET tool |
|---|
| 42 | programmatically, you must set the Extent property of the |
|---|
| 43 | geoprocessor to the values you looked up. Please see the ArcGIS |
|---|
| 44 | documentation for more information about this and Environment |
|---|
| 45 | settings in general.</p></li></ul><ul><li><p>Run the MGET tool. The extent of the output raster should now be the |
|---|
| 46 | 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 |
|---|
| 47 | coordinate system and the new coordinate system.</p><p>This parameter is a new option introduced by ArcGIS 9.2. You must have |
|---|
| 48 | ArcGIS 9.2 to use this parameter.</p><p>This parameter is only needed when you specify that the raster should |
|---|
| 49 | be projected to a new coordinate system and that new system uses a |
|---|
| 50 | different datum than the original coordinate system, or there is some |
|---|
| 51 | other difference between the two coordinate systems that requires a |
|---|
| 52 | transformation. To determine if a transformation is needed, I |
|---|
| 53 | recommend the following procedure:</p><ul><li><p>First, run this tool without specifying a new coordinate system, to |
|---|
| 54 | obtain the output raster in the original coordinate system.</p></li></ul><ul><li><p>Next, use the ArcGIS 9.2 Project Raster tool on the output raster to |
|---|
| 55 | project it to the desired coordinate system. If a geographic |
|---|
| 56 | transformation is needed, that tool will prompt you for one. Write |
|---|
| 57 | 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 |
|---|
| 58 | this tool, rerun it, and verify that the output raster was projected |
|---|
| 59 | as you 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 |
|---|
| 60 | to a new coordinate system. The ArcGIS Project Raster tool is used to |
|---|
| 61 | 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 |
|---|
| 62 | coordinate system. An error will be raised if you specify a new |
|---|
| 63 | 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 |
|---|
| 64 | parameter is optional, to receive the best results, the ArcGIS |
|---|
| 65 | documentation recommends you always specify it when projecting to a |
|---|
| 66 | 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 |
|---|
| 67 | alignment.</p><p>This parameter is a new option introduced by ArcGIS 9.2. You must have |
|---|
| 68 | ArcGIS 9.2 to use this parameter. It is ignored if you do not specify |
|---|
| 69 | that the raster should be projected to a new coordinate system.</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 |
|---|
| 70 | performed after the projection and the rectangle's coordinates should |
|---|
| 71 | be specified in the new coordinate system. If no projected coordinate |
|---|
| 72 | system was specified, the coordinates should be specified in the |
|---|
| 73 | original coordinate system.</p><p>The ArcGIS Clip tool is used to perfom the clip. The clipping |
|---|
| 74 | rectangle must be passed to this tool as a string of four numbers |
|---|
| 75 | separated by spaces. The ArcGIS user interface automatically formats |
|---|
| 76 | the string properly; when invoking this tool from the ArcGIS UI, |
|---|
| 77 | you need not worry about the format. But when invoking it |
|---|
| 78 | programmatically, take care to provide a properly-formatted string. |
|---|
| 79 | The numbers are ordered LEFT, BOTTOM, RIGHT, TOP. For example, if the |
|---|
| 80 | raster is in a geographic coordinate system, it may be clipped to 10 |
|---|
| 81 | 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 output raster.</p><p><b>WARNING:</b> The ArcGIS Geoprocessing Model Builder may randomly and |
|---|
| 82 | silently delete the value of this parameter. This is a bug in ArcGIS. |
|---|
| 83 | Before running a model that you have saved, open this tool and |
|---|
| 84 | validate that the parameter value still exists.</p><p>The expression is executed after the converted raster is projected and |
|---|
| 85 | clipped (if those options are specified). Use the case-sensitive |
|---|
| 86 | string inputRaster to represent the raster that you now want to |
|---|
| 87 | perform map algebra upon. For example, to convert the raster to an |
|---|
| 88 | 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 |
|---|
| 89 | algebra expression, the string is replaced with the path to a |
|---|
| 90 | temporary raster that represents the output raster being generated. |
|---|
| 91 | The final expression must be less than 4000 characters long or ArcGIS |
|---|
| 92 | will report an error.</p><p>The ArcGIS Single Output Map Algebra tool is used to execute the map |
|---|
| 93 | algebra expression. You must have a license for the ArcGIS Spatial |
|---|
| 94 | Analyst extension in order to perform map algebra.</p><p>Map algebra syntax can be very picky. Here are some tips that will |
|---|
| 95 | help you succeed with this tool:</p><ul><li><p>Before using this tool, construct and test out your map algebra |
|---|
| 96 | expression using the ArcGIS Single Output Map Algebra tool. Then |
|---|
| 97 | paste the expression into this tool and edit it to use the |
|---|
| 98 | inputRaster variable rather than the test value you used with Single |
|---|
| 99 | Output Map Algebra.</p></li></ul><ul><li><p>If you do develop your expression directly in this tool, start with |
|---|
| 100 | a very simple expression. Verify that it works properly, add a |
|---|
| 101 | little to it, and verify again. Repeat this process until you have |
|---|
| 102 | built up the complete expression.</p></li></ul><ul><li><p>Always separate mathematical operators from raster paths using |
|---|
| 103 | spaces. In the example above, the / operator contains a space on |
|---|
| 104 | either side. Follow this pattern. In some circumstances, ArcGIS will |
|---|
| 105 | fail to process raster algebra expressions that do not separate |
|---|
| 106 | raster paths from operators using spaces. The reported error message |
|---|
| 107 | usually does not indicate that this is the problem, and tracking it |
|---|
| 108 | down can be very frustrating.</p></li></ul></td></tr><tr><td class="info">{buildPyramids}</td><td class="info" align="left"><p>If True, pyramids will be built for the output raster, which will |
|---|
| 109 | improve its display speed in the ArcGIS user interface. This is the |
|---|
| 110 | last step performed in post-conversion processing.</p></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 |
|---|
| 111 | process. If this parameter is not provided, all of the rows will be |
|---|
| 112 | processed. If this parameter is provided but the underlying database |
|---|
| 113 | does not support WHERE clauses, an error will be raised.</p><p>The exact syntax of this expression depends on the underlying |
|---|
| 114 | database. ESRI recommends you reference fields using the following |
|---|
| 115 | syntax:</p><ul><li><p>If you're querying ArcInfo coverages, shapefiles, INFO tables or |
|---|
| 116 | dBASE tables (.dbf files), enclose field names in double quotes in |
|---|
| 117 | the SQL expression: "MY_FIELD".</p></li></ul><ul><li><p>If you're querying Microsoft Access tables or personal |
|---|
| 118 | geodatabase tables, enclose field names in square brackets: |
|---|
| 119 | [MY_FIELD].</p></li></ul><ul><li><p>If you're querying ArcSDE geodatabase tables, an ArcIMS feature |
|---|
| 120 | class, or an ArcIMS image service sublayer, don't enclose field |
|---|
| 121 | 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 |
|---|
| 122 | specified in the ORDER BY clause of a SQL SELECT statement). If no |
|---|
| 123 | fields are provided, the rows will be sorted in the default order |
|---|
| 124 | determined by the underlying database. If this parameter is provided |
|---|
| 125 | but this computer is not running ArcGIS 9.2 or later or the underlying |
|---|
| 126 | 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 |
|---|
| 127 | 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 |
|---|
| 128 | the sort directions for the ORDER BY fields. If this parameter is |
|---|
| 129 | provided but this computer is not running ArcGIS 9.2 or later or the |
|---|
| 130 | underlying database does not support ORDER BY clauses, an error will |
|---|
| 131 | be raised.</p></td></tr><tr><td class="info">{skipExisting}</td><td class="info" align="left"><p>If True, conversion will be skipped for output rasters 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 |
|---|
| 132 | that are obtained from the fields that list the inputs (and outputs, |
|---|
| 133 | if this tool has outputs). If a base path is not provided, the |
|---|
| 134 | 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">SIRFileToArcGISRasterArcGISTable_GeoEco (table, sirFileField, outputRasterField, projectedCoordinateSystem, geographicTransformation, resamplingTechnique, projectedCellSize, registrationPoint, clippingRectangle, mapAlgebraExpression, buildPyramids, 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">SIR file field (Required) </td><td class="info" align="left"><p>Field containing the paths of SIR files.</p><p>The SIR format was designed by the Brigham Young University MERS lab. |
|---|
| 135 | MERS publishes various products derived from scatterometers bourne by |
|---|
| 136 | satellites such as QuikSCAT. These products include sea surface wind |
|---|
| 137 | vectors, sea ice masks, and raw scatterometer sigma-0 values, which |
|---|
| 138 | correlate with the roughness of the ocean surface.</p><p>Compressed files in a supported compression format will be |
|---|
| 139 | automatically decompressed. Archives (e.g. .zip or .tar) must contain |
|---|
| 140 | exactly one file, which must not be in a subdirectory.</p></td></tr><tr><td class="info">Output ArcGIS raster field (Required) </td><td class="info" align="left"><p>Field containing the output rasters to create.</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 output raster to.</p><p>The raster may only be projected to a new coordinate system if the |
|---|
| 141 | original projection is defined. An error will be raised if you specify |
|---|
| 142 | a new coordinate system without defining the original coordinate |
|---|
| 143 | system.</p><p>The ArcGIS Project Raster tool is used to perform the projection. The |
|---|
| 144 | documentation for that tool recommends that you also specify a cell |
|---|
| 145 | size for the new coordinate system.</p><p>I have noticed that for certain coordinate systems the ArcGIS 9.2 |
|---|
| 146 | Project Raster tool seems to clip the projected raster to an arbitrary |
|---|
| 147 | extent that is too small. For example, when projecting a global MODIS |
|---|
| 148 | Aqua 4 km chlorophyll image in geographic coordinates to |
|---|
| 149 | Lambert_Azimuthal_Equal_Area with central meridian of -60 and latitude |
|---|
| 150 | of origin of -63, the resulting image is clipped to show only |
|---|
| 151 | one-quarter of the planet. This problem does not occur when Project |
|---|
| 152 | Raster is invoked interactively from the ArcGIS user interface; it |
|---|
| 153 | only occurs when the tool is invoked programmatically (the |
|---|
| 154 | ProjectRaster_management method of the geoprocessor). Thus you may |
|---|
| 155 | not see it when you use Project Raster yourself but it may happen when |
|---|
| 156 | you use MGET tools that invoke Project Raster as part of their |
|---|
| 157 | 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 |
|---|
| 158 | obtain the output raster in the original coordinate system.</p></li></ul><ul><li><p>In ArcCatalog, use the Project Raster tool to project the raster to |
|---|
| 159 | the new coordinate system. Verify that the entire raster is present, |
|---|
| 160 | 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 |
|---|
| 161 | right-clicking on it in the catalog tree, selecting Properties, and |
|---|
| 162 | scrolling down to Extent.</p></li></ul><ul><li><p>Now, before running the MGET tool that projects the raster, set the |
|---|
| 163 | Extent environment setting to the values you looked up. If you are |
|---|
| 164 | invoking the MGET tool interactively from ArcCatalog or ArcMap, |
|---|
| 165 | click the Environments button on the tool's dialog box, open General |
|---|
| 166 | Settings, change the Extent drop-down to "As Specified Below", and |
|---|
| 167 | type in the values you looked up. If you're invoking it from a |
|---|
| 168 | geoprocessing model, right-click on the tool in the model, select |
|---|
| 169 | Make Variable, From Environment, General Settings, Extent. This will |
|---|
| 170 | place Extent as a variable in your model, attached to the MGET tool. |
|---|
| 171 | Open the Extent variable, change it to "As Specified Below" and type |
|---|
| 172 | in the values you looked up. If you're invoking the MGET tool |
|---|
| 173 | programmatically, you must set the Extent property of the |
|---|
| 174 | geoprocessor to the values you looked up. Please see the ArcGIS |
|---|
| 175 | documentation for more information about this and Environment |
|---|
| 176 | settings in general.</p></li></ul><ul><li><p>Run the MGET tool. The extent of the output raster should now be the |
|---|
| 177 | 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 |
|---|
| 178 | coordinate system and the new coordinate system.</p><p>This parameter is a new option introduced by ArcGIS 9.2. You must have |
|---|
| 179 | ArcGIS 9.2 to use this parameter.</p><p>This parameter is only needed when you specify that the raster should |
|---|
| 180 | be projected to a new coordinate system and that new system uses a |
|---|
| 181 | different datum than the original coordinate system, or there is some |
|---|
| 182 | other difference between the two coordinate systems that requires a |
|---|
| 183 | transformation. To determine if a transformation is needed, I |
|---|
| 184 | recommend the following procedure:</p><ul><li><p>First, run this tool without specifying a new coordinate system, to |
|---|
| 185 | obtain the output raster in the original coordinate system.</p></li></ul><ul><li><p>Next, use the ArcGIS 9.2 Project Raster tool on the output raster to |
|---|
| 186 | project it to the desired coordinate system. If a geographic |
|---|
| 187 | transformation is needed, that tool will prompt you for one. Write |
|---|
| 188 | 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 |
|---|
| 189 | this tool, rerun it, and verify that the output raster was projected |
|---|
| 190 | as you 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 |
|---|
| 191 | to a new coordinate system. The ArcGIS Project Raster tool is used to |
|---|
| 192 | 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 |
|---|
| 193 | coordinate system. An error will be raised if you specify a new |
|---|
| 194 | 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 |
|---|
| 195 | parameter is optional, to receive the best results, the ArcGIS |
|---|
| 196 | documentation recommends you always specify it when projecting to a |
|---|
| 197 | 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 |
|---|
| 198 | alignment.</p><p>This parameter is a new option introduced by ArcGIS 9.2. You must have |
|---|
| 199 | ArcGIS 9.2 to use this parameter. It is ignored if you do not specify |
|---|
| 200 | that the raster should be projected to a new coordinate system.</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 |
|---|
| 201 | performed after the projection and the rectangle's coordinates should |
|---|
| 202 | be specified in the new coordinate system. If no projected coordinate |
|---|
| 203 | system was specified, the coordinates should be specified in the |
|---|
| 204 | original coordinate system.</p><p>The ArcGIS Clip tool is used to perfom the clip. The clipping |
|---|
| 205 | rectangle must be passed to this tool as a string of four numbers |
|---|
| 206 | separated by spaces. The ArcGIS user interface automatically formats |
|---|
| 207 | the string properly; when invoking this tool from the ArcGIS UI, |
|---|
| 208 | you need not worry about the format. But when invoking it |
|---|
| 209 | programmatically, take care to provide a properly-formatted string. |
|---|
| 210 | The numbers are ordered LEFT, BOTTOM, RIGHT, TOP. For example, if the |
|---|
| 211 | raster is in a geographic coordinate system, it may be clipped to 10 |
|---|
| 212 | 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 output raster.</p><p><b>WARNING:</b> The ArcGIS Geoprocessing Model Builder may randomly and |
|---|
| 213 | silently delete the value of this parameter. This is a bug in ArcGIS. |
|---|
| 214 | Before running a model that you have saved, open this tool and |
|---|
| 215 | validate that the parameter value still exists.</p><p>The expression is executed after the converted raster is projected and |
|---|
| 216 | clipped (if those options are specified). Use the case-sensitive |
|---|
| 217 | string inputRaster to represent the raster that you now want to |
|---|
| 218 | perform map algebra upon. For example, to convert the raster to an |
|---|
| 219 | 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 |
|---|
| 220 | algebra expression, the string is replaced with the path to a |
|---|
| 221 | temporary raster that represents the output raster being generated. |
|---|
| 222 | The final expression must be less than 4000 characters long or ArcGIS |
|---|
| 223 | will report an error.</p><p>The ArcGIS Single Output Map Algebra tool is used to execute the map |
|---|
| 224 | algebra expression. You must have a license for the ArcGIS Spatial |
|---|
| 225 | Analyst extension in order to perform map algebra.</p><p>Map algebra syntax can be very picky. Here are some tips that will |
|---|
| 226 | help you succeed with this tool:</p><ul><li><p>Before using this tool, construct and test out your map algebra |
|---|
| 227 | expression using the ArcGIS Single Output Map Algebra tool. Then |
|---|
| 228 | paste the expression into this tool and edit it to use the |
|---|
| 229 | inputRaster variable rather than the test value you used with Single |
|---|
| 230 | Output Map Algebra.</p></li></ul><ul><li><p>If you do develop your expression directly in this tool, start with |
|---|
| 231 | a very simple expression. Verify that it works properly, add a |
|---|
| 232 | little to it, and verify again. Repeat this process until you have |
|---|
| 233 | built up the complete expression.</p></li></ul><ul><li><p>Always separate mathematical operators from raster paths using |
|---|
| 234 | spaces. In the example above, the / operator contains a space on |
|---|
| 235 | either side. Follow this pattern. In some circumstances, ArcGIS will |
|---|
| 236 | fail to process raster algebra expressions that do not separate |
|---|
| 237 | raster paths from operators using spaces. The reported error message |
|---|
| 238 | usually does not indicate that this is the problem, and tracking it |
|---|
| 239 | down can be very frustrating.</p></li></ul></td></tr><tr><td class="info">Build pyramids (Optional) </td><td class="info" align="left"><p>If True, pyramids will be built for the output raster, which will |
|---|
| 240 | improve its display speed in the ArcGIS user interface. This is the |
|---|
| 241 | last step performed in post-conversion processing.</p></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 |
|---|
| 242 | process. If this parameter is not provided, all of the rows will be |
|---|
| 243 | processed. If this parameter is provided but the underlying database |
|---|
| 244 | does not support WHERE clauses, an error will be raised.</p><p>The exact syntax of this expression depends on the underlying |
|---|
| 245 | database. ESRI recommends you reference fields using the following |
|---|
| 246 | syntax:</p><ul><li><p>If you're querying ArcInfo coverages, shapefiles, INFO tables or |
|---|
| 247 | dBASE tables (.dbf files), enclose field names in double quotes in |
|---|
| 248 | the SQL expression: "MY_FIELD".</p></li></ul><ul><li><p>If you're querying Microsoft Access tables or personal |
|---|
| 249 | geodatabase tables, enclose field names in square brackets: |
|---|
| 250 | [MY_FIELD].</p></li></ul><ul><li><p>If you're querying ArcSDE geodatabase tables, an ArcIMS feature |
|---|
| 251 | class, or an ArcIMS image service sublayer, don't enclose field |
|---|
| 252 | 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 |
|---|
| 253 | specified in the ORDER BY clause of a SQL SELECT statement). If no |
|---|
| 254 | fields are provided, the rows will be sorted in the default order |
|---|
| 255 | determined by the underlying database. If this parameter is provided |
|---|
| 256 | but this computer is not running ArcGIS 9.2 or later or the underlying |
|---|
| 257 | 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 |
|---|
| 258 | 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 |
|---|
| 259 | the sort directions for the ORDER BY fields. If this parameter is |
|---|
| 260 | provided but this computer is not running ArcGIS 9.2 or later or the |
|---|
| 261 | underlying database does not support ORDER BY clauses, an error will |
|---|
| 262 | 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 output rasters 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 |
|---|
| 263 | that are obtained from the fields that list the inputs (and outputs, |
|---|
| 264 | if this tool has outputs). If a base path is not provided, the |
|---|
| 265 | workspace containing the table will be prepended instead.</p></td></tr></tbody></table></div></body></html> |
|---|