Disponible avec une licence Spatial Analyst.
Résumé
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 Pro. Les diagrammes peuvent uniquement être créés dans ArcGIS Pro ; 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 tire parti des processeurs à plusieurs cœurs. Le nombre maximal de cœurs pouvant être utilisés s’élève à quatre.
Pour utiliser moins de cœurs, utilisez le paramètre d’environnement Facteur de traitement parallèle.
Syntaxe
StorageCapacity(in_surface_raster, out_table, in_zone_data, {zone_field}, {analysis_type}, {min_elevation}, {max_elevation}, {increment_type}, {increment}, {z_unit}, {out_chart})| Paramètre | Explication | Type 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.
| 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.
| 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) | Unité linéaire des valeurs z verticales.
| String |
out_chart (Facultatif) | Le nom du diagramme en sortie à afficher. | Chart |
Exemple de code
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")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)Environnements
Informations de licence
- Basic: Requiert Spatial Analyst
- Standard: Requiert Spatial Analyst
- Advanced: Requiert Spatial Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?