Mettre à jour les propriétés du jeu de données d’imagerie orientée (Imagerie orientée)

Synthèse

Met à jour ou modifie les propriétés du jeu de données d’imagerie orientée.

Utilisation

    Attention :

    Cet outil modifie les données en entrée. Pour plus d’informations et connaître les stratégies permettant d’empêcher les modifications de données indésirables, reportez-vous à la rubrique Outils qui modifient ou mettent à jour les données en entrée.

  • Les propriétés du jeu de données peuvent servir à optimiser le jeu de données. Si une propriété de jeu de données est présente en tant que champ dans la table attributaire avec la même valeur pour tous les enregistrements, le champ peut être supprimé de la table attributaire et la valeur peut être définie comme propriété du jeu de données. Si le champ existe dans la table attributaire, la valeur de cette dernière prime sur la valeur de la propriété du jeu de données.

  • Si un paramètre de données de type chaîne doit être supprimé à l’aide de l’outil dans Python, fournissez la valeur "None".

Paramètres

ÉtiquetteExplicationType de données
Jeu de données d’imagerie orientée

Chemin d’accès et nom du jeu de données d’imagerie orientée.

Oriented Imagery Layer
Distance maximale
(Facultatif)

Distance de recherche maximale qui est utilisée pour interroger les entités du jeu de données. La distance maximale ne peut pas être inférieure à zéro. Les unités sont les mètres.

Double
Pourcentage de couverture
(Facultatif)

Pourcentage qui modifie l’étendue de l’emprise au sol de l’image. L’emprise au sol de chaque image est calculée pour rechercher des images contenant l’emplacement sélectionné, qui est identifié sous la forme d’une croix rouge sur la carte.

Une valeur de pourcentage négative réduit la taille de l’emprise au sol et une valeur de pourcentage positive l’augmente. Ce paramètre permet d’exclure ou d’inclure des points sur le bord d’une image. Par exemple, la valeur -30 réduit la taille de l’emprise de 30 pour cent et la valeur 20 l’augmente de 20 pour cent. Les valeurs valides sont comprises entre -50 et 50.

Double
Élément d’emprise
(Facultatif)

Nom de la classe d’entités d’emprise. La classe d’entités doit se trouver dans la même géodatabase que le jeu de données d’imagerie orientée.

String
Source d'altitude
(Facultatif)

Spécifie la source d’élévation à utiliser.

  • MNELa source d'altitude sera un modèle numérique de terrain constituant un service d'imagerie dynamique ou un service d'image de titre.
  • Altitude constanteLa source d'altitude sera une valeur d'élévation du sol constante pour le jeu de données entier.
  • AucunLa source d’élévation est supprimée.
String
Altitude constante
(Facultatif)

Valeur d'élévation du sol constante du jeu de données entier. La valeur du paramètre Unité de mesure verticale est utilisée comme unité d’élévation constante.

Ce paramètre est actif lorsque la valeur du paramètre Source d'altitude est définie sur Altitude constante.

Double
Modèle numérique de terrain
(Facultatif)

URL faisant référence au modèle numérique d’élévation en entrée. Un service d'imagerie dynamique ou un service d'image de titre peut être utilisé comme modèle numérique de terrain.

Ce paramètre est actif lorsque la valeur du paramètre Source d'altitude est définie sur DEMMNT.

Image Service
Niveau de détail
(Facultatif)

Échelle dans une structure de tuilage. L'échelle représente la valeur de niveau de zoom. Chaque niveau successif améliore la résolution et l'échelle de carte de deux fois par rapport au niveau précédent.

Ce paramètre est activé lorsque la valeur du paramètre Modèle numérique de terrain est un service d'image de tuile.

String
Fonction raster
(Facultatif)

Modèle de traitement de la fonction raster qui sera appliqué au service d'imagerie.

Ce paramètre est activé lorsque la valeur du paramètre Modèle numérique de terrain est un service d'imagerie dynamique.

String
Unité de mesure verticale
(Facultatif)

Spécifie l’unité utilisée pour toutes les mesures verticales.

  • MètreLes mètres sont utilisés comme unité de mesure.
  • PiedsLes pieds sont utilisés comme unité de mesure.
String
Unité de l’intervalle temporel
(Facultatif)

Indique l’unité de mesure temporelle utilisée pour filtrer les images.

  • MinutesLes images sont filtrées toutes les minutes.
  • HeuresLes images sont filtrées toutes les heures.
  • JoursLes images sont filtrées tous les jours.
  • SemainesLes images sont filtrées toutes les semaines.
  • MoisLes images sont filtrées tous les mois.
  • AnnéesLes images sont filtrées toutes les années.
String
Type d’imagerie orientée
(Facultatif)

Spécifie le type d’images dans le jeu de données.

  • HorizontalLes images dans lesquelles l’exposition est parallèle au sol et dirigée vers l’horizon se trouvent dans le jeu de données.
  • ObliqueLes images dans lesquelles l’exposition se trouve à un angle par rapport au sol, généralement à environ 45 degrés, de sorte que les côtés des objets sont visibles, se trouvent dans le jeu de données.
  • Point nadiralLes images dans lesquelles l’exposition est perpendiculaire au sol et dirigée directement vers le bas se trouvent dans le jeu de données. Seule la partie supérieure des objets est visible.
  • 360Les images prises à l’aide de caméras qui fournissent des vues d’habillage sphériques à 360 degrés ou qui ont été assemblées en tant que vues à 360 degrés à partir de plusieurs caméras se trouvent dans le jeu de données.
  • InspectionLes images en gros plan des ressources se trouvent dans le jeu de données
  • AucunLe type d’imagerie orientée est supprimée du jeu de données.
String
Direction de la caméra
(Facultatif)

Orientation de caméra de la première rotation autour de l’axe z de la caméra. La valeur est en degrés. Les valeurs de direction sont mesurées dans le sens horaire positif, où le nord est défini par 0 degré. La valeur -999 est utilisée lorsque l’orientation est inconnue.

Double
Tangage de la caméra
(Facultatif)

Orientation de caméra de la deuxième rotation autour de l’axe x de la caméra dans le sens antihoraire positif. La valeur est en degrés. Le tangage est de 0 degré lorsque la caméra plonge directement vers le sol. La plage de tangage valide est comprise entre 0 et 180 degrés. La valeur de 180 degrés désigne une caméra dirigée directement vers le haut et 90 degrés une caméra dirigée vers l’horizon.

Double
Roulis de la caméra
(Facultatif)

Orientation de caméra de la rotation finale autour de l’axe z de la caméra dans le sens horaire positif. La valeur est en degrés. Les valeurs valides sont comprises entre -90 et 90.

Double
Hauteur de la caméra
(Facultatif)

Hauteur de la caméra au-dessus du sol lorsque l’imagerie a été capturée. Les unités sont les mètres. La hauteur de la caméra permet de déterminer l’étendue visible de l’image. Les valeurs importantes génèrent une étendue supérieure de la vue. Les valeurs ne doivent pas être inférieures à 0.

Double
Champ de vision horizontal
(Facultatif)

Étendue de la caméra dans la direction horizontale. La valeur est en degrés. Les valeurs valides sont comprises entre 0 et 360.

Double
Champ de vision vertical
(Facultatif)

Étendue de la caméra dans la direction verticale. La valeur est en degrés. Les valeurs valides sont comprises entre 0 et 180.

Double
Distance proche
(Facultatif)

Distance utilisable la plus proche de l’imagerie à partir de la position de la caméra. Les unités sont les mètres.

Double
Distance lointaine
(Facultatif)

Distance utilisable la plus éloignée de l’imagerie à partir de la position de la caméra. Les unités sont les mètres. Les distances lointaines doivent être supérieures à 0.

Double
Rotation de l’image
(Facultatif)

Orientation de la caméra en degrés par rapport à la scène lorsque l’image a été capturée. L’orientation est ajoutée en plus du roulis de la caméra. Les valeurs valides sont comprises entre +360 et 360.

Double
Précision de l’orientation
(Facultatif)

