Bilder zu Oriented Imagery-Dataset hinzufügen (Oriented Imagery)

Zusammenfassung

Fügt dem Oriented Imagery-Dataset Bilder aus mehreren Eingabequellen, wie beispielsweise einer Datei, einem Ordner, einer Tabelle, einer Liste mit Bildpfaden oder einem Punkt-Feature-Layer, hinzu.

Verwendung

  • Die hinzugefügten Bilder werden nicht vom Oriented Imagery-Dataset verwaltet. Das Dataset verweist auf den Speicherort der Bilder. Gelöschte oder verschobene Bilder werden nicht in den Oriented Imagery-Viewer geladen.

  • Die zum Laden der Daten in das Oriented Imagery-Dataset erforderlichen Metadaten werden vom Werkzeug auf der Grundlage des Wertes des Parameters Eingabedaten identifiziert. Die Oriented Imagery-Funktionen sind von den Metadateninformationen abhängig.

  • Alle Eingabedaten-Optionen unterstützen das JPEG-Format. In den folgenden Fällen müssen die Bilder unter Verwendung einer .csv-Datei, die dem Schema der Oriented Imagery-Tabelle entspricht, eines Feature-Layers, der dem Schema der Oriented Imagery-Attributtabelle entspricht, oder eines Oriented Imagery-Layers hinzugefügt werden:

    • Das Bildformat lautet TIF oder MRF.
    • Die Bildmetadaten sind getrennt von den Bilddateien gespeichert oder müssen vor dem Hinzufügen bearbeitet werden.
    • Sie fügen die Kameraausrichtung hinzu, um genauere Bild-zu-Boden- und Boden-zu-Bild-Transformationen zu ermöglichen.

  • Wenn die Daten direkt aus Bilddateien, einem Ordner mit Bildern oder einer Textdatei mit einer Liste der Bildpfade hinzugefügt werden, werden die Metadateninformationen aus den EXIF- und XMP-Daten des Bildes extrahiert. Die EXIF-Daten müssen mindestens Angaben zur geographischen Position enthalten.

Parameter

BeschriftungErläuterungDatentyp
Oriented Imagery-Dataset

Der Pfad und der Name des Oriented Imagery-Datasets, dem die Bilder hinzugefügt werden.

Oriented Imagery Layer
Bilddatenkategorie

Gibt den Typ der verwendeten Eingabebilder an, und legt die Standardeigenschaften des Oriented Imagery-Datasets fest. Die Standardeigenschaft wird verwendet, wenn das entsprechende Attribut nicht in der Attributtabelle des Oriented Imagery-Datasets gefunden wird.

  • Horizontal: Es werden Bilder verwendet, die parallel zum Boden mit Blick auf den Horizont aufgenommen wurden.
  • Oblique: Es werden Bilder verwendet, die in einem Winkel von typischerweise etwa 45 Grad zum Boden aufgenommen wurden, sodass die Seiten von Objekten zu sehen sind.
  • Nadir: Es werden Bilder verwendet, die senkrecht zum Boden mit gerade nach unten verlaufendem Blick aufgenommen wurden. Es ist nur die Oberseite der Objekte zu sehen.
  • 360: Es werden Bilder verwendet, die mit Spezialkameras aufgenommen wurden, die sphärische 360-Grad-Rundumsichten ermöglichen, oder die von Aufnahmen mehrerer Kameras zu 360-Grad-Ansichten zusammengefügt wurden.
  • Inspection: Es werden Nahaufnahmen von weniger als 5 Meter von der Kamera entfernten Objekten verwendet.
String
Eingabedaten

Der Pfad und der Name der Eingabedaten. Folgendes wird unterstützt:

  • Ein oder mehrere Bilder im JPEG-Format.
  • Ein Ordner mit Bildern. Dem Dataset werden nur JPEG-Bilder aus dem Ordner hinzugefügt.
  • Eine .txt-Datei mit JPEG-Bildpfaden. Jeder Bildpfad muss in einer separaten Zeile angegeben werden.
  • Eine .csv-Datei, die das Schema der Oriented Imagery-Tabelle verwendet.
  • Ein Feature-Layer, der das Schema der Oriented Imagery-Attributtabelle verwendet.
  • Ein Oriented Imagery-Layer

Folder; Oriented Imagery Layer; Table; Raster Layer; File
Unterordner einbeziehen
(optional)

Gibt an, ob Unterordner rekursiv untersucht werden.

  • Aktiviert: Alle Unterordner werden rekursiv auf Daten untersucht. Dies ist die Standardeinstellung.
  • Deaktiviert: Nur der Ordner der obersten Ebene wird auf Daten untersucht.
Boolean
Eingabeordnerfilter
(optional)

Ein Ausdruck, der zum Filtern und Hinzufügen von Bildern in den Eingabeordner verwendet wird.

Um beispielsweise nur Bilder hinzuzufügen, die eine bestimmte Zeichenfolge enthalten, fügen Sie vor und nach dem Zeichenfolgenwert Prozentzeichen ein (%Wert%).

String
Eingabetabellenfilter
(optional)

