Définir une projection

Résumé

Remplace les informations sur le système de coordonnées (projection cartographique et datum) stockées par un jeu de données. Cet outil a été conçu pour les jeux de données pour lesquels un système de coordonnées inconnu ou incorrect a été défini.

Tous les jeux de données géographiques possèdent un système de coordonnées qui est utilisé dans l'ensemble d'ArcGIS pour afficher, mesurer et transformer des données géographiques. Si le système de coordonnées d'un jeu de données est inconnu ou incorrect, vous pouvez utiliser cet outil pour spécifier le système de coordonnées correct. Vous devez connaître le système de coordonnées correct du jeu de données avant d'utiliser cet outil.

Utilisation

• Cet outil se contente de mettre à jour les informations sur le système de coordonnées existant ; il ne modifie pas la géométrie. Pour transformer la géométrie dans un autre système de coordonnées, utilisez l'outil Projeter.

• Cet outil permet essentiellement d'attribuer un système de coordonnées connu à un jeu de données dont le système de coordonnées est inconnu (à savoir, lorsque le système de coordonnées est « Inconnu » dans les propriétés du jeu de données). Cet outil permet également d'attribuer un système de coordonnées correct à un jeu de données dont le système de coordonnées défini est incorrect (par exemple, les coordonnées sont en mètres UTM, mais le système de coordonnées est défini comme étant géographique).

• Lorsqu'un jeu de données avec un système de coordonnées connu est entré dans cet outil, celui-ci affiche un avertissement mais s'exécute normalement.

• Toutes les classes d'entités d'un jeu de données d'entité de la géodatabase possèdent le même système de coordonnées. Le système de coordonnées d'un jeu de données de géodatabase doit être déterminé à sa création. Une fois qu'il contient des classes d'entités, son système de coordonnées ne peut plus être modifié.

Syntaxe

arcpy.management.DefineProjection(in_dataset, coor_system)

Paramètre	Explication	Type de données
in_dataset	Jeu de données ou classe d'entités contenant la projection à définir.	Feature Layer;Geodataset
coor_system	Système de coordonnées à appliquer à l'entrée. La valeur par défaut est définie par rapport au paramètre d'environnement du système de coordonnées en sortie. Les valeurs valides sont un objet SpatialReference, un fichier avec une extension .prj ou une représentation de chaîne d’un système de coordonnées.	Coordinate System

Sortie dérivée

Nom	Explication	Type de données
out_dataset	Jeu de données géographiques en entrée mis à jour.	Jeu de données géographiques

Exemple de code

Exemple 1 d'utilisation de l'outil Définir une projection (fenêtre Python)

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

import arcpy
infc = r"C:\data\citylim_unk.shp"
sr = arcpy.SpatialReference("NAD 1983 UTM Zone 11N")
arcpy.DefineProjection_management(infc, sr)

Exemple d'utilisation de l'outil Définir une projection (script autonome)

Le script autonome suivant utilise la fonction DefineProjection pour enregistrer les informations sur le système de coordonnées du jeu de données en entrée.

# Name: DefineProjection.py 
# Description: Records the coordinate system information for the specified input dataset or feature class

# import system modules
import arcpy

# set workspace environment
arcpy.env.workspace = "C:/data"

try:
    # set local variables
    in_dataset = "citylim_unk.shp" #"forest.shp"
    
    # get the coordinate system by describing a feature class
    dsc = arcpy.Describe("citylim_utm11.shp")
    coord_sys = dsc.spatialReference
    
    # run the tool
    arcpy.DefineProjection_management(in_dataset, coord_sys)
    
    # print messages when the tool runs successfully
    print(arcpy.GetMessages(0))
    
except arcpy.ExecuteError:
    print(arcpy.GetMessages(2))
    
except Exception as ex:
    print(ex.args[0])

Environnements

• Espace de travail courant
• Espace de travail temporaire

Informations de licence

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