Écart type dans les valeurs de précision séparées par des points-virgule. Les valeurs d’écart type sont ajoutées selon l’ordre et le format suivants :

  • Emplacement de la caméra dans le sens XY en mètres
  • Hauteur de la caméra en mètres
  • Direction de la caméra en degrés
  • Tangage de la caméra en degrés
  • Roulis de la caméra en degrés
  • Distance proche en mètres
  • Distance lointaine en mètres
  • Élévation en mètres

Par exemple, si le GPS présente une EQM de +/– 10 mètres dans les coordonnées x,y et une hauteur de +/– 20 mètres, la valeur de précision de l’orientation est de 10;20.

String
Préfixe du chemin d’accès à l’image
(Facultatif)

Préfixe utilisé pour construire le chemin d’accès à l’image en association avec l’attribut Image.

String
Suffixe du chemin d’accès à l’image
(Facultatif)

Suffixe utilisé pour construire le chemin d’accès à l’image en association avec l’attribut Image.

String
Préfixe du chemin d’accès à l’image de profondeur
(Facultatif)

Préfixe utilisé pour construire le chemin d’accès à l’image de profondeur en association avec l’attribut Depth Image.

String
Suffixe du chemin d’accès à l’image de profondeur
(Facultatif)

Suffixe utilisé pour construire le chemin d’accès à l’image de profondeur en association avec l’attribut Depth Image.

String
Préfixe du chemin d’accès au MNE
(Facultatif)

Préfixe utilisé pour construire le chemin d’accès au MNE en association avec l’URL Elevation Source dans l’attribut.

String
Suffixe du chemin d’accès au MNE
(Facultatif)

Suffixe utilisé pour construire le chemin d’accès au MNE en association avec l’URL Elevation Source dans l’attribut.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Jeu de données d'imagerie orientée en sortie

Jeu de données d’imagerie orientée mis à jour.

Oriented Imagery Dataset

arcpy.management.UpdateOrientedImageryDatasetProperties(in_oriented_imagery_dataset, {maximum_distance}, {coverage_percent}, {footprint_item}, {elevation_source}, {constant_elevation}, {dem}, {lod}, {raster_function}, {vertical_measurement_unit}, {time_interval_unit}, {oriented_imagery_type}, {camera_heading}, {camera_pitch}, {camera_roll}, {camera_height}, {hfov}, {vfov}, {near_distance}, {far_distance}, {image_rotation}, {orientation_accuracy}, {image_path_prefix}, {image_path_suffix}, {depth_image_path_prefix}, {depth_image_path_suffix}, {dem_path_prefix}, {dem_path_suffix})
NomExplicationType de données
in_oriented_imagery_dataset

Chemin d’accès et nom du jeu de données d’imagerie orientée.

Oriented Imagery Layer
maximum_distance
(Facultatif)

Distance de recherche maximale qui est utilisée pour interroger les entités du jeu de données. La distance maximale ne peut pas être inférieure à zéro. Les unités sont les mètres.

Double
coverage_percent
(Facultatif)

Pourcentage qui modifie l’étendue de l’emprise au sol de l’image. L’emprise au sol de chaque image est calculée pour rechercher des images contenant l’emplacement sélectionné, qui est identifié sous la forme d’une croix rouge sur la carte.

Une valeur de pourcentage négative réduit la taille de l’emprise au sol et une valeur de pourcentage positive l’augmente. Ce paramètre permet d’exclure ou d’inclure des points sur le bord d’une image. Par exemple, la valeur -30 réduit la taille de l’emprise de 30 pour cent et la valeur 20 l’augmente de 20 pour cent. Les valeurs valides sont comprises entre -50 et 50.

Double
footprint_item
(Facultatif)

Nom de la classe d’entités d’emprise. La classe d’entités doit se trouver dans la même géodatabase que le jeu de données d’imagerie orientée.

String
elevation_source
(Facultatif)

Spécifie la source d’élévation à utiliser.

  • DEMLa source d'altitude sera un modèle numérique de terrain constituant un service d'imagerie dynamique ou un service d'image de titre.
  • CONSTANT_ELEVATIONLa source d'altitude sera une valeur d'élévation du sol constante pour le jeu de données entier.
  • NONELa source d’élévation est supprimée.
