Statistiques de points (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

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

  • La taille de cellule en sortie (champ Output cell size) peut être définie par une valeur numérique ou obtenue à partir d’un jeu de données raster. Si la taille de cellule n’a pas été spécifiée de manière explicite comme étant la valeur du paramètre, elle est dérivée de l’environnement de taille de cellule si celui-ci a été spécifié. Lorsque ni le paramètre ni l’environnement de taille de cellule n’a été spécifié, mais que l’environnement Snap Raster (Raster de capture) est défini, c’est la taille de cellule du raster de capture qui est utilisée. Si aucun élément n’est spécifié, la taille de cellule est calculée d’après la largeur ou la hauteur la plus petite (selon celle qui est la plus petite des deux) de l’étendue spécifiée dans le système de coordonnées en sortie (option Output Coordinate System) de l’environnement, divisée par 250.

  • Si la taille de cellule est spécifiée à l’aide d’une valeur numérique, l’outil l’utilise directement pour le raster en sortie.

    Si la taille de cellule est spécifiée à l’aide d’un jeu de données raster, le paramètre affiche le chemin du jeu de données raster au lieu de la valeur de la taille de cellule. La taille de cellule de ce jeu de données raster sera utilisée directement dans l’analyse, à condition que la référence spatiale du jeu de données soit identique à la référence spatiale en sortie. Si la référence spatiale du jeu de données diffère de la référence spatiale en sortie, elle sera projetée d’après la valeur du champ Cell Size Projection Method (Méthode de projection de la taille de cellule).

  • 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.

Paramètres

ÉtiquetteExplicationType de données
Entités points en entrée

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
Champ

Champ pour lequel la statistique spécifiée est calculée. Ce peut être un champ numérique quelconque des entités en entrée.

Il peut s’agir du champ Shape si les entités en entrée contiennent des valeurs z.

Field
Taille de cellule en sortie
(Facultatif)

La taille de cellule du jeu de données raster en sortie sera créée.

Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de la taille de cellule de l’environnement sera utilisée dans la mesure où elle est définie. Dans le cas contraire, le calcul fera appel à des règles supplémentaires pour la déterminer à partir d’autres données en entrée. Pour en savoir plus, consultez la section relative à l’utilisation.

Analysis Cell Size
Quartier
(Facultatif)

Zone autour de chaque cellule de traitement dans laquelle les points en entrée trouvés sont utilisés dans le calcul des statistiques. Vous avez le choix entre plusieurs types de voisinage prédéfinis.

Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un rectangle.

Voici les formes des types de voisinage pris en charge :

  • Anneau, Rayon intérieur, Rayon extérieur, Unités

    Voisinage en forme de tore (anneau) défini par un rayon intérieur et un rayon extérieur. L'anneau par défaut a un rayon intérieur d'une cellule et un rayon extérieur de trois cellules.

  • Cercle, Rayon, Unités

    Voisinage circulaire doté d'un rayon donné. Le rayon par défaut est de trois cellules.

  • Rectangle, Hauteur, Largeur, Unités

    Voisinage rectangulaire défini par la hauteur et la largeur. La valeur par défaut est un carré avec une hauteur et une largeur de trois cellules.

  • Secteur, Rayon, Angle de départ, Angle de fin, Unités

    Voisinage en forme de secteur défini par un rayon, l'angle de début et l'angle de fin. Il s'étend dans le sens anti-horaire, de l'angle de départ vers l'angle d'arrivée. Les angles sont précisés en degrés, 0 ou 360 représentant l'Est. Vous pouvez utiliser des angles négatifs. Le secteur par défaut s'étend de 0 à 90 degrés, avec un rayon de trois cellules.

Les unités de distance des paramètres peuvent être spécifiées en unités de cellule ou en unités de carte. Les unités de cellule sont privilégiées par défaut.

Neighborhood
Type de statistique
(Facultatif)

Spécifie le type de statistique à calculer.

Le calcul s’effectue sur les valeurs du champ spécifié de points en entrée qui se trouvent dans le voisinage spécifié 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é. Si le champ est entier, tous les types de statistiques sont disponibles. Si le champ est à virgule flottante, seules les statistiques Moyenne, Maximum, Minimum, Plage, Écart type et Somme sont disponibles.

  • MoyenneLa moyenne des valeurs de champ dans chaque voisinage est calculée.
  • MajoritéLa valeur de champ la plus récurrente dans chaque voisinage est identifiée. En cas d'égalité, la valeur la plus faible est utilisée.
  • MaximumLa valeur de champ la plus grande dans chaque voisinage est identifiée.
  • MédianeLa valeur de champ médiane dans chaque voisinage est calculée. Si le nombre de points est impair dans le voisinage, le résultat est la valeur la plus faible des deux valeurs moyennes.
  • MinimalLa plus petite valeur de champ dans chaque voisinage est identifiée.
  • MinoritéLa valeur de champ la moins récurrente dans chaque voisinage est identifiée. En cas d'égalité, la valeur la plus faible est utilisée.
  • PlageLa plage (différence entre la valeur la plus élevée et la valeur la plus faible) des valeurs de champ dans chaque voisinage est calculée.
  • Écart typeL’écart type des valeurs de champ dans chaque voisinage est calculé.
  • SommeLa somme des valeurs de champ dans le voisinage est calculée.
  • VariétéLe nombre de valeurs uniques du champ dans chaque voisinage est calculé.
String

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster de statistiques de points en sortie.

Raster

PointStatistics(in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})
NomExplicationType 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 est calculée. Ce peut être un champ numérique quelconque des entités en entrée.

