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
Usage
This tool can only accept netCDF files created by the Create Space Time Cube By Aggregating Points tool.
To visualize the space-time cube in 3D, you must use either ArcGlobe or ArcGIS Pro. For optimal 3D visualization, ArcGIS Pro is recommended.
The VALUE theme allows you to see the raw numbers associated with aggregation.
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.
Any Summary Fields that were aggregated will also have 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.
If the data is not drawing, you may need to manually generate the data cache. You can do this by right-clicking the output layer and selecting Generate Data Cache. When the Generate Cache window pops up, click OK.
In order to maintain temporal precision, shapefile output is not recommended as they 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(in_cube, cube_variable, display_theme, output_features)
Parameter | Explanation | Data 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 the Create Space Time Cube By Aggregating Points tool. | File |
cube_variable | The numeric variable in the netCDF cube that you want to explore. The cube will always contain the COUNT variable. Any Summary Fields in the cube 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. VALUE will always contain an option for every cube. 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.
| 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.
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 Python 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.overwriteOutput = True
# Local variables...
workspace = r"C:\STPM"
try:
# Set the current workspace (to avoid having to specify the full path to the feature classes each time)
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")
except:
# If any error occurred when running the tool, print the messages
print(arcpy.GetMessages())
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes