Ajouter des points de contrôle (Gestion des données)

Synthèse

Combine les points de contrôle dans une table de points de contrôle existante.

Les points à ajouter sont les résultats de l’outil Calculer les points de rattachement ou Calculer des points de contrôle ou d’une classe d'entités ponctuelles.

Utilisation

  • Si les paramètres Nom du champ de valeur Z et MNA en entrée sont tous les deux définis, le paramètre Nom du champ de valeur Z est prioritaire. Si aucun des paramètres Nom du champ de valeur Z ou MNA en entrée n'est défini, la valeur z est définie sur 0 pour tous les points de canevas géodésique et les points de vérification.

  • Soyez prudent lorsque vous appelez l’option d’ajout ; elle n’est applicable que si les points de rattachement des tables de points de contrôle en entrée et cible ont la même transformation.

Paramètres

ÉtiquetteExplicationType de données
Points de contrôle de la cible

Table de points de contrôle en entrée. Elle est généralement générée par l'outil Calculer les points de rattachement.

Feature Class; Feature Layer
Points de contrôle en entrée

Classe d’entités points qui stocke les points de contrôle. Il peut s'agir de la table de points de contrôle créée à partir de l'outil Calculer des points de contrôle, de l'outil Calculer les points de rattachement ou d'une classe d'entités points qui possède des points de contrôle au sol.

Feature Class; Feature Layer; File; String
Nom du champ de valeur Z
(Facultatif)

Champ qui stocke les valeurs Z des points de contrôle.

Si les paramètres Nom du champ de valeur Z et MNA en entrée sont tous les deux définis, le champ de la valeur Z est utilisé. Si aucun des paramètres Nom du champ de valeur Z ou MNA en entrée n'est défini, la valeur z est définie sur 0 pour tous les points de canevas géodésique et les points de vérification.

Field
Nom du champ de balise
(Facultatif)

Champ de la table de points de contrôle en entrée qui possède une valeur unique. Ce champ sera ajouté à la table de points de contrôle cible dans laquelle le champ de balise peut être utilisé pour importer les identifiants associés aux points de contrôle au sol.

Field
MNA en entrée
(Facultatif)

MNT à utiliser pour obtenir la valeur Z des points de contrôle dans la table de points de contrôle en entrée.

Si les paramètres Nom du champ de valeur Z et MNA en entrée sont tous les deux définis, le champ de la valeur Z est utilisé. Si aucun des paramètres Nom du champ de valeur Z ou MNA en entrée n'est défini, la valeur z est définie sur 0 pour tous les points de canevas géodésique et les points de vérification.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
Précision XY
(Facultatif)

Précision en entrée des coordonnées X et Y. La précision est exprimée à l'aide des mêmes unités que les points de contrôle en entrée.

Le fournisseur de données doit communiquer ces informations. Si aucune information n'indique la précision, n'appliquez aucune valeur à ce paramètre facultatif.

Double
Précision Z
(Facultatif)

Précision en entrée des coordonnées verticales. La précision est exprimée à l'aide des unités des points de contrôle en entrée.

Le fournisseur de données doit communiquer ces informations. Si aucune information n'indique la précision, n'appliquez aucune valeur à ce paramètre facultatif.

Double
Géoïde
(Facultatif)

La correction de géoïde est requise par les coefficients polynomiaux rationnels (RPC) qui font référence aux hauteurs ellipsoïdales. La plupart des jeux de données d'altitude étant référencés par rapport à des hauteurs orthométriques au niveau de la mer, cette correction est nécessaire dans ce cas pour effectuer la conversion en hauteurs ellipsoïdales.

  • Désactivé : aucune correction de géoïde n'est effectuée. Utilisez cette option uniquement si votre MNT est déjà exprimé en hauteurs ellipsoïdales. Il s’agit de l’option par défaut.
  • Activé : une correction de géoïde sera effectuée pour convertir les hauteurs orthométriques en hauteurs ellipsoïdales (en fonction de la géoïde EGM96).
