Couche GA vers isoligne (Geostatistical Analyst)

Disponible avec une licence Geostatistical Analyst.

Synthèse

Crée une classe d’entités d’isolignes à partir d’une couche géostatistique. La classe d’entités en sortie peut être une classe d’entités linéaires d’isolignes ou une classe d’entités surfaciques d’isolignes remplies.

Utilisation

  • Pour les formats de données prenant en charge les valeurs nulles (par exemple, les classes d’entités de géodatabase fichier), une valeur nulle est ignorée pour indiquer qu’une prédiction ne peut pas être établie pour cette localisation et que la valeur doit être ignorée lorsqu’elle est utilisée comme entrée. Pour les formats de données qui ne prennent pas en charge les valeurs nulles, par exemple les shapefiles, la valeur -1.7976931348623158e+308 est utilisée (c’est la valeur négative de la constante définie C++ DBL_MAX) pour indiquer qu’une prévision ne peut pas être établie pour cette localisation.

  • Les entités polylignes ou surfaciques en sortie contiennent une géométrie légèrement différente selon le nombre de cœurs CPU de votre machine. Cela s’explique par un nombre différent de tuiles qui seront utilisées dans l’algorithme d’isoligne (un plus grand nombre de cœurs donnent lieu à un tuilage plus important, et par conséquent, des isolignes plus affinées dans la sortie). Pour des résultats reproductibles sur des machines avec différents nombres de cœurs, utilisez l’environnement Facteur de traitement parallèle afin de contrôler le nombre de cœurs que l’outil est autorisé à utiliser.

  • Si Couche géostatistique en entrée représente un modèle d’interpolation 3D, vous devez spécifier l’élévation des isolignes à exporter avec le paramètre Élévation en sortie.

Paramètres

ÉtiquetteExplicationType de données
Couche géostatistique en entrée

Couche géostatistique à analyser.

Geostatistical Layer
Contour type

Type d’isoligne pour représenter la couche géostatistique.

  • IsoligneReprésentation d’isoligne de la couche géostatistique. Affiche les lignes en qualité Présentation ou Brouillon.
  • Isoligne remplieReprésentation surfacique de la couche géostatistique. En ce qui concerne l’affichage graphique, cette représentation suppose que les valeurs entre les isolignes sont identiques pour toutes les localisations situées dans le polygone. Affiche les lignes en qualité Présentation ou Brouillon.
  • Comme la coucheUtilisez le moteur de rendu actuel dans la couche géostatistique en entrée.
String
Classe d'entités en sortie

La classe d’entités en sortie sera une polyligne ou un polygone, selon le type d’isoligne sélectionné.

Feature Class
Qualité des isolignes
(Facultatif)

Détermine le lissage de la représentation des isolignes.

  • BrouillonLa qualité Brouillon par défaut présente une version généralisée des isolignes pour accélérer l’affichage.
  • PrésentationL’option Présentation garantit des isolignes plus détaillées pour la classe d’entités en sortie.
String
Type de classification
(Facultatif)

Désigne le mode de calcul des seuils d’isoligne.

  • Intervalle géométriqueLes seuils d’isoligne sont calculés en fonction des intervalles géométriques.
  • Intervalle égalLes seuils d’isoligne sont calculés en fonction des intervalles égaux.
  • QuantileLes seuils d’isoligne sont calculés à partir des quantiles des données en entrée.
  • ManuelleSpécifiez vos propres valeurs de seuil.
String
Nombre de classes
(Facultatif)

Spécifiez le nombre de classes dans la classe d’entités en sortie.

Si le paramètre Type d’isoligne est défini sur des polygones d’isoligne remplie en sortie, le nombre de polygones créés est égal à la valeur spécifiée dans ce paramètre. S’il est défini sur des polylignes d’isoligne en sortie, le nombre de polylines sera égal à la valeur spécifiée dans ce paramètre moins un (car N intervalles de classe définissent N-1 valeurs de seuil d’isoligne).

Ce paramètre ne s’applique pas si l’option Type de classification est définie sur Manuel.

Long
Interruptions de classe
(Facultatif)

Liste des valeurs de seuil si l’option Type de classification est définie sur Manuel.

  • Pour l’isoligne en sortie, il s’agit des valeurs des isolignes.
  • Pour l’isoligne remplie, il s’agit des limites supérieures de chaque intervalle de classe. Notez que si la valeur de seuil la plus élevée est inférieure au maximum de la couche géostatistique, la classe d’entités en sortie ne remplit pas l’ensemble de l’étendue rectangulaire. Les localisations avec des valeurs prédites supérieures au seuil le plus élevé ne recevront pas les isolignes remplies.
Double
Élévation en sortie
(Facultatif)

Pour les modèles d’interpolation 3D, vous pouvez exporter des isolignes à n’importe quelle élévation. Utilisez ce paramètre pour spécifier l’élévation à exporter. Si vous ne renseignez pas ce paramètre, l’élévation est héritée de la couche en entrée. Les unités seront par défaut celles de la couche en entrée.

