<?xml version="1.0" encoding="UTF-8"?><metadata>
<Esri>
<CreaDate>20200102</CreaDate>
<CreaTime>12203200</CreaTime>
<ArcGISFormat>1.0</ArcGISFormat>
<SyncOnce>TRUE</SyncOnce>
<ModDate>20220407</ModDate>
<ModTime>074425</ModTime>
</Esri>
<dataIdInfo>
<idCitation>
<resTitle>InterpolatePoints</resTitle>
<date>
<createDate>20200102</createDate>
</date>
</idCitation>
<idAbs>
<para>Predicts values at new locations based on measurements from a collection of points. The tool takes point data with values at each point and returns a raster of predicted values.</para>
</idAbs>
<descKeys KeyTypCd="005">
<keyTyp>
<keyTyp>005</keyTyp>
</keyTyp>
<keyword>Generate Surface</keyword>
<keyword>Pattern</keyword>
<keyword>Ebk</keyword>
<keyword>Empirical Bayesian Kriging</keyword>
<keyword>Geostat</keyword>
<keyword>Interpolate</keyword>
<keyword>Kriging</keyword>
</descKeys>
</dataIdInfo>
<distInfo>
<distributor>
<distorFormat>
<formatName>ArcToolbox Tool</formatName>
</distorFormat>
</distributor>
</distInfo>
<mdDateSt>20200102</mdDateSt>
<mdContact>
<rpOrgName>Environmental Systems Research Institute, Inc. (Esri)</rpOrgName>
<rpCntInfo>
<cntAddress>
<delPoint>380 New York Street</delPoint>
<city>Redlands</city>
<adminArea>California</adminArea>
<postCode>92373-8100</postCode>
<eMailAdd>info@esri.com</eMailAdd>
<country>United States</country>
</cntAddress>
<cntPhone>
<voiceNum>909-793-2853</voiceNum>
<faxNum>909-793-5953</faxNum>
</cntPhone>
<cntOnlineRes>
<linkage>http://www.esri.com</linkage>
</cntOnlineRes>
</rpCntInfo>
<role>
<RoleCd>007</RoleCd>
</role>
</mdContact>
<tool displayname="InterpolatePoints" name="InterpolatePoints" softwarerestriction="none" toolboxalias="rasteranalytics">
<summary>
<para>Predicts values at new locations based on measurements from a collection of points. The tool takes point data with values at each point and returns a raster of predicted values.</para>
</summary>
<alink_name>InterpolatePoints_ra</alink_name>
<toolIllust alt="Interpolate Points tool" src="withheld" type="dialog"/>
<toolIllust alt="Interpolate Points tool" src="withheld" type="illustration"/>
<parameters>
<param datatype="Feature Set" direction="Input" displayname="inputPointFeatures" expression="inputPointFeatures" name="inputPointFeatures" sync="true" type="Required">
<pythonReference>
<para>The input point features you want to interpolate.</para>
</pythonReference>
<dialogReference>
<para>The input point features you want to interpolate.</para>
</dialogReference>
</param>
<param datatype="String" direction="Input" displayname="interpolateField" expression="interpolateField" name="interpolateField" sync="true" type="Required">
<pythonReference>
<para>The field containing the data values you want to interpolate. The field must be numeric.</para>
</pythonReference>
<dialogReference>
<para>The field containing the data values you want to interpolate. The field must be numeric.</para>
</dialogReference>
</param>
<param datatype="String" direction="Input" displayname="outputName" expression="outputName" name="outputName" sync="true" type="Required">
<pythonReference>
<para>The name of the output raster service.</para>
<para>The default name is based on the tool name and the input layer name. If the layer already exists, you will be prompted to provide another name.</para>
</pythonReference>
<dialogReference>
<para>The name of the output raster service.</para>
<para>The default name is based on the tool name and the input layer name. If the layer already exists, you will be prompted to provide another name.</para>
</dialogReference>
</param>
<param datatype="String" direction="Input" displayname="optimizeFor" expression="{BALANCE | SPEED | ACCURACY}" name="optimizeFor" sync="true" type="Optional">
<pythonReference>
<para>Choose your preference for speed versus accuracy. More accurate predictions will take longer to calculate.</para>
<bulletList>
<bullet_item>SPEED—The operation is optimized for speed.</bullet_item>
<bullet_item>BALANCE—A balance between speed and accuracy. This is the default.</bullet_item>
<bullet_item>ACCURACY—The operation is optimized for accuracy.</bullet_item>
</bulletList>
</pythonReference>
<dialogReference>
<para>Choose your preference for speed versus accuracy. More accurate predictions will take longer to calculate.</para>
<bulletList>
<bullet_item>Speed—The operation is optimized for speed.</bullet_item>
<bullet_item>Balance—A balance between speed and accuracy. This is the default.</bullet_item>
<bullet_item>Accuracy—The operation is optimized for accuracy.</bullet_item>
</bulletList>
</dialogReference>
<enumcorrespondence>
<enum label="Speed" name="SPEED"/>
<enum label="Balance" name="BALANCE"/>
<enum label="Accuracy" name="ACCURACY"/>
</enumcorrespondence>
</param>
<param datatype="Boolean" direction="Input" displayname="transformData" expression="{NO_TRANSFORM | TRANSFORM}" name="transformData" sync="true" type="Optional">
<pythonReference>
<para>Choose whether to transform your data to a normal distribution before performing analysis. If your data values do not appear to be normally distributed (bell-shaped), it is recommended to perform a transformation.</para>
<bulletList>
<bullet_item>NO_TRANSFORM—No transformation is applied. This is the default.</bullet_item>
<bullet_item>TRANSFORM—A transformation to the normal distribution is applied.</bullet_item>
</bulletList>
</pythonReference>
<dialogReference>
<para>Choose whether to transform your data to a normal distribution before performing analysis. If your data values do not appear to be normally distributed (bell-shaped), it is recommended to perform a transformation.</para>
<bulletList>
<bullet_item>Checked—A transformation to the normal distribution is applied.</bullet_item>
<bullet_item>Unchecked—No transformation is applied. This is the default.</bullet_item>
</bulletList>
</dialogReference>
</param>
<param datatype="Long" direction="Input" displayname="sizeOfLocalModels" expression="{sizeOfLocalModels}" name="sizeOfLocalModels" sync="true" type="Optional">
<pythonReference>
<para>Choose the number of points in each of the local models. A larger value will make the interpolation more global and stable, but small-scale effects may be missed. Smaller values will make the interpolation more local, so small-scale effects are more likely to be captured, but the interpolation may be unstable.</para>
</pythonReference>
<dialogReference>
<para>Choose the number of points in each of the local models. A larger value will make the interpolation more global and stable, but small-scale effects may be missed. Smaller values will make the interpolation more local, so small-scale effects are more likely to be captured, but the interpolation may be unstable.</para>
</dialogReference>
</param>
<param datatype="Long" direction="Input" displayname="numberOfNeighbors" expression="{numberOfNeighbors}" name="numberOfNeighbors" sync="true" type="Optional">
<pythonReference>
<para>The number of neighbors to use when calculating the prediction at a particular cell.</para>
</pythonReference>
<dialogReference>
<para>The number of neighbors to use when calculating the prediction at a particular cell.</para>
</dialogReference>
</param>
<param datatype="Linear Unit" direction="Input" displayname="outputCellSize" expression="{outputCellSize}" name="outputCellSize" sync="true" type="Optional">
<pythonReference>
<para>Set the cell size and units of the output raster. If a prediction error raster is created, it will also use this cell size.</para>
<para>The units can be Kilometers, Meters, Miles, or Feet.</para>
<para>The default units are Meters.</para>
</pythonReference>
<dialogReference>
<para>Set the cell size and units of the output raster. If a prediction error raster is created, it will also use this cell size.</para>
<para>The units can be Kilometers, Meters, Miles, or Feet.</para>
<para>The default units are Meters.</para>
</dialogReference>
</param>
<param datatype="Boolean" direction="Input" displayname="outputPredictionError" expression="{NO_OUTPUT_ERROR | OUTPUT_ERROR}" name="outputPredictionError" sync="true" type="Optional">
<pythonReference>
<para>Choose whether to output a raster of standard errors of the interpolated predictions.</para>
<para>Standard errors are useful because they provide information about the reliability of the predicted values. A simple rule of thumb is that the true value will fall within two standard errors of the predicted value 95 percent of the time. For example, suppose a new location gets a predicted value of 50 with a standard error of 5. This means that this task's best guess is that the true value at that location is 50, but it reasonably could be as low as 40 or as high as 60. To calculate this range of reasonable values, multiply the standard error by 2, add this value to the predicted value to get the upper end of the range, and subtract it from the predicted value to get the lower end of the range.</para>
<para>If a raster of standard errors for the interpolated predictions is requested, it will have the same name as the Result layer name but with Errors appended.</para>
<bulletList>
<bullet_item>OUTPUT_ERROR—Create a prediction error raster.</bullet_item>
<bullet_item>NO_OUTPUT_ERROR—Do not create a prediction error raster. This is the default.</bullet_item>
</bulletList>
</pythonReference>
<dialogReference>
<para>Choose whether to output a raster of standard errors of the interpolated predictions.</para>
<para>Standard errors are useful because they provide information about the reliability of the predicted values. A simple rule of thumb is that the true value will fall within two standard errors of the predicted value 95 percent of the time. For example, suppose a new location gets a predicted value of 50 with a standard error of 5. This means that this task's best guess is that the true value at that location is 50, but it reasonably could be as low as 40 or as high as 60. To calculate this range of reasonable values, multiply the standard error by 2, add this value to the predicted value to get the upper end of the range, and subtract it from the predicted value to get the lower end of the range.</para>
<para>If a raster of standard errors for the interpolated predictions is requested, it will have the same name as the Result layer name but with Errors appended.</para>
<bulletList>
<bullet_item>Unchecked—No output prediction error is generated. This is the default.</bullet_item>
<bullet_item>Checked—An output prediction error is generated.</bullet_item>
</bulletList>
</dialogReference>
</param>
<param datatype="String" direction="Input" displayname="context" expression="{context}" name="context" type="Optional"/>
</parameters>
<returnvalues/>
<environments>
<environment label="Output extent" name="extent"/>
<environment label="Cell size" name="cellSize"/>
<environment label="Mask" name="mask"/>
<environment label="Output coordinate system" name="outputCoordinateSystem"/>
<environment label="Snap raster" name="snapRaster"/>
</environments>
<usage>
<bullet_item>
<para>The interpolation is performed by generating many local interpolation models that are merged together to create the final output raster. The number of points in each local model can be controlled with the Size of local models parameter.</para>
</bullet_item>
<bullet_item>
<para>The Empirical Bayesian Kriging tool is used to perform the underlying interpolation. This tool is part of the ArcGIS Geostatistical Analyst extension. Many parameters of the tool are exposed in Interpolate Points, but many are controlled automatically by the Optimize for parameter.</para>
</bullet_item>
</usage>
<scriptExamples>
<scriptExample>
<title>InterpolatePoints example 1 (Python window)</title>
<para>This example interpolates a point feature service into an image service raster.</para>
<code xml:space="preserve">import arcpy
arcpy.InterpolatePoints_ra('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
'myField', 'outImgServ', 'SPEED', 'False', 50, 8, '10000 Meters', 'NO_OUTPUT_ERROR')
</code>
</scriptExample>
<scriptExample>
<title>InterpolatePoints example 2 (stand-alone script)</title>
<para>This example interpolates a point feature service into an image service raster.</para>
<code xml:space="preserve">#-------------------------------------------------------------------------------
# Name: InterpolatePoints_example02.py
# Description: Interpolates a point feature service into an image service raster.
#
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inPoints = 'https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0'
inField = 'myField'
outRaster = 'outImgServ'
optimizeFor = 'SPEED'
transform = 'False'
subsetSize = 50
numNeighbors = 8
outCellSize = '10000 Meters'
error = 'NO_OUTPUT_ERROR'
# Execute InterpolatePoints
arcpy.InterpolatePoints_ra(inPoints, inField, outRaster, optimizeFor, transform, subsetSize, numNeighbors, outCellSize, error)
</code>
</scriptExample>
</scriptExamples>
<shortdesc>ArcGIS geoprocessing tool for interpolating points into a raster surface.</shortdesc>
<arcToolboxHelpPath>withheld</arcToolboxHelpPath>
</tool>
</metadata>
