Agréger un raster multidimensionnel (Outils Image Analyst)

Résumé

Génère un jeu de données raster multidimensionnelles en associant les variables raster multidimensionnelles existantes sur une dimension.

Utilisation

Utilisez le paramètre Aggregation Definition (Définition de l’agrégation) pour choisir un intervalle à l’aide d’un mot-clé, d’une valeur ou d’une plage de valeurs. Par exemple, si vous avez 30 ans de données de température de la surface de la mer, recueillies quotidiennement tous les cinq mètres de profondeur jusqu’à 100 mètres, vous pouvez utiliser les différentes options d’intervalle pour les scénarios suivants :
- Agrégez les données de température quotidiennes en données mensuelles. Le résultat est alors un raster multidimensionnel avec 12 tranches temporelles, chaque tranche horaire étant l’agrégat de chaque mois sur toutes les années. Choisissez Interval Keyword (Mot-clé de l’intervalle) et définissez le mot-clé sur Recurring Monthly (Récurrence mensuelle).
- Agrégez les données de température quotidiennes en données mensuelles. Le résultat est alors un raster multidimensionnel comportant 360 tranches ou 12 tranches temporelles par an (30 ans x 12 mois = 360 tranches). Choisissez Interval Keyword (Mot-clé de l’intervalle) et définissez le mot-clé sur Par mois.
- Agréger les données de température mensuelles en intervalles de 4 mois. Choisissez Interval Value (Valeur de l’intervalle), définissez Value Interval (Intervalle de valeur) sur 4 et Unit (Unité) sur Months (Mois).
- Agrégez les données de température de 0 à 25 mètres, puis de 25 à 50 mètres, et enfin de 50 à 100 mètres. Sélectionnez Interval Ranges (Plages d’intervalle) et définissez les profondeurs minimales et maximales sur 0 25; 25 50; 50 100.
Parmi les jeux de données raster multidimensionnel pris en charge se trouvent le format Cloud Raster Format (CRF), les mosaïques multidimensionnelles ou les couches raster multidimensionnelles générées par des fichiers au format netCDF, GRIB ou HDF.
Cet outil crée un jeu de données raster multidimensionnel au format Cloud Raster Format (CRF). Actuellement, aucun autre format en sortie n’est pris en charge.
Par défaut, le raster multidimensionnel en sortie sera compressé à l’aide du type de compression LZ77. Nous vous recommandons néanmoins de changer le type de compression de sorte à utiliser la compression LERC et d’ajuster la valeur d’erreur maximale en fonction des données. Par exemple, si vous voulez que la précision des résultats de l’analyse soit de trois décimales, utilisez la valeur d’erreur maximale 0,001. Évitez les exigences de précision inutiles, car elles ne feront qu’augmenter le temps de traitement et l’espace nécessaire au stockage.

Pour changer le type de compression, modifiez le paramètre d’environnement Compression.

Etiqueter	Explication	Type de données
Raster multidimensionnel en entrée	Jeu de données raster multidimensionnel en entrée.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
Dimension	Dimension de l’agrégation. Il s’agit de la dimension le long de laquelle les variables sont agrégées.	String
Méthode d’agrégation (Facultatif)	Indique la méthode mathématique qui est utilisée pour combiner les tranches agrégées dans un intervalle. Si la méthode est définie sur Custom (Personnalisée), le paramètre Aggregation Function (Fonction d’agrégation) devient actif. Moyenne—La moyenne des valeurs d’un pixel est calculée pour toutes les tranches de l’intervalle. Il s’agit de l’option par défaut. Maximum—La valeur maximale d’un pixel est calculée pour toutes les tranches de l’intervalle. Majorité—La valeur survenue le plus souvent est calculée pour toutes les tranches de l’intervalle. Minimum—La valeur minimale d’un pixel est calculée pour toutes les tranches de l’intervalle. Minorité—La valeur survenue le moins souvent est calculée pour toutes les tranches de l’intervalle. Médiane—La valeur médiane d’un pixel est calculée pour toutes les tranches de l’intervalle. Centile—Le centile des valeurs d’un pixel est calculé pour toutes les tranches de l’intervalle. Le 90è centile est calculé par défaut. Vous pouvez spécifier d’autres valeurs (entre 0 et 100) à l’aide du paramètre Percentile Value (Valeur de centile). Plage—La plage des valeurs d’un pixel est calculée pour toutes les tranches de l’intervalle. Écart type—L’écart type des valeurs d’un pixel est calculé pour toutes les tranches de l’intervalle. Somme—La somme des valeurs d’un pixel est calculée pour toutes les tranches de l’intervalle. Variété—Le nombre de valeurs de pixel uniques est calculé pour toutes les tranches de l’intervalle. Personnalisée—La valeur de pixel est calculée en fonction d’une fonction raster personnalisée.	String
Variables [info dimension] (Description) (Facultatif)	La variable ou les variables sont agrégées sur la dimension donnée. Si aucune variable n’est spécifiée, toutes les variables avec la dimension sélectionnée sont agrégées. Ainsi, pour agréger les données des températures quotidiennes dans des valeurs moyennes mensuelles, spécifiez la température comme la variable à agréger. Si vous ne spécifiez aucune variable et que vous possédez des variables de précipitation quotidiennes et des températures quotidiennes, ces deux variables sont agrégées en moyennes mensuelles ; le raster multidimensionnel en sortie inclut alors les deux variables.	String
Définition de l’agrégation (Facultatif)	Spécifie l’intervalle dimensionnel selon lequel les données sont agrégées. Tout—Les valeurs de données sont agrégées à travers toutes les tranches. Il s’agit de l’option par défaut. Mot-clé de l’intervalle—Les données de variable sont agrégées à l’aide d’un intervalle courant connu. Valeur de l’intervalle—Les données de variable sont agrégées à l’aide d’un intervalle et d’une unité spécifiés par l’utilisateur. Plages d’intervalle—Les données de variable sont agrégées entre les paires de valeurs ou de dates spécifiées.	String
Intervalle de mot-clé (Facultatif)	Spécifie l’intervalle de mot-clé à utiliser au cours de l’agrégation sur la dimension. Ce paramètre est requis lorsque le paramètre Aggregation Definition (Définition de l’agrégation) est défini sur Interval Keyword (Mot-clé de l’intervalle) et que l’agrégation doit s’étendre dans le temps. Par heure—Les valeurs de données sont agrégées en intervalles temporels définis en heures. Le résultat inclut chaque heure de la série chronologique. Par jour—Les valeurs de données sont agrégées en intervalles temporels définis en jours. Le résultat inclut chaque jour de la série chronologique. Par semaine—Les valeurs de données sont agrégées en intervalles temporels définis en semaines. Le résultat inclut chaque semaine de la série chronologique. Par dix jours—Les valeurs de données sont agrégées en 3 périodes de 10 jours chacune. La dernière période peut contenir plus ou moins de 10 jours. La sortie comprend 3 tranches pour chaque mois. Par cinq jours—Les valeurs de données sont agrégées en 6 périodes de 5 jours. La dernière période peut contenir plus ou moins de cinq jours. La sortie comprend 6 tranches pour chaque mois. Par mois—Les valeurs de données sont agrégées en intervalles temporels définis en mois. Le résultat inclut chaque mois de la série chronologique. Par trimestre—Les valeurs de données sont agrégées en intervalles temporels définis en trimestres. Le résultat inclut chaque trimestre de la série chronologique. Par an—Les valeurs de données sont agrégées en intervalles temporels définis en années. Le résultat inclut chaque année de la série chronologique. Récurrence quotidienne—Les valeurs de données sont agrégées en intervalles temporels définis en jours. Le résultat inclut une valeur agrégée par jour du calendrier julien. Le résultat comprend 366 tranches de temps quotidiennes au maximum. Récurrence hebdomadaire—Les valeurs de données sont agrégées en intervalles temporels définis en semaines. Le résultat inclut une valeur agrégée par semaine. Le résultat comprend 53 tranches de temps hebdomadaires au maximum. Récurrence mensuelle—Les valeurs de données sont agrégées en intervalles temporels mensuels et le résultat inclut une valeur agrégée par mois. Le résultat comprend 12 tranches de temps mensuelles au maximum. Récurrence trimestrielle—Les valeurs de données sont agrégées en intervalles temporels trimestriels et le résultat inclut une valeur agrégée par trimestre. Le résultat comprend 4 tranches de temps trimestrielles au maximum.	String
Valeur de l’intervalle (Facultatif)	Taille de l’intervalle à appliquer à l’agrégation. Ce paramètre est requis lorsque le paramètre Aggregation Definition (Définition de l’agrégation) est défini sur Interval Value (Valeur de l’intervalle). Par exemple, pour agréger 30 années de données de température mensuelles par incréments de 5 ans, saisissez 5 dans Value Interval (Intervalle de valeur) et spécifiez Years (Années) pour Unit (Unité).	Double
Unité (Facultatif)	Unité à utiliser pour le paramètre Value Interval (Intervalle de valeur). Ce paramètre est requis lorsque le paramètre Dimension est un champ temporel et que le paramètre Aggregation Definition (Définition de l’agrégation) est défini sur Interval Value (Valeur de l’intervalle). Si vous agrégez un champ non temporel, cette option n’est pas disponible et l’unité de la valeur d’intervalle correspond à l’unité de variable des données raster multidimensionnel en entrée. Heures—Les valeurs de données sont agrégées en tranches horaires à l’intervalle fourni. Jours—Les valeurs de données sont agrégées en tranches journalières à l’intervalle fourni. Semaines—Les valeurs de données sont agrégées en tranches hebdomadaires à l’intervalle fourni. Mois—Les valeurs de données sont agrégées en tranches mensuelles à l’intervalle fourni. Années—Les valeurs de données sont agrégées en tranches annuelles à l’intervalle fourni.	String
Plage (Facultatif)	Plages d’intervalle spécifiques d’une table de valeurs à utiliser pour agréger les groupes de valeurs. La table de valeurs est constituée de paires de valeurs de plage minimale et maximale, avec le type de données Double ou Date. Ce paramètre est requis lorsque le paramètre Aggregation Definition (Définition de l’agrégation) est défini sur Interval Ranges (Plages d’intervalle). Colonnes de la table de valeurs : Minimum Value—The minimum value for a range. Maximum Value—The maximum value for a range.	Value Table
Fonction d’agrégation (Facultatif)	Fonction raster personnalisée à utiliser pour calculer les valeurs en pixels des rasters agrégés. L’entrée est un objet JSON de fonction raster ou un fichier `.rft.xml` créé depuis une chaîne de fonctions ou une fonction raster Python personnalisée. Ce paramètre est requis lorsque le paramètre Aggregation Method (Méthode d’agrégation) est défini sur Custom (Personnalisée).	File; String
Ignorer NoData (Facultatif)	Spécifie si les valeurs NoData sont ignorées lors de l’analyse. Activé—L’analyse inclut tous les pixels valides selon une dimension donnée et ignore les pixels NoData. Il s’agit de l’option par défaut. Décoché—Le résultat de l’analyse est NoData s’il existe des valeurs NoData pour les pixels selon la dimension donnée.	Boolean
Sans dimension (Facultatif)	Spécifie si la couche possède des valeurs de dimension. Ce paramètre est activé uniquement si une seule tranche est sélectionnée pour la création d’une couche. Activé—La couche ne contient pas de valeurs de dimension. Décoché—La couche contient des valeurs de dimension. Il s’agit de l’option par défaut.	Boolean
Valeur de centile (Facultatif)	Centile à calculer. La valeur par défaut est de 90, soit le 90e centile. Les valeurs peuvent varier entre 0 et 100. Le centile n° 0 est équivalent à la statistique minimale tandis que le 100e centile équivaut au maximum Une valeur de 50 donne le même résultat que la statistique médiane. Ce paramètre est disponible uniquement si le paramètre Statistics type (Type de statistique) est défini sur Percentile (Centile).	Double
Type d’interpolation en centile (Facultatif)	Définit la méthode d’interpolation en centile à utiliser lorsque le nombre de valeurs du raster en entrée à calculer est pair. Le plus proche—La valeur disponible la plus proche du centile souhaité sera utilisée. Dans ce cas, le type de pixel en sortie est identique à celui du raster de valeurs en entrée. Linéaire—La moyenne pondérée des deux valeurs environnantes du centile souhaité sera utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.	String

Valeur de retour

Etiqueter	Explication	Type de données
Raster multidimensionnel en sortie	Jeu de données raster multidimensionnel CRF (Cloud Raster Format) en sortie.	Raster

AggregateMultidimensionalRaster(in_multidimensional_raster, dimension, {aggregation_method}, {variables}, {aggregation_def}, {interval_keyword}, {interval_value}, {interval_unit}, {interval_ranges}, {aggregation_function}, {ignore_nodata}, {dimensionless}, {percentile_value}, {percentile_interpolation_type})

Nom	Explication	Type de données
in_multidimensional_raster	Jeu de données raster multidimensionnel en entrée.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
dimension	Dimension de l’agrégation. Il s’agit de la dimension le long de laquelle les variables sont agrégées.	String
aggregation_method (Facultatif)	Indique la méthode mathématique qui est utilisée pour combiner les tranches agrégées dans un intervalle. Si `aggregation_method` est définie sur `CUSTOM`, le paramètre `aggregation_function` est activé. `MEAN`—La moyenne des valeurs d’un pixel est calculée pour toutes les tranches de l’intervalle. Il s’agit de l’option par défaut. `MAXIMUM`—La valeur maximale d’un pixel est calculée pour toutes les tranches de l’intervalle. `MAJORITY`—La valeur survenue le plus souvent est calculée pour toutes les tranches de l’intervalle. `MINIMUM`—La valeur minimale d’un pixel est calculée pour toutes les tranches de l’intervalle. `MINORITY`—La valeur survenue le moins souvent est calculée pour toutes les tranches de l’intervalle. `MEDIAN`—La valeur médiane d’un pixel est calculée pour toutes les tranches de l’intervalle. `PERCENTILE`—Le centile des valeurs d’un pixel est calculé pour toutes les tranches de l’intervalle. Le 90è centile est calculé par défaut. Vous pouvez spécifier d’autres valeurs (entre 0 et 100) à l’aide du paramètre `percentile_value`. `RANGE`—La plage des valeurs d’un pixel est calculée pour toutes les tranches de l’intervalle. `STD`—L’écart type des valeurs d’un pixel est calculé pour toutes les tranches de l’intervalle. `SUM`—La somme des valeurs d’un pixel est calculée pour toutes les tranches de l’intervalle. `VARIETY`—Le nombre de valeurs de pixel uniques est calculé pour toutes les tranches de l’intervalle. `CUSTOM`—La valeur de pixel est calculée en fonction d’une fonction raster personnalisée.	String
variables [variables,...] (Facultatif)	La variable ou les variables sont agrégées sur la dimension donnée. Si aucune variable n’est spécifiée, toutes les variables avec la dimension sélectionnée sont agrégées. Ainsi, pour agréger les données des températures quotidiennes dans des valeurs moyennes mensuelles, spécifiez la température comme la variable à agréger. Si vous ne spécifiez aucune variable et que vous possédez des variables de précipitation quotidiennes et des températures quotidiennes, ces deux variables sont agrégées en moyennes mensuelles ; le raster multidimensionnel en sortie inclut alors les deux variables.	String
aggregation_def (Facultatif)	Spécifie l’intervalle dimensionnel selon lequel les données sont agrégées. `ALL`—Les valeurs de données sont agrégées à travers toutes les tranches. Il s’agit de l’option par défaut. `INTERVAL_KEYWORD`—Les données de variable sont agrégées à l’aide d’un intervalle courant connu. `INTERVAL_VALUE`—Les données de variable sont agrégées à l’aide d’un intervalle et d’une unité spécifiés par l’utilisateur. `INTERVAL_RANGES`—Les données de variable sont agrégées entre les paires de valeurs ou de dates spécifiées.	String
interval_keyword (Facultatif)	Spécifie l’intervalle de mot-clé à utiliser au cours de l’agrégation sur la dimension. Ce paramètre est requis si le paramètre `aggregation_def` est défini sur `INTERVAL_KEYWORD` et que l’agrégation doit s’étendre dans le temps. `HOURLY`—Les valeurs de données sont agrégées en intervalles temporels définis en heures. Le résultat inclut chaque heure de la série chronologique. `DAILY`—Les valeurs de données sont agrégées en intervalles temporels définis en jours. Le résultat inclut chaque jour de la série chronologique. `WEEKLY`—Les valeurs de données sont agrégées en intervalles temporels définis en semaines. Le résultat inclut chaque semaine de la série chronologique. `DEKADLY`—Les valeurs de données sont agrégées en 3 périodes de 10 jours chacune. La dernière période peut contenir plus ou moins de 10 jours. La sortie comprend 3 tranches pour chaque mois. `PENTADLY`—Les valeurs de données sont agrégées en 6 périodes de 5 jours. La dernière période peut contenir plus ou moins de cinq jours. La sortie comprend 6 tranches pour chaque mois. `MONTHLY`—Les valeurs de données sont agrégées en intervalles temporels définis en mois. Le résultat inclut chaque mois de la série chronologique. `QUARTERLY`—Les valeurs de données sont agrégées en intervalles temporels définis en trimestres. Le résultat inclut chaque trimestre de la série chronologique. `YEARLY`—Les valeurs de données sont agrégées en intervalles temporels définis en années. Le résultat inclut chaque année de la série chronologique. `RECURRING_DAILY`—Les valeurs de données sont agrégées en intervalles temporels définis en jours. Le résultat inclut une valeur agrégée par jour du calendrier julien. Le résultat comprend 366 tranches de temps quotidiennes au maximum. `RECURRING_WEEKLY`—Les valeurs de données sont agrégées en intervalles temporels définis en semaines. Le résultat inclut une valeur agrégée par semaine. Le résultat comprend 53 tranches de temps hebdomadaires au maximum. `RECURRING_MONTHLY`—Les valeurs de données sont agrégées en intervalles temporels mensuels et le résultat inclut une valeur agrégée par mois. Le résultat comprend 12 tranches de temps mensuelles au maximum. `RECURRING_QUARTERLY`—Les valeurs de données sont agrégées en intervalles temporels trimestriels et le résultat inclut une valeur agrégée par trimestre. Le résultat comprend 4 tranches de temps trimestrielles au maximum.	String
interval_value (Facultatif)	Taille de l’intervalle à appliquer à l’agrégation. Ce paramètre est requis lorsque le paramètre `aggregation_def` est défini sur `INTERVAL_VALUE`. Par exemple, pour agréger 30 années de données de température mensuelles par incréments de 5 ans, saisissez 5 dans `interval_value` et pour `interval_unit`, spécifiez `YEARS`.	Double
interval_unit (Facultatif)	Unité à utiliser pour le paramètre `interval_value`. Ce paramètre est requis lorsque le paramètre `dimension` est défini sur un champ temporel et que le paramètre `aggregation_def` est défini sur `INTERVAL_VALUE`. Si vous agrégez un champ non temporel, cette option n’est pas disponible et l’unité de la valeur d’intervalle correspond à l’unité de variable des données raster multidimensionnel en entrée. `HOURS`—Les valeurs de données sont agrégées en tranches horaires à l’intervalle fourni. `DAYS`—Les valeurs de données sont agrégées en tranches journalières à l’intervalle fourni. `WEEKS`—Les valeurs de données sont agrégées en tranches hebdomadaires à l’intervalle fourni. `MONTHS`—Les valeurs de données sont agrégées en tranches mensuelles à l’intervalle fourni. `YEARS`—Les valeurs de données sont agrégées en tranches annuelles à l’intervalle fourni.	String
interval_ranges [interval_ranges,...] (Facultatif)	Plages d’intervalle spécifiques d’une table de valeurs à utiliser pour agréger les groupes de valeurs. La table de valeurs est constituée de paires de valeurs de plage minimale et maximale, avec le type de données Double ou Date. Ce paramètre est requis lorsque le paramètre `aggregation_def` est défini sur `INTERVAL_RANGE`. Colonnes de la table de valeurs : `Minimum Value`—The minimum value for a range. `Maximum Value`—The maximum value for a range.	Value Table
aggregation_function (Facultatif)	Fonction raster personnalisée à utiliser pour calculer les valeurs en pixels des rasters agrégés. L’entrée est un objet JSON de fonction raster ou un fichier `.rft.xml` créé depuis une chaîne de fonctions ou une fonction raster Python personnalisée. Ce paramètre est requis lorsque le paramètre `aggregation_method` est défini sur `CUSTOM`.	File; String
ignore_nodata (Facultatif)	Spécifie si les valeurs NoData sont ignorées lors de l’analyse. `DATA`—L’analyse inclut tous les pixels valides selon une dimension donnée et ignore les pixels NoData. Il s’agit de l’option par défaut. `NODATA`—Le résultat de l’analyse est NoData s’il existe des valeurs NoData pour les pixels selon la dimension donnée.	Boolean
dimensionless (Facultatif)	Spécifie si la couche possède des valeurs de dimension. Ce paramètre est activé uniquement si une seule tranche est sélectionnée pour la création d’une couche. `NO_DIMENSIONS`—La couche ne contient pas de valeurs de dimension. `DIMENSIONS`—La couche contient des valeurs de dimension. Il s’agit de l’option par défaut.	Boolean
percentile_value (Facultatif)	Centile à calculer. La valeur par défaut est de 90, soit le 90e centile. Les valeurs peuvent varier entre 0 et 100. Le centile n° 0 est équivalent à la statistique minimale tandis que le 100e centile équivaut au maximum Une valeur de 50 donne le même résultat que la statistique médiane. Ce paramètre est pris en charge uniquement si le paramètre `statistics_type` est défini sur `PERCENTILE`.	Double
percentile_interpolation_type (Facultatif)	Définit la méthode d’interpolation en centile à utiliser lorsque le nombre de valeurs du raster en entrée à calculer est pair. `NEAREST`—La valeur disponible la plus proche du centile souhaité sera utilisée. Dans ce cas, le type de pixel en sortie est identique à celui du raster de valeurs en entrée. `LINEAR`—La moyenne pondérée des deux valeurs environnantes du centile souhaité sera utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.	String

