VisualDebug

Usage

use VisualDebug;

or

import VisualDebug;

Support for the visualization tool chplvis.

This module provides access to and enables hooks to dump out task and communication information for post-run visualization of the tasks and communication.

config param DefaultVisualDebugOn = true

This is the default setting for VisualDebugOn. It defaults to true, but can be changed at compile time.

config const VisualDebugOn = DefaultVisualDebugOn

If this is true, data collection to support chplvis reporting is turned on. It defaults to the value of DefaultVisualDebugOn, but can be changed at execution time.

proc startVdebug(rootname: string)

Start logging events for VisualDebug. Open a new set of data files, one for each locale, for chplvis. This routine should be called only once for each program. It creates a directory with the rootname and creates the files in that directory. The files are named with the rootname and “-n” is added where n is the locale number.

Arguments:rootname – Directory name and rootname for files.
proc tagVdebug(tagname: string)

Add a tag to the data for chplvis to allow “view points” in the data.

Arguments:tagname – name of the tag
proc stopVdebug()

Stop collecting VisualDebug data and close the data files.

proc pauseVdebug()

Suspend collection of VisualDebug data.