Résumé
Calcule le méridien central et les parallèles de référence facultatifs en fonction du point central de l’étendue d’une entité ; stocke ce système de coordonnées comme chaîne de référence spatiale dans un champ de texte donné ; puis répète ce processus pour un ensemble ou un sous-ensemble d’entités. Ce champ peut être utilisé avec des pages dynamiques pour mettre à jour le système de coordonnées du bloc de données pour chaque page.
Utilisation
Les entités en entrée peuvent être des points, des lignes ou des polygones.
Le fait d’appliquer directement cet outil à une classe d’entités dépourvue de projection génère une erreur. La classe d’entités doit être projetée.
Si vous utilisez l’outil alors que ArcMap est ouvert, la chaîne de référence spatiale obtenue sera basée sur la projection du bloc de données actif. Le bloc de données doit se trouver dans un système de coordonnées projetées pour que l’outil soit opérationnel ; sinon, vous recevez un message d’erreur.
Le paramètre Coordinate System Field (Champ de système de coordonnées) doit être un champ de texte suffisamment long (il faut prévoir au moins 600 caractères). La longueur des chaînes de système de coordonnées est variable, mais ces chaînes sont généralement longues. Il convient donc de s’assurer que le champ comporte assez d’espace. L’outil émet un avertissement si la chaîne du système de coordonnées a été tronquée en raison d’un champ trop court. Si vous recevez cet avertissement, certaines des chaînes du système de coordonnées générées peuvent avoir été tronquées, ce qui les rend inutilisables. Si vous recevez cet avertissement, supprimez vos résultats, créez un champ suffisamment long (plus de 600 caractères) et réexécutez l’outil.
Utilisez des classes d’entités de géodatabase en entrée au lieu de shapefiles. Dans la plupart des cas, il est fort probable que la limitation de la taille du champ tronque les chaînes de système de coordonnées si vous appliquez cet outil à un shapefile.
Le paramètre Standard Parallel Offset (Décalage parallèle de référence) spécifie un pourcentage de l’étendue de hauteur latitudinale de l’entité en entrée. Le décalage par rapport à la latitude du centre de l’entité en entrée est calculé au moyen de ce pourcentage. Une valeur Standard Parallel Offset (Décalage parallèle de référence) de 0 génère des valeurs parallèles égales à la latitude du centre latitudinal de l’entité en entrée. La valeur 0,5 (50 %) permet de générer des parallèles de part et d’autre de la hauteur latitudinale de l’entité, mais relativement proches de celle-ci. Des valeurs supérieures à 0,5 ont pour effet de déplacer les parallèles en dehors des limites latitudinales de l’entité en entrée. La valeur par défaut est 0,25. Elle positionne les parallèles à mi-chemin du centre latitudinal de l’entité et de ses limites latitudinales. Les valeurs négatives et les valeurs supérieures à 1 sont des entrées acceptables.
Syntaxe
arcpy.cartography.CalculateCentralMeridianAndParallels(in_features, in_field, {standard_offset})
Paramètre | Explication | Type de données |
in_features | Couche d'entités en entrée. | Feature Layer |
in_field | Champ de texte où est stocké la chaîne du système de coordonnées. | Field |
standard_offset (Facultatif) | Pourcentage de la hauteur de l’entité en entrée utilisé pour décaler les parallèles de référence par rapport à la latitude du centre de l’entité en entrée. La valeur par défaut est 25% ou 0,25. Les valeurs négatives et les valeurs supérieures à 1 sont des entrées acceptables. | Double |
Sortie dérivée
Nom | Explication | Type de données |
out_features | Classe d’entités mise à jour après calcul du méridien central et des parallèles de référence. | Couche d’entités |
Exemple de code
Exemple d’utilisation de l’outil CalculateCentralMeridianAndParallels (fenêtre Python)
L’exemple suivant permet de calculer le méridien central et les parallèles de référence facultatifs pour un ensemble d’entités.
import arcpy
arcpy.env.workspace = "C:\Data\ProjectData.gdb"
arcpy.CalculateCentralMeridianAndParallels_cartography("US_states", "CentralMeridian", 0.25)
Exemple d’utilisation de l’outil CalculateCentralMeridianAndParallels (script autonome)
L’exemple suivant permet de calculer le méridien central et les parallèles de référence facultatifs pour un ensemble d’entités.
# Name: calculatecentralmeridianandparallels_example.py
# Description: Calculates the central meridian and optional standard parallels
# for a set of features
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = "C:\Data\ProjectData.gdb"
# Set local variables
inFeatures = "US_states"
coordsysField = "CentralMeridian"
standardOffset = 0.25
# Execute CalculateAdjacentFields
arcpy.CalculateCentralMeridianAndParallels_cartography(inFeatures,
coordsysField,
standardOffset)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui