Spline avec interruptions (Spatial Analyst)
Récapitulatif
Permet d'interpoler une surface raster, à l'aide d'interruptions, à partir de points à l'aide d'une méthode de spline de courbure minimum. Les interruptions sont entrées en tant qu'entités polygones ou polylignes.
Pour en savoir plus sur le fonctionnement de l'outil Spline avec interruptions
Utilisation
-
Cet outil nécessite l'installation de l'environnement d'exécution Java Version 6, ou ultérieure. L'environnement d'exécution Java peut être téléchargé gratuitement à cette adresse : http://www.java.com/en/download.
-
La surface lissée résultante est contrainte par les entités interruptions en entrée.
-
Certains jeux de données en entrée peuvent avoir plusieurs points avec les mêmes coordonnées x,y. Si les valeurs des points à l'emplacement commun sont les mêmes, elles sont considérées comme étant en double et n'ont aucune incidence sur la sortie. Si les valeurs sont différentes, elles sont considérées comme étant des points coïncidents.
Les différents outils d'interpolation peuvent gérer cette condition de données différemment. Par exemple dans certains cas, le premier point coïncident détecté est utilisé pour le calcul, tandis que dans d'autres cas c'est le dernier point détecté qui est utilisé. Cela peut entraîner des valeurs inattendues pour les emplacements du raster en sortie. La solution consiste à préparer vos données en supprimant ces points coïncidents. L'outil Collect Events de la boîte à outils Outils de statistiques spatiales sert à identifier tous points coïncidents de vos données.
Pour l'outil Spline avec interruptions, par défaut la moyenne des valeurs de chaque ensemble de points coïncidents est effectuée.
-
Si une taille de cellule nulle est entrée, la taille de cellule utilisée sera la largeur ou la hauteur la plus faible de l'étendue des entités ponctuelles en entrée, dans la référence spatiale en entrée, divisée par 250.
-
Les entités interruptions sont rastérisées et le centre de la cellule permet de décider si la cellule tombe dans un polygone ou si elle devient une interruption pour les entités polylignes.
Remarque :Si l'outil ne peut pas s'exécuter et qu'un message d'erreur indique qu'une version plus récente de Java doit être installée, si plusieurs versions de Java sont effectivement installées, vous devez mettre à jour la variable d'environnement PATH.
Syntaxe
| Paramètre | Explication | Type de données |
Input_point_features in_point_features |
Les entités points en entrée contenant les valeurs z à interpoler dans un raster de surface. | Feature Layer |
Z_value_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 |
Input_barrier_features (Facultatif) |
Entités interruptions en entrée facultatives pour contraindre l'interpolation. | Feature Layer |
Output_cell_size cell_size (Facultatif) |
Taille des cellules qui sera utilisée pour la création du raster en sortie. Si une valeur nulle est entrée, la taille de cellule utilisée sera la largeur ou la hauteur la plus faible 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 |
Smoothing_Factor (Facultatif) | Paramètre qui influence le lissage de la surface en sortie. Aucun lissage n'est appliqué lorsque la valeur est nulle et la quantité maximale du lissage est appliquée lorsque le facteur est égal à 1. La valeur par défaut est 0,0. | Double |
Valeur renvoyée
| Nom | Explication | Type de données |
| Output_raster |
Raster de surface interpolé en sortie. | Raster |
Exemple de code
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"
outSplineBarriers = SplineWithBarriers("ca_ozone_pts.shp", "ozone",
"ca_ozone_barrier.shp", 2000)
outSplineBarriers.save("C:/sapyexamples/output/splinebarrierout.tif")
Cet exemple entre un fichier de formes ponctuelles et interpole la surface en sortie en tant que raster Grid.
# Name: SplineWithBarriers_Ex_02.py
# Description: Interpolate a series of point features onto a
# rectangular raster, using optional barriers, using a
# minimum curvature spline technique.
# Requirements: Spatial Analyst Extension and Java Runtime
# Environment Version 5.0, or higher.
# 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"
inBarrierFeature = "ca_ozone_barrier.shp"
cellSize = 2000.0
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Spline with Barriers
outSplineBarriers = SplineWithBarriers(inPointFeatures,
zField, inBarrierFeature, cellSize)
# Save the output
outSplineBarriers.save("C:/sapyexamples/output/splinebout02")