Pairwise Erase (Effacement deux par deux) (Analyse)

Synthèse

Calcule une intersection deux par deux de l’entrée et efface des entités. Seules les parties des entités en entrée situées hors des entités d’effacement sont copiées vers la classe d’entités en sortie.

Un outil alternatif est disponible pour les opérations d’effacement. Reportez-vous à la documentation de l’outil Effacer pour plus de détails.

Illustration

Illustration de l’outil Effacer deux par deux

Utilisation

  • La valeur du paramètre Erase Features (Entités d’effacement) peut être de type point, ligne ou polygone, tant que la valeur du paramètre Input Features (Entités en entrée) correspond à un type d’entité d’ordre égal ou inférieur. Une entité d’effacement surfacique permet d’effacer des polygones, des lignes ou des points des entités en entrée, une entité d’effacement linéaire permet d’effacer des lignes ou des points des entités en entrée et une entité d’effacement ponctuelle permet d’effacer des points des entités en entrée.

    La valeur du paramètre Input Features (Entités en entrée) doit être des entités simples, de type point, multi-points, ligne ou polygone. Elles ne peuvent pas correspondre à des entités complexes telles que les entités annotation, les entités cotation ou les entités de réseau.

  • Les valeurs attributaires des classes d'entités en entrée sont copiées vers la classe d'entités en sortie. Toutefois, si l'entrée représente une ou plusieurs couche(s) créée(s) par l'outil Générer une couche et que l'option Règle de division est activée pour un champ, alors un quotient de la valeur attributaire en entrée est calculé pour la valeur attributaire en sortie. Lorsque l'option Règle de division est activée, chaque fois qu'une entité est fractionnée dans une opération de superposition, les attributs des entités résultantes sont égaux à un quotient de la valeur attributaire de l'entité en entrée. La valeur en sortie dépend du quotient de division de la géométrie d'entité en entrée. Par exemple, si la géométrie en entrée a été divisée en parties égales, la moitié de la valeur attributaire de l'entité en entrée est affectée à la valeur attributaire de chaque nouvelle entité. L'option Règle de division s'applique uniquement aux champs de type numérique.

    Attention :

    Les outils de géotraitement ne respectent pas les règles de fractionnement de champ des classes d'entités ou des tables de géodatabase.

  • Les entités courbe en entrée seront densifiées dans la sortie.

  • Pour utiliser cet outil, les entités en entrée doivent disposer d’un index spatial. Utilisez l’outil Ajouter un index spatial pour créer un index (en particulier pour les shapefiles) ou pour régénérer un index spatial si vous doutez de son exactitude.

  • Lorsque vos entités en entrée possèdent des valeurs m ou z, seules les valeurs m et z de la première classe d’entités seront transférées vers les entités en sortie. Si la première classe d’entités ne contient pas de valeurs m ou z, la sortie ne comportera ni valeurs m, ni valeurs z.

  • La référence spatiale de la classe d’entités en sortie demeure celle de la première classe d’entités dans le paramètre Input Features (Entités en entrée). Pour plus d’informations, consultez Référence spatiale et géotraitement.

  • Par défaut, les entités de courbe de l’entrée seront densifiées dans la sortie. Pour prendre en charge les courbes dans la sortie, utilisez l’environnement Maintain Curve Segments (Conserver les segments de courbe).

  • Cet outil respecte l’environnement Facteur de traitement parallèle. Si l’environnement n’est pas défini (valeur par défaut) ou s’il est défini sur 100, le traitement parallèle complet est activé et l’outil tente de répartir les tâches sur tous les cœurs logiques de la machine. Si vous définissez l'environnement sur 0, le traitement parallèle est désactivé. Si vous spécifiez un facteur compris entre 1 et 99, l’outil identifie le pourcentage de cœurs logiques à utiliser en appliquant la formule (Facteur de traitement parallèle / 100 * Cœurs logiques) arrondie à l’entier supérieur le plus proche. Si le résultat de cette formule est 0 ou 1, le traitement parallèle n'est pas activé.

  • L’outil Effacer deux par deux est similaire à l’outil Effacer puisque des intersections géométriques sont calculées, mais il est différent dans le sens où les intersections sont calculées sur des paires d’entités et non sur toutes les combinaisons d’entités. Cet outil est efficace lorsque les classes d’entités d’effacement ou en entrée contiennent un grand nombre d’entités denses.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Classe ou couche d'entités en entrée.

Feature Layer
Entités d’effacement

Entités à utiliser pour effacer les entités coïncidentes de l'entrée.

Feature Layer
Classe d’entités en sortie

Classe d’entités en sortie.

Feature Class
Tolérance XY
(Facultatif)

Distance minimale séparant toutes les coordonnées d’entités (nœuds et sommets), ainsi que la distance de déplacement possible d’une coordonnée sur l’axe X ou Y (ou les deux).

Attention :

Modifier la valeur de ce paramètre peut provoquer des erreurs ou des résultats inattendus. Il est recommandé de ne pas modifier ce paramètre. Ce paramètre n’est plus affiché dans la boîte de dialogue de l’outil. Par défaut, la propriété Tolérance x,y de la référence spatiale de la classe d’entités en entrée est utilisée.

Linear Unit

arcpy.analysis.PairwiseErase(in_features, erase_features, out_feature_class, {cluster_tolerance})
NomExplicationType de données
in_features

Classe ou couche d'entités en entrée.

Feature Layer
erase_features

Entités à utiliser pour effacer les entités coïncidentes de l'entrée.

Feature Layer
out_feature_class

Classe d’entités en sortie.

Feature Class
cluster_tolerance
(Facultatif)

Distance minimale séparant toutes les coordonnées d’entités (nœuds et sommets), ainsi que la distance de déplacement possible d’une coordonnée sur l’axe X ou Y (ou les deux).

Attention :

Modifier la valeur de ce paramètre peut provoquer des erreurs ou des résultats inattendus. Il est recommandé de ne pas modifier ce paramètre. Ce paramètre n’est plus affiché dans la boîte de dialogue de l’outil. Par défaut, la propriété Tolérance x,y de la référence spatiale de la classe d’entités en entrée est utilisée.

Linear Unit

Exemple de code

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

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction PairwiseErase en mode immédiat.

import arcpy
arcpy.env.workspace = 'C:/data/gdb'
arcpy.PairwiseErase_analysis(r'redlands.gdb\rdlswells\well', 
                             r'redlands.gdb\rdlsfloodzones\flood', 
                             r'redlands.gdb\wellsoutside_flood')
Exemple 2 d’utilisation de l’outil PairwiseErase (script autonome)

Identifiez les surfaces de végétation convenable en excluant les surfaces très affectées par les routes principales.

# Name: PairwiseErase.py
# Description: Find areas of suitable vegetation that exclude areas heavily 
#              impacted by major roads.

# Import system modules 
import arcpy

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

# Select suitable vegetation patches from all vegetation
veg = "vegtype"
suitableVeg = "C:/output/Output.gdb/suitable_vegetation"
whereClause = "HABITAT = 1" 
arcpy.Select_analysis(veg, suitableVeg, whereClause)

# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveField = "Distance"
arcpy.Buffer_analysis(roads, roadsBuffer, distanceField, "FULL", "ROUND", 
                      "LIST", dissolveField)

# Erase areas of impact around major roads from the suitable vegetation patches
eraseOutput = "C:/output/Output.gdb/suitable_vegetation_minus_roads"
arcpy.PairwiseErase_analysis(suitableVeg, roadsBuffer, eraseOutput)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes