Définir les propriétés de mosaïque (Gestion des données)

Niveau de licence :BasicStandardAdvanced

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

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}, {data_source_type}, {minimum_pixel_contribution})
ParamètreExplicationType 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).

  • AucunAucune compression ne sera utilisée.
  • JPEGLa compression JPEG sera utilisée.
  • LZWLa compression LZW sera utilisée.
  • LERCLa 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.

  • NEARESTLa méthode de rééchantillonnage voisin le plus proche sera utilisée.
  • BILINEARLa méthode de rééchantillonnage interpolation bilinéaire sera utilisée.
  • CUBICLa méthode de rééchantillonnage convolution cubique sera utilisée.
  • MAJORITYLa 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_CLIPNe découpe pas le raster selon l'emprise. Il s'agit de l'option par défaut.
  • CLIPDé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_NODATAVos 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_NODATAVos 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_CLIPNe 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_APPLYConserver la correction des couleurs désactivée. Il s'agit de l'option par défaut.
  • APPLYUtilise 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.

  • AucunAucune fonction de mesure n'est autorisée.
  • De baseLes calculs de distance, point, centroïde et surface sont autorisés.
  • Hauteur de la base au sommetLes 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 sommetLes 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 à sommetLes 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.
  • 3DLes 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 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.

  • AucunTrie les rasters en fonction de l'ordre (ObjectID) de la table attributaire de mosaïque.
  • CentrePermet 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-OuestPermet 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 rasterPermet à l'utilisateur de verrouiller l'affichage d'un ou plusieurs rasters en fonction du champ ObjectID.
  • Par attributPermet de trier les rasters selon un attribut de métadonnées défini et sa différence par rapport à une valeur de base.
  • Point nadiralPermet 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 vuePermet 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 raccordDé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.
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 :

  • Nom
  • PS min
  • PS max
  • PS faible
  • PS élevé
  • 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 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.

  • ASCENDINGUtilise un ordre croissant pour vos rasters. Il s'agit de l'option par défaut.
  • DESCENDINGUtilise un ordre décroissant pour vos rasters.

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.

  • FIRSTLes zones superposées contiendront les cellules du premier jeu de données raster répertorié dans la source.
  • LASTLes zones superposées contiendront les cellules du dernier jeu de données raster répertorié dans la source.
  • MINLes zones superposées contiendront les valeurs de cellule minimales de toutes les cellules superposées.
  • MAXLes zones superposées contiendront les valeurs de cellule maximales de toutes les cellules superposées.
  • MOYENNELes zones superposées contiendront les valeurs de cellule moyennes de toutes les cellules superposées.
  • BLENDLes 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.
  • SUMLes zones superposées correspondent à la valeur totale des pixels de toutes les valeurs de cellule ajoutées à partir des 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.

  • FULLToutes 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.
  • NONEAucune métadonnée ne sera affichée dans le client.
  • BASICLes 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_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 :

  • Nom
  • PS min
  • PS max
  • PS faible
  • PS élevé
  • 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.

  • DISABLEDLa mosaïque n'est pas temporelle. Il s'agit de l'option par défaut.
  • ENABLEDLa mosaïque est temporelle. Cela permet au client d'utiliser le curseur temporel.
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.

  • AAAAAnnée
  • AAAAMMAnnée et mois
  • AAAA/MMAnnée et mois
  • AAAA-MMAnnée et mois
  • AAAAMMJJAnnée, mois et jour
  • AAAA/MM/JJAnnée, mois et jour
  • AAAA-MM-JJAnnée, mois et jour
  • AAAAMMJJhhmmssAnnée, mois, jour, heure, minute et secondes
  • AAAA/MM/JJ hh:mm:ssAnnée, mois, jour, heure, minute et secondes
  • AAAA-MM-JJ hh:mm:ssAnnée, mois, jour, heure, minute et secondes
  • AAAAMMJJhhmmss.sAnnée, mois, jour, heure, minute, secondes et fraction de secondes
  • AAAA/MM/JJ hh:mm:ss.sAnnée, mois, jour, heure, minute, secondes et fraction de secondes
  • AAAA-MM-JJ hh:mm:ss.sAnné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
data_source_type
(Facultatif)

Choisissez le type de source de données de la mosaïque.

  • GENERICAucun type de données n'est spécifié pour la mosaïque.
  • THEMATICLa mosaïque est thématique. Les données thématiques comportent des valeurs discrètes.
  • PROCESSEDLa mosaïque est traitée. Les couleurs de la mosaïque ont déjà été ajustées.
  • ELEVATIONLa mosaïque contient des données d'altitude.
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

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", 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")
Exemple 2 d'utilisation de la fonction SetMosaicDatasetProperties (script autonome)

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

Environnements

Cet outil n'utilise aucun environnement de géotraitement

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Annuler
ArcGIS for Desktop Standard: Oui
ArcGIS for Desktop Advanced: Oui
6/5/2014