Définir les propriétés de mosaïque (Gestion des données)
Récapitulatif
Définit les propriétés d'une mosaïque. Nombre de ces propriétés définissent les valeurs par défaut utilisées lors de l'affichage de la mosaïque ou la façon dont celle-ci peut être utilisée lorsqu'elle est publiée en tant que service d'imagerie.
Utilisation
Les propriétés actuelles de la mosaïque se trouvent sous l'onglet Valeurs par défaut de la boîte de dialogue Propriétés de la mosaïque.
Syntaxe
Paramètre | Explication | Type de données |
in_mosaic_dataset |
Mosaïque dont les propriétés sont à définir. | Mosaic Layer |
rows_maximum_imagesize (Facultatif) |
Définissez le nombre maximal d'enregistrements pour l'image mosaïquée, généré par la mosaïque pour chaque requête. En augmentant le nombre de lignes et de colonnes dans le champ Taille maximum de l'image par requête, vous augmenterez le temps de traitement de la mosaïque. Toutefois, cela peut être pertinent si vous imprimez des tracés très importants, de haute résolution. Si vous définissez des valeurs trop faibles, il se peut qu'aucune image ne s'affiche. Par exemple, si vous les ramenez à 10, la dimension de la fenêtre d'affichage de l'image sera inférieure ou égale à 10 pixels. | Long |
columns_maximum_imagesize (Facultatif) |
Définissez le nombre maximal de colonnes pour l'image mosaïquée, généré par la mosaïque pour chaque requête. En augmentant le nombre de lignes et de colonnes dans le champ Taille maximum de l'image par requête, vous augmenterez le temps de traitement de la mosaïque. Toutefois, cela peut être pertinent si vous imprimez des tracés très importants, de haute résolution. Si vous définissez des valeurs trop faibles, il se peut qu'aucune image ne s'affiche. Par exemple, si vous les ramenez à 10, la dimension de la fenêtre d'affichage de l'image sera inférieure ou égale à 10 pixels. | Long |
allowed_compressions [allowed_compressions,...] (Facultatif) |
Définissez la propriété Compression de transmission autorisée de la mosaïque, qui définit la méthode de compression utilisée pour transmettre l'image mosaïquée de l'ordinateur à l'écran (ou du serveur au client).
| String |
default_compression_type (Facultatif) |
Définissez le type de compression par défaut. La compression par défaut doit figurer dans la liste allowed_compressions ou être déjà définie dans la propriété Méthodes de compression autorisées de la mosaïque. | String |
JPEG_quality (Facultatif) |
Définissez la qualité de compression à utiliser avec la compression JPEG. La qualité de compression peut s'échelonner de 1 à 100. Une valeur supérieure permet d'obtenir une meilleure qualité d'image, mais une compression moindre. | Long |
LERC_Tolerance (Facultatif) |
Spécifiez la tolérance LERC, lorsque la méthode de compression LERC est utilisée. La tolérance représente la valeur d'erreur maximale applicable par pixel (pas une moyenne pour l'image). Cette valeur est exprimée dans les unités de la mosaïque. Par exemple, si l'erreur est de 10 centimètres et que la mosaïque est exprimée en mètres, saisissez 0.1. LERC est une méthode efficace de compression avec perte recommandée pour les données comportant un espace par pixel important, telles que les données à virgule flottante, 32 bits, 16 bits ou 12 bits. La méthode LERC compresse 5 à 10 fois mieux et plus rapidement les données à virgule flottante que la méthode LZ77. Elle est également plus performante avec les données numériques entières. Si vous utilisez des données numériques entières et que la limite d'erreur spécifiée est 0,99 au plus, la méthode LERC est considérée comme une compression sans perte. | Double |
resampling_type (Facultatif) |
Définissez la méthode de rééchantillonnage par défaut utilisée pour afficher l'image mosaïquée.
| String |
clip_to_footprints (Facultatif) |
Spécifiez si vous souhaitez limiter l'étendue de chaque raster à son emprise ou utiliser le raster dans son intégralité pour créer l'image mosaïquée. Il est fréquent que le raster et l'emprise soient identiques, mais lorsqu'ils sont différents, vous pouvez préciser si le raster doit être ou non découpé.
| Boolean |
footprints_may_contain_nodata (Facultatif) | Précisez si les emprises de la mosaïque contiennent des pixels NoData.
| Boolean |
clip_to_boundary (Facultatif) |
Spécifiez si vous souhaitez découper l'image de la mosaïque à la limite, ou afficher l'image mosaïquée entière. Souvent, la limite représente la mosaïque entière ; toutefois, vous pouvez la modifier pour exclure une partie du jeu de données.
| Boolean |
color_correction (Facultatif) |
Choisissez s'il faut activer la correction des couleurs configurée pour la mosaïque.
| Boolean |
allowed_mensuration_capabilities [allowed_mensuration_capability,...] (Facultatif) |
Sélectionnez les fonctions de mensuration autorisées pour cette mosaïque.
| String |
default_mensuration_capabilities (Facultatif) |
Choisissez la fonction de mensuration par défaut pour cette mosaïque. La valeur par défaut doit être définie dans le paramètre allowed_mensuration_capabilities ou être déjà définie dans la propriété Fonctionnalités de mesure de la mosaïque. | String |
allowed_mosaic_methods [allowed_mosaic_method,...] (Facultatif) |
Choisissez les méthodes de mosaïquage qui seront autorisées par cette mosaïque. L'image mosaïquée peut être créée à partir de plusieurs rasters en entrée. La méthode de mosaïquage définit la façon dont l'image mosaïquée est créée à partir des différents rasters contenus dans la mosaïque.
| String |
default_mosaic_method (Facultatif) |
Choisissez la méthode de mosaïquage par défaut pour cette mosaïque. La valeur par défaut doit être définie dans le paramètre allowed_mosaic_methods ou être déjà définie dans la propriété Méthodes de mosaïquage autorisées de la mosaïque. | String |
order_field (Facultatif) |
Sélectionnez le champ par défaut à utiliser lors du tri des rasters à l'aide de la méthode de mosaïquage Par attribut. La liste des champs comprend ceux présents dans la table attributaire, de type métadonnées et qui sont des nombres entiers. Cette liste, non exhaustive, comprend les valeurs suivantes :
Si votre champ est de type numérique ou date, le paramètre Ordre de base doit être défini. Ce paramètre n'est pas requis si Par attribut n'est pas une méthode de mosaïquage autorisée. | String |
order_base (Facultatif) | Les images sont triées selon la différence entre cette valeur ou les autres dans le Champ de tri de la table attributaire. Si vous utilisez un attribut Date, il doit avoir l'un des formats suivants :
Ce paramètre doit uniquement être spécifié si Par attribut est indiqué pour le paramètre allowed_mosaic_method. | String |
sorting_order (Facultatif) |
Choisissez s'il faut trier vos rasters en ordre croissant ou décroissant.
Ce paramètre doit uniquement être spécifié si Par attribut est indiqué pour le paramètre allowed_mosaic_method. | Boolean |
mosaic_operator (Facultatif) |
Choisissez l'opérateur de mosaïque à utiliser pour résoudre les cellules superposées.
| String |
blend_width (Facultatif) |
Définit la distance en pixels (à l'échelle d'affichage) utilisée lorsque BLEND est spécifié pour l'opérateur de mosaïque. | Long |
view_point_x (Facultatif) | Définit un décalage X servant à calculer où se trouve le centre de l'affichage. Cette valeur est calculée avec l'unité du système de référence spatiale de la mosaïque. Cette valeur est utilisée uniquement lorsque Point de vue est spécifié pour le paramètre Méthodes de mosaïquage autorisées. | Double |
view_point_y (Facultatif) | Définit un décalage Y servant à calculer où se trouve le centre de l'affichage. Cette valeur est calculée avec l'unité du système de référence spatiale de la mosaïque. Cette valeur est utilisée uniquement lorsque Point de vue est spécifié pour le paramètre Méthodes de mosaïquage autorisées. | Double |
max_num_per_mosaic (Facultatif) |
Le nombre maximal de rasters pouvant être utilisés pour créer l'image mosaïquée. | Long |
cell_size_tolerance (Facultatif) |
Le facteur de tolérance doit être supérieur ou égal à 0.0. Un facteur de 0,1 signifie que toutes les valeurs LowPS qui sont 10 pour cent supérieures à la taille de pixel la plus basse sont considérées identiques pour les outils et les opérations qui font appel à des tailles de pixel (cellule). | Double |
cell_size (Facultatif) | Vous pouvez choisir la couche comme modèle de taille de cellule, ou vous pouvez spécifier la taille de cellule réelle. Si vous spécifiez la taille de cellule réelle, vous pouvez utiliser une valeur unique pour une taille de cellule carrée, ou des valeurs X et Y pour une taille de cellule rectangulaire. | Cell Size XY |
metadata_level (Facultatif) |
Choisissez le niveau de métadonnées à exposer du serveur à un client lors de la publication de la mosaïque.
| String |
transmission_fields [transmission_field,...] (Facultatif) |
Choisissez les champs auxquels les utilisateurs ont accès. Cette liste peut englober des champs qui ne sont pas ajoutés par défaut à la table attributaire de la mosaïque. Par défaut, la liste contient :
| String |
use_time (Facultatif) |
Spécifiez s'il faut rendre la mosaïque temporelle. Si le temps est activé, vous devez spécifier les champs de début et de fin, et le format horaire.
| Boolean |
start_time_field (Facultatif) |
Champ dans la table attributaire à utiliser comme heure de début. | String |
end_time_field (Facultatif) |
Champ dans la table attributaire à utiliser comme heure de fin. | String |
time_format (Facultatif) |
Format du champ temporel.
| String |
geographic_transform [geographic_transform,...] (Facultatif) |
Choisissez les transformations géographiques associées à cette mosaïque. | String |
max_num_of_download_items (Facultatif) |
Choisissez le nombre maximal des éléments qui peuvent être téléchargés par requête. | Long |
max_num_of_records_returned (Facultatif) |
Sélectionnez le nombre maximal d’enregistrements renvoyés par requête. | Long |
data_source_type (Facultatif) |
Choisissez le type de source de données de la mosaïque.
| String |
minimum_pixel_contribution (Facultatif) |
Choisissez le nombre minimum de pixels requis pour qu'un élément de mosaïque soit considéré comme assez important pour être utilisé dans la mosaïque. Cette propriété permet à la mosaïque d'ignorer les éléments raster dont le nombre de pixels est insuffisant. Le fait d'ignorer ces éléments de mosaïque permet d'optimiser les performances de la mosaïque lors des calculs ou de l'affichage. Ceci est particulièrement utile lorsqu'un grand nombre de rasters superposés ne comptent qu'un tout petit nombre de pixels. | Long |
Exemple de code
Voici un exemple en code Python de la fonction SetMosaicDatasetProperties.
import arcpy
arcpy.SetMosaicDatasetProperties_management(
"c:/workspace/mdproperties.gdb/md", cell_size="0.2", metadata_level="BASIC",
transmission_fields="NAME;MINPS;MAXPS;GROUPNAME;PRODUCTNAME;ZORDER;YEARS;YEARE",
use_time="ENABLED", start_time_field="YEARS", end_time_field="YEARE",
time_format="YYYYMM", geographic_transform=
"NAD_1983_HARN_To_WGS_1984_2", max_num_of_download_items="10",
max_num_of_records_returned="500", source_type="GENERIC",
minimum_pixel_contribution="50")
Voici un exemple de script Python de la fonction SetMosaicDatasetProperties.
#Set mosaic dataset imagery properties group
import arcpy
arcpy.env.workspace = "C:/Workspace"
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")