Il peut s’agir du champ Shape si les entités en entrée contiennent des valeurs z.

Field
cell_size
(Facultatif)

La taille de cellule du jeu de données raster en sortie sera créée.

Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de la taille de cellule de l’environnement sera utilisée dans la mesure où elle est définie. Dans le cas contraire, le calcul fera appel à des règles supplémentaires pour la déterminer à partir d’autres données en entrée. Pour en savoir plus, consultez la section relative à l’utilisation.

Analysis Cell Size
neighborhood
(Facultatif)

Zone autour de chaque cellule de traitement dans laquelle les points en entrée trouvés sont utilisés dans le calcul des statistiques. Vous avez le choix entre plusieurs types de voisinage prédéfinis.

Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un rectangle.

La forme des voisinages autour de chaque point en entrée est définie par la classe Neighborhood. Les types de voisinage pris en charge sont NbrAnnulus, NbrCircle, NbrRectangle, et NbrWedge.

Voici les formes des types de voisinage pris en charge :

  • NbrAnnulus({innerRadius}, {outerRadius}, {units})

    Voisinage en forme de tore (anneau) défini par un rayon intérieur et un rayon extérieur. L'anneau par défaut a un rayon intérieur d'une cellule et un rayon extérieur de trois cellules.

  • NbrCircle({radius}, {units}

    Voisinage circulaire doté d'un rayon donné. Le rayon par défaut est de trois cellules.

  • NbrRectangle({width}, {height}, {units})

    Voisinage rectangulaire défini par la hauteur et la largeur. La valeur par défaut est un carré avec une hauteur et une largeur de trois cellules.

  • NbrWedge({radius}, {startAngle}, {endAngle}, {units})

    Voisinage en forme de secteur défini par un rayon, l'angle de début et l'angle de fin. Il s'étend dans le sens anti-horaire, de l'angle de départ vers l'angle d'arrivée. Les angles sont précisés en degrés, 0 ou 360 représentant l'Est. Vous pouvez utiliser des angles négatifs. Le secteur par défaut s'étend de 0 à 90 degrés, avec un rayon de trois cellules.

Les unités de distance des paramètres peuvent être spécifiées en unités CELL ou en unités MAP. Les unités de cellule sont privilégiées par défaut.

Le type de voisinage par défaut est NbrRectangle, avec une hauteur et une largeur de trois cellules.

Neighborhood
statistics_type
(Facultatif)

Spécifie le type de statistique à calculer.

Le calcul s’effectue sur les valeurs du champ spécifié de points en entrée qui se trouvent dans le voisinage spécifié de chaque cellule de raster en sortie.

  • MEANLa moyenne des valeurs de champ dans chaque voisinage est calculée.
  • MAJORITYLa valeur de champ la plus récurrente dans chaque voisinage est identifiée. En cas d'égalité, la valeur la plus faible est utilisée.
  • MAXIMUMLa valeur de champ la plus grande dans chaque voisinage est identifiée.
  • MEDIANLa valeur de champ médiane dans chaque voisinage est calculée. Si le nombre de points est impair dans le voisinage, le résultat est la valeur la plus faible des deux valeurs moyennes.
  • MINIMUMLa plus petite valeur de champ dans chaque voisinage est identifiée.
  • MINORITYLa valeur de champ la moins récurrente dans chaque voisinage est identifiée. En cas d'égalité, la valeur la plus faible est utilisée.
  • RANGELa plage (différence entre la valeur la plus élevée et la valeur la plus faible) des valeurs de champ dans chaque voisinage est calculée.
  • STDL’écart type des valeurs de champ dans chaque voisinage est calculé.
  • SUMLa somme des valeurs de champ dans le voisinage est calculée.
  • VARIETYLe nombre de valeurs uniques du champ dans chaque voisinage est calculé.

Les choix possibles pour le type de statistiques est fonction du type numérique du champ spécifié. Si le champ est entier, tous les types de statistiques sont disponibles. Si le champ est à virgule flottante, seules les statistiques Moyenne, Maximum, Minimum, Plage, Écart type et Somme sont disponibles.

String

Valeur renvoyée

NomExplicationType 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")

# Execute PointStatistics
outPointStatistics = PointStatistics(inPointFeatures, field, cellSize,
                                     neighborhood, "MEAN")

# Save the output 
outPointStatistics.save("C:/sapyexamples/output/pointstatout")

Informations de licence

  • Basic: Nécessite Spatial Analyst
  • Standard: Nécessite Spatial Analyst
  • Advanced: Nécessite Spatial Analyst

Rubriques connexes