Mosaik-Dataset-Eigenschaften festlegen (Data Management)
Zusammenfassung
Legt die Eigenschaften eines Mosaik-Datasets fest. Viele dieser Eigenschaften definieren die Standardwerte, die beim Anzeigen des Mosaik-Datasets verwendet werden oder geben an, wie es verwendet wird, wenn es als Image-Service veröffentlicht wird.
Verwendung
-
Mit diesem Werkzeug können Sie Mosaik-Dataset-Eigenschaften innerhalb einer Geoverarbeitungs- oder Python-Umgebung festlegen.
Syntax
| Parameter | Erläuterung | Datentyp |
in_mosaic_dataset |
Das Mosaik-Dataset, das seinen Eigenschaftensatz hat. | Mosaic Layer |
rows_maximum_imagesize (optional) |
Legen Sie die maximale Anzahl von Zeilen für das mosaikierte Bild fest, das vom Mosaik-Dataset für jede Anforderung generiert wird. Je höher Sie die Anzahl der Zeilen und Spalten für die maximale Bildgröße von Anforderungen festlegen, desto länger dauert es, das Mosaik zu verarbeiten. Die Erhöhung dieser Werte empfiehlt sich jedoch u. U., wenn Sie sehr große Plots mit hoher Auflösung drucken. Wenn zu niedrige Werte festgelegt werden, wird kein Bild angezeigt. Wenn Sie den Wert beispielsweise in 10 ändern, stehen im Anzeigefenster möglicherweise nur 10 Pixel oder weniger zur Anzeige des Bildes zur Verfügung. | Long |
columns_maximum_imagesize (optional) |
Legen Sie die maximale Anzahl von Spalten für das mosaikierte Bild fest, das vom Mosaik-Dataset für jede Anforderung generiert wird. Je höher Sie die Anzahl der Zeilen und Spalten für die maximale Bildgröße von Anforderungen festlegen, desto länger dauert es, das Mosaik zu verarbeiten. Die Erhöhung dieser Werte empfiehlt sich jedoch u. U., wenn Sie sehr große Plots mit hoher Auflösung drucken. Wenn zu niedrige Werte festgelegt werden, wird kein Bild angezeigt. Wenn Sie den Wert beispielsweise in 10 ändern, stehen im Anzeigefenster möglicherweise nur 10 Pixel oder weniger zur Anzeige des Bildes zur Verfügung. | Long |
allowed_compressions [allowed_compressions,...] (optional) |
Legen Sie die Eigenschaft "Zulässige Komprimierungsmethoden" des Mosaik-Datasets fest. Damit wird die Methode der Komprimierung definiert, die verwendet wird, um das mosaikierte Bild vom Computer zur Anzeige (oder vom Server zum Client) zu senden.
| String |
default_compression_type (optional) |
Legen Sie den Standardkomprimierungstyp fest. Die Standardkomprimierung muss in der Liste "Zulässige Komprimierungseinstellungen" festgelegt werden oder ist bereits in der Eigenschaft "Zulässige Komprimierungsmethoden" des Mosaik-Datasets festgelegt. | String |
JPEG_quality (optional) |
Legen Sie die Komprimierungsqualität fest, die verwendet wird, wenn JPEG-Komprimierung verwendet wird. Die Komprimierungsqualität liegt zwischen 1 und 100. Je höher der Wert, desto höher die Bildqualität und desto niedriger die Komprimierung. | Long |
LERC_Tolerance (optional) |
Geben Sie die LERC-Toleranz an, wenn die LERC-Komprimierungsmethode verwendet wird. Die Toleranz gibt den maximalen Fehlerwert an, der pro Pixel anwendbar ist (nicht den Durchschnitt für das Bild). Dieser Wert wird in den Einheiten des Mosaik-Datasets angegeben. Wenn z. B. der Fehler 10 cm beträgt und das Mosaik-Dataset in Meter angegeben ist, geben Sie 0.1 ein. LERC ist eine effiziente und verlustbehaftete Komprimierungsmethode, die für Daten mit großer Pixeltiefe empfohlen wird, beispielsweise Float-, 32-Bit-, 16-Bit und 12-Bit-Daten. Die LERC-Komprimierung erfolgt bei Float-Daten 5 bis 10-mal besser und 5 bis 10-mal schneller als LZ77. LERC ist zudem besser für Ganzzahlen geeignet. Wenn Ganzzahldaten verwendet werden und die Fehlergrenze auf 0,99 oder weniger festgelegt ist, wird LERC als verlustfreie Komprimierungsmethode betrachtet. | Double |
resampling_type (optional) |
Legen Sie die Standard-Resampling-Methode fest, die verwendet wird, um das mosaikierte Bild anzuzeigen.
| String |
clip_to_footprints (optional) |
Geben Sie an, ob Sie die Ausdehnung jedes Rasters auf seinen Footprint beschränken oder das ganze Raster verwenden möchten, um das mosaikierte Bild zu erstellen. In vielen Fällen stimmen das Raster und der Footprint überein. Wenn sie jedoch voneinander abweichen, können Sie angeben, ob das Raster ausgeschnitten werden soll oder nicht.
| Boolean |
footprints_may_contain_nodata (optional) | Geben Sie an, ob die Footprints des Mosaik-Datasets NoData-Pixel enthalten.
| Boolean |
clip_to_boundary (optional) |
Geben Sie an, ob Sie das Bild des Mosaik-Datasets auf die Grenze zuschneiden oder das ganze mosaikierte Bild anzeigen möchten. Oft stellt die Grenze das ganze Mosaik-Dataset dar; Sie können sie jedoch ändern, um einen Teil des Datasets auszuschließen.
| Boolean |
color_correction (optional) |
Wählen Sie aus, ob die Farbkorrektur aktiviert wird, die für das Mosaik-Dataset eingerichtet wurde.
| Boolean |
allowed_mensuration_capabilities [allowed_mensuration_capabilities,...] (optional) |
Wählen Sie die zulässigen Messfunktionen für dieses Mosaik-Dataset aus.
| String |
default_mensuration_capabilities (optional) |
Wählen Sie die Standardmessfunktionen für dieses Mosaik-Dataset aus. Der Standard muss in der Parameterliste "Zulässige Messfunktionen" festgelegt werden oder bereits in der Eigenschaft "Messfunktionen" des Mosaik-Datasets festgelegt worden sein. | String |
allowed_mosaic_methods [allowed_mosaic_methods,...] (optional) |
Wählen Sie aus, welche Mosaik-Methoden von diesem Mosaik-Dataset zugelassen werden. Das mosaikierte Bild kann aus einer Reihe von Eingabe-Rastern erstellt werden. Die Mosaik-Methode bestimmt, wie das mosaikierte Bild aus den verschiedenen Rastern im Mosaik-Dataset erstellt wird.
| String |
default_mosaic_method (optional) |
Wählen Sie die Mosaik-Methode für dieses Mosaik-Dataset aus. Der Standard muss in der Parameterliste "Zulässige Mosaik-Methoden" festgelegt werden oder ist bereits in der Eigenschaft "Zulässige Mosaik-Methoden" des Mosaik-Datasets festgelegt. | String |
order_field (optional) |
Wählen Sie das Standardfeld zum Sortieren von Rastern aus, wenn die Mosaik-Methode "ByAttribute" verwendet wird. Die Feldliste umfasst definitionsgemäß die Felder, die in der Attributtabelle enthalten, vom Typ Metadaten und ganzzahlig sind. Diese Liste kann folgende Elemente enthalten, ist aber nicht darauf beschränkt:
Wenn es sich um ein Zahlen- oder Datumsfeld handelt, dann muss der Parameter Sortierungsbasis festgelegt werden. Dieser Parameter wird nicht benötigt, wenn "ByAttribute" keine zulässige Mosaik-Methode ist. | String |
order_base (optional) |
Die Bilder werden anhand der Differenz zwischen diesem Wert oder den anderen im Sortierfeld der Attributtabelle sortiert. Wird das Attribut "Datum" verwendet, muss es eines der folgenden Formate aufweisen:
Dieser Parameter wird nicht benötigt, wenn "ByAttribute" keine zulässige Mosaik-Methode ist. | String |
sorting_order (optional) |
Wählen Sie aus, ob die Raster in aufsteigender oder absteigender Reihenfolge sortiert werden sollen.
Dieser Parameter wird nicht benötigt, wenn "ByAttribute" keine zulässige Mosaik-Methode ist. | Boolean |
mosaic_operator (optional) |
Wählen Sie aus, welcher Mosaikoperator zum Auflösen der überlappenden Zellen verwendet werden soll.
| String |
blend_width (optional) |
Definiert die Entfernung in Pixel (im Anzeigemaßstab), die vom Mosaikoperator "BLEND" verwendet wird. | Long |
view_point_x (optional) | Definiert einen X-Versatz, der verwendet wird, um zu berechnen, wo der Mittelpunkt der Anzeige ist. Dieser Wert wird in der Einheit des Raumbezugssystems des Mosaik-Datasets berechnet. Dieser Wert wird verwendet, wenn die Mosaik-Methode "Am nächsten zum Betrachtungspunkt" verwendet wird. | Double |
view_point_y (optional) | Definiert einen Y-Versatz, der verwendet wird, um zu berechnen, wo der Mittelpunkt der Anzeige ist. Dieser Wert wird in der Einheit des Raumbezugssystems des Mosaik-Datasets berechnet. Dieser Wert wird verwendet, wenn die Mosaik-Methode "Am nächsten zum Betrachtungspunkt" verwendet wird. | Double |
max_num_per_mosaic (optional) |
Die maximale Anzahl von Rastern, die zum Erstellen des mosaikierten Bildes verwendet werden können. | Long |
cell_size_tolerance (optional) |
Geben Sie den Toleranzfaktor der Zellengröße an. Der Toleranzfaktor muss größer oder gleich 0,0 sein. Ein Faktor von 0,1 bedeutet, dass alle LowPS-Werte, die 10 Prozent größer sind als die niedrigste Pixelgröße als gleich betrachtet werden. Dies gilt für Werkzeuge und Vorgänge, in denen Pixelgrößen (Zellgrößen) verwendet werden. | Double |
cell_size (optional) | Geben Sie die Ausgabe-Zellengröße an. Sie können einen Layer als Zellengrößenvorlage auswählen oder die tatsächliche Zellengröße angeben. Wenn Sie die Zellengröße angeben, können Sie einen einzelnen Wert für eine quadratische Zellengröße oder X- und Y-Werte für eine rechteckige Zellengröße angeben. | Cell Size XY |
metadata_level (optional) |
Wählen Sie die Ebene der Metadaten aus, die vom Server zu einem Client bereitzustellen ist, wenn Sie das Mosaik-Dataset veröffentlichen.
| String |
transmission_fields [transmission_fields,...] (optional) |
Wählen Sie die Felder aus, auf die Benutzer zugreifen können. Diese Liste kann Felder einschließen, die der Attributtabelle des Mosaik-Datasets nicht standardmäßig hinzugefügt werden. Standardmäßig schließt die Liste ein:
| String |
use_time (optional) |
Geben Sie an, ob für das Mosaik-Dataset Zeiteigenschaften aktiviert werden sollen. Wenn Zeit aktiviert wird, dann müssen Sie die Start- und Endfelder und das Zeitformat angeben.
| Boolean |
start_time_field (optional) |
Geben Sie das Feld in der Attributtabelle an, das als Startzeit verwendet werden soll. | String |
end_time_field (optional) |
Geben Sie das Feld in der Attributtabelle an, das als Endzeit verwendet werden soll. | String |
time_format (optional) |
Geben Sie das Format für das Zeitfeld ein.
| String |
geographic_transform [geographic_transform,...] (optional) |
Wählen Sie aus, welche geographischen Transformationen mit diesem Mosaik-Dataset verknüpft sind. | String |
max_num_of_download_items (optional) |
Wählen Sie die maximale Anzahl von Elementen aus, die pro Anforderung heruntergeladen werden können. | Long |
max_num_of_records_returned (optional) |
Wählen Sie die maximale Anzahl an zurückgegebenen Datensätzen pro Anforderung aus. | Long |
Codebeispiel
Dies ist ein Python-Beispiel für "SetMosaicDatasetProperties".
import arcpy
arcpy.SetMosaicDatasetProperties_management("c:/workspace/mdproperties.gdb/md", "", "", "",
"", "", "", "", "", "", "", "", "",
"", "", "", "", "", "", "", "", "",
"", "", "", "0.2", "BASIC",
"NAME;MINPS;MAXPS;GROUPNAME;PRODUCTNAME;ZORDER;YEARS;YEARE",
"ENABLED", "YEARS", "YEARE", "YYYYMM",
"NAD_1983_HARN_To_WGS_1984_2", "10", "500")
Dies ist ein Python-Skriptbeispiel für "SetMosaicDatasetProperties".
#===========================
#Set Mosaic Dataset Properties
'''Usage: SetMosaicDatasetProperties_management(in_mosaic_dataset, {rows_maximum_imagesize},
{columns_maximum_imagesize}, {None | JPEG | LZ77 | LERC},
{None | JPEG | LZ77 | LERC}, {JPEG_quality},
{LERC_Tolerance}, {BILINEAR | NEAREST |
CUBIC | MAJORITY}, {NOT_CLIP | CLIP},
{FOOTPRINTS_MAY_CONTAIN_NODATA | FOOTPRINTS_DO_NOT_CONTAIN_NODATA},
{CLIP | NOT_CLIP}, {NOT_APPLY | APPLY},
{Basic | Base-Top Height | Base-Top Shadow Height |
Top-Top Shadow Height | 3D}, {Basic | Base-Top Height |
Base-Top Shadow Height | Top-Top Shadow Height | 3D},
{Center | NorthWest | LockRaster | ByAttribute |
Nadir | Viewpoint | Seamline | None}, {Center |
NorthWest | LockRaster | ByAttribute | Nadir |
Viewpoint | Seamline | None}, {Name | MinPS |
MaxPS | LowPS | HighPS | Tag | GroupName |
ProductName | CenterX | CenterY | ZOrder |
SOrder | Shape_Length | Shape_Area}, {order_base},
{ASCENDING | DESCENDING}, {FIRST | LAST | MIN |
MAX | MEAN | BLEND}, {blend_width}, {view_point_x},
{view_point_y}, {max_num_per_mosaic},
{cell_size_tolerance}, {cell_size}, {FULL | NONE | BASIC},
{transmission_fields;transmission_fields...},
{DISABLED | ENABLED}, {start_time_field},
{end_time_field}, {YYYY | YYYYMM | YYYY/MM |
YYYY-MM | YYYYMMDD | YYYY/MM/DD | YYYY-MM-DD |
YYYYMMDDhhmmss | YYYY/MM/DD hh:mm:ss |
YYYY-MM-DD hh:mm:ss | YYYYMMDDhhmmss.s |
YYYY/MM/DD hh:mm:ss.s | YYYY-MM-DD hh:mm:ss.s},
{geographic_transform;geographic_transform...},
{max_num_of_download_items}, {max_num_of_records_returned})
'''
try:
import arcpy
arcpy.env.workspace = "C:/Workspace"
#Set mosaic dataset imagery properties group
arcpy.SetMosaicDatasetProperties_management("mdproperties.gdb/md", "525340", "3909809",
"None;JPEG", "JPEG", "85", "0.5", "CUBIC", "CLIP",
"FOOTPRINTS_MAY_CONTAIN_NODATA", "NOT_CLIP",
"APPLY", "Base-Top Height;Top-Top Shadow Height",
"Base-Top Height")
#Set mosaic dataset mosaic properties group
arcpy.SetMosaicDatasetProperties_management("mdproperties.gdb/md", "", "", "",
"", "", "", "", "", "", "", "", "", "",
"NorthWest;LockRaster;ByAttribute;Seamline",
"ByAttribute", "ZORDER", "3",
"DESCENDING", "BLEND", "10", "200",
"100", "40", "0.2")
#Set mosaic dataset catalog properties group
arcpy.SetMosaicDatasetProperties_management("mdproperties.gdb/md", "", "", "", "",
"", "", "", "", "", "", "", "", "",
"", "", "", "", "", "", "", "", "",
"", "", "1", "BASIC", "NAME;MINPS;MAXPS;GROUPNAME;PRODUCTNAME;ZORDER;YEARS;YEARE",
"ENABLED", "YEARS", "YEARE", "YYYYMM",
"NAD_1983_HARN_To_WGS_1984_2", "10", "500")
except:
print "Set Mosaic Dataset example failed."
print arcpy.GetMessages()