Ungenerate (Couverture)
Récapitulatif
Crée un fichier texte de coordonnées X,Y à partir de la couverture en entrée.
Utilisation
-
L'outil Ungenerate permet de créer des fichiers de coordonnées simples à partir de couvertures. Vous pouvez ainsi facilement transférer des couvertures sur d'autres systèmes de cartographie ou visualiser et mettre à jour des coordonnées individuelles à l'aide de l'éditeur de texte de votre ordinateur.
-
Le fichier texte en sortie doit être dans un format utilisable par l'outil Générer.
-
Les identifiants utilisateur sont écrits dans le fichier Generate en sortie pour les lignes, les points, les polygones, les régions et les tics.
-
Tous les calculs internes sont effectués en double précision, quelle que soit la précision du jeu de données en entrée ou en sortie. La sortie à simple précision permet d'obtenir une précision d'environ 7 chiffres significatifs. Ignorez les valeurs qui dépassent 7 chiffres significatifs pour les fichiers Ungenerate en simple précision. Pour obtenir une précision d'environ 15 chiffres, utilisez la double précision.
-
Les coordonnées créées par l'outil Ungenerate sont dans la même précision de coordonnées que la couverture en entrée. Des coordonnées à simple précision sont générées pour des couvertures à simple précision et des coordonnées à double précision sont générées pour des couvertures à double précision.
-
Les fichiers créés avec Region.<sous-classe> devront être traités avec l'outil Couverture de lignes vers région et l'outil Construire ou Nettoyer pour restaurer entièrement les régions.
-
Lorsque vous utilisez l'option POLY, les polygones qui ne sont pas complètement fermés ne sont pas écrits dans le fichier en sortie. Si deux points labels sont présents dans un polygone, un seul est écrit. Si aucun point label n'existe, alors zéro est écrit pour le numéro d'identifiant de cette entité surfacique et les coordonnées X,Y du centroïde sont écrites.
-
L'outil Ungenerate marque les polygones d'îles d'un indicateur. Le numéro d'identifiant du polygone d'île est -99999 et un jeu de sommets définit le polygone. Cela s'avère utile lors de la conversion de couvertures de polygones dans d'autres systèmes dans lesquels les polygones d'îles nécessitent une prise en charge spéciale.
-
L'option POLY considère tous les segments de lignes qui figurent intégralement dans un polygone comme des polygones d'îles et les référence avec un numéro d'identifiant de -99999. Les segments de lignes qui figurent à l'intérieur du polygone, mais touchent la bordure du polygone, sont également considérés comme des îles à l'intérieur du polygone. Les segments de lignes qui figurent à l'extérieur d'un polygone sont toutefois considérés comme faisant partie du polygone universel et sont ignorés.
-
Tous les sommets qui définissent chaque arc composant d'une entité surfacique sont écrits. Pour supprimer des sommets de couvertures très denses, utilisez l'outil Simplifier des lignes avant d'utiliser l'outil Generate. Les arcs de chaque polygone sont écrits en commençant en bas à gauche du polygone, puis en allant dans le sens horaire. Les arcs partagés par plusieurs polygones sont dupliqués dans le fichier en sortie. Les nœuds et l'orientation des arcs ne sont pas conservés.
-
Lorsque vous utilisez l'option ANNO, les annotations qui figurent dans une classe spécifiée sont écrites dans un fichier, dans le format ci-dessous. Tous les points de forme d'annotation jusqu'à 500 sont écrits.
ID, LEVEL, SYMBOL, HEIGHT TEXT X,Y X,Y .. END
-
Il est important de noter que le format indiqué ci-dessus pour l'annotation Ungenerate n'est pas compatible avec le format attendu par la commande Generate. Son rôle consiste essentiellement à translater une annotation dans un format différent.
Syntaxe
| Paramètre | Explication | Type de données |
in_cover |
Couverture à partir de laquelle les coordonnées des entités sont écrites. | Coverage |
out_generate_file |
Fichier texte dans lequel les coordonnées X,Y sont écrites. | File |
feature_type |
Type d'entités utilisées lors de la génération du fichier en sortie.
| String |
duplicate_nodes (Facultatif) |
Détermine s'il faut conserver ou non les coordonnées des nœuds dupliqués dans le fichier Generate en sortie. Cela s'applique uniquement à l'option POLY.
| Boolean |
format (Facultatif) |
Sélectionne la représentation exponentielle ou fixe des nombres à virgule flottante dans le fichier Generate en sortie.
| String |
Exemple de code
Le script autonome suivant illustre la création d'un fichier texte à partir d'une couverture.
# Name: Ungenerate_Example.py
# Description: Creates a text file from a coverage.
# Requirements: ArcInfo Workstation
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inCover = "tong_azone"
outGenerateFile = "C:/output/tong_azone.gen"
featureType = "POLY"
format = "FIXED"
# Execute Ungenerate
arcpy.Ungenerate_arc(inCover, outGenerateFile, featureType, "", format)