Задать свойства набора данных мозаики (Set Mosaic Dataset Properties) (Управление данными)

Уровень лицензии:BasicStandardAdvanced

Резюме

Устанавливает свойства набора данных мозаики. Многие из этих свойств определяют значения по умолчанию, используемые при отображении набора данных мозаики, а также способ использования этого набора при публикации в качестве сервиса изображений.

Использование

Синтаксис

SetMosaicDatasetProperties_management (in_mosaic_dataset, {rows_maximum_imagesize}, {columns_maximum_imagesize}, {allowed_compressions}, {default_compression_type}, {JPEG_quality}, {LERC_Tolerance}, {resampling_type}, {clip_to_footprints}, {footprints_may_contain_nodata}, {clip_to_boundary}, {color_correction}, {allowed_mensuration_capabilities}, {default_mensuration_capabilities}, {allowed_mosaic_methods}, {default_mosaic_method}, {order_field}, {order_base}, {sorting_order}, {mosaic_operator}, {blend_width}, {view_point_x}, {view_point_y}, {max_num_per_mosaic}, {cell_size_tolerance}, {cell_size}, {metadata_level}, {transmission_fields}, {use_time}, {start_time_field}, {end_time_field}, {time_format}, {geographic_transform}, {max_num_of_download_items}, {max_num_of_records_returned})
ПараметрОбъяснениеТип данных
in_mosaic_dataset

Набор данных мозаики, свойства которого будут установлены.

Mosaic Layer
rows_maximum_imagesize
(дополнительно)

Установите максимальное количество строк для изображения мозаики, созданного набором данных мозаики для каждого запроса.

При увеличении количества строк и столбцов для параметра Максимальный размер изображения запросов (Maximum Image Size of Requests) будет увеличиваться время, необходимое для обработки мозаики. Однако вы можете увеличить эти числа, если вы распечатываете очень большие изображения большого разрешения. Если вы сделаете эти числа слишком маленькими, изображение может не отображаться. Например, если изменить эти числа на 10, окно отображения изображения будет иметь размер всего 10 пикселов или меньше.

Long
columns_maximum_imagesize
(дополнительно)

Установите максимальное количество столбцов для изображения мозаики, создаваемого набором данных мозаики для каждого запроса.

При увеличении количества строк и столбцов для параметра Максимальный размер изображения запросов (Maximum Image Size of Requests) будет увеличиваться время, необходимое для обработки мозаики. Однако вы можете увеличить эти числа, если вы распечатываете очень большие изображения большого разрешения. Если вы сделаете эти числа слишком маленькими, изображение может не отображаться. Например, если изменить эти числа на 10, окно отображения изображения будет иметь размер всего 10 пикселов или меньше.

Long
allowed_compressions
[allowed_compressions,...]
(дополнительно)

Установите свойство Допустимые методы сжатия (Allowed Compression Methods) набора данных мозаики, с помощью которого определяется метод сжатия, используемый для передачи изображения мозаики с компьютера на экран (или с сервера клиенту).

  • Нет сжатия (NONE)Сжатие не используется.
  • JPEGБудет использоваться метод сжатия JPEG.
  • LZWБудет использоваться метод сжатия LZW.
  • LERCБудет использоваться метод сжатия растров LERC.
String
default_compression_type
(дополнительно)

Установите метод сжатия по умолчанию. Метод сжатия по умолчанию должен находиться в списке допустимых методов сжатия (allowed_compressions) или быть уже установленным в свойстве Допустимые методы сжатия (Allowed Compression Methods) набора данных мозаики.

String
JPEG_quality
(дополнительно)

Установите качество сжатия, которое будет использоваться при сжатии JPEG. Качество сжатия может находиться в диапазоне от 1 до 100. Большее число означает лучшее качество изображения, но меньшую степень сжатия.

Long
LERC_Tolerance
(дополнительно)

Если выбран метод сжатия LERC, необходимо указать допуск LERC. Допуск представляет собой максимальную ошибку для одного пиксела (а не среднюю ошибку для всего изображения). Это значение измеряется в единицах набора данных мозаики. Например, если ошибка равна 10 см, а единицы измерения набора данных мозаики – метры, введите 0.1.

LERC – это эффективный метод сжатия с потерями, который рекомендуется применять для данных с большой глубиной пиксела, в частности, для 32-битных, 16-битных и 12-битных изображений, а также изображений, в которых глубина пиксела имеет тип данных с плавающей точкой. Метод LERC в 5–10 раз эффективнее и в 5–10 раз быстрее метода LZ77 при работе с данными с плавающей точкой. LERC также лучше работает с целочисленными данными.

