Générer des points de calibrage (Location Referencing)

Disponible avec la licence Location Referencing.

Synthèse

Génère des points de calibrage pour toute forme d'itinéraire fournie, notamment des formes complexes, telles que des itinéraires qui se ferment eux-mêmes, des itinéraires qui s'intersectent eux-mêmes et des itinéraires à branches.

Utilisation

  • Un jeu de données LRS est requis pour exécuter cet outil.

    En savoir plus sur la création d’un jeu de données LRS dans ArcGIS Pipeline Referencing ou la création d’un jeu de données LRS dans ArcGIS Roads and Highways.

  • La valeur du paramètre Entités polylignes en entrée sert de base pour les points de calibrage qui seront générés.

  • La valeur du paramètre Classe d’entités de point de calibrage doit être enregistrée dans le LRS.

  • La valeur du paramètre Réseau LRS doit être enregistrée dans le LRS.

  • Les réseaux LRS dérivés ne sont pas pris en charge comme valeur du paramètre Réseau LRS.

  • Les valeurs Z sont prises en compte durant le calcul de la longueur géométrique des axes médians.

  • Les règles de calibrage des interruptions sont respectées lors de la génération de points de calibrage à l'aide des options Longueur de la géométrie et Champs attributaires du paramètre Méthode de calibrage.

    En savoir plus sur le calibrage des itinéraires avec des interruptions physiques dans ArcGIS Roads and Highways ou le calibrage des itinéraires avec des interruptions physiques dans ArcGIS Pipeline Referencing.

  • Si le paramètre Méthode de calibrage est défini sur M sur itinéraire, l’outil utilise les valeurs m aux sommets de début et d’extrémité des itinéraires en entrée pour créer les points de calibrage de début et de fin.

  • Lorsque le paramètre Méthode de calibrage est défini sur Champs attributaires, il se produit ce qui suit :

    • L’option Champs attributaires est utilisée pour évaluer les champs de type double précision à des fins de calibrage.
    • La valeur du paramètre Champ Mesure de départ est utilisée pour fournir la mesure de départ de l’itinéraire et la valeur du paramètre Champ Mesure d’arrivée est utilisée pour fournir la mesure d’arrivée de l’itinéraire.
  • La valeur du paramètre Entités polylignes en entrée peut être une couche de service d’entités qui ne dispose pas de la fonctionnalité de référencement linéaire. Si la valeur du paramètre Classe d’entités de points de calibrage est une couche de service d’entités, la fonctionnalité de référencement linéaire doit être activée sur cette couche.

Paramètres

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

Entités qui font office de source pour calculer les valeurs de mesure des points de calibrage.

Feature Layer
Champ d’ID d’itinéraire

Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Le type de champ doit correspondre à celui du champ Route ID dans les classes d’entités de point de calibrage.

Field
Champ de date de début

Champ contenant les valeurs de date de début d’un itinéraire.

Field
Champ de date de fin

Champ contenant les valeurs de date de fin d’un itinéraire.

Field
Classe d’entités de points de calibrage

Classe d’entités de points de calibrage existante dans laquelle les nouvelles entités sont ajoutées.

Feature Layer
Réseau LRS

Réseau LRS pour lequel les valeurs de mesure seront générées dans la classe d’entités de points de calibrage.

String
Direction de calibrage
(Facultatif)

Spécifie le sens du calibrage croissant sur un itinéraire lors de la création de points de calibrage.

  • Sens de numérisationLe sens de numérisation de l’entité polyligne individuelle détermine celui du calibrage de l’itinéraire. Il s’agit de l’option par défaut.
  • Sens des mesuresLe sens des valeurs m croissantes de l’entité polyligne individuelle détermine celui du calibrage de l’itinéraire.Si l’entité polyligne individuelle ne comporte pas de valeurs m, le sens de numérisation est utilisé.
String
Méthode de calibrage
(Facultatif)

Spécifie la méthode à utiliser pour déterminer les mesures sur un itinéraire lors de la création de points de calibrage.

  • Longueur de la géométrieLa longueur géométrique de l’entité d'itinéraire en entrée est utilisée comme méthode de calibrage. Il s’agit de l’option par défaut.
  • M sur itinéraireLes valeurs de mesure sur l’entité d'itinéraire en entrée est utilisée comme méthode de calibrage.
  • Champs attributairesLes valeurs de mesure stockées dans les champs attributaires de l’entité d'itinéraire en entrée sont utilisées comme méthode de calibrage.
String
Champ Mesure de départ
(Facultatif)

Champ contenant la mesure de départ de l'itinéraire sélectionné.

Ce paramètre est actif si le paramètre Méthode de calibrage est défini sur Champs attributaires.

Field
Champ Mesure de fin
(Facultatif)

Champ contenant la mesure d’arrivée de l'itinéraire sélectionné.

Ce paramètre est actif si le paramètre Méthode de calibrage est défini sur Champs attributaires.

Field

Sortie obtenue

ÉtiquetteExplicationType de données
Classe d’entités de point de calibrage mise à jour

Entités de calibrage mises à jour.

Feature Layer
Fichier de détails en sortie

Fichier texte qui détaille les modifications apportées par l’outil.

