Capacité de stockage (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Crée un tableau et un diagramme des altitudes et des capacités de stockage correspondantes pour un raster de surface en entrée. Cet outil calcule la surface et le volume total de la région sous-jacente au niveau de plusieurs incréments d’altitude.

Utilisation

  • L’outil crée une table de superficie et des volumes totaux à une série d’incréments d’altitude. La table contient un enregistrement pour chaque incrément d’altitude pour chaque zone.

    La table en sortie contient la structure suivante :

    • Les champs sont ELEVATION, AREA et VOLUME.
    • Les champs de surface et de volume contiennent les calculs de la capacité de stockage à chaque incrément d’altitude.
    • Les champs de surface et de volume sont calculés en unités z. Le champ de surface est calculé dans les unités x,y du raster de surface en entrée.
    • Si aucune zone n’est spécifiée, un champ ZONE_CODE est ajouté avec la valeur 1 pour tous les enregistrements en utilisant l’étendue d’analyse comme zone unique.
    • Si des zones sont spécifiées, un champ est ajouté en fonction de la valeur du paramètre Zone field (Champ de zone) (zone_field dans Python). Pour un champ de zone de type entier, un champ est ajouté avec le même nom dans la table en sortie. Pour un champ de zone de type chaîne, un champ est ajouté avec le même nom dans la table en sortie et un champ supplémentaire ZONE_CODE est ajouté.
  • Deux diagrammes peuvent être créés pour tracer les courbes de surface d’altitude et de volume d’altitude. Les diagrammes sont ajoutés dans la fenêtre Contents (Contenu) avec la table en sortie. La convention de nom utilisée pour le nom du diagramme est <out_chart> Elevation Area Curve (Courbe de surface d’altitude) et <out_chart> Elevation Volume Curve (Courbe de volume d’altitude), où <out_chart> est remplacé par le nom spécifié dans le paramètre Output chart name (Nom du diagramme en sortie) (out_chart dans Python). Lorsque vous créez un diagramme avec plusieurs zones, chaque ligne du diagramme représente une zone. Utilisez la légende pour activer ou désactiver les lignes interactivement dans le diagramme. Reportez-vous à la rubrique Présentation rapide des diagrammes pour en savoir plus sur l’utilisation des diagrammes dans ArcGIS AllSource. Les diagrammes peuvent uniquement être créés dans ArcGIS AllSource ; ils ne sont pas pris en charge à partir d’un script autonome.

  • Utilisez le paramètre Analysis type (Type d’analyse) (analysis_type dans Python) pour sélectionner une superficie, des calculs volumétriques, ou les deux. Cela détermine la structure des tables et des diagrammes. Par exemple, si l’option Area (Surface) (AREA dans Python) est sélectionnée, seul un champ de surface est créé dans la table en sortie et le champ de volume est ignoré. De même, un seul diagramme est créé pour la courbe de surface d’altitude.

  • Si aucune zone n’est spécifiée, la capacité de stockage est calculée avec l’étendue d’analyse comme zone unique. Spécifiez une valeur de paramètre Input raster or feature zone data (Données raster ou vecteur de zones en entrée) facultative (in_zone_data dans Python) qui représente les zones où les capacités de stockage doivent être calculées. Par exemple, une zone peut être un réservoir ou un bassin de retenue. L’outil prend en charge les calculs dans plusieurs zones, et les capacités de stockage sont calculées indépendamment à chaque zone en fonction d’un champ de zone.

  • Les incréments d’altitude d’après lesquels les capacités de stockage sont calculées reposent sur les valeurs des paramètres Minimum elevation (Altitude minimale) (min_elevation dans Python), Maximum elevation (Altitude maximale) (max_elevation dans Python), Increment type (Type d’incrément) (increment_type dans Python) et Increment (Incrément) (increment dans Python).

  • Les valeurs par défaut des paramètres Minimum elevation (Altitude minimale) et Maximum elevation (Altitude maximale) sont déterminées comme suit :

    • L’outil utilise les valeurs zonales minimale et maximale du raster de surface en entrée comme valeurs par défaut. Ces valeurs peuvent varier d’une zone à une autre, selon les valeurs minimale et maximale du raster de surface en entrée dans ces zones.
    • Si vous spécifiez une valeur de paramètre Minimum elevation (Altitude minimale) ou Maximum elevation (Altitude maximale), l’outil utilise la même valeur pour les incréments minimum et maximum dans toutes les zones. Dans ce cas, si un sous-ensemble d’incréments d’altitude devient plus petit que le minimum zonal, la surface et les volumes sont calculés comme étant égaux à zéro. S’ils deviennent plus grands que le maximum zonal, les surfaces et les volumes pour ces incréments ne sont pas calculés et s’affichent comme étant égaux à zéro ou nuls, selon le format tabulaire.
  • Spécifiez une valeur de paramètre Z unit (Unité z) (z_unit dans Python) pour indiquer les unités verticales du raster de surface en entrée. Si un système de coordonnées verticales est spécifié pour le raster de surface en entrée, ces unités sont utilisées comme l’unité z par défaut. Si aucune unité z n’est spécifiée et que le raster de surface en entrée n’a pas de système de coordonnées verticales, l’unité z par défaut est le mètre. Lorsque les unités x,y sont différentes de l’unité z, les unités x,y sont converties de façon à correspondre à l’unité z lors du calcul des volumes.

  • Par défaut, cet outil utilise des processeurs à plusieurs cœurs. Le nombre maximal de cœurs pouvant être utilisés est de quatre.

    Pour utiliser moins de cœurs, utilisez le paramètre d’environnement Facteur de traitement parallèle.

Paramètres

ÉtiquetteExplicationType de données
Raster de surface en entrée

Raster en entrée qui représente une surface continue.

Raster Layer
Table en sortie

La table en sortie contenant, pour chaque zone, la superficie et les volumes totaux pour chaque incrément en altitude.

Table
Données raster ou vecteur de zones en entrée

Jeu de données qui définit les zones.

Les zones peuvent être définies par un raster d'entiers ou une couche d'entités.

Raster Layer; Feature Layer
Champ de zone
(Facultatif)

Champ contenant les valeurs qui définissent chaque zone.

Il peut s'agir d'un champ de type entier ou chaîne du jeu de données de zones.

Field
Type d'analyse
(Facultatif)

Indique le type d’analyse.

  • Superficie et volumeLes superficies et les volumes totaux sont calculés à chaque incrément d’altitude. Il s’agit de l’option par défaut.
  • SuperficieLa superficie est calculée à chaque incrément d’altitude.
  • VolumeLe volume total est calculé à chaque incrément d’altitude.
String
Altitude minimale
(Facultatif)

L’altitude minimale à partir de laquelle les capacités de stockage sont évaluées.

Par défaut, l’outil utilise la valeur raster de la surface minimale dans chaque zone comme altitude minimale pour cette zone. Si une valeur est fournie, elle est utilisée comme altitude minimale dans toutes les zones.

Double
Altitude maximale
(Facultatif)

L’altitude maximale à partir de laquelle les capacités de stockage sont évaluées.

Par défaut, l’outil utilise la valeur raster de la surface maximale dans chaque zone comme altitude maximale pour cette zone. Si une valeur est fournie, elle est utilisée comme altitude maximale dans toutes les zones.

Double
Type d’incrément
(Facultatif)

Indique le type d’incrément à utiliser pour calculer les incréments d’altitude entre les altitudes minimale et maximale.

  • Nombre d’incrémentsLe nombre d’incréments entre les altitudes maximale et maximale est utilisé. Il s’agit de l’option par défaut.
  • Valeur d’incrémentLa différence d’altitude entre chaque incrément est utilisée.
String
Incrément
(Facultatif)

Une valeur incrémentielle qui est soit, le nombre d’incréments, soit la différence en altitude entre les incréments. La valeur repose sur la valeur de paramètre du type d’incrément.

Double
Unité Z
(Facultatif)

Spécifie l’unité linéaire qui sera utilisée pour les valeurs Z verticales.

  • PouceLes unités linéaires sont les pouces.
  • PiedLes unités linéaires sont les pieds.
  • JardinLes unités linéaires sont les yards.
  • Mile USLes unités linéaires sont les milles.
  • Mille nautiqueLes unités linéaires sont les milles nautiques.
  • MillimètreLes unités linéaires sont les millimètres.
  • CentimètreLes unités linéaires sont les centimètres.
  • MètresLes unités linéaires sont les mètres.
  • KilomètreLes unités linéaires sont les kilomètres.
  • DécimètreLes unités linéaires sont les décimètres.
String
Nom du diagramme en sortie
(Facultatif)

Le nom du diagramme en sortie à afficher.

Le diagramme apparaît dans la fenêtre Contents (Contenu), sous Standalone Tables (Tables autonomes).

Chart

StorageCapacity(in_surface_raster, out_table, in_zone_data, {zone_field}, {analysis_type}, {min_elevation}, {max_elevation}, {increment_type}, {increment}, {z_unit}, {out_chart})
NomExplicationType de données
in_surface_raster

Raster en entrée qui représente une surface continue.

Raster Layer
out_table

La table en sortie contenant, pour chaque zone, la superficie et les volumes totaux pour chaque incrément en altitude.

Table
in_zone_data

Jeu de données qui définit les zones.

Les zones peuvent être définies par un raster d'entiers ou une couche d'entités.

Raster Layer; Feature Layer
zone_field
(Facultatif)

Champ contenant les valeurs qui définissent chaque zone.

Il peut s'agir d'un champ de type entier ou chaîne du jeu de données de zones.

Field
analysis_type
(Facultatif)

Indique le type d’analyse.

  • AREA_VOLUMELes superficies et les volumes totaux sont calculés à chaque incrément d’altitude. Il s’agit de l’option par défaut.
  • AREALa superficie est calculée à chaque incrément d’altitude.
  • VOLUMELe volume total est calculé à chaque incrément d’altitude.
String
min_elevation
(Facultatif)

L’altitude minimale à partir de laquelle les capacités de stockage sont évaluées.

Par défaut, l’outil utilise la valeur raster de la surface minimale dans chaque zone comme altitude minimale pour cette zone. Si une valeur est fournie, elle est utilisée comme altitude minimale dans toutes les zones.

Double
max_elevation
(Facultatif)

L’altitude maximale à partir de laquelle les capacités de stockage sont évaluées.

Par défaut, l’outil utilise la valeur raster de la surface maximale dans chaque zone comme altitude maximale pour cette zone. Si une valeur est fournie, elle est utilisée comme altitude maximale dans toutes les zones.

Double
increment_type
(Facultatif)

Indique le type d’incrément à utiliser pour calculer les incréments d’altitude entre les altitudes minimale et maximale.

  • NUMBER_OF_INCREMENTSLe nombre d’incréments entre les altitudes maximale et maximale est utilisé. Il s’agit de l’option par défaut.
  • VALUE_OF_INCREMENTLa différence d’altitude entre chaque incrément est utilisée.
String
increment
(Facultatif)

Une valeur incrémentielle qui est soit, le nombre d’incréments, soit la différence en altitude entre les incréments. La valeur repose sur la valeur de paramètre du type d’incrément.

Double
z_unit
(Facultatif)

Spécifie l’unité linéaire qui sera utilisée pour les valeurs Z verticales.

  • INCHLes unités linéaires sont les pouces.
  • FOOTLes unités linéaires sont les pieds.
  • YARDLes unités linéaires sont les yards.
  • MILE_USLes unités linéaires sont les milles.
  • NAUTICAL_MILELes unités linéaires sont les milles nautiques.
  • MILLIMETERLes unités linéaires sont les millimètres.
  • CENTIMETERLes unités linéaires sont les centimètres.
  • METERLes unités linéaires sont les mètres.
  • KILOMETERLes unités linéaires sont les kilomètres.
  • DECIMETERLes unités linéaires sont les décimètres.
String
out_chart
(Facultatif)

Le nom du diagramme en sortie à afficher.

Chart

Exemple de code

Exemple 1 d’utilisation de l’outil StorageCapacity (fenêtre Python)

Utilisez l’outil StorageCapacity pour créer une table de superficies et volumes totaux à 10 incréments d’altitude dans un raster de surface en entrée pour chaque zone d’une entité de zone.

import arcpy
from arcpy.sa import *
arcpy.env.workspace = "C:/sapyexamples/data"
arcpy.sa.StorageCapacity("in_surface.tif", "out_table", "in_zones", "zone_id")
Exemple 2 d’utilisation de l’outil StorageCapacity (script autonome)

Utilisez l’outil StorageCapacity pour créer une table de superficies et volumes totaux à 10 incréments d’altitude dans un raster de surface en entrée pour chaque zone d’une entité de zone.

# Name: StorageCapacity_Standalone.py
# Description: 
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set the analysis environments
arcpy.CheckOutExtension("Spatial")
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set local variables
in_surface_raster = "in_surface.tif"
out_table = "fgdb.gdb\out_table"
in_zones = "fgdb.gdb\in_zones"
zone_field = "zone_id"

# Execute StorageCapacity tool
arcpy.sa.StorageCapacity(in_surface_raster, out_table, in_zones, zone_field)

Rubriques connexes