Linear Unit

arcpy.ga.GALayerToContour(in_geostat_layer, contour_type, out_feature_class, {contour_quality}, {classification_type}, {classes_count}, {classes_breaks}, {out_elevation})
NomExplicationType de données
in_geostat_layer

Couche géostatistique à analyser.

Geostatistical Layer
contour_type

Type d’isoligne pour représenter la couche géostatistique.

  • CONTOURReprésentation d’isoligne de la couche géostatistique. Affiche les lignes en qualité Présentation ou Brouillon.
  • FILLED_CONTOURReprésentation surfacique de la couche géostatistique. En ce qui concerne l’affichage graphique, cette représentation suppose que les valeurs entre les isolignes sont identiques pour toutes les localisations situées dans le polygone. Affiche les lignes en qualité Présentation ou Brouillon.
  • SAME_AS_LAYERUtilisez le moteur de rendu actuel dans la couche géostatistique en entrée.
String
out_feature_class

La classe d’entités en sortie sera une polyligne ou un polygone, selon le type d’isoligne sélectionné.

Feature Class
contour_quality
(Facultatif)

Détermine le lissage de la représentation des isolignes.

  • DRAFTLa qualité Brouillon par défaut présente une version généralisée des isolignes pour accélérer l’affichage.
  • PRESENTATIONL’option Présentation garantit des isolignes plus détaillées pour la classe d’entités en sortie.
String
classification_type
(Facultatif)

Désigne le mode de calcul des seuils d’isoligne.

  • GEOMETRIC_INTERVALLes seuils d’isoligne sont calculés en fonction des intervalles géométriques.
  • EQUAL_INTERVALLes seuils d’isoligne sont calculés en fonction des intervalles égaux.
  • QUANTILELes seuils d’isoligne sont calculés à partir des quantiles des données en entrée.
  • MANUALSpécifiez vos propres valeurs de seuil.
String
classes_count
(Facultatif)

Spécifiez le nombre de classes dans la classe d’entités en sortie.

Si le paramètre contour_type est défini sur des polygones d’isoligne remplie en sortie, le nombre de polygones créés est égal à la valeur spécifiée dans ce paramètre. S’il est défini sur des polylignes d’isoligne en sortie, le nombre de polylines sera égal à la valeur spécifiée dans ce paramètre moins un (car N intervalles de classe définissent N-1 valeurs de seuil d’isoligne).

Ce paramètre ne s’applique pas si l’option classification_type est définie sur Manual.

Long
classes_breaks
[classes_breaks,...]
(Facultatif)

Liste des valeurs de seuil si l’option classification_type est définie sur Manual. Les valeurs doivent être transmises sous forme de liste et peuvent se trouver dans n’importe quel ordre.

  • Pour l’isoligne en sortie, il s’agit des valeurs des isolignes.
  • Pour l’isoligne remplie, il s’agit des limites supérieures de chaque intervalle de classe. Notez que si la valeur de seuil la plus élevée est inférieure au maximum de la couche géostatistique, la classe d’entités en sortie ne remplit pas l’ensemble de l’étendue rectangulaire. Les localisations avec des valeurs prédites supérieures au seuil le plus élevé ne recevront pas les isolignes remplies.
Double
out_elevation
(Facultatif)

Pour les modèles d’interpolation 3D, vous pouvez exporter des isolignes à n’importe quelle élévation. Utilisez ce paramètre pour spécifier l’élévation à exporter. Si vous ne renseignez pas ce paramètre, l’élévation est héritée de la couche en entrée. Les unités seront par défaut celles de la couche en entrée.

Linear Unit

Exemple de code

Exemple d’utilisation de la fenêtre interactive GALayerToContour

Exportez une couche géostatistique vers une classe d’entités d’isolignes.

import arcpy
from arcpy import env
env.workspace = "C:/gapyexamples/data"
arcpy.GALayerToContour_ga("kriging.lyr", "Contour", "krig_contour",
                          "Presentation", "GEOMETRIC_INTERVAL", 10, "")
Exemple d’utilisation du script GALayerToContour

Exportez une couche géostatistique vers une classe d’entités d’isolignes.

# Name: GALayerToContour_Example_02.py
# Description: Exports a geostatistical layer to filled contours with
#              class breaks at 100, 500 and 2000.
# Requirements: Geostatistical Analyst Extension

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/gapyexamples/data"

# Set local variables
in_geostat_layer = "kriging.lyr"
contour_type = "Filled_contour"
out_feature_class = "C:/gapyexamples/output/krig_filled_contour.shp"
contour_quality = "Presentation"
classification_type = "Manual"
classes_count = ""
classes_breaks = [100, 500, 2000]

# Execute GALayerToContour
arcpy.GALayerToContour_ga(in_geostat_layer, contour_type, out_feature_class,
                          contour_quality, classification_type, classes_count,
                          classes_breaks)

Informations de licence

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

Rubriques connexes