Boolean
Zone d’intérêt
(Facultatif)

Définit une étendue de zone d’intérêt en entrant les coordonnées X et Y minimales et maximales dans la référence spatiale de la table de points de contrôle en entrée.

Envelope; Feature Layer; Feature Class
Option d’ajout
(Facultatif)

Indique la manière dont les points de contrôle doivent être ajoutés à la table de points de contrôle.

  • Ajouter tous les pointsAjoutez tous les points de la table de points de contrôle en entrée dans la table de points de contrôle cible, y compris les points de contrôle au sol, les points de vérification et tous les points de rattachement. Il s’agit de l’option par défaut.
  • Ajouter uniquement les points de contrôle au solN’ajoutez que les points de contrôle au sol de la table de points de contrôle en entrée dans la table de points de contrôle cible.
  • Ajouter les points de contrôle au sol et les points de rattachementAjoutez les points de contrôle au sol et les points de rattachement associés spécifiquement aux points de contrôle au sol à la table de points de contrôle cible.Soyez prudent avec cette option ; elle n’est applicable que si les points de rattachement des tables de points de contrôle en entrée et cible ont la même transformation. Les points de rattachement ne se trouvent peut-être pas aux positions souhaitées s’ils ont été calculés à l’aide d’un autre processus d’ajustement.
String

Sortie obtenue

ÉtiquetteExplicationType de données
Points de contrôle mis à jour

Points de contrôle mis à jour.

Classe d'entités ; Couche d’entités

arcpy.management.AppendControlPoints(in_master_control_points, in_input_control_points, {in_z_field}, {in_tag_field}, {in_dem}, {in_xy_accuracy}, {in_z_accuracy}, {Geoid}, {area_of_interest}, {append_option})
NomExplicationType de données
in_master_control_points

Table de points de contrôle en entrée. Elle est généralement générée par l'outil Calculer les points de rattachement.

Feature Class; Feature Layer
in_input_control_points

Classe d’entités points qui stocke les points de contrôle. Il peut s'agir de la table de points de contrôle créée à partir de l'outil Calculer des points de contrôle, de l'outil Calculer les points de rattachement ou d'une classe d'entités points qui possède des points de contrôle au sol.

Feature Class; Feature Layer; File; String
in_z_field
(Facultatif)

Champ qui stocke les valeurs Z des points de contrôle.

Si les paramètres Nom du champ de valeur Z et MNA en entrée sont tous les deux définis, le champ de la valeur Z est utilisé. Si aucun des paramètres Nom du champ de valeur Z ou MNA en entrée n'est défini, la valeur z est définie sur 0 pour tous les points de canevas géodésique et les points de vérification.

Field
in_tag_field
(Facultatif)

Champ de la table de points de contrôle en entrée qui possède une valeur unique. Ce champ sera ajouté à la table de points de contrôle cible dans laquelle le champ de balise peut être utilisé pour importer les identifiants associés aux points de contrôle au sol.

Field
in_dem
(Facultatif)

MNT à utiliser pour obtenir la valeur Z des points de contrôle dans la table de points de contrôle en entrée.

Si les paramètres Nom du champ de valeur Z et MNA en entrée sont tous les deux définis, le champ de la valeur Z est utilisé. Si aucun des paramètres Nom du champ de valeur Z ou MNA en entrée n'est défini, la valeur z est définie sur 0 pour tous les points de canevas géodésique et les points de vérification.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
in_xy_accuracy
(Facultatif)

Précision en entrée des coordonnées X et Y. La précision est exprimée à l'aide des mêmes unités que les in_input_control_points.

Le fournisseur de données doit communiquer ces informations. Si aucune information n'indique la précision, ignorez ce paramètre facultatif.

Double
in_z_accuracy
(Facultatif)