При использовании целочисленных данных, если установлен предел ошибки 0,99 или менее, метод LERC рассматривается как сжатие без потерь.

Double
resampling_type
(дополнительно)

Установите метод пересчета по умолчанию, используемый для отображения изображения мозаики.

  • Ближайший (NEAREST)Для пересчета будет использоваться метод ближайшего соседа.
  • Билинейный (BILINEAR)Для пересчета будет использоваться метод билинейной интерполяции.
  • Кубический (CUBIC)Для пересчета будет использоваться метод кубической свертка.
  • Большинство (MAJORITY)Для пересчета будет использоваться метод большинства.
String
clip_to_footprints
(дополнительно)

Укажите, необходимо ли ограничить экстент каждого растра его контуром или использовать весь растр для создания изображения мозаики. Растр и контур часто являются одинаковыми, но если они отличаются, вы можете указать, следует ли вырезать растр.

  • NOT_CLIPНе вырезать растр по контуру. Это значение используется по умолчанию.
  • CLIPВырезать растры по контуру.
Boolean
footprints_may_contain_nodata
(дополнительно)

Указывает, содержат ли контуры набора данных мозаики пикселы NoData.

  • FOOTPRINTS_MAY_CONTAIN_NODATAКонтуры содержат пикселы NoData. Включите эту опцию, чтобы избежать пробелов в наборе данных мозаики. Это значение используется по умолчанию.
  • FOOTPRINTS_DO_NOT_CONTAIN_NODATAКонтуры не содержат пикселов NoData. Установка этого значения может дать некоторые преимущества в плане производительности. Однако при наличии в контурах пикселов NoData, в наборе данных мозаики появятся пробелы.
Boolean
clip_to_boundary
(дополнительно)

Укажите, следует ли вырезать изображение набора данных мозаики по границе или отображать изображение мозаики полностью. Часто граница представляет весь набор данных мозаики. Но вы можете изменить ее, чтобы исключить часть набора данных.

  • CLIP Вырезать изображение мозаики по границе. Это значение используется по умолчанию.
  • NOT_CLIPНе вырезать изображение мозаики по границе.
Boolean
color_correction
(дополнительно)

Выберите, требуется ли включать цветовую коррекцию, которая была настроена для набора данных мозаики.

  • NOT_APPLYЦветовая коррекция выключена. Это значение используется по умолчанию.
  • APPLYИспользовать цветовую коррекцию, которая была настроена для набора данных мозаики.
Boolean
allowed_mensuration_capabilities
[allowed_mensuration_capabilities,...]
(дополнительно)

Выберите допустимые функции измерения для этого набора данных мозаики.

  • BasicДопускаются вычисления расстояния, точки, центроида и площади.
  • Высота от основания до верха (Base-Top Height)Допускается измерение высоты от основания до верха. Для выполнения измерений Высота от основания до верха (Base-Top Height) необходима информация о коэффициентах рационального многочлена (RPC).
  • Высота от основания до верхней точки тени (Base-Top Shadow Height)Допускается измерение высоты от основания до верхней точки тени. Для выполнения измерений Высота от основания до верхней точки тени (Base-Top Shadow Height) требуется информация об азимуте и высоте солнца.
  • Высота от вершины до верхней точки тени (Top-Top Shadow Height)Допускается измерение высоты от вершины до верхней точки тени. Для выполнения этого измерения требуется информация о коэффициентах рационального многочлена (RPC), азимуте и высоте солнца.
  • 3DИзмерения 3D допускаются, когда доступен параметр DEM.
String
default_mensuration_capabilities
(дополнительно)

Выберите функцию измерения по умолчанию для этого набора данных мозаики. Функция по умолчанию должна быть установлена в списке параметров допустимых функций измерения (allowed_mensuration_capabilities) или быть уже установленной в свойстве Функции измерения (Mensuration Capabilities) набора данных мозаики.

String
allowed_mosaic_methods
[allowed_mosaic_methods,...]
(дополнительно)

