Skip To Content

Visualize Space Time Cube in 3D

Summary

Visualizes the variables stored in a netCDF cube created with the Space Time Pattern Mining tools. Output from this tool is a three-dimensional representation uniquely rendered based on the variable and theme chosen.

Illustration

Visualizing the space-time cube in 3D

Usage

  • This tool can only accept netCDF files created by the Create Space Time Cube By Aggregating Points or Create Space Time Cube From Defined Locations tool.

  • The Value theme allows you to see the raw numbers associated with aggregation or creation of the cube.

  • If you have run Emerging Hot Spot Analysis on a particular variable, you also have the option of visualizing Hot and cold spot results. This theme shows you the statistical significance of each bin based on the space time hot spot analysis run in Emerging Hot Spot Analysis .

  • If you have run Local Outlier Analysis on a particular variable, you also have the option of visualizing Cluster and outlier results. This theme shows you the result type assigned to each statistically significant bin based on the analysis run in Local Outlier Analysis.

  • For cubes that were created from defined locations and aggregated temporally, the theme Temporal aggregation count will be available to visualize the count of records aggregated into each space-time bin.

  • Time-series charts are created as part of the output of this tool. If the Display Theme is Hot and cold spot results, the z-scores are plotted over time for each location. For all other display themes, the value of the Cube Variable chosen is charted over time for each location. These charts can be accessed by selecting the List By Charts tab List By Charts in the Contents pane.

  • Any Summary Fields or Variables that were aggregated will also give you the option of visualizing the Estimated bins so you can see exactly which bins were estimated based on your decisions in Create Space Time Cube By Aggregating Points or Create Space Time Cube From Defined Locations.

  • Because time is used as the vertical axis in visualizing the space-time cube, it is important for accurate interpretation that all locations on the ground are at the same elevation. This way, all time-step intervals start at the same base. To do this, the default elevation services need to be turned off by clicking off any Ground layers that appear in the Elevation Surfaces group in the Contents pane.

    Note:
    The next time a New Scene is added, the default surfaces will populate again.

  • If the data is not drawing, you may need to clear the visibility range limits, which you can do by selecting the new layer in the Contents pane, choosing the Appearance tab, and clicking the Clear Limits button.

  • The output of this tool is symbolized with cube-shaped point symbols representing each bin in the cube. If your cube was created from defined locations, it is best practice to add a 2D representation of your polygons to your Scene.

  • The space-time cube can also be visualized in 3D using the Space Time Cube Explorer Add-in.

  • To maintain temporal precision, shapefile output is not recommended as it cannot store both date and time in the same field. This is particularly important when visualizing the results in 3D and using the time slider to explore the results. Temporal precision can only be achieved when storing data in a geodatabase.

Syntax

VisualizeSpaceTimeCube3D_stpm (in_cube, cube_variable, display_theme, output_features)
ParameterExplanationData Type
in_cube

The netCDF cube that contains the variable to be displayed. This file must have an .nc extension and must have been created using either the Create Space Time Cube By Aggregating Points or Create Space Time Cube From Defined Locations tool.

File
cube_variable

The numeric variable in the netCDF cube that you want to explore. The cube will always contain the COUNT variable if aggregation was used in cube creation. Any Summary Fields or Variables will also be available if they were included in the cube creation process.

String
display_theme

The characteristic of the Cube Variable that you want to display. Options will vary depending on how the cube was created and the analyses run.

Value is the numeric value of the Cube Variable chosen. Estimated bins are only available for the Summary Fields that were included in the cube creation process. Hot and cold spot results will only be available for Cube Variables for which Emerging Hot Spot Analysis has been run. Cluster and outlier results will only be available for Cube Variables for which Local Outlier Analysis has been run. Temporal aggregation count will only be available for defined location cubes that have been aggregated temporally.

  • VALUEThe numeric value of the cube variable chosen
  • HOT_AND_COLD_SPOT_RESULTSThe statistical significance of each bin based on the space-time hot spot analysis run in Emerging Hot Spot Analysis
  • ESTIMATED_BINSDisplays the bins with estimated values
  • LOCAL_OUTLIER_RESULTSThe cluster or outlier type (COType) assigned to each bin from the analysis run in Local Outlier Analysis
  • TEMPORAL_AGGREGATION_COUNTThe count of records aggregated into each space-time bin
String
output_features

The output feature class results. This feature class will be a three-dimensional map representation of the display variable chosen that can be displayed in a 3D scene.

Feature Class

Code sample

VisualizeSpaceTimeCube3D example 1 (Python window)

The following Python window script demonstrates how to use the VisualizeSpaceTimeCube3D tool.

import arcpy
arcpy.env.workspace = r"C:\STPM"
arcpy.VisualizeSpaceTimeCube3D_stpm("Homicides.nc", "COUNT", "HOT_AND_COLD_SPOT_RESULTS", "Homicides_Count_HS.shp")
VisualizeSpaceTimeCube3D example 2 (stand-alone script)

The following stand-alone Python script demonstrates how to use the VisualizeSpaceTimeCube3D tool.

# Display Space Time Cube of homicide incidents in a metropolitan area

# Import system modules
import arcpy

# Set geoprocessor object property to overwrite existing output, by default
arcpy.env.overwriteOutput = True

# Local variables...
workspace = r"C:\STPM"

arcpy.env.workspace = workspace

# Display Space Time Cube of homicide with the hot and cold spots with crime counts
# Process: Visualize Space Time Cube in 3D 
cube = arcpy.VisualizeSpaceTimeCube3D_stpm("Homicides.nc", "COUNT", "HOT_AND_COLD_SPOT_RESULTS", "Homicides_Count_HS.shp")

Licensing information

  • ArcGIS Desktop Basic: Yes
  • ArcGIS Desktop Standard: Yes
  • ArcGIS Desktop Advanced: Yes

Related topics