String
constant_elevation
(Facultatif)

Valeur d'élévation du sol constante du jeu de données entier. La valeur du paramètre vertical_measurement_unit est utilisée comme unité d’élévation constante.

Ce paramètre est activé lorsque la valeur du paramètre elevation_source est définie sur CONSTANT_ELEVATION.

Double
dem
(Facultatif)

URL faisant référence au modèle numérique d’élévation en entrée. Un service d'imagerie dynamique ou un service d'image de titre peut être utilisé comme modèle numérique de terrain.

Ce paramètre est activé lorsque la valeur du paramètre elevation_source est définie sur DEM.

Image Service
lod
(Facultatif)

Échelle dans une structure de tuilage. L'échelle représente la valeur de niveau de zoom. Chaque niveau successif améliore la résolution et l'échelle de carte de deux fois par rapport au niveau précédent.

Ce paramètre est activé lorsque la valeur du paramètre dem est un service d'image de tuile.

String
raster_function
(Facultatif)

Modèle de traitement de la fonction raster qui sera appliqué au service d'imagerie.

Ce paramètre est activé lorsque la valeur du paramètre dem est un service d'imagerie dynamique.

String
vertical_measurement_unit
(Facultatif)

Spécifie l’unité utilisée pour toutes les mesures verticales.

  • METERLes mètres sont utilisés comme unité de mesure.
  • FEETLes pieds sont utilisés comme unité de mesure.
String
time_interval_unit
(Facultatif)

Indique l’unité de mesure temporelle utilisée pour filtrer les images.

  • MINUTESLes images sont filtrées toutes les minutes.
  • HOURSLes images sont filtrées toutes les heures.
  • DAYSLes images sont filtrées tous les jours.
  • WEEKSLes images sont filtrées toutes les semaines.
  • MONTHSLes images sont filtrées tous les mois.
  • YEARSLes images sont filtrées toutes les années.
String
oriented_imagery_type
(Facultatif)

Spécifie le type d’images dans le jeu de données.

  • HORIZONTALLes images dans lesquelles l’exposition est parallèle au sol et dirigée vers l’horizon se trouvent dans le jeu de données.
  • OBLIQUELes images dans lesquelles l’exposition se trouve à un angle par rapport au sol, généralement à environ 45 degrés, de sorte que les côtés des objets sont visibles, se trouvent dans le jeu de données.
  • NADIRLes images dans lesquelles l’exposition est perpendiculaire au sol et dirigée directement vers le bas se trouvent dans le jeu de données. Seule la partie supérieure des objets est visible.
  • 360Les images prises à l’aide de caméras qui fournissent des vues d’habillage sphériques à 360 degrés ou qui ont été assemblées en tant que vues à 360 degrés à partir de plusieurs caméras se trouvent dans le jeu de données.
  • INSPECTIONLes images en gros plan des ressources se trouvent dans le jeu de données
  • NONELe type d’imagerie orientée est supprimée du jeu de données.
String
camera_heading
(Facultatif)

Orientation de caméra de la première rotation autour de l’axe z de la caméra. La valeur est en degrés. Les valeurs de direction sont mesurées dans le sens horaire positif, où le nord est défini par 0 degré. La valeur -999 est utilisée lorsque l’orientation est inconnue.

Double
camera_pitch
(Facultatif)

Orientation de caméra de la deuxième rotation autour de l’axe x de la caméra dans le sens antihoraire positif. La valeur est en degrés. Le tangage est de 0 degré lorsque la caméra plonge directement vers le sol. La plage de tangage valide est comprise entre 0 et 180 degrés. La valeur de 180 degrés désigne une caméra dirigée directement vers le haut et 90 degrés une caméra dirigée vers l’horizon.

Double
camera_roll
(Facultatif)

Orientation de caméra de la rotation finale autour de l’axe z de la caméra dans le sens horaire positif. La valeur est en degrés. Les valeurs valides sont comprises entre -90 et 90.

Double
camera_height
(Facultatif)

