JPEG visualization of graph

The tivxExportGraphToDot API provides the ability to generate a JPEG diagramming the nodes in a graph. Below are a few notes on how to use this tool.

• In PC emulation mode, this API will generate both a .txt file and a .jpg file located at the specified output path. The graph diagram will not show the cores that each node runs on, it will simply show the interactions between nodes in the graph.

• In target mode, this API will generate only a .txt file located at the specified output path. However, the .jpg file can be generated on a Linux machine using the dot command. The command to generate the JPEG can be seen below:

  dot -Tjpg -o<output file="" path>="">/<jpg name>="">.jpg <text file="" name>="">

  In the case of a text file called graph.txt, the following command would be used to generate a JPEG called graph.jpg in the current directory:

  dot -Tjpg -o./graph.jpg graph.txt

• In the case of a pipelined graph, this API outputs 4 separate files:
  • 1. The first file shows the interaction between all nodes and data objects in a graph.
  • 2. In the case of a pipelined graph, the second file shows the interactions between the nodes and data reference queues for every pipeline ID for the pipeline depth of a graph.
  • 3. In the case of a pipelined graph, the third file shows how each of the data reference queues are acquired and released by the framework. (Note: this file requires a more in-depth knowledge of the framework and is mainly intended for debugging issues within the framework.)
  • 4. In the case of a pipelined graph, the fourth file shows the interactions between the nodes and data reference queues for the first pipeline ID of a graph.