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

• Cet outil vous permet de définir des propriétés de la mosaïque dans un environnement de géotraitement ou Python.

Syntaxe

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})

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é Méthodes de compression autorisées 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'affichage (ou du serveur au client). NONE —Aucune compression ne sera utilisée. JPEG —La compression JPEG sera utilisée. LZW —La compression LZW sera utilisée. LERC —La compression LERC (Limited Error Raster Compression) sera utilisée.	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. NEAREST —La méthode de rééchantillonnage voisin le plus proche sera utilisée. BILINEAR —La méthode de rééchantillonnage interpolation bilinéaire sera utilisée. CUBIC —La méthode de rééchantillonnage convolution cubique sera utilisée. MAJORITY —La méthode de rééchantillonnage par majorité sera utilisé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é. NOT_CLIP —Ne découpe pas le raster selon l'emprise. Il s'agit de l'option par défaut. CLIP —Découpe le raster selon l'emprise.	Boolean
footprints_may_contain_nodata (Facultatif)	Précisez si les emprises de la mosaïque contiennent des pixels NoData. FOOTPRINTS_MAY_CONTAIN_NODATA —Vos emprises contiennent des pixels NoData. Cette option permet de s'assurer que votre mosaïque est libre de trous. Il s'agit de l'option par défaut. FOOTPRINTS_DO_NOT_CONTAIN_NODATA —Vos emprises ne contiennent pas de pixels NoData. Si vous spécifiez ce paramètre, les performances peuvent être légèrement améliorées. Cependant, si des pixels NoData sont présents dans vos empreintes, vous aurez des trous dans votre mosaïque.	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. CLIP — Découpe l'image mosaïquée à la limite. Il s'agit de l'option par défaut. NOT_CLIP —Ne découpe pas l'image mosaïquée à la limite.	Boolean
color_correction (Facultatif)	Choisissez s'il faut activer la correction des couleurs configurée pour la mosaïque. NOT_APPLY —Conserver la correction des couleurs désactivée. Il s'agit de l'option par défaut. APPLY —Utilise la correction des couleurs configurée pour la mosaïque.	Boolean
allowed_mensuration_capabilities [allowed_mensuration_capabilities,...] (Facultatif)	Sélectionnez les fonctions de mensuration autorisées pour cette mosaïque. De base —Les calculs de distance, point, centroïde et surface sont autorisés. Hauteur de la base au sommet —Les mesures de hauteur de la base au sommet sont autorisées. Pour effectuer des mesures Hauteur de la base au sommet, les informations de coefficients (RPC) polynomiales rationnelles sont requises. Hauteur de l'ombre de la base au sommet —Les mesures de hauteur de l'ombre de la base au sommet sont autorisées. Pour effectuer des mesures Hauteur de l'ombre de la base au sommet, les informations relatives à l'azimut et à l'altitude du soleil sont requises. Hauteur de l'ombre de sommet à sommet —Les mesures de hauteur de l'ombre du sommet au sommet sont autorisées. Pour effectuer cette mesure, les informations relatives à l'azimut et à l'altitude du soleil et aux coefficients polynomiaux rationnels (RPC) sont requises. 3D —Les mesures 3D sont autorisées lorsqu'un MNA est disponible.	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 la liste de paramètres allowed_mensuration_capabilities ou déjà définie dans la propriété de fonctions de mensuration de la mosaïque.	String
allowed_mosaic_methods [allowed_mosaic_methods,...] (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. Centre —Permet de trier les rasters selon un ordre par défaut dans lequel les rasters dont le centre est le plus proche du centre de vue s'affichent en haut de la liste. Nord-Ouest —Permet d'effectuer un tri indépendant de la vue, dans lequel les rasters dont les centres sont situés au nord-ouest s'affichent en haut de la liste. Verrouiller le raster —Permet à l'utilisateur de verrouiller l'affichage d'un ou plusieurs rasters en fonction du champ ObjectID. Par attribut —Permet de trier les rasters selon un attribut de métadonnées défini et sa différence par rapport à une valeur de base. Nadir —Permet de trier les rasters selon la distance entre la position de Nadir et le centre de la vue. Cette option est semblable à la méthode Plus proche du centre, mais elle utilise le point de Nadir d'un raster, qui peut être différent du centre, surtout pour une imagerie oblique. Point de vue —Permet de trier les rasters selon une position nadir et une position définie par l'utilisateur pour les rasters à l'aide de l'outil Point de vue. Ligne de raccord —Découpe les rasters à l'aide de sa forme de ligne de raccord prédéfinie en appliquant un estompage optionnel le long des raccords. Le classement est prédéfini lors de la génération de la ligne de raccord. Le dernier (LAST) opérateur de mosaïque n'est pas valide avec cette méthode de mosaïquage. Aucun —Trie les rasters en fonction de l'ordre (ObjectID) de la table attributaire de 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 la liste de paramètres allowed_mosaic_methods ou 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 : Nom MinPS MaxPS LowPS HighPS Balise GroupName ProductName CenterX CenterY ZOrder Shape_Length Shape_Area 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 : AAAA/MM/JJ HH:mm:ss.s AAAA/MM/JJ HH:mm:ss AAAA/MM/JJ HH:mm AAAA/MM/JJ HH AAAA/MM/JJ AAAA/MM AAAA Ce paramètre n'est pas requis si Par attribut n'est pas une méthode de mosaïquage autorisée.	String
sorting_order (Facultatif)	Choisissez s'il faut trier vos rasters en ordre croissant ou décroissant. ASCENDING —Utilise un ordre croissant pour vos rasters. Il s'agit de l'option par défaut. DESCENDING —Utilise un ordre décroissant pour vos rasters. Ce paramètre n'est pas requis si Par attribut n'est pas une méthode de mosaïquage autorisée.	Boolean
mosaic_operator (Facultatif)	Choisissez l'opérateur de mosaïque à utiliser pour résoudre les cellules superposées. FIRST —Les zones superposées contiendront les cellules du premier jeu de données raster répertorié dans la source. LAST —Les zones superposées contiendront les cellules du dernier jeu de données raster répertorié dans la source. MIN —Les zones superposées contiendront les valeurs de cellule minimales de toutes les cellules superposées. MAX —Les zones superposées contiendront les valeurs de cellule maximales de toutes les cellules superposées. MEAN —Les zones superposées contiendront les valeurs de cellule moyennes de toutes les cellules superposées. BLEND —Les zones superposées seront un mélange des valeurs de cellules superposées le long du tronçon de chaque jeu de données raster dans l'image mosaïquée. Par défaut, le tronçon est défini par l'emprise ou la ligne de raccord pour chaque raster.	String
blend_width (Facultatif)	Définit la distance en pixels (à l'échelle d'affichage) utilisée par l'opérateur de mosaïque Fusionner.	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 lorsque la méthode de mosaïquage Plus proche du point de vue est utilisée.	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 lorsque la méthode de mosaïquage Plus proche du point de vue est utilisée.	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)	Spécifiez le facteur de tolérance de taille de cellule. 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)	Entrez la taille de cellule en sortie. 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. FULL —Toutes les métadonnées, notamment les informations de jeu de données raster de base et les détails de la chaîne de fonctions sont transmis. Il s'agit de l'option par défaut. NONE —Aucune métadonnée ne sera affichée dans le client. BASIC —Les informations de niveau jeu de données raster sont transmises, telles que les colonnes et les lignes, la taille de cellule et les informations de référence spatiale.	String
transmission_fields [transmission_fields,...] (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 : Nom MinPS MaxPS LowPS HighPS Balise GroupName ProductName CenterX CenterY ZOrder Shape_Length Shape_Area	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. DISABLED —La mosaïque n'est pas temporelle. Il s'agit de l'option par défaut. ENABLED —La mosaïque est temporelle. Cela permet au client d'utiliser le curseur temporel.	Boolean
start_time_field (Facultatif)	Spécifiez le champ dans la table attributaire à utiliser comme heure de début.	String
end_time_field (Facultatif)	Spécifiez le champ dans la table attributaire à utiliser comme heure de fin.	String
time_format (Facultatif)	Spécifiez le format du champ temporel. AAAA —Année AAAAMM —Année et mois AAAA/MM —Année et mois AAAA-MM —Année et mois AAAAMMJJ —Année, mois et jour AAAA/MM/JJ —Année, mois et jour AAAA-MM-JJ —Année, mois et jour AAAAMMJJhhmmss —Année, mois, jour, heure, minute et secondes AAAA/MM/JJ hh:mm:ss —Année, mois, jour, heure, minute et secondes AAAA-MM-JJ hh:mm:ss —Année, mois, jour, heure, minute et secondes AAAAMMJJhhmmss.s —Année, mois, jour, heure, minute, secondes et fraction de secondes AAAA/MM/JJ hh:mm:ss.s —Année, mois, jour, heure, minute, secondes et fraction de secondes AAAA-MM-JJ hh:mm:ss.s —Année, mois, jour, heure, minute, secondes et fraction de secondes	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

Exemple de code

Exemple 1 d'utilisation de la fonction SetMosaicDatasetProperties (fenêtre Python)

Voici un exemple en code Python de la fonction 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")

Exemple 2 d'utilisation de la fonction SetMosaicDatasetProperties (script autonome)

Voici un exemple de script Python de la fonction 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()

Environnements

Cet outil n'utilise aucun environnement de géotraitement