Hauteur de la caméra au-dessus du sol lorsque l’imagerie a été capturée. Les unités sont les mètres. La hauteur de la caméra permet de déterminer l’étendue visible de l’image. Les valeurs importantes génèrent une étendue supérieure de la vue. Les valeurs ne doivent pas être inférieures à 0.

Double
hfov
(Facultatif)

Étendue de la caméra dans la direction horizontale. La valeur est en degrés. Les valeurs valides sont comprises entre 0 et 360.

Double
vfov
(Facultatif)

Étendue de la caméra dans la direction verticale. La valeur est en degrés. Les valeurs valides sont comprises entre 0 et 180.

Double
near_distance
(Facultatif)

Distance utilisable la plus proche de l’imagerie à partir de la position de la caméra. Les unités sont les mètres.

Double
far_distance
(Facultatif)

Distance utilisable la plus éloignée de l’imagerie à partir de la position de la caméra. Les unités sont les mètres. Les distances lointaines doivent être supérieures à 0.

Double
image_rotation
(Facultatif)

Orientation de la caméra en degrés par rapport à la scène lorsque l’image a été capturée. L’orientation est ajoutée en plus du roulis de la caméra. Les valeurs valides sont comprises entre +360 et 360.

Double
orientation_accuracy
(Facultatif)

Écart type dans les valeurs de précision séparées par des points-virgule. Les valeurs d’écart type sont ajoutées selon l’ordre et le format suivants :

  • Emplacement de la caméra dans le sens XY en mètres
  • Hauteur de la caméra en mètres
  • Direction de la caméra en degrés
  • Tangage de la caméra en degrés
  • Roulis de la caméra en degrés
  • Distance proche en mètres
  • Distance lointaine en mètres
  • Élévation en mètres

Par exemple, si le GPS présente une EQM de +/– 10 mètres dans les coordonnées x,y et une hauteur de +/– 20 mètres, la valeur de précision de l’orientation est de 10;20.

String
image_path_prefix
(Facultatif)

Préfixe utilisé pour construire le chemin d’accès à l’image en association avec l’attribut Image.

String
image_path_suffix
(Facultatif)

Suffixe utilisé pour construire le chemin d’accès à l’image en association avec l’attribut Image.

String
depth_image_path_prefix
(Facultatif)

Préfixe utilisé pour construire le chemin d’accès à l’image de profondeur en association avec l’attribut Depth Image.

String
depth_image_path_suffix
(Facultatif)

Suffixe utilisé pour construire le chemin d’accès à l’image de profondeur en association avec l’attribut Depth Image.

String
dem_path_prefix
(Facultatif)

Préfixe utilisé pour construire le chemin d’accès au MNE en association avec l’URL Elevation Source dans l’attribut.

String
dem_path_suffix
(Facultatif)

Suffixe utilisé pour construire le chemin d’accès au MNE en association avec l’URL Elevation Source dans l’attribut.

String

Sortie obtenue

NomExplicationType de données
out_oriented_imagery_dataset

Jeu de données d’imagerie orientée mis à jour.

Oriented Imagery Dataset

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction UpdateOrientedImageryDatasetProperties en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.UpdateOrientedImageryDatasetProperties(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset",
    maximum_distance=550,
    footprint_item='MyOrientedImageryDataset_footprint',
    image_path_prefix='None')
Exemple 2 d’utilisation de l’outil UpdateOrientedImageryDatasetProperties (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction UpdateOrientedImageryDatasetProperites dans un script autonome.

# Import system modules
import arcpy

# Set local variables
in_oi = "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset"
new_maximum_distance = 550
footprint = "MyOrientedImageryDataset_footprint"
new_time_unit = "HOURS"
new_camera_height = 2.5

# Run Update Oriented Imagery Dataset Properties
arcpy.oi.UpdateOrientedImageryDatasetProperties(
    in_oriented_imagery_dataset = in_oi,
    maximum_distance = new_maximum_distance,
    footprint_item = footprint,
    time_interval_unit = new_time_unit,
    camera_height = new_camera_height,
)

Environnements

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