Выберите, какие методы мозаики допускаются этим набором данных мозаики. Изображение мозаики может быть создано из ряда входных растров. Метод мозаики определяет способ создания мозаичного изображения из разных растров в наборе данных мозаики.

  • Выравнивание по центруПозволяет сортировать растры на основе порядка по умолчанию, при котором растры, центры которых находятся ближе к центру просмотра, располагаются наверху.
  • Северо-западПозволяет сортировать растры независимо от обзора; при этом растры с центрами на северо-западе отображаются сверху.
  • Зафиксировать растр (LockRaster)Позволяет пользователю фиксировать отображение одного или нескольких растров в зависимости от значения ObjectID.
  • По атрибуту (ByAttribute)Позволяет сортировать растры на основе определенного атрибута метаданных и его отличия от базового значения.
  • Надир (Nadir)Позволяет сортировать растры по расстоянию между положением надира и центром вида. Этот метод сходен с методом Ближайшие к центру (Closest to Center), но использует точку надира к растру, которое может отличаться от центра, особенно для изображения косой.
  • Точка обзораПозволяет сортировать растры на основе определенного пользователем местоположения и местоположения надира для растров с помощью инструмента Точка обзора (Viewpoint).
  • Линия сшивкиВырезает растры с помощью предопределенной формы линии сшивки для каждого растра с дополнительным размытием изображения вдоль швов. Порядок предопределяется в процессе создания линий сшивки. Некорректно использовать оператор мозаики LAST с этим методом мозаики.
  • НетРасполагает растры на основании порядкового значения (ObjectID) в таблице атрибутов набора данных мозаики.
String
default_mosaic_method
(дополнительно)

Выберите метод мозаики по умолчанию для этого набора данных мозаики. Метод мозаики по умолчанию должен устанавливаться в списке параметров допустимых методов мозаики (allowed_mosaic_methods) или быть уже установленным в свойстве Допустимые методы мозаики (Allowed Mosaic Methods) набора данных мозаики.

String
order_field
(дополнительно)

Выберите поле по умолчанию для использования при расположении растров с помощью метода По атрибуту (By Attribute). Перечень полей определяется как список полей в таблице атрибутов, которые относятся к типу метаданных и являются целыми числами. Этот список может включать, кроме прочего, следующие элементы:

  • Имя (Name)
  • MinPS
  • MaxPS
  • LowPS
  • HighPS
  • Тег
  • GroupName
  • ProductName
  • CenterX
  • CenterY
  • ZOrder
  • Shape_Length
  • Shape_Area

Если поле является числовым или полем даты, необходимо установить параметр Базовый порядок (Base Order).

Этот параметр не нужен, если метод По атрибуту (By Attribute) не является допустимым методом мозаики.

String
order_base
(дополнительно)

Изображения сортируются на основе разницы между этим значением или другими значениями в Поле порядка (Order Field) таблицы атрибутов.

Если используется атрибут Дата (Date), он должен быть в одном из перечисленных ниже форматов.

  • ГГГГ/ММ/ДД ЧЧ:мм:сс.с
  • ГГГГ/ММ/ДД ЧЧ:мм:сс
  • ГГГГ/ММ/ДД ЧЧ:мм
  • ГГГГ/ММ/ДД ЧЧ
  • ГГГГ/ММ/ДД
  • ГГГГ/ММ
  • ГГГГ

Этот параметр не нужен, если метод По атрибуту (By Attribute) не является допустимым методом мозаики.

String
sorting_order
(дополнительно)

Выберите, следует ли сортировать растры в порядке возрастания или убывания.

  • ASCENDINGИспользовать для растров порядок по возрастанию. Это установка по умолчанию.
  • DESCENDINGИспользовать для растров порядок по убыванию.

Этот параметр не нужен, если метод По атрибуту (By Attribute) не является допустимым методом мозаики.

Boolean
mosaic_operator
(дополнительно)

Выберите, какой оператор мозаики необходимо использовать для разрешения перекрывающихся ячеек.

  • FIRSTПерекрывающиеся области будут содержать ячейки из первого набора растровых данных, перечисленного в источнике.
  • LASTПерекрывающиеся области будут содержать ячейки из последнего набора растровых данных, перечисленного в источнике.
  • MINПерекрывающиеся области будут содержать минимальные значения ячеек из всех перекрывающихся ячеек.
  • MAXПерекрывающиеся области будут содержать максимальные значения ячеек из всех перекрывающихся ячеек.
  • MEANПерекрывающиеся области будут содержать средние значения ячеек из всех перекрывающихся ячеек.
  • BLENDПерекрывающимися областями будет слияние значений ячеек, которые перекрываются по краю каждого набора растровых данных в изображении мозаики. По умолчанию край определяется контуром или линией сшивки для каждого растра.
String
blend_width
(дополнительно)

Определяет расстояние в пикселах (в масштабе отображения), используемое оператором мозаики Смешивание (Blend).

Long
view_point_x
(дополнительно)

Определяет x-смещение, используемое для вычисления центра отображения. Это значение вычисляется в единицах системы пространственной привязки набора данных мозаики.

Это значение будет применяться при использовании метода мозаики Ближайший к точке обзора (Closest to Viewpoint).

Double
view_point_y
(дополнительно)

Определяет y-смещение, используемое для вычисления центра отображения. Это значение вычисляется в единицах системы пространственной привязки набора данных мозаики.

