Testing Tiling Job Output

The Aperture Tiles source code contains two utilities for testing the output of tiling jobs. Both utilities are Java applications that can help you quickly identify problems with your tiling job before you deploy your application.

  • Bin Visualizer: Renders basic representations of individual Avro tiles in your tile pyramid.
  • JSON Tile Visualizer: Generates a list of data or bin values that appear in individual Avro tiles in your tile pyramid.

If you notice any inconsistencies with the tiled data, you should review your tiling job parameters, fix any errors and run the job again.

Bin Visualizer

The BinVisualizer.java file in binning-utilities/src/main/java/com/oculusinfo/binning/visualization/ allows you to preview tiling job output before you configure your application.

NOTE: The Bin Visualizer currently only supports heatmap layers.

To use the Bin Visualizer
  1. Execute the following command in your root aperture-tiles directory to start the Bin Visualizer:

    gradlew runBinVisualizer
    
  2. Use the I/O type drop-down list to specify the location (HBase or local file system) of your Avro tiles, then enter the appropriate connection details:

    Storage Location Connection Details Default
    HBase Zookeeper quorum
    Zookeeper port
    HBase master
    Local file system Root path
    Tile extension avro
  3. In the Pyramid id field, enter the name of the tile pyramid you want to view.

  4. Set the following coordinates to choose the individual tile you want to view:

    Property Description
    Zoom level 0 is the highest level (most zoomed out),
    1 is one further zoom level down, etc.
    Tile x coordinate 0 is the leftmost column of tiles
    Tile y coordinate 0 is the bottommost row of tiles
  5. Click Show tile.

Bin Visualizer

JSON Tile Visualizer

NOTE: The JSON Tile Visualizer currently only supports heatmap layers.

To use the JSON Tile Visualizer
  1. In an integrated development environment, browse to the JsonTileVisualizer.java file in binning-utilities/src/main/java/com/oculusinfo/binning/visualization/.
  2. Debug the utility as a Java application.
  3. Specify the location of your Avro tiles, the name of the pyramid and the coordinates of the tile you want to view as described in steps 2-5 above.

JSON Tile Visualizer

Next Steps

For details on customizing an application that creates an interactive visual analytic from your tiled data, see the Setup the Application topic.