Disponible avec une licence Spatial Analyst.
Résumé
Calcule une statistique sur les points situés dans le voisinage de chaque cellule en sortie.
Pour en savoir plus sur le fonctionnement de l'outil Statistiques de points
Utilisation
Lorsque le champ spécifié est de type entier, les choix possibles de statistiques de superposition sont Moyenne, Majorité, Maximum, Médiane, Minimum, Minorité, Plage, Ecart type, Somme et Variété. Lorsque le champ est à virgule flottante, les seules statistiques autorisées sont Moyenne, Maximum, Minimum, Plage, Ecart type et Somme.
Pour les types de statistiques Majorité, Maximum, Médiane, Minimum, Minorité, Plage et Somme, le type de données en sortie du raster est le même que le type du champ en entrée. Pour les types de statistiques Moyenne et Ecart type, le raster en sortie sera toujours de type virgule flottante. Pour Variété, le raster en sortie est toujours de type entier.
Si aucun point n'est présent dans le voisinage d'une cellule raster, la statistique Variété lui attribue la valeur 0. Pour les autres statistiques, la valeur NoData est attribuée.
Pour plus d'informations sur les environnements de géotraitement qui s'appliquent à cet outil, reportez-vous à la rubrique Environnements d'analyse et Spatial Analyst.
Syntaxe
PointStatistics (in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})
Paramètre | Explication | Type de données |
in_point_features | Entités ponctuelles en entrée pour lesquelles les statistiques dans le voisinage de chaque cellule en sortie sont calculées. L'entrée peut être une classe d'entités points ou multi-points. | Feature Layer |
field | Champ pour lequel la statistique spécifiée sera calculée. Ce peut être un champ numérique quelconque des entités en entrée. Ce peut être le champ Shape si les entités en entrée contiennent une valeur z. | Field |
cell_size (Facultatif) | Taille de cellule du jeu de données raster en sortie. Il s'agit de la valeur contenue dans l'environnement, si spécifiquement définie. Si elle n'a pas été définie dans l'environnement, elle correspond à la valeur la plus faible entre la largeur et la hauteur de l'étendue du jeu de classes d'entités en entrée, dans la référence spatiale en sortie, divisée par 250. | Analysis Cell Size |
neighborhood (Facultatif) | La classe Neighborhood dicte la forme de la zone autour de chaque point en entrée utilisé pour le calcul des statistiques. Les différents types de voisinage disponibles sont NbrAnnulus, NbrCircle, NbrRectangle, et NbrWedge. Formes des voisinages :
Le voisinage par défaut est un voisinage NbrRectangle carré avec une largeur et une hauteur de 3 cellules. | Neighborhood |
statistics_type (Facultatif) | Type de statistique à calculer. Le calcul s'effectue sur les valeurs du champ spécifié de points en entrée dans le voisinage de chaque cellule de raster en sortie.
Les choix possibles pour le type de statistiques est fonction du type numérique du champ spécifié. | String |
Valeur renvoyée
Nom | Explication | Type de données |
out_raster | Raster de statistiques de points en sortie. | Raster |
Exemple de code
Exemple 1 d'utilisation de l'outil PointStatistics (fenêtre Python)
Cet exemple détermine une statistique (somme) sur les entités ponctuelles de fichier de formes en entrée qui se trouvent dans le voisinage circulaire de chaque cellule de raster en sortie.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPointStats = PointStatistics("ca_ozone_pts.shp", "OZONE", 500,
NbrCircle(10000, "MAP"), "SUM")
outPointStats.save("C:/sapyexamples/output/pointstatsout")
Exemple 2 d'utilisation de l'outil PointStatistics (script autonome)
Cet exemple détermine une statistique (moyenne) sur les entités ponctuelles de fichier de formes en entrée qui se trouvent dans le voisinage circulaire de chaque cellule de raster en sortie.
# Name: PointStatistics_Ex_02.py
# Description: Calculates a statistic on points over a specified
# neighborhood outputting a raster.
# 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"
field = "OZONE"
cellSize = 500
neighborhood = NbrCircle(6000, "MAP")
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute PointStatistics
outPointStatistics = PointStatistics(inPointFeatures, field, cellSize,
neighborhood, "MEAN")
# Save the output
outPointStatistics.save("C:/sapyexamples/output/pointstatout")
Environnements
Informations de licence
- ArcGIS Desktop Basic: Requiert Spatial Analyst
- ArcGIS Desktop Standard: Requiert Spatial Analyst
- ArcGIS Desktop Advanced: Requiert Spatial Analyst