IDW (3D Analyst)

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_3d (in_point_features, z_field, out_raster, {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
out_raster

Raster de surface interpolé en sortie.

Raster Layer
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)

Indique les points en entrée utilisés pour interpoler la valeur de chaque cellule dans le raster en sortie.

Il existe deux moyens de spécifier la recherche de voisinage : Variable et +++Fixed.

Variable utilise un rayon de recherche variable afin de rechercher un nombre spécifié de points d'échantillonnage en entrée pour l'interpolation. +++Fixed utilise une distance fixe spécifiée dans laquelle tous les points en entrée sont utilisés. Variable est l'option par défaut.

La syntaxe de ces paramètres est la suivante :

  • Variable, number_of_points, maximum_distance, où :
    • number_of_points - 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.
    • maximum_distance - 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.
  • Fixed, distance, minimum_number_of_points, où :
    • 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.
    • minimum_number_of_points – 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 minimum_number_of_points 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

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  
env.workspace = "C:/data"
arcpy.Idw_3d("ozone_pts.shp", "ozone", "C:/output/idwout.tif", 2000, 2, 10)
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_3d_Ex_02.py
# Description: Interpolate a series of point features onto a
#    rectangular raster using Inverse Distance Weighting (IDW).
# Requirements: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inPointFeatures = "ca_ozone_pts.shp"
zField = "ozone"
outRaster = "C:/output/idwout01"
cellSize = 2000.0
power = 2
searchRadius = 150000

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

# Execute IDW
arcpy.Idw_3d(inPointFeatures, zField, outRaster, cellSize, 
             power, searchRadius)

Environnements

Rubriques connexes

Informations de licence

ArcView : Obligatoire 3D Analyst ou Spatial Analyst
ArcEditor : Obligatoire 3D Analyst ou Spatial Analyst
ArcInfo : Obligatoire 3D Analyst ou Spatial Analyst

7/10/2012