Etiqueta | Explicación | Tipo de datos |
Cubo de espacio-tiempo de entrada | El cubo de espacio-tiempo del que se desea obtener un subconjunto. Los cubos de espacio-tiempo tienen una extensión de archivo .nc y se crean utilizando varias herramientas de la caja de herramientas Minería de patrones en espacio-tiempo. | File |
Cubo de espacio-tiempo de salida | El subconjunto del cubo de espacio-tiempo de entrada que satisface con los criterios espaciales y temporales especificados por los parámetros Método de subconjunto espacial y Método de subconjunto temporal. Las variables de análisis almacenadas en el cubo de espacio-tiempo de entrada se excluirán del cubo de espacio-tiempo de salida. | File |
Método de subconjunto espacial | Especifica el método que se utilizará para crear mediante el espacio un subconjunto del cubo de espacio-tiempo de entrada. Cualquier ubicación del cubo de espacio-tiempo de entrada que cumpla con este criterio de subconjunto espacial se incluirá en el cubo de espacio-tiempo de salida.
| String |
Método de subconjunto temporal | Especifica el método que se utilizará para crear mediante el tiempo un subconjunto de un cubo de espacio-tiempo. Cualquier periodo de tiempo del cubo de espacio-tiempo de entrada que cumpla con los criterios del subconjunto temporal se incluirá en el cubo de espacio-tiempo de salida.
| String |
Entidades de subconjunto de entrada (Opcional) | Una clase de entidad que contiene polígonos, puntos o líneas para crear un subconjunto de un cubo de espacio-tiempo. La relación espacial entre las entidades del subconjunto de entrada y el cubo de espacio-tiempo se especifica mediante el parámetro Relación espacial. | Feature Layer |
Relación espacial (Opcional) | Especifica la relación espacial que se aplicará entre el valor del parámetro Entidades de subconjunto de entrada o Cubo de subconjunto espacial de entrada y el cubo de espacio-tiempo de entrada para crear mediante el espacio un subconjunto del cubo de espacio-tiempo. Las opciones de relación espacial disponibles dependerán de la geometría del cubo de espacio-tiempo de entrada y de las entidades del subconjunto de entrada o del cubo de subconjunto espacial de entrada.
| String |
Extensión (Opcional) | La extensión espacial por la cual se creará mediante el espacio un subconjunto del cubo de espacio-tiempo de entrada. El cubo de espacio-tiempo de salida incluirá las ubicaciones del cubo de espacio-tiempo de entrada que se intersequen con la extensión. | Extent |
Cubo de subconjunto espacial de entrada (Opcional) | Un cubo de espacio-tiempo por el cual se creará mediante el espacio un subconjunto del cubo de espacio-tiempo de entrada. La relación espacial entre el cubo de subconjunto espacial de entrada y el cubo de espacio-tiempo se especifica mediante el parámetro Relación espacial. | File |
Intervalo de tiempo del subconjunto (Opcional) | El intervalo de tiempo para crear mediante el tiempo subconjuntos del cubo de espacio-tiempo de entrada. Cualquier periodo de tiempo que esté dentro de este intervalo de tiempo o que contenga los valores de las columnas Hora de inicio u Hora de finalización se incluirán en el cubo de espacio-tiempo de salida. | Value Table |
Número de periodos de tiempo a eliminar (Opcional) | El número de periodos de tiempo desde el inicio y el final del cubo de espacio-tiempo de entrada que se eliminarán del cubo de espacio-tiempo de salida. | Value Table |
Cubo de subconjunto temporal de entrada (Opcional) | Un cubo de espacio-tiempo por el cual se creará mediante el tiempo un subconjunto del cubo de espacio-tiempo de entrada. La extensión temporal del cubo de subconjunto temporal define la extensión temporal del cubo de espacio-tiempo de salida. Cualquier periodo de tiempo que esté dentro de la extensión temporal del cubo de subconjunto temporal de entrada o que contenga la hora de inicio o el tiempo de finalización del cubo del subconjunto temporal se incluirá en el cubo de espacio-tiempo de salida. | File |
Resumen
Subconjuntos de un cubo de espacio-tiempo por extensión espacial, espacio o tiempo.
La herramienta genera las ubicaciones y bins del cubo de espacio-tiempo de entrada que cumplen los criterios de los métodos de subconjuntos seleccionados. La herramienta puede crear mediante el espacio un subconjunto de un cubo de espacio-tiempo por entidades, una extensión o las ubicaciones de otro cubo de espacio-tiempo. La herramienta también puede crear mediante el tiempo un subconjunto de un cubo de espacio-tiempo por un intervalo de tiempo, la extensión temporal de otro cubo de espacio-tiempo o eliminar los periodos de tiempo del inicio o fin del cubo de espacio-tiempo. El cubo de espacio-tiempo de salida incluirá todas las variables creadas por las herramientas del conjunto de herramientas Creación de cubo de espacio-tiempo.
Ilustración
Uso
Esta herramienta acepta archivos netCDF creados por varias herramientas en la caja de herramientas Minería de patrones en espacio-tiempo.
Más información sobre la creación de un cubo de espacio-tiempo
A continuación se describen aplicaciones potenciales para esta herramienta:
- Utilice una clase de entidad de África para crear mediante el espacio un subconjunto de un cubo de espacio-tiempo que contenga datos globales.
- Utilice un cubo de espacio-tiempo que contenga datos de California para crear mediante el espacio un subconjunto de un cubo de espacio-tiempo que incluya datos de todo Estados Unidos.
- Aplique un subconjunto temporal para eliminar todos los periodos de tiempo del inicio o del final de un cubo de espacio-tiempo en el que muchos de los bins tienen un recuento cero.
- Aplique un subconjunto temporal para eliminar los resultados previstos de un cubo de espacio-tiempo. A continuación, utilice una herramienta del conjunto de herramientas Previsión de serie temporal del cubo de espacio-tiempo.
Las variables de análisis que se almacenan en el cubo de espacio-tiempo de entrada no se transfieren al cubo de espacio-tiempo de salida del subconjunto. Los resultados del análisis del cubo de espacio-tiempo de entrada se basan en su estructura espaciotemporal. Si el cubo de espacio-tiempo es un subconjunto, es posible que los resultados del análisis no sean válidos. Para recuperar las variables de análisis, vuelva a ejecutar las herramientas utilizadas desde el conjunto de herramientas Análisis de patrones en espacio-tiempo y el conjunto de herramientas Previsión de serie temporal con el cubo de espacio-tiempo de salida del subconjunto.con el cubo de espacio-tiempo de salida del subconjunto.
La herramienta crea mensajes de geoprocesamiento. Para acceder a los mensajes, pase el cursor sobre la barra de progreso y haga clic en el botón emergente o expanda la sección de mensajes del panel Geoprocesamiento. Estos mensajes incluyen la siguiente información:
- Sección Resumen de subconjunto que compara las características del cubo de espacio-tiempo de entrada con las del cubo de espacio-tiempo de salida del subconjunto.
Una sección de Características del cubo de espacio-tiempo que describe las propiedades de espacio y tiempo del cubo de espacio-tiempo. En esta sección, el valor Extensión temporal de la entidad de entrada proporciona la extensión temporal de las entidades usadas para crear el cubo de espacio-tiempo original. Este valor no cambiará si crea un subconjunto de un cubo de espacio-tiempo. Para obtener más información acerca de estas características, consulte Cómo funciona la herramienta Crear cubo de espacio-tiempo.
- Una sección de Contenido del cubo de espacio-tiempo en la que cada fila corresponde a una variable en el cubo de espacio-tiempo de entrada. Cada fila contiene el resumen de estadísticas de la variable, la herramienta que creó la variable (junto con el tipo de agregación y el tipo de relleno) y las opciones del tema de visualización disponibles en las herramientas Visualizar el cubo de espacio-tiempo en 2D y Visualizar el cubo de espacio-tiempo en 3D.
- Si el cubo de espacio-tiempo se creó utilizando la herramienta Crear cubo de espacio-tiempo agregando puntos, los mensajes incluirán una o varias subsecciones en la sección Ubicaciones y bins de cubo de espacio-tiempo. La subsección Recuento y cada subsección Campo de resumen opcional contienen el número de bins y ubicaciones que contienen al menos un punto. La escasez (porcentaje de bins que contienen un recuento cero) también se muestra en la subsección Recuento.
- Si el cubo de espacio-tiempo se creó con una herramienta del conjunto de herramientas Previsión de serie temporal, los mensajes contendrán una sección Detalles de la previsión que resume los métodos de previsión que se aplicaron. En esta sección, la extensión de tiempo utilizada en el pronóstico proporciona la extensión temporal de las entidades usadas para crear el cubo de espacio-tiempo original. Este valor no cambiará si crea un subconjunto de un cubo de espacio-tiempo.
- Los mensajes incluirán una o más secciones bajo Tendencias de cubo de espacio-tiempo. Las secciones incluyen la estadística de tendencias de Mann-Kendall general para cada variable del cubo de espacio-tiempo.
Si el parámetro Método de subconjunto espacial tiene el valor Entidades, asegúrese de que el sistema de coordenadas de las entidades del subconjunto de entrada coincida con el sistema de coordenadas del cubo de espacio-tiempo de entrada. Utilice la herramienta Proyectar para modificar el sistema de coordenadas de las entidades del subconjunto de entrada. Si el sistema de coordenadas no coincide, puede que el subconjunto no sea posible o que las ubicaciones del cubo de espacio-tiempo de salida estén en lugares inesperados.
La aplicación de un subconjunto espacial no modifica la geometría de ninguna ubicación del cubo de espacio-tiempo. Cada ubicación se incluye o se excluye del cubo de espacio-tiempo de salida basándose en los criterios de subconjunto espacial seleccionados.
La aplicación de un subconjunto temporal no cambia el intervalo de periodo de tiempo del cubo de espacio-tiempo ni la extensión de tiempo de los bins. Cada bin se incluye o se excluye del cubo de espacio-tiempo de salida basándose en los criterios de subconjunto temporal seleccionados. Si el parámetro Método de subconjunto temporal tiene el valor Definido por el usuario o Cubo de espacio-tiempo y el tiempo de inicio o finalización especificado está dentro de un bin, todo el bin se incluirá en el cubo de espacio-tiempo de salida. En este caso, el rango de tiempo del cubo de espacio-tiempo de salida puede no coincidir con el tiempo de inicio o de finalización especificado o con el intervalo de tiempo del cubo del subconjunto temporal. Por ejemplo, si un cubo de espacio-tiempo tiene un intervalo de periodo de tiempo de un mes y es un subconjunto creado mediante el tiempo con un cubo de espacio-tiempo con un intervalo de tiempo que abarca de 24/1/2020 a 24/12/2020, el intervalo de tiempo del cubo de espacio-tiempo de salida variará de 1/1/2020 a 31/12/2020.
Cada periodo de tiempo en un cubo de espacio-tiempo excluye la hora de inicio del bin e incluye la hora de finalización del bin. Por ejemplo, si la hora de inicio de un bin es 1/1/2020 12:00:00 a.m. y su hora de finalización es 1/1/2021 12:00:00 a.m., el bin incluirá datos posteriores al 1/1/2020 12: 00:00 a.m. y hasta, el o antes del 1/1/2021 12:00:00 a.m. Si la columna Hora de inicio del parámetro Intervalo de tiempo del subconjunto se especifica como 1/1/2021 12:00:00 a.m., el cubo de espacio-tiempo de salida del subconjunto comenzará desde el 1/1/2020 12:00:00 a.m. de forma que los datos a partir del 1/1/2021 12:00:00 a.m. se incluirán en el cubo de espacio-tiempo de salida.
Si un cubo de espacio-tiempo tiene un subconjunto creado mediante el tiempo, el cubo de espacio-tiempo de salida debe contener al menos 10 periodos de tiempo para que la herramienta se ejecute.
Si las herramientas crean subconjuntos de un cubo de ubicaciones definidas, cualquier ubicación que no cumpla los criterios del subconjunto se eliminará del cubo de espacio-tiempo de salida. Sin embargo, si la herramienta crea subconjuntos de un cubo de cuadrícula, cualquier ubicación que falle el criterio del subconjunto solo se enmascarará en el cubo de espacio-tiempo de salida. Las ubicaciones enmascaradas permanecen en el cubo de espacio-tiempo, pero se excluyen del análisis.
Más información sobre la estructura de los cubos de espacio-tiempo
Si se ha creado un cubo de espacio-tiempo con la herramienta Crear cubo de espacio-tiempo agregando puntos puntos, el cubo puede contener variables que tengan distintas ubicaciones enmascaradas. Este hecho afecta a la forma en que la herramienta Cubo de espacio-tiempo del subconjunto aplica un subconjunto espacial.
- Si el cubo de espacio-tiempo se ha definido como el valor del parámetro Cubo de subconjunto espacial de entrada, las ubicaciones de la variable de recuento se utilizarán para crear mediante el espacio un subconjunto del cubo de espacio-tiempo de entrada.
- Si el cubo de espacio-tiempo es el cubo de espacio-tiempo de entrada y la herramienta aplica un subconjunto espacial, cada variable debe existir en al menos una ubicación del cubo de espacio-tiempo de salida del subconjunto; de lo contrario, la herramienta no funcionará.
- Controle qué variable del cubo de espacio-tiempo determina el subconjunto espacial volviendo a crear el cubo de espacio-tiempo utilizando solo la variable de interés. En primer lugar, use la herramienta Visualizar cubo de espacio-tiempo en 3D para visualizar los valores del cubo de espacio-tiempo. A continuación, aplique la herramienta Crear cubo de espacio-tiempo a partir de ubicaciones definidas definidas para crear un nuevo cubo de espacio-tiempo a partir de la entidad de salida. Seleccione la variable de interés.
Si crea mediante el tiempo un subconjunto de un cubo previsto y elimina todos los periodos de tiempo previsto, el cubo de espacio-tiempo de salida ya no será un cubo de predicción. El cubo de espacio-tiempo resultante se puede utilizar como entrada de cualquier herramienta del conjunto de herramientas Predicción de serie temporal.
Parámetros
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})
Nombre | Explicación | Tipo de datos |
in_cube | El cubo de espacio-tiempo del que se desea obtener un subconjunto. Los cubos de espacio-tiempo tienen una extensión de archivo .nc y se crean utilizando varias herramientas de la caja de herramientas Minería de patrones en espacio-tiempo. | File |
out_cube | El subconjunto del cubo de espacio-tiempo de entrada que satisface con los criterios espaciales y temporales especificados por los parámetros spatial_subset_method y temporal_subset_method. Las variables de análisis almacenadas en el cubo de espacio-tiempo de entrada se excluirán del cubo de espacio-tiempo de salida. | File |
spatial_subset_method | Especifica el método que se utilizará para crear mediante el espacio un subconjunto del cubo de espacio-tiempo de entrada. Cualquier ubicación del cubo de espacio-tiempo de entrada que cumpla con este criterio de subconjunto espacial se incluirá en el cubo de espacio-tiempo de salida.
| String |
temporal_subset_method | Especifica el método que se utilizará para crear mediante el tiempo un subconjunto de un cubo de espacio-tiempo. Cualquier periodo de tiempo del cubo de espacio-tiempo de entrada que cumpla con los criterios del subconjunto temporal se incluirá en el cubo de espacio-tiempo de salida.
| String |
in_subset_features (Opcional) | Una clase de entidad que contiene polígonos, puntos o líneas para crear un subconjunto de un cubo de espacio-tiempo. La relación espacial entre las entidades del subconjunto de entrada y el cubo de espacio-tiempo se especifica mediante el parámetro spatial_relationship. | Feature Layer |
spatial_relationship (Opcional) | La relación espacial que se aplicará entre el valor del parámetro in_subset_features o in_spatial_cube y el cubo de espacio-tiempo de entrada para crear mediante el espacio un subconjunto del cubo de espacio-tiempo. Las opciones de relación espacial disponibles dependerán de la geometría del cubo de espacio-tiempo de entrada y de las entidades del subconjunto de entrada o del cubo de subconjunto espacial de entrada.
| String |
spatial_extent (Opcional) | La extensión espacial por la cual se creará mediante el espacio un subconjunto del cubo de espacio-tiempo de entrada. El cubo de espacio-tiempo de salida incluirá las ubicaciones del cubo de espacio-tiempo de entrada que se intersequen con la extensión. | Extent |
in_spatial_cube (Opcional) | Un cubo de espacio-tiempo por el cual se creará mediante el espacio un subconjunto del cubo de espacio-tiempo de entrada. La relación espacial entre el cubo de subconjunto espacial de entrada y el cubo de espacio-tiempo se especifica mediante el parámetro spatial_relationship. | File |
time_span_subset [time_span_subset,...] (Opcional) | El intervalo de tiempo para crear mediante el tiempo subconjuntos del cubo de espacio-tiempo de entrada. Cualquier periodo de tiempo que esté dentro de este intervalo de tiempo o que contenga los valores de las columnas de hora de inicio u hora de finalización se incluirán en el cubo de espacio-tiempo de salida. | Value Table |
remove_time_steps [remove_time_steps,...] (Opcional) | El número de periodos de tiempo desde el inicio y el final del cubo de espacio-tiempo de entrada que se eliminarán del cubo de espacio-tiempo de salida. | Value Table |
in_temporal_cube (Opcional) | Un cubo de espacio-tiempo por el cual se creará mediante el tiempo un subconjunto del cubo de espacio-tiempo de entrada. La extensión temporal del cubo de subconjunto temporal define la extensión temporal del cubo de espacio-tiempo de salida. Cualquier periodo de tiempo que esté dentro de la extensión temporal del cubo de subconjunto temporal de entrada o que contenga la hora de inicio o el tiempo de finalización del cubo del subconjunto temporal se incluirá en el cubo de espacio-tiempo de salida. | File |
Muestra de código
En el siguiente script de Python se muestra cómo utilizar la función 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")
El siguiente script independiente de Python muestra cómo utilizar la función 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")