Ein SQL-Ausdruck, mit dem eine Teilmenge der Datensätze ausgewählt wird. Weitere Informationen zur SQL-Syntax finden Sie unter SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke.

SQL Expression
Alle Felder der Eingabetabelle einbeziehen
(optional)

Gibt an, ob alle Felder der Eingabetabelle mit Ausnahme des erforderlichen Schemas zur Attributtabelle des Datasets hinzugefügt werden.

Deaktiviert: Nur schemaspezifische Felder werden der Attributtabelle des Datasets hinzugefügt. Dies ist die Standardeinstellung.

Aktiviert: Alle Felder der Eingabetabelle werden der Attributtabelle des Datasets hinzugefügt.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisiertes Oriented Imagery-Dataset

Das aktualisierte Oriented Imagery-Dataset.

Oriented Imagery Layer

arcpy.management.AddImagesToOrientedImageryDataset(in_oriented_imagery_dataset, imagery_category, input_data, {include_sub_folders}, {folder_filter}, {where_clause}, {include_all_fields})
NameErläuterungDatentyp
in_oriented_imagery_dataset

Der Pfad und der Name des Oriented Imagery-Datasets, dem die Bilder hinzugefügt werden.

Oriented Imagery Layer
imagery_category

Gibt den Typ der verwendeten Eingabebilder an, und legt die Standardeigenschaften des Oriented Imagery-Datasets fest. Die Standardeigenschaft wird verwendet, wenn das entsprechende Attribut nicht in der Attributtabelle des Oriented Imagery-Datasets gefunden wird.

  • Horizontal: Es werden Bilder verwendet, die parallel zum Boden mit Blick auf den Horizont aufgenommen wurden.
  • Oblique: Es werden Bilder verwendet, die in einem Winkel von typischerweise etwa 45 Grad zum Boden aufgenommen wurden, sodass die Seiten von Objekten zu sehen sind.
  • Nadir: Es werden Bilder verwendet, die senkrecht zum Boden mit gerade nach unten verlaufendem Blick aufgenommen wurden. Es ist nur die Oberseite der Objekte zu sehen.
  • 360: Es werden Bilder verwendet, die mit Spezialkameras aufgenommen wurden, die sphärische 360-Grad-Rundumsichten ermöglichen, oder die von Aufnahmen mehrerer Kameras zu 360-Grad-Ansichten zusammengefügt wurden.
  • Inspection: Es werden Nahaufnahmen von weniger als 5 Meter von der Kamera entfernten Objekten verwendet.
String
input_data
[input_data,...]

Der Pfad und der Name der Eingabedaten. Folgendes wird unterstützt:

  • Ein oder mehrere Bilder im JPEG-Format.
  • Ein Ordner mit Bildern. Dem Dataset werden nur JPEG-Bilder aus dem Ordner hinzugefügt.
  • Eine .txt-Datei mit JPEG-Bildpfaden. Jeder Bildpfad muss in einer separaten Zeile angegeben werden.
  • Eine .csv-Datei, die das Schema der Oriented Imagery-Tabelle verwendet.
  • Ein Feature-Layer, der das Schema der Oriented Imagery-Attributtabelle verwendet.
  • Ein Oriented Imagery-Layer

Folder; Oriented Imagery Layer; Table; Raster Layer; File
include_sub_folders
(optional)

Gibt an, ob Unterordner rekursiv untersucht werden.

  • SUBFOLDERSAlle Unterordner werden rekursiv auf Daten untersucht. Dies ist die Standardeinstellung.
  • NOSUBFOLDERSNur der Ordner der obersten Ebene wird auf Daten untersucht.
Boolean
folder_filter
(optional)

Ein Ausdruck, der zum Filtern und Hinzufügen von Bildern in den Eingabeordner verwendet wird.

Um beispielsweise nur Bilder hinzuzufügen, die eine bestimmte Zeichenfolge enthalten, fügen Sie vor und nach dem Zeichenfolgenwert Prozentzeichen ein (%Wert%).

String
where_clause
(optional)

Ein SQL-Ausdruck, mit dem eine Teilmenge der Datensätze ausgewählt wird. Weitere Informationen zur SQL-Syntax finden Sie unter SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke.

SQL Expression
include_all_fields
(optional)

Gibt an, ob alle Felder der Eingabetabelle mit Ausnahme des erforderlichen Schemas zur Attributtabelle des Datasets hinzugefügt werden.

  • NO_INCLUDE_ALL_FIELDSNur schemaspezifische Felder werden der Attributtabelle des Datasets hinzugefügt. Dies ist die Standardeinstellung.
  • INCLUDE_ALL_FIELDSAlle Felder der Eingabetabelle werden der Attributtabelle des Datasets hinzugefügt.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_oriented_imagery_dataset

Das aktualisierte Oriented Imagery-Dataset.

Oriented Imagery Layer

Codebeispiel

AddImagesToOrientedImageryDataset: Beispiel1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion AddImagesToOrientedImageryDataset im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.AddImagesToOrientedImageryDataset(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset", 
    imagery_category="Oblique",
    input_data='C:/OrientedImageryExample/Samples/img1.jpg;C:/OrientedImageryExample/Samples/img2.jpg')