Valeur de retour

Nom	Explication	Type de données
out_multidimensional_raster	Jeu de données raster multidimensionnel CRF (Cloud Raster Format) en sortie.	Raster

Exemple de code

Exemple 1 d’utilisation de la fonction AggregateMultidimensionalRaster (fenêtre Python)

Cet exemple agrège les données de température en données annuelles avec les valeurs de température moyennes.

# Import system modules
import arcpy
from arcpy.ia import *

aggMultidim = arcpy.ia.AggregateMultidimensionalRaster("climateData.crf",
    "StdTime", "MEAN", "temperature", "INTERVAL_KEYWORD", "YEARLY",
    None, "", None, "", "DATA")

aggMultidim.save("C:/data/YearlyTemp.crf")

Exemple 2 d’utilisation de la fonction AggregateMultidimensionalRaster (script autonome)

Cet exemple agrège les données de température et de précipitation quotidiennes en données mensuelles avec les valeurs de température et de précipitation maximales.

# Import system modules
import arcpy
from arcpy.ia import *

# Define input parameters
inputFile = "C:/data/dailyclimateData.crf"
dimensionName = "StdTime"
aggregationMethod = "MAXIMUM"
variables = "temperature;precipitation"
aggregationDefinition = "INTERVAL_KEYWORD"
keyword = "MONTHLY"
ignore_nodata = "DATA"

# Run
aggMultidim = arcpy.ia.AggregateMultidimensionalRaster(inputFile, dimensionName,
    variables, aggregationMethod, aggregationDefinition, keyword, None, "", None, "",
    ignore_nodata)

# Save output
aggMultidim.save("C:/data/monthlymaxtemp.crf")

Environnements

Taille de cellule, Compression, Espace de travail courant, Transformations géographiques, NoData, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Étendue, Facteur de traitement parallèle, Pyramide, Statistiques raster, Méthode de rééchantillonnage, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence

Basic: Requiert Image Analyst ou Spatial Analyst
Standard: Requiert Image Analyst ou Spatial Analyst
Advanced: Requiert Image Analyst ou Spatial Analyst

Agréger un raster multidimensionnel (Outils Image Analyst)

Résumé

Utilisation

Paramètres

Valeur de retour

Environnements

Informations de licence

Rubriques connexes