Résumé
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 du portail d’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise comportant un ArcGIS Image Server configuré pour Raster Analysis . Lorsque cet outil est appelé, ArcGIS Pro est utilisé comme client et le traitement est effectué dans les serveurs fédérés avec ArcGIS Enterprise. Cet outil du portail prend en charge les couches de votre portail en entrée et crée la sortie dans le portail.
La couche d’entités en entrée peut être une couche du portail, ou une URI ou une URL d’un service d’entités. Bien que vous ayez la possibilité d’utiliser des données d’entité et des couches locales en entrée dans cet outil du portail, 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 Geostatistical Analyst d'ArcGIS. 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.
Syntaxe
arcpy.ra.InterpolatePoints(inputPointFeatures, interpolateField, outputName, {optimizeFor}, {transformData}, {sizeOfLocalModels}, {numberOfNeighbors}, {outputCellSize}, {outputPredictionError})
Paramètre | 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.
| 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.
| 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 unités peuvent être les kilomètres, les mètres, les miles ou les pieds. 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 le nom de la couche de résultats mais avec Errors ajouté.
| Boolean |
Sortie dérivée
Nom | Explication | Type de données |
outputRaster | Raster en sortie. | Couche raster |
outputErrorRaster | Le raster d’erreur de prévision en sortie. | Couche raster |
Exemple de code
Cet exemple interpole un service d'entités ponctuelles dans un raster de service d'imagerie.
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')
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.InterpolatePoints_ra(inPoints, inField, outRaster, optimizeFor, transform,
subsetSize, numNeighbors, outCellSize, error)
Environnements
Informations de licence
- Basic: Requiert ArcGIS Image Server
- Standard: Requiert ArcGIS Image Server
- Advanced: Requiert ArcGIS Image Server
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?