Text File

arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, {calibration_direction}, {calibration_method}, {from_measure_field}, {to_measure_field})
NomExplicationType de données
in_polyline_features

Entités qui font office de source pour calculer les valeurs de mesure des points de calibrage.

Feature Layer
route_id_field

Champ contenant des valeurs identifiant de manière unique chaque itinéraire. Le type de champ doit correspondre à celui du champ Route ID dans les classes d’entités de point de calibrage.

Field
from_date_field

Champ contenant les valeurs de date de début d’un itinéraire.

Field
to_date_field

Champ contenant les valeurs de date de fin d’un itinéraire.

Field
in_calibration_point_feature_class

Classe d’entités de points de calibrage existante dans laquelle les nouvelles entités sont ajoutées.

Feature Layer
lrs_network

Réseau LRS pour lequel les valeurs de mesure seront générées dans la classe d’entités de points de calibrage.

String
calibration_direction
(Facultatif)

Spécifie le sens du calibrage croissant sur un itinéraire lors de la création de points de calibrage.

  • DIGITIZED_DIRECTIONLe sens de numérisation des entités polylignes individuelles détermine celui du calibrage de l’itinéraire. Il s’agit de l’option par défaut.
  • MEASURE_DIRECTIONLe sens des valeurs m croissantes de l’entité polyligne individuelle détermine celui du calibrage de l’itinéraire.Si l’entité polyligne individuelle ne comporte pas de valeurs m, le sens de numérisation est utilisé.
String
calibration_method
(Facultatif)

Spécifie la méthode à utiliser pour déterminer les mesures sur un itinéraire lors de la création de points de calibrage.

  • GEOMETRY_LENGTHLa longueur géométrique de l’entité d'itinéraire en entrée est utilisée comme méthode de calibrage. Il s’agit de l’option par défaut.
  • M_ON_ROUTELes valeurs de mesure sur l’entité d'itinéraire en entrée est utilisée comme méthode de calibrage.
  • ATTRIBUTE_FIELDSLes valeurs de mesure stockées dans les champs attributaires de l’entité d'itinéraire en entrée sont utilisées comme méthode de calibrage.
String
from_measure_field
(Facultatif)

Champ contenant la mesure de départ de l'itinéraire sélectionné.

Ce paramètre est activé lorsque le paramètre calibration_method est défini sur ATTRIBUTE_FIELDS.

Field
to_measure_field
(Facultatif)

Champ contenant la mesure d’arrivée de l'itinéraire sélectionné.

Ce paramètre est activé lorsque le paramètre calibration_method est défini sur ATTRIBUTE_FIELDS.

Field

Sortie obtenue

NomExplicationType de données
out_calibration_point_feature_class

Entités de calibrage mises à jour.

Feature Layer
out_details_file

Fichier texte qui détaille les modifications apportées par l’outil.

Text File

Exemple de code

Exemple 1 d'utilisation de la fonction GenerateCalibrationPoints (fenêtre Python)

Le script Python ci-dessous illustre l’utilisation de la fonction GenerateCalibrationPoints dans la fenêtre Python.

# Name: GenerateCalibrationPoints.py
# Description: Build calibration point features when an LRS already exists in the geodatabase.
# Requires: ArcGIS Location Referencing

# Tool variables:
in_polyline_features = "SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = "Calibration_Point"
lrs_network = "NonLineNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Set current workspace
arcpy.env.workspace = r"C:\Data\UPDM.gdb"

# Execute Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, 
                                       to_date_field, in_calibration_point_feature_class, 
                                       lrs_network, calibration_direction, calibration_method)
Exemple 2 d'utilisation de la fonction GenerateCalibrationPoints (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction GenerateCalibrationPoints.

# Name: GenerateCalibrationPoints.py
# Description: Build calibration point features when an LRS already exists in the geodatabase.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = r"C:\\Data\UPDM.gdb\LRS\Calibration_Point"
lrs_network = "EngineeringNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, 
                                       to_date_field, in_calibration_point_feature_class, 
                                       lrs_network, calibration_direction, calibration_method)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Exemple 3 d'utilisation de la fonction GenerateCalibrationPoints (script autonome)

Le script autonome suivant montre comment utiliser la fonction GenerateCalibrationPoints pour créer des points de calibrage dans un service d’entités existant.

# Name: GenerateCPs_Pro_standalone_fs.py
# Description: Build calibration point features in an existing feature service.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing"

# Local variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Input LRS route network is in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the calibration point layer from the feature service. Here, 5 corresponds to the calibration point layer.
lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Execute the tool
arcpy.locref.GenerateCalibrationPoints(in_calibration_point_feature_class)

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, 
                                       to_date_field, in_calibration_point_feature_class, 
                                       lrs_network, calibration_direction, calibration_method)
                                                         
## Check in license
arcpy.CheckInExtension('LocationReferencing')

Environnements

Cas particuliers

Facteur de traitement parallèle

Si vous ne renseignez pas ce champ, la valeur par défaut pour cet environnement est égale à 0 %. Toute valeur absolue pour l’environnement est toujours fixée entre 0 et le nombre de cœurs logiques de cette machine.

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)

Rubriques connexes