Activer les champs référents (Location Referencing)

Synthèse

Active ou modifie les champs de référence afin que vous puissiez gérer les informations de référence pour l’événement LRS inscrit.

En savoir plus sur les champs de référence de l’événément

Utilisation

• L’outil active les champs de référence en vous permettant d’inscrire des champs existants en tant que champs de référence.

• Si les champs de référence sont déjà activés, par défaut, l’outil renseigne alors les champs existants afin qu’ils puissent être modifiés.

• Les données existantes dans les champs de référence ne sont pas validés ou mises à jour lorsque vous activez ou modifiez les champs de référence.

• Pour désactiver les champs de référence, utilisez l’outil Désactiver les champs de référence.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Classe d’entités d’événement	Classe d’entités qui sera utilisée pour l’événement LRS.	Feature Layer
Champ de méthode de référence (Facultatif)	Champ de méthode de référence de départ.	Field
Champ de localisation de référence (Facultatif)	Champ de localisation de référence de départ.	Field
Champ de décalage de référence (Facultatif)	Champ de décalage de référence de départ.	Field
Champ de méthode de référence d’arrivée (Facultatif)	Champ de méthode de référence d’arrivée.	Field
Champ de localisation de référence d’arrivée (Facultatif)	Champ de localisation de référence d’arrivée.	Field
Champ de décalage de référence d’arrivée (Facultatif)	Champ de décalage de référence d’arrivée.	Field
Unités du décalage (Facultatif)	Indique les unités de décalage qui seront utilisées. Miles d’arpentage américains—L’unité de mesure est le mille. Il s’agit de l’option par défaut. Pouces d’arpentage américains—L’unité de mesure est le pouce. Pieds d’arpentage américains—L’unité de mesure est le pied. Yards d’arpentage américains—L’unité de mesure est le yard. Milles nautiques d’arpentage américains—L’unité de mesure est le mille nautique. Pieds internationaux—L’unité de mesure est le pied international. Millimètres—L’unité de mesure est le millimètre. Centimètres—L’unité de mesure est le centimètre. Mètres—L’unité de mesure est le mètre. Kilomètres—L’unité de mesure est le kilomètre. Décimètres—L’unité de mesure est le décimètre.	String

Sortie obtenue

Étiquette	Explication	Type de données
Classe d’entités d’événement en sortie	Couche d’entités d’événement mise à jour.	Feature Layer

Python

arcpy.locref.EnableReferentFields(in_feature_class, {from_referent_method_field}, {from_referent_location_field}, {from_referent_offset_field}, {to_referent_method_field}, {to_referent_location_field}, {to_referent_offset_field}, {offset_units})

Nom	Explication	Type de données
in_feature_class	Classe d’entités qui sera utilisée pour l’événement LRS.	Feature Layer
from_referent_method_field (Facultatif)	Champ de méthode de référence de départ.	Field
from_referent_location_field (Facultatif)	Champ de localisation de référence de départ.	Field
from_referent_offset_field (Facultatif)	Champ de décalage de référence de départ.	Field
to_referent_method_field (Facultatif)	Champ de méthode de référence d’arrivée.	Field
to_referent_location_field (Facultatif)	Champ de localisation de référence d’arrivée.	Field
to_referent_offset_field (Facultatif)	Champ de décalage de référence d’arrivée.	Field
offset_units (Facultatif)	Indique les unités de décalage qui seront utilisées. MILES—L’unité de mesure est le mille. Il s’agit de l’option par défaut. INCHES—L’unité de mesure est le pouce. FEET—L’unité de mesure est le pied. YARDS—L’unité de mesure est le yard. NAUTICAL_MILES—L’unité de mesure est le mille nautique. INTFEET—L’unité de mesure est le pied international. MILLIMETERS—L’unité de mesure est le millimètre. CENTIMETERS—L’unité de mesure est le centimètre. METERS—L’unité de mesure est le mètre. KILOMETERS—L’unité de mesure est le kilomètre. DECIMETERS—L’unité de mesure est le décimètre.	String

Sortie obtenue

Nom	Explication	Type de données
out_feature_class	Couche d’entités d’événement mise à jour.	Feature Layer

Exemple de code

Exemple 1 d’utilisation de la fonction EnableReferentFields (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction EnableReferentFields en mode immédiat en vue d’activer les champs de référence pour un événement LRS existant.

# Name: Enable_Referent_Fields_ex1.py
# Description: Enable referent fields for an existing LRS Event that already has referent fields configured.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
inputEventFC = r"c:\EnableReferent\Py\EnableReferent.gdb\LRS"
fromReferentMethodField = 'FromRefMethod'
fromReferentLocationField = 'FromRefLocation'
fromReferentOffsetField = 'FromRefOffset'
toReferentMethodField = 'ToRefMethod'
toReferentLocationField = 'ToRefLocation'
toReferentOffsetField = 'ToRefOffset'
offsetUnit = 'FEET'

# Execute the tool
arcpy.locref.EnableReferentFields(inputEventFC, fromReferentMethodField, fromReferentLocationField,
                                  fromReferentOffsetField, toReferentMethodField, toReferentLocationField,
                                  toReferentOffsetField, offsetUnit)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Exemple 2 d’utilisation de la fonction EnableReferentFields (script autonome)

Le script Python autonome ci-dessous illustre l’utilisation de la fonction EnableReferentFields en vue d’activer les champs de référence pour un événement LRS existant.

# Name: Enable_Referent_Fields_ex2.py
# Description: Enables referent fields for an existing LRS Event.
# Requires: ArcGIS Pipeline Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables
inputEventFC = "c:\EnableReferent\Py\EnableReferent.gdb\LRS"
fromReferentMethodField = 'FromRefMethod'
fromReferentLocationField = 'FromRefLocation'
fromReferentOffsetField = 'FromRefOffset'
toReferentMethodField = 'ToRefMethod'
toReferentLocationField = 'ToRefLocation'
toReferentOffsetField = 'ToRefOffset'
offsetUnit = 'FEET'

# execute the tool
arcpy.locref.EnableReferentFields(inputEventFC, fromReferentMethodField, fromReferentLocationField,
                                  fromReferentOffsetField, toReferentMethodField, toReferentLocationField,
                                  toReferentOffsetField, offsetUnit)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Exemple 3 d’utilisation de la fonction EnableReferentFields (script autonome)

Le script Python autonome ci-dessous illustre l’utilisation de la fonction EnableReferentFields en vue de modifier les champs de référence pour un événement LRS existant qui comporte déjà des champs de référence configurés.

# Name: Enable_Referent_Fields_ex3.py
# Description: Modifies  referent fields for an existing LRS Event that already has referent fields configured.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
inputEventFC = r"c:\EnableReferent\Py\EnableReferent.gdb\LRS"
toReferentMethodField = 'ToRefMethod2'
toReferentLocationField = 'ToRefLocation2'
toReferentOffsetField = 'ToRefOffset2'

# Execute the tool
arcpy.locref.EnableReferentFields(inputEventFC, '' , '' , '' , toReferentMethodField, toReferentLocationField, toReferentOffsetField)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
• Standard: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)
• Advanced: Nécessite ArcGIS Location Referencing (ArcGIS Pipeline Referencing ou ArcGIS Roads and Highways)