Créer un raster normal (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Crée un raster de valeurs aléatoires avec une répartition normale (Gauss) dans l'étendue et la taille de cellule de la fenêtre d'analyse.

Illustration

Illustration de l’outil Créer un raster normal
OutRas = CreateNormalRaster(1, 0 0 4 4)
Remarque : ce résultat est significatif. Les valeurs réelles seront différentes chaque fois que l'outil est exécuté.

Utilisation

  • L'outil Créer un raster normal génère des valeurs pour chaque cellule dans le raster en sortie.

  • Le raster en sortie généré par cet outil est toujours à virgule flottante.

  • Les valeurs de cellule auront jusqu'à 7 chiffres de précision après le séparateur décimal.

  • Les valeurs en sortie ont une moyenne de 0 et un écart type de 1. Si vous souhaitez employer un écart type différent, multipliez le raster en sortie par cette valeur. Si vous souhaitez obtenir une moyenne différente, ajoutez cette valeur au raster. Vous pouvez par exemple créer un raster dans lequel les valeurs sont associées à une moyenne de 39 et à un écart type standard de 2,5. Multipliez le résultat obtenu via Créer un raster normal par 2,5, puis rajoutez 39.

    • L'outil Algèbre spatiale vous permet d'effectuer les opérations suivantes :

      import arcpy
      from arcpy import env
      from arcpy.sa import *
      env.workspace = "C:/data"
      outNorm = CreateNormalRaster(1, Extent(0, 0, 100, 100)) * 2.5 + 39
      outNorm.save("C:/output/norm2")

  • Le générateur de nombres aléatoires démarre automatiquement avec la valeur actuelle de l'horloge système (en secondes depuis le 1er janvier 1970). Lorsque vous reparamétrez l’outil Créer un raster aléatoire, l’outil Créer un raster normal est également reparamétré.

  • 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 Cell Size (Taille de cellule) si celui-ci a été spécifié. Si la taille de cellule du paramètre ou la taille de cellule de l’environnement n’a pas été spécifiée, mais que l’environnement Snap Raster (Raster de capture) a été défini, c’est la taille de cellule du raster de capture qui est utilisée. Si rien n’est spécifié, la taille de cellule prend la valeur 1.

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

  • Puisque l’outil ne nécessite aucune entrée, la référence spatiale en sortie est dérivée des autres paramètres selon un ordre défini. C’est tout d’abord, l’environnement Output Coordinate System (Système de coordonnées en sortie) qui est utilisé, si celui-ci est spécifié, suivi du système de coordonnées de la vue cartographique. Si aucune de ces conditions n’est remplie, la référence spatiale en sortie sera définie sur Inconnue.

  • L’étendue en sortie par défaut est calculée d’après la taille de cellule pour créer un raster de 250 lignes et 250 colonnes. Ainsi, pour une taille de cellule par défaut de 1, Output extent (Étendue en sortie) a pour valeurs (0, 0, 250, 250). La valeur d’étendue est ajustée en fonction des environnements Cell Size (Taille de cellule), Snap Raster (Raster de capture), et Output Coordinate System (Système de coordonnées en sortie), si ceux-ci sont spécifiés.

  • 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
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
Etendue en sortie
(Facultatif)

Etendue du jeu de données raster en sortie.

L'étendue est la valeur définie spécifiquement dans l'environnement, le cas échéant. Si elle n'est pas définie spécifiquement, la valeur par défaut est 0, 0, 250, 250.

Envelope; Extent

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Le raster de valeurs en sortie qui sont normalement réparties avec une moyenne de 0 et un écart type de 1.

Raster

CreateNormalRaster({cell_size}, {extent})
NomExplicationType de données
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
extent
(Facultatif)

Etendue du jeu de données raster en sortie.

Le Extent est une classe Python.

Dans cet outil, l’étendue prend la forme Extent(XMin, YMin, XMax, YMax)

  • XMin et YMin désignent les coordonnées inférieures gauches de l’étendue, et XMax et YMax ses coordonnées supérieures droites.

Les coordonnées sont spécifiées dans les mêmes unités de carte que le paramètre d'environnement Système de coordonnées en sortie.

L'étendue est la valeur définie spécifiquement dans l'environnement, le cas échéant. Si elle n'est pas définie spécifiquement, la valeur par défaut est 0, 0, 250, 250.

Envelope; Extent

Valeur renvoyée

NomExplicationType de données
out_raster

Le raster de valeurs en sortie qui sont normalement réparties avec une moyenne de 0 et un écart type de 1.

Raster

Exemple de code

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

Cet exemple indique comment créer un raster en sortie de valeurs distribuées normalement, conformément à la taille de cellule et à l'étendue.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNormalRaster = CreateNormalRaster(2, Extent(0, 0, 150, 150))
outNormalRaster.save("C:/sapyexamples/output/outnormal")
Deuxième exemple d'utilisation de l'outil CreateNormalRaster (script autonome)

Cet exemple indique comment créer un raster en sortie de valeurs distribuées normalement, conformément à la taille de cellule et à l'étendue.

# Name: CreateNormalRaster_Ex_02.py
# Description: Creates a raster of random values from a normal distribution
# 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
cellSize = 2
extent = Extent(0, 0, 150, 150)

# Execute CreateNormalRaster
outNormalRaster = CreateNormalRaster(cellSize, extent) 

# Save the output 
outNormalRaster.save("C:/sapyexamples/output/outnormraster")

Rubriques connexes