Étiquette | Explication | Type de données |
Cube spatio-temporel en entrée | Cube spatio-temporel à subdiviser. Les cubes spatio-temporels présentent une extension de fichier .nc et sont créés à l’aide de divers outils dans la boîte à outils Exploration des modèles spatio-temporels. | File |
Cube spatio-temporel en sortie | Subdivision du cube spatio-temporel qui répond aux critères spatiaux et temporels spécifiés par les paramètres Méthode de subdivision spatiale et Méthode de subdivision temporelle. Les variables d’analyse stockées dans le cube spatio-temporel en entrée seront exclues du cube spatio-temporel en sortie. | File |
Méthode de subdivision spatiale | Indique la méthode à utiliser pour subdiviser spatialement le cube spatio-temporel en entrée. Toute localisation dans le cube spatio-temporel en entrée qui répond à ces critères de subdivision spatiale sera incluse dans le cube spatio-temporel en sortie.
| String |
Méthode de subdivision temporelle | Indique la méthode à utiliser pour subdiviser temporellement un cube spatio-temporel. Tout intervalle temporel dans le cube spatio-temporel en entrée qui répond aux critères de subdivision temporelle sera inclus dans le cube spatio-temporel en sortie.
| String |
Entités de subdivision en entrée (Facultatif) | Classe d’entités qui contient des polygones, des points ou des lignes pour subdiviser un cube spatio-temporel. La relation spatiale entre les entités de subdivision en entrée et le cube spatio-temporel est spécifiée par le paramètre Relation spatiale. | Feature Layer |
Relation spatiale (Facultatif) | Indique la relation spatiale qui sera appliquée entre la valeur du paramètre Entités de subdivision en entrée ou Cube de subdivision spatiale en entrée et le cube spatio-temporel en entrée pour subdiviser spatialement le cube spatio-temporel. Les options disponibles pour la relation spatiale dépendent de la géométrie du cube spatio-temporel en entrée et des entités de subdivision en entrée ou du cube de subdivision spatiale en entrée.
| String |
Étendue (Facultatif) | Étendue spatiale qui va subdiviser spatialement le cube spatio-temporel en entrée. Le cube spatio-temporel en sortie inclura les localisations du cube spatio-temporel en entrée qui intersectent l’étendue. | Extent |
Cube de subdivision spatiale en entrée (Facultatif) | Cube spatio-temporel qui va subdiviser spatialement le cube spatio-temporel en entrée. La relation spatiale entre le cube spatio-temporel en entrée et le cube spatio-temporel est spécifiée par le paramètre Relation spatiale. | File |
Période de la subdivision (Facultatif) | Intervalle temporel qui va subdiviser temporellement le cube spatio-temporel en entrée. Tout intervalle temporel qui se trouve dans cet intervalle ou qui contient les valeurs de colonnes Heure de début ou Heure de fin est inclus dans le cube spatio-temporel en sortie. | Value Table |
Nombre d’intervalles temporels à supprimer (Facultatif) | Nombre d’intervalles temporels à partir du début ou de la fin du cube spatio-temporel en entrée qui seront supprimés du cube spatio-temporel en sortie. | Value Table |
Cube de subdivision temporelle en entrée (Facultatif) | Cube spatio-temporel qui va subdiviser temporellement le cube spatio-temporel en entrée. L’étendue temporelle du cube de subdivision temporelle définit l’étendue temporelle du cube spatio-temporel en sortie. Tout intervalle temporel qui se trouve dans l’étendue temporelle du cube de subdivision temporelle en entrée ou qui contient l’heure de début ou l’heure de fin du cube de subdivision temporelle sera inclus dans le cube spatio-temporel en sortie. | File |
Synthèse
Subdivise un cube spatio-temporel en fonction de l’étendue spatiale, de l’espace ou du temps.
L’outil génère les localisations et groupes du cube spatio-temporel en entrée qui répondent aux critères des méthodes de subdivision sélectionnées. L’outil peut subdiviser spatialement un cube spatio-temporel selon des entités, une étendue ou les localisations d’un autre cube spatio-temporel. L’outil peut aussi subdiviser temporellement un cube spatio-temporel selon une période, l’étendue temporelle d’un autre cube spatio-temporel ou en supprimant des intervalles temporels du début ou de la fin du cube spatio-temporel. Le cube spatio-temporel en sortie comprendra toutes les variables qui sont créées par les outils du jeu d’outils Création d’un cube spatio-temporel.
Illustration
Utilisation
Cet outil accepte les fichiers netCDF créés à l’aide de divers outils figurant dans la boîte à outils Exploration des modèles spatio-temporels.
Les applications possibles de cet outil sont les suivantes :
- Utilisez une classe d’entités d’Afrique pour subdiviser spatialement un cube spatio-temporel qui contient des données globales.
- Utilisez un cube spatio-temporel contenant des données pour la Californie afin de subdiviser spatialement un cube spatio-temporel qui comprend des données pour l’ensemble des États-Unis.
- Appliquez une subdivision temporelle pour supprimer des intervalles temporels du début ou de la fin d’un cube spatio-temporel dans lequel de nombreux groupes ont un décompte nul.
- Appliquez une subdivision temporelle pour supprimer les résultats prévus d’un cube spatio-temporel. Utilisez ensuite un outil du jeu d’outils Prévision de séries chronologiques sur le cube spatio-temporel.
Les variables d’analyse qui sont stockées dans le cube spatio-temporel en entrée ne sont pas transférées vers le cube spatio-temporel subdivisé en sortie. Les résultats d’analyse dans le cube spatio-temporel reposent sur sa structure spatio-temporelle. Si le cube spatio-temporel est subdivisé, les résultats d’analyse risquent de ne pas être valides. Pour récupérer les variables d’analyse, réexécutez les outils du jeu d’outils Analyse des modèles spatio-temporels et du jeu d’outils Prévision de séries chronologiques sur le cube spatio-temporel subdivisé en sortie.
L’outil génère des messages de géotraitement. Pour accéder aux messages, passez le curseur de la souris sur la barre d’avancement et cliquez sur le bouton de menu contextuel ou développez la section des messages dans la fenêtre Géotraitement. Les messages comprennent les informations suivantes :
- Une section Résumé de la subdivision qui compare les caractéristiques du cube spatio-temporel en entrée à celles du cube spatio-temporel subdivisé en sortie.
Section Caractéristiques du cube spatio-temporel qui décrit les propriétés spatiales et temporelles du cube spatio-temporel. Dans cette section, la valeur Durée des entités en entrée indique l’étendue temporelle des entités qui ont été utilisées pour créer le cube spatio-temporel d’origine. Cette valeur ne change pas si vous subdivisez un cube spatio-temporel. Pour plus d’informations sur ces caractéristiques, reportez-vous à la rubrique Fonctionnement de l’outil Créer un cube spatio-temporel.
- Section Contenu du cube spatio-temporel dans laquelle chaque ligne correspond à une variable dans le cube spatio-temporel en entrée. Chaque ligne comprend les statistiques de récapitulation de la variable, l’outil ayant créé la variable (avec le type d’agrégation et de remplissage), ainsi que les options de thème d’affichage disponibles dans les outils Visualiser le cube spatio-temporel en 2D et Visualiser le cube spatio-temporel en 3D.
- Si le cube spatio-temporel a été créé à l’aide de l’outil Créer un cube spatio-temporel en agrégeant des points, les messages comprennent une ou plusieurs sous-sections dans la section Localisation et groupes du cube spatio-temporel. La sous-section Nombre et chaque sous-section Champ de récapitulation facultative comprennent le nombre de groupes et de localisations contenant au moins un point. La faible densité (pourcentage de groupes contenant un décompte nul) est également répertoriée dans la sous-section Nombre.
- Si le cube spatio-temporel a été créé à l’aide d’un outil issu du jeu d’outils Prévision de séries chronologiques, les messages comprennent une section Détails de la prévision qui récapitule les méthodes de prévision ayant été appliquées. Dans cette section, l’étendue temporelle utilisée dans la prévision indique l’étendue temporelle des entités qui ont été utilisées pour créer le cube spatio-temporel d’origine. Cette valeur ne change pas si vous subdivisez un cube spatio-temporel.
- Les messages comprennent une ou plusieurs sections sous Tendances du cube spatio-temporel. Les sections comprennent la statistique de tendance de Mann-Kendall pour chaque variable dans le cube spatio-temporel.
Si le paramètre Méthode de subdivision spatiale est défini sur Entités, vérifiez que le système de coordonnées des entités subdivisées en entrée correspond à celui du cube spatio-temporel en entrée. Utilisez l’outil Projeter pour modifier le système de coordonnées des entités de subdivision en entrée. Si les systèmes de coordonnées ne concordent pas, la subdivision risque de ne pas être possible ou les localisations dans le cube spatio-temporel en sortie peuvent se retrouver dans des endroits inattendus.
L’application d’une subdivision spatiale ne modifie pas la géométrie d’une localisation du cube spatio-temporel. Chaque localisation est incluse ou exclue du cube spatio-temporel en sortie en fonction des critères de subdivision spatiale sélectionnés.
L’application d’une subdivision temporelle ne change pas l’intervalle temporel dans le cube spatio-temporel et l’étendue temporelle des groupes. Chaque groupe est inclus ou exclu du cube spatio-temporel en sortie en fonction des critères de subdivision temporelle sélectionnés. Si le paramètre Méthode de subdivision temporelle est défini sur Définie par l’utilisateur ou Cube spatio-temporel et que les dates/heures de début ou de fin se trouvent dans un groupe, le groupe entier est inclus dans le cube spatio-temporel en sortie. Dans ce cas, il est possible que la plage temporelle du cube spatio-temporel en sortie ne concorde pas avec les dates/heures de début ou de fin spécifiées ou avec l’intervalle temporel du cube de subdivision temporelle. Par exemple, si un cube spatio-temporel présente un intervalle temporel d’un mois et qu’il est subdivisé temporellement par un cube spatio-temporel doté d’un intervalle temporel qui s’étend du 24/01/2020 au 24/12/2020, l’intervalle temporel du cube spatio-temporel en sortie s’étendra du 01/01/2020 au 31/12/2020.
Chaque intervalle temporel d’un cube spatio-temporel est exclusif de la date et de l’heure de début du groupe et inclusif de la date et de l’heure de fin du groupe. Par exemple, si un groupe a pour date et heure de début 01/01/2020 00:00:00 et pour date et heure de fin 01/01/2021 00:00:00, le groupe inclut les données ultérieures au 01/01/2020 à 00:00:00 et antérieures au ou datant du 01/01/2021 à 00:00:00. Si la colonne Heure de début du paramètre Période de la subdivision indique 01/01/2021 00:00:00, le cube spatio-temporel en sortie du sous-ensemble commence le 01/01/2020 à 00:00:00 de sorte que les données datant du 01/01/2021 à 00:00:00 soient comprises dans le cube spatio-temporel en sortie.
Si un cube spatio-temporel est subdivisé temporellement, le cube spatio-temporel en sortie doit contenir au moins 10 intervalles temporels pour que l’outil puisse s’exécuter.
Si les outils subdivisent un cube de localisations définies, toute localisation qui ne répond pas aux critères de subdivision sera supprimée du cube spatio-temporel en sortie. Toutefois, si les outils subdivisent un cube de grilles, toute localisation qui ne répond pas aux critères de subdivision sera uniquement masquée dans le cube spatio-temporel en sortie. Les localisations masquées demeurent dans le cube spatio-temporel, mais elles sont exclues de l’analyse.
Si un cube spatio-temporel a été créé à l’aide de l’outil Créer un cube spatio-temporel en agrégeant des points, il peut contenir des variables qui disposent de différentes localisations masquées. Cela impacte la façon dont l’outil Subdiviser un cube spatio-temporel applique une subdivision spatiale.
- Si le cube spatio-temporel est défini comme valeur du paramètre Cube de subdivision spatial en entrée, les localisations de la variable de décompte serviront à subdiviser spatialement le cube spatio-temporel en entrée.
- Si le cube spatio-temporel est le cube spatio-temporel en entrée et que l’outil applique une subdivision spatiale, chaque variable doit être présente dans au moins une localisation du cube spatio-temporel subdivisé en sortie. Sinon, l’outil connaît un échec.
- Identifiez la variable du cube spatio-temporel qui détermine la subdivision spatiale en recréant le cube spatio-temporel avec uniquement la variable d’intérêt. Commencez par utiliser l’outil Visualiser le cube spatio-temporel en 3D pour visualiser les valeurs du cube spatio-temporel. Appliquez ensuite l’outil Créer un cube spatio-temporel à partir de localisations définies pour créer un nouveau cube spatio-temporel à partir de l’entité en sortie. Sélectionnez la variable d’intérêt.
Si vous subdivisez temporellement un cube de prévision et supprimez tous les intervalles temporels prévus, le cube spatio-temporel en sortie n’est plus un cube de prévision. Le cube spatio-temporel obtenu peut être utilisé en entrée dans n’importe quel outil du jeu d’outils Prévision de séries chronologiques.
Paramètres
arcpy.stpm.SubsetSpaceTimeCube(in_cube, out_cube, spatial_subset_method, temporal_subset_method, {in_subset_features}, {spatial_relationship}, {spatial_extent}, {in_spatial_cube}, {time_span_subset}, {remove_time_steps}, {in_temporal_cube})
Nom | Explication | Type de données |
in_cube | Cube spatio-temporel à subdiviser. Les cubes spatio-temporels présentent une extension de fichier .nc et sont créés à l’aide de divers outils dans la boîte à outils Exploration des modèles spatio-temporels. | File |
out_cube | Subdivision du cube spatio-temporel qui répond aux critères spatiaux et temporels spécifiés par les paramètres spatial_subset_method et temporal_subset_method. Les variables d’analyse stockées dans le cube spatio-temporel en entrée seront exclues du cube spatio-temporel en sortie. | File |
spatial_subset_method | Indique la méthode à utiliser pour subdiviser spatialement le cube spatio-temporel en entrée. Toute localisation dans le cube spatio-temporel en entrée qui répond à ces critères de subdivision spatiale sera incluse dans le cube spatio-temporel en sortie.
| String |
temporal_subset_method | Indique la méthode à utiliser pour subdiviser temporellement un cube spatio-temporel. Tout intervalle temporel dans le cube spatio-temporel en entrée qui répond aux critères de subdivision temporelle sera inclus dans le cube spatio-temporel en sortie.
| String |
in_subset_features (Facultatif) | Classe d’entités qui contient des polygones, des points ou des lignes pour subdiviser un cube spatio-temporel. La relation spatiale entre les entités de subdivision en entrée et le cube spatio-temporel est spécifiée par le paramètre spatial_relationship. | Feature Layer |
spatial_relationship (Facultatif) | Indique la relation spatiale qui sera appliquée entre la valeur du paramètre in_subset_features ou in_spatial_cube et le cube spatio-temporel en entrée pour subdiviser spatialement le cube spatio-temporel. Les options disponibles pour la relation spatiale dépendent de la géométrie du cube spatio-temporel en entrée et des entités de subdivision en entrée ou du cube de subdivision spatiale en entrée.
| String |
spatial_extent (Facultatif) | Étendue spatiale qui va subdiviser spatialement le cube spatio-temporel en entrée. Le cube spatio-temporel en sortie inclura les localisations du cube spatio-temporel en entrée qui intersectent l’étendue. | Extent |
in_spatial_cube (Facultatif) | Cube spatio-temporel qui va subdiviser spatialement le cube spatio-temporel en entrée. La relation spatiale entre le cube spatio-temporel en entrée et le cube spatio-temporel est spécifiée par le paramètre spatial_relationship. | File |
time_span_subset [time_span_subset,...] (Facultatif) | Intervalle temporel qui va subdiviser temporellement le cube spatio-temporel en entrée. Tout intervalle temporel qui se trouve dans cet intervalle ou qui contient les valeurs d’heure de début ou d’heure de fin sera inclus dans le cube spatio-temporel en sortie. | Value Table |
remove_time_steps [remove_time_steps,...] (Facultatif) | Nombre d’intervalles temporels à partir du début ou de la fin du cube spatio-temporel en entrée qui seront supprimés du cube spatio-temporel en sortie. | Value Table |
in_temporal_cube (Facultatif) | Cube spatio-temporel qui va subdiviser temporellement le cube spatio-temporel en entrée. L’étendue temporelle du cube de subdivision temporelle définit l’étendue temporelle du cube spatio-temporel en sortie. Tout intervalle temporel qui se trouve dans l’étendue temporelle du cube de subdivision temporelle en entrée ou qui contient l’heure de début ou l’heure de fin du cube de subdivision temporelle sera inclus dans le cube spatio-temporel en sortie. | File |
Exemple de code
Le script Python ci-dessous montre comment utiliser la fonction SubsetSpaceTimeCube.
import arcpy
arcpy.env.workspace = "C:\STPM"
arcpy.stpm.SubsetSpaceTimeCube("input_cube.nc", "subset_cube.nc",
"SPACE_TIME_CUBE", "NONE", None, None, None,
"spatial_subset_cube.nc")
Le script Python autonome ci-dessous illustre l’utilisation de la fonction SubsetSpaceTimeCube.
# Use the Subset Space Time Cube tool to subset a space-time cube by time
# and space.
# Import system modules
import arcpy
import os
# Set workspace
arcpy.env.workspace = r"C:\Analysis"
gdb = os.path.join(arcpy.env.workspace, "continents.gdb")
arcpy.env.overwriteOutput = True
# Temporally subset a space-time cube
temperature_stc = "Temperature_STC.nc"
temporal_subset_stc = "Temperature_STC_temporal_subset.nc"
arcpy.stpm.SubsetSpaceTimeCube(temperature_stc, temporal_subset_stc, "NONE",
"USER_DEFINED", None, "", "DEFAULT", None,
"1/1/2012 1/1/2022")
# Spatially subset the data for every continent in the space-time cube
continents = ["Africa", "North_America", "Antarctica", "South_America", "Asia",
"Europe", "Australia"]
for continent in continents:
feature = os.path.join(gdb, c)
arcpy.stpm.SubsetSpaceTimeCube(temporal_subset_stc,
continent + "_temperature_subset.nc",
"FEATURES", "NONE", feature, "INTERSECT")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?