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

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 GeoTIF 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.

Beschriftung	Erläuterung	Datentyp
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. Nur die Oberseiten der Objekte sind sichtbar. `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. `AeriaFrameVideo`—Video, das von einer Drohne oder einem Flugzeug aufgenommen wurde, wobei die Kamera nach unten auf den Boden gerichtet ist. `TerrestrialFrameVideo`—Videoaufnahmen, die mit Handgeräten wie Dashcams aufgenommen wurden. `Terrestrial360Video`—Ein 360-Grad-Video, das mit Geräten wie GoPro oder Insta360 aufgenommen wurde.	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 Eine `.csv`-Datei, die das Schema der FrameCamera-Tabelle verwendet. Mosaik-Datasets, die aus Luftbild-Raster-Typen erstellt wurden	Folder; Oriented Imagery Layer; Table; Raster Layer; File
Unterordner einbeziehen (Optional)	Gibt an, ob Unterordner rekursiv nach Daten 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 (`%value%`).	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 aus der Eingabetabelle mit Ausnahme des erforderlichen Schemas zur Attributtabelle des Datasets hinzugefügt werden. Aktiviert—Alle Felder aus der Eingabetabelle werden der Attributtabelle des Datasets hinzugefügt. Deaktiviert—Nur schemaspezifische Felder werden der Attributtabelle des Datasets hinzugefügt. Dies ist die Standardeinstellung.	Boolean
Eingabe-Videodatei (Optional)	Eine Videodatei, die in einem Speicherort einer öffentlichen Cloud gespeichert ist. Die Videodatei muss mit Standard-Webbrowsern kompatibel sein. Weitere Informationen zu den unterstützten Videotypen (Formate und Codecs) finden Sie unter Allgemeine Codecs. Bei `TerrestrialFrameVideo`- und `Terrestrial360Video`-Eingaben extrahiert das Werkzeug automatisch die Felder für die Position des Sensors und den Zeitstempel, sofern das Video gültige KLV-Metadaten enthält.	File
Metadaten-Datei (Optional)	Eine `.csv`-Datei, die die Metadaten des Videos enthält. Für `AerialFrameVideo` muss jedem Luftvideobild eine lokale `.csv`-Datei beigefügt sein, die für jedes Bild die folgenden Felder enthält: "Präzisionszeitstempel", "Breitengrad des Sensors", "Längengrad des Sensors", "Ellipsoid-Höhe des Sensors" oder "Echte Höhe des Sensors", "Kurs der Plattform", "Neigungswinkel der Plattform", "Rollwinkel der Plattform", "Relativer Rollwinkel des Sensors", "Relativer Höhenwinkel des Sensors", "Relativer Azimutwinkel des Sensors", "Horizontaler sichtbarer Bereich des Sensors" und "Vertikaler sichtbarer Bereich des Sensors" Alle Felder sind erforderlich und müssen gültige Werte enthalten. Für `TerrestrialFrameVideo` und `Terrestrial360Video` ist die `.csv`-Datei optional. Falls eine Datei beigefügt wird, muss diese lokal gespeichert sein und mindestens die folgenden Felder enthalten: XY und AcquisitionDate (im Format yyyy-mm-dd HH:MM:SS).	File
Mindest-Frame-Intervall (Optional)	Das erforderliche Mindestzeitintervall zwischen aufeinanderfolgenden Videobildern. Nur Bilder, deren Zeitabstand mindestens diesem Wert entspricht, werden zum Oriented Imagery-Dataset hinzugefügt. Der Standardwert ist 1 Sekunde.	Time Unit
Änderung der minimalen Sensorposition (Optional)	Die Mindestentfernung in Metern, um die sich der Sensor zwischen den Einzelbildern bewegen muss. Nur Bilder, bei denen sich die Sensorposition um mindestens diesen Wert verändert hat, werden zum Oriented Imagery-Dataset hinzugefügt.	Double
Minimale Rahmenüberlappung (Optional)	Die erforderliche Mindestüberlappung in Prozent zwischen aufeinanderfolgenden Bildern. Nur Bilder mit einer Überlappung, die größer ist als dieser Wert, werden zum Oriented Imagery-Dataset hinzugefügt. Der Standardwert ist 0. Damit dieser Parameter richtig angewendet wird, muss ein gültiger Wert für CameraHeading angegeben sein.	Double
Entfernung zur Berechnung der Überlappung (Optional)	Die Entfernung in Metern, die zur Berechnung der Bild-Footprints (Frustum) für Überlappungsberechnungen verwendet wird. Wird kein Wert angegeben, ist der Standardwert `FarDistance` / 2. Weitere Informationen zu `FarDistance` finden Sie unter Oriented Imagery-Tabellenfelder.	Double
Kurs berechnen (Optional)	Gibt an, ob vom Werkzeug CameraHeading-Werte generiert werden. Hinweis: Die Footprint-Berechnung schlägt fehl, wenn die `CameraHeading`-Werte fehlen. Aktiviert—Das Werkzeug generiert die `CameraHeading`-Werte. Diese berechneten Werte haben Vorrang, selbst wenn das Video bereits Werte für `CameraHeading` enthält. Deaktiviert—Das Werkzeug generiert die `CameraHeading`-Werte.	Boolean
Überschriftenversatz (Optional)	Ein Versatz, der auf `CameraHeading` angewendet wird, um die Aufstellungsposition der Kamera zu berücksichtigen. Dies ist nützlich, wenn die Kamera nicht nach vorne gerichtet ist, beispielsweise bei der Montage an der Seite eines Fahrzeugs. Der Standardwert ist 0.	Double

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisiertes Oriented Imagery-Dataset	Das aktualisierte Oriented Imagery-Dataset.	Oriented Imagery Layer

arcpy.oi.AddImagesToOrientedImageryDataset(in_oriented_imagery_dataset, imagery_category, input_data, {include_sub_folders}, {folder_filter}, {where_clause}, {include_all_fields}, {input_video_file}, {metadata_file}, {minimum_frame_interval}, {minimum_sensor_position_change}, {minimum_frame_overlap}, {distance_to_compute_overlap}, {compute_heading}, {heading_offset})

Name	Erläuterung	Datentyp
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. Nur die Oberseiten der Objekte sind sichtbar. `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. `AeriaFrameVideo`—Video, das von einer Drohne oder einem Flugzeug aufgenommen wurde, wobei die Kamera nach unten auf den Boden gerichtet ist. `TerrestrialFrameVideo`—Videoaufnahmen, die mit Handgeräten wie Dashcams aufgenommen wurden. `Terrestrial360Video`—Ein 360-Grad-Video, das mit Geräten wie GoPro oder Insta360 aufgenommen wurde.	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 Eine `.csv`-Datei, die das Schema der FrameCamera-Tabelle verwendet. Mosaik-Datasets, die aus Luftbild-Raster-Typen erstellt wurden	Folder; Oriented Imagery Layer; Table; Raster Layer; File
include_sub_folders (Optional)	Gibt an, ob Unterordner rekursiv nach Daten untersucht werden. `SUBFOLDERS`—Alle Unterordner werden rekursiv auf Daten untersucht. Dies ist die Standardeinstellung. `NOSUBFOLDERS`—Nur 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 (`%value%`).	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 aus der Eingabetabelle mit Ausnahme des erforderlichen Schemas zur Attributtabelle des Datasets hinzugefügt werden. `INCLUDE_ALL_FIELDS`—Alle Felder aus der Eingabetabelle werden der Attributtabelle des Datasets hinzugefügt. `NO_INCLUDE_ALL_FIELDS`—Nur schemaspezifische Felder werden der Attributtabelle des Datasets hinzugefügt. Dies ist die Standardeinstellung.	Boolean
input_video_file (Optional)	Eine Videodatei, die in einem Speicherort einer öffentlichen Cloud gespeichert ist. Die Videodatei muss mit Standard-Webbrowsern kompatibel sein. Weitere Informationen zu den unterstützten Videotypen (Formate und Codecs) finden Sie unter Allgemeine Codecs. Bei `TerrestrialFrameVideo`- und `Terrestrial360Video`-Eingaben extrahiert das Werkzeug automatisch die Felder für die Position des Sensors und den Zeitstempel, sofern das Video gültige KLV-Metadaten enthält.	File
metadata_file (Optional)	Eine `.csv`-Datei, die die Metadaten des Videos enthält. Für `AerialFrameVideo` muss jedem Luftvideobild eine lokale `.csv`-Datei beigefügt sein, die für jedes Bild die folgenden Felder enthält: "Präzisionszeitstempel", "Breitengrad des Sensors", "Längengrad des Sensors", "Ellipsoid-Höhe des Sensors" oder "Echte Höhe des Sensors", "Kurs der Plattform", "Neigungswinkel der Plattform", "Rollwinkel der Plattform", "Relativer Rollwinkel des Sensors", "Relativer Höhenwinkel des Sensors", "Relativer Azimutwinkel des Sensors", "Horizontaler sichtbarer Bereich des Sensors" und "Vertikaler sichtbarer Bereich des Sensors" Alle Felder sind erforderlich und müssen gültige Werte enthalten. Für `TerrestrialFrameVideo` und `Terrestrial360Video` ist die `.csv`-Datei optional. Falls eine Datei beigefügt wird, muss diese lokal gespeichert sein und mindestens die folgenden Felder enthalten: XY und AcquisitionDate (im Format yyyy-mm-dd HH:MM:SS).	File
minimum_frame_interval (Optional)	Das erforderliche Mindestzeitintervall zwischen aufeinanderfolgenden Videobildern. Nur Bilder, deren Zeitabstand mindestens diesem Wert entspricht, werden zum Oriented Imagery-Dataset hinzugefügt. Der Standardwert ist 1 Sekunde.	Time Unit
minimum_sensor_position_change (Optional)	Die Mindestentfernung in Metern, um die sich der Sensor zwischen den Einzelbildern bewegen muss. Nur Bilder, bei denen sich die Sensorposition um mindestens diesen Wert verändert hat, werden zum Oriented Imagery-Dataset hinzugefügt.	Double
minimum_frame_overlap (Optional)	Die erforderliche Mindestüberlappung in Prozent zwischen aufeinanderfolgenden Bildern. Nur Bilder mit einer Überlappung, die größer ist als dieser Wert, werden zum Oriented Imagery-Dataset hinzugefügt. Der Standardwert ist 0. Damit dieser Parameter richtig angewendet wird, muss ein gültiger Wert für CameraHeading angegeben sein.	Double
distance_to_compute_overlap (Optional)	Die Entfernung in Metern, die zur Berechnung der Bild-Footprints (Frustum) für Überlappungsberechnungen verwendet wird. Wird kein Wert angegeben, ist der Standardwert `FarDistance` / 2. Weitere Informationen zu `FarDistance` finden Sie unter Oriented Imagery-Tabellenfelder.	Double
compute_heading (Optional)	Gibt an, ob vom Werkzeug CameraHeading-Werte generiert werden. Hinweis: Die Footprint-Berechnung schlägt fehl, wenn die `CameraHeading`-Werte fehlen. `COMPUTE_HEADING`—Das Werkzeug generiert die `CameraHeading`-Werte. Diese berechneten Werte haben Vorrang, selbst wenn das Video bereits Werte für `CameraHeading` enthält. `NO_COMPUTE_HEADING`—Das Werkzeug generiert die `CameraHeading`-Werte.	Boolean
heading_offset (Optional)	Ein Versatz, der auf `CameraHeading` angewendet wird, um die Aufstellungsposition der Kamera zu berücksichtigen. Dies ist nützlich, wenn die Kamera nicht nach vorne gerichtet ist, beispielsweise bei der Montage an der Seite eines Fahrzeugs. Der Standardwert ist 0.	Double

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_oriented_imagery_dataset	Das aktualisierte Oriented Imagery-Dataset.	Oriented Imagery Layer

Codebeispiel

AddImagesToOrientedImageryDataset: Beispiel (Python-Fenster)

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

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

Umgebungen

Ausgabe-Koordinatensystem, Geographische Transformationen, Ausdehnung

Lizenzierungsinformationen

Basic: Nein
Standard: Ja
Advanced: Ja

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

Zusammenfassung

Verwendung

Parameter

Hinweis:

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen