IDW (Spatial Analyst)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Interpole une surface raster à partir de points à l'aide d'une méthode de pondération par l'inverse de la distance (IDW).

Pour en savoir plus sur la fonction IDW

Utilisation

Syntaxe

Idw (in_point_features, z_field, {cell_size}, {power}, {search_radius}, {in_barrier_polyline_features})
ParamètreExplicationType de données
in_point_features

Les entités points en entrée contenant les valeurs z à interpoler dans un raster de surface.

Feature Layer
z_field

Champ contenant une valeur de hauteur ou de magnitude pour chaque point.

Il peut s'agir d'un champ numérique ou du champ Forme, si les entités ponctuelles en entrée contiennent des valeurs Z.

Field
cell_size
(Facultatif)

Taille des cellules qui sera utilisée pour la création du raster en sortie.

Il s'agit de la valeur dans l'environnement s'il est explicitement défini, ou de la plus petite largeur ou hauteur de l'étendue des entités ponctuelles en entrée, dans la référence spatiale en entrée, divisée par 250.

Analysis Cell Size
power
(Facultatif)

Exposant de la distance.

Contrôle l'importance des points environnants sur la valeur interpolée. Une puissance plus élevée engendre une moindre influence des points distants. Il peut s'agir de n'importe quel nombre réel supérieur à 0 ; vous obtiendrez toutefois de meilleurs résultats avec des valeurs comprises entre 0,5 et 3. La valeur par défaut est 2.

Double
search_radius
(Facultatif)

La classe Rayon définit le point en entrée qui permet d'interpoler la valeur pour chaque cellule dans le raster en sortie.

Il existe deux types de classes de rayons : RadiusVariable et RadiusFixed. Un rayon de recherche Variable permet de rechercher un nombre spécifié de points d'échantillonnage en entrée pour l'interpolation. Le type Fixed utilise une distance fixe spécifiée dans laquelle tous les points en entrée sont utilisés pour l'interpolation. Variable est le type par défaut.

  • RadiusVariable ({numberofPoints}, {maxDistance})
    • {numberofPoints} - Valeur entière spécifiant le nombre de points d'échantillonnage en entrée les plus proches à utiliser pour effectuer l'interpolation. La valeur par défaut est 12.
    • {maxDistance} - Spécifie la distance, en unités de carte, de limite de la recherche des points d'échantillonnage en entrée les plus proches. La valeur par défaut est la longueur de la diagonale de l'étendue.
  • RadiusFixed ({distance}, {minNumberofPoints})
    • {distance} - Spécifie la distance en tant que rayon au sein duquel les points d'échantillonnage en entrée permettent d'effectuer l'interpolation.

      La valeur du rayon est exprimée en unités de carte. Le rayon par défaut est de 5 fois la taille de cellule du raster en sortie.

    • {minNumberofPoints} – Entier définissant le nombre minimal de points à utiliser pour l'interpolation. La valeur par défaut est 0.

      Si le nombre de points requis n'est pas trouvé dans la distance spécifiée, la distance de recherche augmente jusqu'à ce que le nombre minimal de points spécifié soit trouvé.

      Le rayon de recherche est augmenté lorsque cela est nécessaire jusqu'à ce que la valeur de l'option {minNumberofPoints} soit comprise dans ce rayon ou que l'étendue du rayon traverse l'étendue inférieure (sud) et/ou supérieure (nord) du raster en sortie. La valeur NoData est attribuée à tous les emplacements qui ne remplissent pas la condition susmentionnée.

Radius
in_barrier_polyline_features
(Facultatif)

Entités de type polyligne à utiliser pour couper ou limiter la recherche des points d'échantillonnage en entrée.

Feature Layer

Valeur renvoyée

NomExplicationType de données
out_raster

Raster de surface interpolé en sortie.

Raster

Exemple de code

1er exemple d'utilisation de l'outil IDW (fenêtre Python)

Cet exemple entre un fichier de formes ponctuel et interpole la surface en sortie en tant que raster TIFF.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outIDW = Idw("ozone_pts.shp", "ozone", 2000, 2, RadiusVariable(10, 150000))
outIDW.save("C:/sapyexamples/output/idwout.tif")
2e exemple d'utilisation de l'outil IDW (script autonome)

Cet exemple entre un fichier de formes ponctuelles et interpole la surface en sortie en tant que raster Grid.

# Name: IDW_Ex_02.py
# Description: Interpolate a series of point features onto a rectangular 
#   raster using Inverse Distance Weighting (IDW).
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inPointFeatures = "ca_ozone_pts.shp"
zField = "ozone"
cellSize = 2000.0
power = 2
searchRadius = RadiusVariable(10, 150000)

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute IDW
outIDW = Idw(inPointFeatures, zField, cellSize, power, searchRadius)

# Save the output 
outIDW.save("C:/sapyexamples/output/idwout02")

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst ou 3D Analyst
ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst ou 3D Analyst
ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst ou 3D Analyst
5/10/2014