Это значение будет применяться при использовании метода мозаики Ближайший к точке обзора (Closest to Viewpoint).

Double
max_num_per_mosaic
(дополнительно)

Максимальное количество растров, которое можно использовать для создания мозаичного изображения.

Long
cell_size_tolerance
(дополнительно)

Укажите коэффициент допуска размера ячейки. Коэффициент допуска должен быть больше или равен нулю.

Коэффициент 0,1 означает, что все значения LowPS, которые на 10 процентов больше наименьшего размера в пикселах, считаются одинаковыми для инструментов и операций, в которых используются размеры в пикселах (ячейках).

Double
cell_size
(дополнительно)

Укажите размер выходной ячейки. В качестве шаблона размера ячейки можно выбрать слой или задать фактический размер ячейки. Если указывается размер ячейки, можно использовать одно значение квадратных ячеек либо значения X и Y для прямоугольных ячеек.

Cell Size XY
metadata_level
(дополнительно)

Выберите уровень метаданных, которые будут показываться с сервера клиенту при публикации набора данных мозаики.

  • FULLБудут перенесены все метаданные, включая основную информацию о наборе растровых данных и сведения о последовательности функций. Это значение используется по умолчанию.
  • Нет сжатия (NONE)Метаданные не будут показаны клиенту.
  • BASICБудет перенесен уровень информации набора растровых данных, например информация о столбцах и строках, размере ячеек и пространственной привязке.
String
transmission_fields
[transmission_fields,...]
(дополнительно)

Выберите поля, к которым пользователи могут получать доступ. Этот список может содержать поля, которые не добавляются по умолчанию в таблицу атрибутов набора данных мозаики. По умолчанию список содержит следующие элементы:

  • Имя (Name)
  • MinPS
  • MaxPS
  • LowPS
  • HighPS
  • Тег
  • GroupName
  • ProductName
  • CenterX
  • CenterY
  • ZOrder
  • Shape_Length
  • Shape_Area

String
use_time
(дополнительно)

Укажите, будет ли этот набор данных мозаики содержать данные времени. Если время активируется, вам необходимо указать начальное и конечное поля, а также формат времени.

  • ОтключеноНабор данных мозаики не будет содержать данные времени. Это значение используется по умолчанию.
  • ОтмеченоНабор данных мозаики будет содержать данные времени. Это позволяет клиенту использовать бегунок времени.
Boolean
start_time_field
(дополнительно)

Укажите поле в таблице атрибутов, которое будет использоваться в качестве времени начала.

String
end_time_field
(дополнительно)

Укажите поле в таблице атрибутов, которое будет использоваться в качестве времени окончания.

String
time_format
(дополнительно)

Задайте формат поля времени.

  • ГГГГГод
  • ГГГГММГод и месяц
  • ГГГГ/ММГод и месяц
  • ГГГГ-ММГод и месяц
  • ГГГГММДДГод, месяц и день
  • ГГГГ/ММ/ДДГод, месяц и день
  • ГГГГ-ММ-ДДГод, месяц и день
  • ГГГГММДДччммссГод, месяц, день, часы, минуты и секунды
  • ГГГГ/ММ/ДД чч:мм:ссГод, месяц, день, часы, минуты и секунды
  • ГГГГ-ММ-ДД чч:мм:ссГод, месяц, день, часы, минуты и секунды
  • ГГГГММДДччммсс.сГод, месяц, день, часы, минуты, секунды и доли секунды
  • ГГГГ/ММ/ДД чч:мм:сс.сГод, месяц, день, часы, минуты, секунды и доли секунды
  • ГГГГ-ММ-ДД чч:мм:сс.сГод, месяц, день, часы, минуты, секунды и доли секунды
String
geographic_transform
[geographic_transform,...]
(дополнительно)

Выберите, какие географические преобразования связаны с этим набором данных мозаики.

String
max_num_of_download_items
(дополнительно)

Выберите максимальное количество элементов, которые можно загрузить по запросу.

Long
max_num_of_records_returned
(дополнительно)

Выберите максимальное количество записей, возвращаемых по запросу.

Long

Пример кода

SetMosaicDatasetProperties Пример 1 (окно Python)

Это пример Python для инструмента Задать свойства набора данных мозаики (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")
SetMosaicDatasetProperties Пример 2 (автономный скрипт)

Это пример скрипта Python для инструмента Задать свойства набора данных мозаики (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()

Параметры среды

Этот инструмент не использует параметры среды геообработки

Связанные темы

Информация о лицензировании

ArcGIS for Desktop Basic: Нет
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
9/10/2013