Précision en entrée des coordonnées verticales. La précision est exprimée à l'aide des mêmes unités que les in_input_control_points.

Le fournisseur de données doit communiquer ces informations. Si aucune information n'indique la précision, ignorez ce paramètre facultatif.

Double
Geoid
(Facultatif)

La correction de géoïde est requise par les coefficients polynomiaux rationnels (RPC) qui font référence aux hauteurs ellipsoïdales. La plupart des jeux de données d'altitude étant référencés par rapport à des hauteurs orthométriques au niveau de la mer, cette correction est nécessaire dans ce cas pour effectuer la conversion en hauteurs ellipsoïdales.

  • NONEAucune correction de géoïde n'est effectuée. Utilisez NONE uniquement si votre MNT est déjà exprimé en hauteurs ellipsoïdales. Il s’agit de l’option par défaut.
  • GEOIDUne correction de géoïde sera effectuée pour convertir les hauteurs orthométriques en hauteurs ellipsoïdales (en fonction de la géoïde EGM96).
Boolean
area_of_interest
(Facultatif)

Définit une étendue de zone d’intérêt en entrant les coordonnées X et Y minimales et maximales dans la référence spatiale de la table de points de contrôle en entrée.

Envelope; Feature Layer; Feature Class
append_option
(Facultatif)

Indique la manière dont les points de contrôle doivent être ajoutés à la table de points de contrôle.

  • ALLAjoutez tous les points de la table de points de contrôle en entrée dans la table de points de contrôle cible, y compris les points de contrôle au sol, les points de vérification et tous les points de rattachement. Il s’agit de l’option par défaut.
  • GCPN’ajoutez que les points de contrôle au sol de la table de points de contrôle en entrée dans la table de points de contrôle cible.
  • GCPSETAjoutez les points de contrôle au sol et les points de rattachement associés spécifiquement aux points de contrôle au sol à la table de points de contrôle cible.Soyez prudent avec cette option ; elle n’est applicable que si les points de rattachement des tables de points de contrôle en entrée et cible ont la même transformation. Les points de rattachement ne se trouvent peut-être pas aux positions souhaitées s’ils ont été calculés à l’aide d’un autre processus d’ajustement.
String

Sortie obtenue

NomExplicationType de données
out_master_control_points

Points de contrôle mis à jour.

Classe d'entités ; Couche d’entités

Exemple de code

Exemple 1 d'utilisation de l'outil AppendControlPoints (fenêtre Python)

Il s’agit d'un exemple Python d'utilisation de l'outil AppendControlPoints.

#===========================
#AppendControlPoints
'''Usage: AppendControlPoints_management(in_master_control_points, 
{in_z_field}, {in_tag_field}, {in_dem}, {in_xy_accuracy}, 
{in_z_accuracy}, {Geoid}, {area_of_interest}, {append_option}
'''

import arcpy
arcpy.env.workspace = "C:/Workspace"

arcpy.management.AppendControlPoints("calval_allpoints_dem1", 
    "C:\test\calval_allpoints_dem1", "Score", "Ways", "calval",1, 2, "NONE", 
"-79.6407162269889 43.4853802421312 -79.094324938576 44.0836924137218", "GCP")
Exemple 2 d'utilisation de l'outil AppendControlPoints (script autonome)

Il s’agit d'un exemple de script Python d'utilisation de l'outil AppendControlPoints.

#append control points

import arcpy
arcpy.env.workspace = "c:/workspace"

#append the control points and tie points
target = "BD.gdb/tiePoints"
in_controlPoints = "BD.gdb/controlPoints"
dem = "BD.gdb/dem"
AOI = "-79.6407162269889 43.4853802421312 -79.094324938576 44.0836924137218"
AppOpt = "GCP"


arcpy.AppendControlPoints_management(target, in_controlPoints, "", dem, "", "", "", AOI, appOpt)

Environnements

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

Informations de licence

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

Rubriques connexes