Statistiques de lignes (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Calcule des statistiques sur les attributs des lignes qui se trouvent dans un voisinage circulaire autour de chaque cellule en sortie.

Pour en savoir plus sur le fonctionnement de l'outil Statistiques de lignes

Utilisation

  • Vous avez le choix entre plusieurs types de statistique. 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, variété et longueur. Pour les champs de type réel simple, les statistiques valides sont : maximum, moyenne, minimum, plage et longueur. 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 et variété. Le raster en sortie est un réel simple pour les statistiques de moyenne et longueur.

    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.

  • Seule la partie d’une ligne qui se situe dans le voisinage est prise en compte pour les statistiques de majorité, moyenne, médiane, minorité et longueur. Pour les statistiques de maximum, minimum, plage et variété, il est possible d’utiliser entièrement ou partiellement la ligne.

  • Les statistiques de majorité, moyenne, médiane et minorité sont pondérées en fonction de la longueur des lignes. Par exemple, si une ligne est deux fois plus longue qu'une autre, sa valeur est considérée comme survenant deux fois plus souvent.

  • Si aucune ligne ne se situe dans le voisinage d’une cellule raster, les statistiques de variété et longueur attribuent la valeur zéro. 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’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 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 sélectionnée du champ Méthode de projection de la taille de cellule.

  • 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 polylignes en entrée

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

Pour chaque cellule en sortie, une statistique est calculée pour toutes les parties des entités polylignes en entrée qui se situent dans un voisinage circulaire de cette cellule.

La taille du voisinage circulaire est définie par le rayon de recherche.

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 linéaires en entrée.

Lorsque le paramètre Type de statistique est défini sur Longueur, le paramètre Champ peut être défini sur NONE.

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
Rayon de recherche
(Facultatif)

Rayon de recherche qui est utilisé pour le calcul des statistiques correspondantes, en unités de carte.

Le rayon par défaut est cinq fois supérieur à la taille de cellule en sortie.

Double
Type de statistique
(Facultatif)

Spécifie le type de statistique à calculer.

Les statistiques sont calculées à partir de la valeur du champ spécifié pour toutes les lignes du voisinage.

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, les types de statistique possibles sont la majorité, le maximum, la moyenne, la médiane, le minimum, la minorité, la plage, la variété et la longueur. Si le champ est de type virgule flottante, la moyenne, le maximum, le minimum, la plage et la longueur sont les seuls types de statistique disponibles.

  • MoyenneLa valeur de champ moyenne pour chaque voisinage, pondérée par la longueur, est calculée.La formule de calcul est la suivante :
    • Moyenne = (somme de (longueur * valeur du champ)) / (somme des longueurs)
    Seule la partie de la ligne qui se situe dans le voisinage est utilisée.
  • MajoritéLa valeur ayant la plus grande longueur de ligne dans le voisinage est identifiée.
  • MaximumLa plus grande valeur dans le voisinage est identifiée.
  • MédianeLa valeur médiane, pondérée par la longueur, est calculée.En théorie, tous les segments de ligne situés dans le voisinage sont triés par valeur et mis bout à bout pour former une ligne droite. La valeur du segment au centre de la ligne droite constitue la médiane.
  • MinimumLa plus petite valeur dans chaque voisinage est identifiée.
  • MinoritéLa valeur ayant la plus petite longueur de ligne dans le voisinage est identifiée.
  • PlageLa plage de valeurs (maximum - minimum) est calculée.
  • VariétéLe nombre de valeurs uniques est calculé.
  • LongueurLa longueur de ligne totale dans le voisinage est calculée. Si la valeur du champ est différente de 1, les longueurs sont multipliées par la valeur de l’élément avant d’être additionnées. Cette option peut être utilisée lorsque le paramètre de champ est défini sur Aucun.
String

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster de statistiques de lignes en sortie.

Raster

LineStatistics(in_polyline_features, field, {cell_size}, {search_radius}, {statistics_type})
NomExplicationType de données
in_polyline_features

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

Pour chaque cellule en sortie, une statistique est calculée pour toutes les parties des entités polylignes en entrée qui se situent dans un voisinage circulaire de cette cellule.

La taille du voisinage circulaire est définie par le rayon de recherche.

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 linéaires en entrée.

Lorsque statistics_type est défini sur Length, le paramètre field peut être défini sur NONE.

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
search_radius
(Facultatif)

Rayon de recherche qui est utilisé pour le calcul des statistiques correspondantes, en unités de carte.

Le rayon par défaut est cinq fois supérieur à la taille de cellule en sortie.

Double
statistics_type
(Facultatif)

Spécifie le type de statistique à calculer.

Les statistiques sont calculées à partir de la valeur du champ spécifié pour toutes les lignes du voisinage.

  • MEANLa valeur de champ moyenne pour chaque voisinage, pondérée par la longueur, est calculée.La formule de calcul est la suivante :
    • Moyenne = (somme de (longueur * valeur du champ)) / (somme des longueurs)
    Seule la partie de la ligne qui se situe dans le voisinage est utilisée.
  • MAJORITYLa valeur ayant la plus grande longueur de ligne dans le voisinage est identifiée.
  • MAXIMUMLa plus grande valeur dans le voisinage est identifiée.
  • MEDIANLa valeur médiane, pondérée par la longueur, est calculée.En théorie, tous les segments de ligne situés dans le voisinage sont triés par valeur et mis bout à bout pour former une ligne droite. La valeur du segment au centre de la ligne droite constitue la médiane.
  • MINIMUMLa plus petite valeur dans chaque voisinage est identifiée.
  • MINORITYLa valeur ayant la plus petite longueur de ligne dans le voisinage est identifiée.
  • RANGELa plage de valeurs (maximum - minimum) est calculée.
  • VARIETYLe nombre de valeurs uniques est calculé.
  • LENGTHLa longueur de ligne totale dans le voisinage est calculée. Si la valeur du champ est différente de 1, les longueurs sont multipliées par la valeur de l’élément avant d’être additionnées. Cette option peut être utilisée lorsque le paramètre de champ est défini sur Aucun.

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, les types de statistique possibles sont la majorité, le maximum, la moyenne, la médiane, le minimum, la minorité, la plage, la variété et la longueur. Si le champ est de type virgule flottante, la moyenne, le maximum, le minimum, la plage et la longueur sont les seuls types de statistique disponibles.

String

Valeur renvoyée

NomExplicationType de données
out_raster

Raster de statistiques de lignes en sortie.

Raster

Exemple de code

1er exemple d'utilisation de l'outil LineStatistics (fenêtre Python)

Cet exemple décrit le calcul de la longueur moyenne des segments de ligne dans un certain rayon de chaque cellule du raster en entrée.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
lineStatOut = LineStatistics("streams", "LENGTH", 50, 500, "MEAN")
lineStatOut.save("C:/sapyexamples/output/linestatout")
2e exemple d'utilisation de l'outil LineStatistics (script autonome)

Cet exemple décrit le calcul de la longueur moyenne des segments de ligne dans un certain rayon de chaque cellule du raster en entrée.

# Name: LineStatistics_Ex_02.py
# Description: 
# 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
inLines = "streams.shp"
field = "LENGTH"
cellSize = 50
searchRadius = 500

# Execute LineStatistics
lineStatOut = LineStatistics(inLines, field, cellSize, searchRadius,
                              "MEAN")

# Save the output 
lineStatOut.save("C:/sapyexamples/output/linestatisout")

Informations de licence

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

Rubriques connexes