Interpoler les points (Analyse raster)

Synthèse

Permet de prévoir des valeurs à des nouveaux emplacement en fonction de mesures provenant d'une collection de points. L'outil prélève des données ponctuelles avec des valeurs à chaque point et renvoie un raster de valeurs prévues.

Illustration

Utilisation

• Cet outil de portail d'analyse raster est disponible si vous êtes connecté à un portail ArcGIS Enterprise où ArcGIS Image Server est configuré pour l'Analyse raster. Si cet outil est exécuté, ArcGIS Pro est utilisé comme client et le traitement est effectué sur les serveurs fédérés avec ArcGIS Enterprise. L'outil de portail accepte les couches de votre portail en entrée et crée la sortie dans votre portail.

  La couche d'entités en entrée peut correspondre à une couche du portail, un URI ou une URL vers un service d'entités. Vous pouvez utiliser des couches et données d'entités locales en entrée dans cet outil de portail, mais il est recommandé d’utiliser les couches de votre portail en entrée.

• L'interpolation est effectuée en générant de nombreux modèles d'interpolation locaux qui sont combinés pour créer le raster en sortie final. Le nombre de points dans chaque modèle local peut être contrôlé à l'aide du paramètre Taille des modèles locaux.

• L’outil Krigeage bayésien empirique permet d’effectuer l’interpolation sous-jacente. Cet outil appartient à l’extension d’ArcGIS Geostatistical Analyst. De nombreux paramètres de l'outil sont exposés dans Interpoler les points, mais de nombreux paramètres sont contrôlés automatiquement par le paramètre Optimiser pour.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités ponctuelles en entrée	Entités ponctuelles en entrée à interpoler.	Feature Set
Champ à interpoler	Champ contenant les valeurs de données que vous souhaitez interpoler. Le champ doit être numérique.	Field
Nom en sortie	Nom du service raster en sortie. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.	String
Optimiser pour (Facultatif)	Choisissez entre la vitesse et la précision. Plus les prévisions sont précises et plus leur calcul est long. Vitesse—L'opération est optimisée pour une plus grande vitesse. Equilibre—Equilibre entre vitesse et précision. Il s’agit de l’option par défaut. Précision—L'opération est optimisée pour une plus grande précision.	String
Transformer les données en distribution normale (Facultatif)	Indiquez si vous souhaitez transformer les données pour une distribution normale avant d'effectuer l'analyse. Si les valeurs des données ne semblent pas distribuées normalement (en forme de cloche), il est conseillé d'effectuer une transformation. Activé - Une transformation vers la distribution normale est appliquée. Désactivé - Aucune transformation n'est appliquée. Il s’agit de l’option par défaut.	Boolean
Taille des modèles locaux (Facultatif)	Choisissez le nombre de points dans chacun des modèles locaux. Si la valeur est élevée, l'interpolation sera globale et stable, mais des effets à petite échelle risquent d'être ignorés. Avec de petites valeurs, l'interpolation sera plus locale et des effets à petite échelle ont plus de chances d'être capturés, mais l'interpolation risque d'être instable.	Long
Nombre de voisins (Facultatif)	Nombre de voisins à utiliser lors du calcul de la prévision dans une cellule particulière.	Long
Taille de cellule en sortie (Facultatif)	Définissez la taille de cellule et les unités du raster en sortie. Si un raster d'erreur de prévision est créé, il utilisera également cette taille de cellule. Les valeurs d'unité sont les suivantes : Kilometers (Kilomètres), Meters (Mètres), Statute Miles (Milles terrestres), International Feet (Pieds internationaux), US Survey Miles (Miles d’arpentage américains) et US Survey Feet (Pieds d’arpentage américains). Les unités par défaut sont les mètres.	Linear Unit
Erreur de prévision en sortie (Facultatif)	Choisissez si vous souhaitez générer un raster des erreurs standard des prévisions interpolées. Les erreurs standard sont utiles, car elles offrent des informations sur la fiabilité des valeurs prévues. Un principe simple est que la valeur réelle est comprise entre deux erreurs standard de la valeur prévue dans 95 pour cent des cas. Par exemple, supposons qu'un nouvel emplacement obtienne une valeur prévue de 50 avec une erreur standard de 5. Cela signifie que la meilleure estimation de la tâche est que la valeur réelle à cet emplacement est de 50, mais qu'elle peut raisonnablement descendre à 40 ou monter à 60. Pour calculer cette plage de valeurs raisonnables, multipliez l'erreur standard par 2, ajoutez cette valeur à la valeur prévue pour obtenir la limite supérieure de la plage et soustrayez-la de la valeur prévue pour obtenir la limite inférieure de la plage. Si un raster des erreurs standard des prévisions interpolées est demandé, il aura le même nom que Result layer name (Nom de la couche de résultats) mais avec Errors ajouté. Désactivé - Aucune erreur de prévision en sortie n'est générée. Il s’agit de l’option par défaut. Activé - Une erreur de prévision en sortie est générée.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Raster en sortie	Raster en sortie.	Raster Layer
Raster d'erreur en sortie	Le raster d’erreur de prévision en sortie.	Raster Layer

