Densité de points (Spatial Analyst)

Récapitulatif

Calcule une grandeur par unité de surface à partir d’entités ponctuelles qui se trouvent dans un voisinage donné de chaque cellule.

Pour en savoir plus sur le fonctionnement de l'outil Densité de points

Utilisation

Syntaxe

PointDensity (in_point_features, population_field, {cell_size}, {neighborhood}, {area_unit_scale_factor})
ParamètreExplicationType de données
in_point_features

Entités ponctuelles en entrée pour lesquelles la densité est calculée.

Feature Layer
population_field

Champ permettant d'identifier les valeurs de population pour chaque point. Le champ Population représente le total ou la quantité à utiliser dans le calcul d'une surface continue.

Le champ Population peut contenir des valeurs entières ou à virgule flottante.

Les options et les comportements par défaut pour le champ sont répertoriés ci-dessous.

  • Utilisez Aucun si aucun attribut ni aucune valeur spéciale ne sont utilisés et si chaque entité est comptée une seule fois.

  • Vous pouvez utiliser le champ Forme si les entités points en entrée contiennent des valeurs z.

  • Sinon, le champ par défaut est POPULATION. Les conditions suivantes peuvent également s'appliquer.

    • S'il n'existe aucun champ POPULATION mais qu'un champ POPULATIONxxxx est disponible, ce dernier est utilisé par défaut. La valeur "xxxx" peut représenter n'importe quel caractère valide, tel que POPULATION6, POPULATION1974 ou POPULATIONROADTYPE.
    • S'il n'existe aucun champ POPULATION ou POPULATIONxxxx mais qu'un champ POP est disponible, ce dernier est utilisé par défaut.
    • S'il n'existe aucun champ POPULATION, POPULATIONxxxx ou POP, mais qu'un champ POPxxxx est disponible, ce dernier est utilisé par défaut.
    • S'il n'existe aucun champ POPULATION, POPULATIONxxxx, POP ou POPxxxx, la valeur Aucun est utilisée par défaut.
Field
cell_size
(Facultatif)

Taille de cellule pour le jeu de données raster en sortie.

Il s'agit de la valeur contenue dans l'environnement, si spécifiquement définie. Si l'environnement n'est pas défini, la taille de cellule est la valeur la plus faible entre la largeur et la hauteur de l'étendue en sortie dans la référence spatiale en sortie, divisée par 250.

Analysis Cell Size
neighborhood
(Facultatif)

Dicte la forme de la zone autour de chaque cellule utilisée pour calculer la valeur de la densité.

Il s'agit d'une classe Voisinage.

Il existe quatre types de classes de voisinage : NbrAnnulus, NbrCircle, NbrRectangle et NbrWedge.

Les formes et descriptions de ces classes sont :

  • NbrAnnulus ({inner_radius}, {outer_radius}, {CELL | MAP})

    Voisinage en forme de tore (anneau) défini par un rayon intérieur et un rayon extérieur.

  • NbrCircle ({radius}, {CELL | MAP})

    Voisinage circulaire doté d'un rayon donné.

  • NbrRectangle ({width}, {height}, {CELL | MAP})

    Voisinage rectangulaire doté d'une hauteur et d'une largeur données.

  • NbrWedge ({radius}, {start_angle}, {end_angle}, {CELL | MAP})

    Voisinage en forme de secteur (camembert). Un secteur est spécifié par un angle de départ, un angle d'arrivée et un rayon. Il s'étend dans le sens anti-horaire, de l'angle de départ vers l'angle d'arrivée. Les angles sont exprimés en degrés arithmétiques (dans le sens anti-horaire à partir de l'axe positif des x). Vous pouvez utiliser des angles négatifs.

  • {CELL | MAP}

    Définit les unités comme le nombre de cellules ou comme une valeur dans les unités de carte.

La valeur par défaut est NbrCircle, radius étant la largeur ou la hauteur la plus faible de l'étendue en sortie dans la référence spatiale en sortie, divisée par 30.

Neighborhood
area_unit_scale_factor
(Facultatif)

Unités de surface souhaitées pour les valeurs de densité en sortie.

Une unité par défaut est sélectionnée en fonction de l'unité linéaire de la projection de la référence spatiale en sortie. Vous pouvez la remplacer par l'unité appropriée si vous souhaitez convertir la densité en sortie. Les valeurs de densité de lignes convertissent les unités de longueur et de surface.

Par exemple, si vos unités en entrée sont des mètres, les unités de densité de la surface en sortie par défaut seront des kilomètres carrés pour les entités ponctuelles ou des kilomètres par kilomètre carré pour les entités polylignes.

Les unités de densité par défaut basées sur les unités d'entité en entrée sont les suivantes :

  • SQUARE_MAP_UNITS Si les unités sont inconnues ou correspondent à des points ou à des degrés décimaux.
  • SQUARE_MILES Pour les pieds, yards, miles ou milles nautiques.
  • SQUARE_KILOMETERS Pour les mètres ou les kilomètres.
  • SQUARE_INCHES Pour les pouces.
  • SQUARE_CENTIMETERS Pour les centimètres.
  • SQUARE_MILLIMETERS Pour les millimètres.
String

Valeur renvoyée

NomExplicationType de données
out_raster

Raster de densité de points en sortie.

Il s'agit toujours d'un raster à virgule flottante.

Raster

Exemple de code

Exemple 1 d'utilisation de l'outil PointDensity (fenêtre Python)

Cet exemple calcule un raster de densité à partir d'un fichier de formes ponctuelles.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
pdensOut = PointDensity("rec_sites.shp", "NONE", 60, NbrCircle(2500, "MAP"))
pdensOut.save("C:/sapyexamples/output/pointdensity")
Exemple 2 d'utilisation de l'outil PointDensity (script autonome)

Cet exemple calcule un raster de densité à partir d'un fichier de formes ponctuelles.

# Name: PointDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from point 
#    features that fall within a neighborhood around each cell.
# 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
inFeatures = "rec_sites.shp"
populationField = "NONE"
cellSize = 60

# Create the Neighborhood Object
radius = 2500
myNbrCirc = NbrCircle(radius, "MAP")

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute PointDensity
outPdens = PointDensity(inFeatures, populationField, cellSize, 
                        myNbrCirc, "SQUARE_KILOMETERS")

# Save the output 
outPdens.save("C:/sapyexamples/output/outpdens")

Environnements

Rubriques connexes

Informations de licence

ArcView : Obligatoire Spatial Analyst
ArcEditor : Obligatoire Spatial Analyst
ArcInfo : Obligatoire Spatial Analyst

7/10/2012