Statistiques de points (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

  • Plusieurs formes de voisinage et types de statistique sont disponibles à la sélection. La sélection de statistiques disponibles est fonction du type du champ spécifié.

  • Pour les champs de type entier, les choix de type de statistique valides sont : majorité, maximum, moyenne, médiane, minimum, minorité, plage, écart type, somme et variété. Pour les champs de type réel simple, les statistiques valides sont : maximum, moyenne, minimum, plage, écart type et somme. La majorité, la minorité et la variété ne sont pas des statistiques disponibles.

  • Si le champ est de type entier, le raster en sortie est un entier pour les statistiques suivantes : majorité, maximum, médiane, minimum, minorité, plage, somme et variété. La sortie est un réel simple pour les statistiques de moyenne et d’écart type.

    Si le champ est de type réel simple, le raster en sortie est un réel simple pour tous les types de statistique disponibles.

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

  • Le paramètre Output cell size (Taille de cellule en sortie) peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster existant. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, elle est dérivée de l’environnement Cell Size (Taille de cellule), s’il est spécifié. Si la taille de cellule du paramètre ou la taille de cellule de l’environnement n’ont pas été spécifiées, mais que l’environnement Raster de capture a été défini, la taille de cellule du raster de capture est utilisée. Si aucun élément n’est spécifié, la taille de cellule résulte de la division par 250 de la largeur ou de la hauteur la plus petite (parmi les deux) de l’étendue spécifiée dans le système de coordonnées en sortie de l’environnement.

  • 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 la même que la référence spatiale en sortie. Si la référence spatiale du jeu de données est différente de la référence spatiale en sortie, elle sera projetée en fonction de la valeur Cell Size Projection Method (Méthode de projection de la taille de cellule) spécifié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 ponctuelles en entrée

Points en entrée à utiliser dans l’opération de voisinage.

Pour chaque cellule en sortie, tous les points en entrée qui se situent dans la forme de voisinage définie autour d’elle sont identifiés. Pour les points sélectionnés, les valeurs provenant de l’attribut spécifié sont obtenues, et une statistique est calculée.

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 ponctuelles 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)

Taille de cellule du raster en sortie à créer.

Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster existant. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de taille de cellule de l’environnement est utilisée si elle est spécifiée. Sinon, des règles supplémentaires sont utilisées pour la calculer à partir des autres entrées. Consultez la section Utilisation pour en savoir plus.

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 carré avec une largeur et une hauteur de trois cellules.

Voici les formes des types de voisinage pris en charge :

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

    Voisinage en forme d’anneau défini par un rayon intérieur et un rayon extérieur. La valeur minimale du rayon est égale à 1 cellule et le rayon extérieur doit être supérieur au rayon intérieur. Le rayon intérieur maximal est de 2 046 cellules et le rayon extérieur maximal est de 2 047 cellules. L’anneau par défaut possède un rayon intérieur égal à 1 cellule et un rayon extérieur de 3 cellules.

  • Cercle, Rayon, Unités

    Voisinage circulaire doté d'un rayon donné. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Le rayon par défaut est de 3 cellules.

  • Rectangle, Hauteur, Largeur, Unités

    Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale de la largeur ou de la hauteur est égale à 1 cellule et la valeur maximale est de 4 096 cellules. Le voisinage par défaut est un voisinage carré d’une largeur et d’une hauteur de 3 cellules.

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

    Voisinage en forme de secteur défini par un rayon, un angle de départ et un angle de fin. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. 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 3 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.

Le type de statistique par défaut est Moyenne.

Les choix possibles pour le type de statistique dépendent du type numérique du champ spécifié. Si le champ est de type entier, tous les types de statistique sont disponibles. Si le champ est de type virgule flottante, seules les statistiques de maximum, de moyenne, de minimum, de plage, d’écart type et de 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.
  • MinimumLa 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

Points en entrée à utiliser dans l’opération de voisinage.

Pour chaque cellule en sortie, tous les points en entrée qui se situent dans la forme de voisinage définie autour d’elle sont identifiés. Pour les points sélectionnés, les valeurs provenant de l’attribut spécifié sont obtenues, et une statistique est calculée.

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 ponctuelles 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)

Taille de cellule du raster en sortie à créer.

Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster existant. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de taille de cellule de l’environnement est utilisée si elle est spécifiée. Sinon, des règles supplémentaires sont utilisées pour la calculer à partir des autres entrées. Consultez la section Utilisation pour en savoir plus.

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 carré avec une largeur et une hauteur de trois cellules.

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 d’anneau défini par un rayon intérieur et un rayon extérieur. La valeur minimale du rayon est égale à 1 cellule et le rayon extérieur doit être supérieur au rayon intérieur. Le rayon intérieur maximal est de 2 046 cellules et le rayon extérieur maximal est de 2 047 cellules. L’anneau par défaut possède un rayon intérieur égal à 1 cellule et un rayon extérieur de 3 cellules.

  • NbrCircle({radius}, {units}

    Voisinage circulaire doté d'un rayon donné. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Le rayon par défaut est de 3 cellules.

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

    Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale de la largeur ou de la hauteur est égale à 1 cellule et la valeur maximale est de 4 096 cellules. Le voisinage par défaut est un voisinage carré d’une largeur et d’une hauteur de 3 cellules.

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

    Voisinage en forme de secteur défini par un rayon, un angle de départ et un angle de fin. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. 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 3 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é.

Le type de statistique par défaut est MEAN.

Les choix possibles pour le type de statistique dépendent du type numérique du champ spécifié. Si le champ est de type entier, tous les types de statistique sont disponibles. Si le champ est de type virgule flottante, seules les statistiques de maximum, de moyenne, de minimum, de plage, d’écart type et de 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")

Rubriques connexes