Python

arcpy.ra.InterpolatePoints(inputPointFeatures, interpolateField, outputName, {optimizeFor}, {transformData}, {sizeOfLocalModels}, {numberOfNeighbors}, {outputCellSize}, {outputPredictionError})

Nom	Explication	Type de données
inputPointFeatures	Entités ponctuelles en entrée à interpoler.	Feature Set
interpolateField	Champ contenant les valeurs de données que vous souhaitez interpoler. Le champ doit être numérique.	Field
outputName	Nom du service raster en sortie. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.	String
optimizeFor (Facultatif)	Choisissez entre la vitesse et la précision. Plus les prévisions sont précises et plus leur calcul est long. SPEED—L'opération est optimisée pour une plus grande vitesse. BALANCE—Equilibre entre vitesse et précision. Il s’agit de l’option par défaut. ACCURACY—L'opération est optimisée pour une plus grande précision.	String
transformData (Facultatif)	Indiquez si vous souhaitez transformer les données pour une distribution normale avant d'effectuer l'analyse. Si les valeurs des données ne semblent pas distribuées normalement (en forme de cloche), il est conseillé d'effectuer une transformation. NO_TRANSFORM—Aucune transformation n'est appliquée. Il s’agit de l’option par défaut. TRANSFORM—Une transformation vers la distribution normale est appliquée.	Boolean
sizeOfLocalModels (Facultatif)	Choisissez le nombre de points dans chacun des modèles locaux. Si la valeur est élevée, l'interpolation sera globale et stable, mais des effets à petite échelle risquent d'être ignorés. Avec de petites valeurs, l'interpolation sera plus locale et des effets à petite échelle ont plus de chances d'être capturés, mais l'interpolation risque d'être instable.	Long
numberOfNeighbors (Facultatif)	Nombre de voisins à utiliser lors du calcul de la prévision dans une cellule particulière.	Long
outputCellSize (Facultatif)	Définissez la taille de cellule et les unités du raster en sortie. Si un raster d'erreur de prévision est créé, il utilisera également cette taille de cellule. Les valeurs d'unité sont les suivantes : Kilometers, Meters, MilesInt, FeetInt, Miles et Feet. Les unités par défaut sont les mètres.	Linear Unit
outputPredictionError (Facultatif)	Choisissez si vous souhaitez générer un raster des erreurs standard des prévisions interpolées. Les erreurs standard sont utiles, car elles offrent des informations sur la fiabilité des valeurs prévues. Un principe simple est que la valeur réelle est comprise entre deux erreurs standard de la valeur prévue dans 95 pour cent des cas. Par exemple, supposons qu'un nouvel emplacement obtienne une valeur prévue de 50 avec une erreur standard de 5. Cela signifie que la meilleure estimation de la tâche est que la valeur réelle à cet emplacement est de 50, mais qu'elle peut raisonnablement descendre à 40 ou monter à 60. Pour calculer cette plage de valeurs raisonnables, multipliez l'erreur standard par 2, ajoutez cette valeur à la valeur prévue pour obtenir la limite supérieure de la plage et soustrayez-la de la valeur prévue pour obtenir la limite inférieure de la plage. Si un raster des erreurs standard des prévisions interpolées est demandé, il aura le même nom que Result layer name (Nom de la couche de résultats) mais avec Errors ajouté. OUTPUT_ERROR—Créez un raster d'erreur de prévision. NO_OUTPUT_ERROR—Ne créez pas de raster d'erreur de prévision. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

Nom	Explication	Type de données
outputRaster	Raster en sortie.	Raster Layer
outputErrorRaster	Le raster d’erreur de prévision en sortie.	Raster Layer

Exemple de code

Exemple 1 d'utilisation de l'outil InterpolatePoints (fenêtre Python)

Cet exemple interpole un service d'entités ponctuelles dans un raster de service d'imagerie.

import arcpy

arcpy.ra.InterpolatePoints('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
                           'myField', 'outImgServ', 'SPEED', 'False', 50, 8, '10000 Meters', 'NO_OUTPUT_ERROR')

Exemple 2 d'utilisation de l'outil InterpolatePoints (script autonome)

Cet exemple interpole un service d'entités ponctuelles dans un raster de service d'imagerie.

#-------------------------------------------------------------------------------
# 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.ra.InterpolatePoints(inPoints, inField, outRaster, optimizeFor, transform, 
                           subsetSize, numNeighbors, outCellSize, error)

Environnements

Étendue, Taille de cellule, Masque, Système de coordonnées en sortie, Pyramide, Raster de capture

Informations de licence

• Basic: Nécessite ArcGIS Image Server
• Standard: Nécessite ArcGIS Image Server
• Advanced: Nécessite ArcGIS Image Server