Définir les propriétés du jeu de données mosaïque

Résumé

Définit les valeurs par défaut permettant d'afficher une mosaïque et de la diffuser en tant que service d'imagerie.

Utilisation

• Les propriétés actuelles du jeu de données mosaïque se trouvent dans l’onglet Valeurs par défaut de la boîte de dialogue Propriétés du jeu de données mosaïque.

Syntaxe

arcpy.management.SetMosaicDatasetProperties(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}, {data_source_type}, {minimum_pixel_contribution}, {processing_templates}, {default_processing_template}, {time_interval}, {time_interval_units}, {product_definition}, {product_band_definitions})

Paramètre	Explication	Type de données
in_mosaic_dataset	Le jeu de données mosaïque avec les propriétés qui sont définies.	Mosaic Layer
rows_maximum_imagesize (Facultatif)	Nombre maximal de lignes pour l'image mosaïquée, générées par la mosaïque pour chaque requête. Cela permet de contrôler les tâches que votre serveur doit encore traiter lorsque les clients consultent l'imagerie. Un nombre plus élevé permet de créer une plus grande image mais augmente également le temps de traitement du jeu de données mosaïque. Si la valeur définie n'est pas assez importante, l'image risque de ne pas s'afficher.	Long
columns_maximum_imagesize (Facultatif)	Nombre maximal de colonnes pour l'image mosaïquée, générées par la mosaïque pour chaque requête. Cela permet de contrôler les tâches que votre serveur doit encore traiter lorsque les clients consultent l'imagerie. Un nombre plus élevé permet de créer une plus grande image mais augmente également le temps de traitement du jeu de données mosaïque. Si la valeur définie n'est pas assez importante, l'image risque de ne pas s'afficher.	Long
allowed_compressions [allowed_compressions,...] (Facultatif)	Spécifie les méthodes de compression utilisées pour transmettre l'image mosaïquée de l'ordinateur vers l'affichage (ou du serveur vers le client). None —Aucune compression ne sera utilisée. JPEG —Une compression maximum de 8:1, adaptée aux arrière-plans, est utilisée. LZ77 —Une compression d'environ 2:1, adaptée aux analyses, est utilisée. LERC —Une compression comprise entre 10:1 et 20:1, rapide et adaptée à l'affichage d'une imagerie brute avec une profondeur des couleurs élevée (12 à 32 bits), est utilisée.	String
default_compression_type (Facultatif)	Spécifie le type de compression par défaut. La compression par défaut doit être définie dans la liste des valeurs utilisées pour le paramètre allowed_compressions ou dans la propriété Méthodes de compression autorisées du jeu de données mosaïque. None —Aucune compression ne sera utilisée. JPEG —Une compression maximum de 8:1, adaptée aux arrière-plans, est utilisée. LZ77 —Une compression d'environ 2:1, adaptée aux analyses, est utilisée. LERC —Une compression comprise entre 10:1 et 20:1, rapide et adaptée à l'affichage d'une imagerie brute avec une profondeur des couleurs élevée (12 à 32 bits), est utilisée.	String
JPEG_quality (Facultatif)	Qualité de compression avec le format JPEG. La qualité de compression est comprise entre 1 et 100. Une valeur supérieure permet d'obtenir une meilleure qualité d'image, mais une compression moindre.	Long
LERC_Tolerance (Facultatif)	Erreur maximale par pixel avec la compression LERC. 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.	Double
resampling_type (Facultatif)	Spécifie le mode de calcul des valeurs de pixel lorsque le jeu de données s'affiche à de petites échelles. Choisissez une technique appropriée en fonction du type de données. NEAREST —La valeur de chaque pixel provient du pixel correspondant le plus proche. Cette technique convient aux données discrètes, telles que l'occupation du sol.Il s'agit de la technique de rééchantillonnage la plus rapide. Elle minimise les modifications apportées aux valeurs des pixels car elle utilise la valeur du pixel le plus proche. BILINEAR —La valeur de chaque pixel est calculée à partir de la moyenne des valeurs des quatre pixels voisins (en fonction de la distance). Cette technique convient aux données continues. CUBIC —La valeur de chaque pixel est calculée en ajustant une courbe lissée en fonction des 16 pixels voisins. Cette technique génère l'image la plus lisse, mais peut créer des valeurs en dehors de la plage identifiée dans les données source. Elle convient aux données continues. MAJORITY —La valeur de chaque pixel dépend de la valeur la plus utilisée au sein d'une fenêtre 3 par 3. Cette technique convient aux données discrètes.	String
clip_to_footprints (Facultatif)	Indique si les rasters sont découpés jusqu'à l'emprise. Le jeu de données raster et son emprise ont souvent la même étendue. Si elles sont différentes, le jeu de données raster peut être découpé jusqu'à l'emprise. NOT_CLIP —Les rasters ne sont pas découpés jusqu'à l'emprise. Il s’agit de l’option par défaut. CLIP —Les rasters sont découpés jusqu'à l'emprise.	Boolean
footprints_may_contain_nodata (Facultatif)	Indique si les pixels sans valeur NoData sont affichés. FOOTPRINTS_MAY_CONTAIN_NODATA —Les pixels sans valeur NoData sont affichés. Il s’agit de l’option par défaut. FOOTPRINTS_DO_NOT_CONTAIN_NODATA —Les pixels sans valeur NoData ne sont pas affichés. Vous pouvez constater une amélioration des performances, mais si votre imagerie comporte des valeurs NoData, elles apparaissent sous forme de discontinuités dans le jeu de données mosaïque.	Boolean
clip_to_boundary (Facultatif)	Indique si l'image mosaïquée est découpée sur la limite. La mosaïque et sa limite ont souvent la même étendue. Si elles sont différentes, le jeu de données mosaïque peut être découpé sur la limite. CLIP —L'image mosaïquée est découpée sur la limite. Il s’agit de l’option par défaut. NOT_CLIP —L'image mosaïquée n'est pas découpée sur la limite.	Boolean
color_correction (Facultatif)	Indique si la correction des couleurs est utilisée sur le jeu de données de la mosaïque. NOT_APPLY —La correction des couleurs n'est pas utilisée. Il s’agit de l’option par défaut. APPLY —La correction des couleurs configurée pour le jeu de données mosaïque est utilisée.	Boolean
allowed_mensuration_capabilities [allowed_mensuration_capabilities,...] (Facultatif)	Spécifie les mesures effectuées sur le jeu de données de la mosaïque. La possibilité d'effectuer des mesures verticales dépend de l'imagerie et peut nécessiter un MNE. None —Aucune fonctionnalité de mesure n'est effectuée. Basic —Les mesures au sol, telles que les calculs de distance, point, centroïde et surface, sont effectuées. Base-Top Height —Les mesures de la base au sommet des entités sont effectuées. Des coefficients polynomiaux rationnels doivent être incorporés dans l'imagerie. Base-Top Shadow Height —Les mesures de la base d'une entité au sommet de son ombre sont effectuées. Des informations sur l'azimut du soleil et l'altitude du soleil sont requises. Top-Top Shadow Height —Les mesures du sommet d'une entité au sommet de son ombre sont effectuées. L'azimut du soleil, l'altitude du soleil et des coefficients polynomiaux rationnels sont requis. 3D —Les mesures en 3D sont effectuées si un MNE est disponible.	String
default_mensuration_capabilities (Facultatif)	Spécifie la fonctionnalité de mesure par défaut du jeu de données mosaïque. La valeur de mesure par défaut doit être définie dans la liste des valeurs utilisées pour le paramètre allowed_mensuration_capabilities ou dans la propriété Fonctionnalités de mesure du jeu de données mosaïque. None —Aucune fonctionnalité de mesure n'est effectuée. Basic —Les mesures au sol, telles que les calculs de distance, point, centroïde et surface, sont effectuées. Base-Top Height —Les mesures de la base au sommet des entités sont effectuées. Des coefficients polynomiaux rationnels doivent être incorporés dans l'imagerie. Base-Top Shadow Height —Les mesures de la base d'une entité au sommet de son ombre sont effectuées. Des informations sur l'azimut du soleil et l'altitude du soleil sont requises. Top-Top Shadow Height —Les mesures du sommet d'une entité au sommet de son ombre sont effectuées. L'azimut du soleil, l'altitude du soleil et des coefficients polynomiaux rationnels sont requis. 3D —Les mesures en 3D sont effectuées si un MNE est disponible.	String
allowed_mosaic_methods [allowed_mosaic_methods,...] (Facultatif)	Spécifie les règles d'affichage des images superposées. None —Les rasters sont triés en fonction du champ ObjectID dans la table attributaire du jeu de données mosaïque. Center —Les images les plus proches du centre de l'écran sont affichées. NorthWest —Les images les plus proches de l'angle nord-ouest de la limite du jeu de données mosaïque sont affichées. LockRaster —Les jeux de données raster sélectionnés sont affichés. ByAttribute —Les images sont affichées et classées en fonction d'un champ de la table attributaire. Nadir —Les rasters avec des angles de vue proches de zéro sont affichés. Viewpoint —Les images les plus proches d'un angle de vue sélectionné sont affichées. Seamline —Les transitions entre les images sont lissées à l'aide de lignes de raccord.	String
default_mosaic_method (Facultatif)	Spécifie la méthode de mosaïquage par défaut utilisée pour le jeu de données mosaïque. La méthode de mosaïquage par défaut doit être définie dans la liste des valeurs utilisées pour le paramètre allowed_mosaic_methods ou dans la propriété Méthodes de mosaïquage autorisées du jeu de données mosaïque. None —Les rasters sont triés en fonction du champ ObjectID dans la table attributaire du jeu de données mosaïque. Center —Les images les plus proches du centre de l'écran sont affichées. NorthWest —Les images les plus proches de l'angle nord-ouest de la limite du jeu de données mosaïque sont affichées. LockRaster —Les jeux de données raster sélectionnés sont affichés. ByAttribute —Les images sont affichées et classées en fonction d'un champ de la table attributaire. Nadir —Les rasters avec des angles de vue proches de zéro sont affichés. Viewpoint —Les images les plus proches d'un angle de vue sélectionné sont affichées. Seamline —Les transitions entre les images sont lissées à l'aide de lignes de raccord.	String
order_field (Facultatif)	Champ à utiliser lors du classement des rasters à l'aide de la valeur ByAttribute du paramètre default_mosaic_method. 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 : MinPS MaxPS LowPS HighPS CenterX CenterY ZOrder Shape_Length Shape_Area Si le champ est de type numérique ou date, le paramètre order_base doit être défini. Ce paramètre n'est pas requis si la valeur ByAttribute n'appartient pas à la liste allowed_mosaic_methods.	String
order_base (Facultatif)	Trie les rasters en fonction de leur différence avec cette valeur dans le champ sélectionné dans le paramètre order_field. Si un attribut Date est utilisé, il doit respecter 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 est requis uniquement si la valeur ByAttribute est spécifiée pour le paramètre allowed_mosaic_methods.	String
sorting_order (Facultatif)	Indique si les rasters sont triés par ordre croissant ou décroissant. ASCENDING —Les rasters sont triés par ordre croissant. Il s’agit de l’option par défaut. DESCENDING —Les rasters sont triés par ordre décroissant. Ce paramètre est requis uniquement si la valeur ByAttribute est spécifiée pour le paramètre allowed_mosaic_methods.	Boolean
mosaic_operator (Facultatif)	Spécifie la règle qui est utilisée pour résoudre les pixels superposés. FIRST —La première image de la table attributaire est affichée. LAST —La dernière image de la table attributaire est affichée. MIN —Les valeurs de pixel les plus faibles sont affichées. MAX —Les valeurs de pixel les plus élevées sont affichées. MEAN —La moyenne arithmétique est utilisée pour calculer la moyenne des pixels superposés. BLEND —Un algorithme de pondération de la distance est utilisé pour calculer la moyenne des pixels superposés. SUM —Toutes les valeurs des pixels superposés sont ajoutées.	String
blend_width (Facultatif)	Nombre de pixels auxquels la valeur BLEND du paramètre mosaic_operator est appliquée.	Long
view_point_x (Facultatif)	Valeur numérique à utiliser pour décaler horizontalement le centre de l'image. Les unités sont identiques à celles du système de référence spatiale. Ce paramètre n’est applicable que si le paramètre allowed_mosaic_methods est défini sur Viewpoint.	Double
view_point_y (Facultatif)	Valeur numérique à utiliser pour décaler verticalement le centre de l'image. Les unités sont identiques à celles du système de référence spatiale. Ce paramètre n’est applicable que si le paramètre allowed_mosaic_methods est défini sur Viewpoint.	Double
max_num_per_mosaic (Facultatif)	Nombre maximal de jeux de données raster affichés à un moment donné dans un jeu de données mosaïque.	Long
cell_size_tolerance (Facultatif)	Différence de taille de pixel maximale autorisée pour que les images soient considérées comme ayant un pixel de cellule différent. Cela permet aux images de résolutions spatiales similaires d'être considérées comme ayant la même résolution nominale. Par exemple, avec un facteur de 0,1, toutes les images avec des tailles de cellule à moins de 10 pour cent des autres sont regroupées pour les outils et les opérations qui utilisent les tailles de cellule.	Double
cell_size (Facultatif)	Taille de cellule du jeu de données mosaïque à l'aide d'un jeu de données raster existant ou de sa largeur (x) et sa hauteur (y) spécifiées. 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)	Spécifie le niveau de métadonnées à exposer du serveur à un client lors de la publication du jeu de données mosaïque. FULL —Les métadonnées relatives au traitement appliqué au niveau du jeu de données mosaïque, ainsi que les métadonnées associées à chaque jeu de données raster sont exposées. NONE —Aucune métadonnée ne sera affichée dans le client. BASIC —Les métadonnées relatives à chaque jeu de données raster, par exemple le nombre de colonnes et de lignes, la taille de cellule et les informations de référence spatiale, sont exposées.	String
transmission_fields [transmission_fields,...] (Facultatif)	Champs de la table attributaire que les clients peuvent voir. Par défaut, la liste inclut les éléments suivants : Name MinPS MaxPS LowPS HighPS Tag GroupName ProductName CenterX CenterY ZOrder Shape_Length Shape_Area	String
use_time (Facultatif)	Activée : le jeu de données mosaïque est temporel. Si le temps est activé, les champs de début et de fin et le format de date doivent être spécifiés. 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)	Champ de la table attributaire qui affiche l'heure de début.	String
end_time_field (Facultatif)	Champ de la table attributaire qui affiche l'heure de fin.	String
time_format (Facultatif)	Spécifie le format de date du jeu de données mosaïque pour des paramètres tels que start_time_field et end_time_field. YYYY —Année YYYYMM —Année et mois YYYY/MM —Année et mois YYYY-MM —Année et mois YYYYMMDD —Année, mois et jour YYYY/MM/DD —Année, mois et jour YYYY-MM-DD —Année, mois et jour YYYYMMDDhhmmss —Année, mois, jour, heure, minute et secondes YYYY/MM/DD hh:mm:ss —Année, mois, jour, heure, minute et secondes YYYY-MM-DD hh:mm:ss —Année, mois, jour, heure, minute et secondes YYYYMMDDhhmmss.s —Année, mois, jour, heure, minute, secondes et fraction de secondes YYYY/MM/DD hh:mm:ss.s —Année, mois, jour, heure, minute, secondes et fraction de secondes YYYY-MM-DD hh:mm:ss.s —Année, mois, jour, heure, minute, secondes et fraction de secondes	String
geographic_transform [geographic_transform,...] (Facultatif)	Transformations géographiques à associer au jeu de données mosaïque.	String
max_num_of_download_items (Facultatif)	Nombre maximal de jeux de données raster pouvant être téléchargés par demande.	Long
max_num_of_records_returned (Facultatif)	Nombre maximal d'enregistrements pouvant être téléchargés par demande.	Long
data_source_type (Facultatif)	Spécifie le type d'imagerie du jeu de données mosaïque. GENERIC —Aucun type de données n'est spécifié pour le jeu de données mosaïque. THEMATIC —Le jeu de données mosaïque contient des données thématiques avec des valeurs discrètes, telles que l'occupation du sol. PROCESSED —Les couleurs de la mosaïque ont été ajustées. ELEVATION —La mosaïque contient des données d'altitude. SCIENTIFIC —La mosaïque contient des données scientifiques. VECTOR_UV —La mosaïque possède deux variables. VECTOR_MAGDIR —La mosaïque possède une magnitude et une direction.	String
minimum_pixel_contribution (Facultatif)	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. En raison de l'imagerie superposée, un élément peut n’afficher qu'un petit micropolygone de son image globale. Ignorer ces éléments de jeu de données mosaïque permet d'améliorer les performances du jeu de données mosaïque.	Long
processing_templates [processing_templates,...] (Facultatif)	Chaînes de fonctions utilisées pour traiter un jeu de données mosaïque ou les éléments d'un jeu de données mosaïque à la volée. Vous pouvez ajouter, supprimer ou réorganiser les chaînes de fonctions. Tous les noms des modèles ajoutés doivent être uniques. Pour en savoir plus sur l'utilisation des chaînes de fonctions, reportez-vous à la rubrique Mise à jour de modèles de chaîne de fonctions.	File; String
default_processing_template (Facultatif)	Chaîne de fonctions par défaut. La chaîne de fonctions par défaut est appliquée en cas d'accès à la mosaïque.	String
time_interval (Facultatif)	Durée de chaque intervalle temporel. L'intervalle temporel définit la granularité des données temporelles. L'unité de temps est spécifiée dans le paramètre time_interval_units.	Double
time_interval_units (Facultatif)	Indique l’unité de mesure utilisée pour l’intervalle temporel. None —Aucune unité de temps n’existe ou elle est inconnue. Milliseconds —Les millisecondes sont l’unité de temps. Seconds —Les secondes sont l’unité de temps. Minutes —Les minutes sont l’unité de temps. Hours —Les heures sont l’unité de temps. Days —Les jours sont l’unité de temps. Weeks —Les semaines sont l’unité de temps. Months —Les mois sont l’unité de temps. Years —Les années sont l’unité de temps. Decades —Les décennies sont l’unité de temps. Centuries —Les siècles sont l’unité de temps.	String
product_definition (Facultatif)	Spécifie un modèle propre au type d'imagerie que vous utilisez ou générique. Les options génériques incluent les types standards de capteur raster pris en charge suivants :	String
product_band_definitions [Band Name {Wavelength Minimum} {Wavelength Maximum},...] (Facultatif)	Définitions des plages de longueurs d’onde, du nombre de canaux et de l'ordre des canaux. Mettez à jour les valeurs product_definition et ajoutez de nouveaux canaux à l'aide de la définition de produit CUSTOM.	Value Table

Sortie dérivée

Nom	Explication	Type de données
out_mosaic_dataset	Jeu de données mosaïque mis à jour.	Mosaic Layer

Exemple de code

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

Il s’agit d’un exemple Python d’utilisation 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", processing_templates="None;C:/Test/NewRFTs/Aspect.rft.xml", 
    default_processing_template="None")

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

Il s’agit d’un exemple de script Python d’utilisation 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")

Environnements

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Non
• Standard: Oui
• Advanced: Oui