User's Reference - Trace

### Trace

Category

Debugging

Function

Enable or disables tracing options.

Syntax

    Trace(what, how);

Inputs

Name | Type | Default | Description
--- | --- | --- | ---
`what` | string | none | the object to be traced
`how` | integer | 1 | 0: set tracing off 1: set tracing on

Functional Details

`what` | is (1) a keyword specifying the object to be traced or (2) a set of letters specifying a group of debug message classes, as used by the `DXEnableDebug()` library function (see IBM Visualization Data Explorer Programmer's Reference). At present, the only keyword value allowed for this parameter is `"time"`: `Trace("time", 1);` will begin the trace, and `Trace("time", 0);` will print a record of time use since the tracing was started. The output appears in the Message window. If `what` is a string of lowercase letters other than `time`, the module calls the `DXEnableDebug` library function. (The uppercase letters A-Z and the numbers 0-9 are reserved for system use).
`how` | specifies whether the trace option is activated or not.

Note: If the executive is started with the flag `-timing` on, the command `Trace("time", 0)` causes all module entry and exit times to be printed. In the VPE window, this command can be enabled using the Debug Tracing button in the `Commands` menu of the Message window (see 8.2 , "Using the Message Window" in IBM Visualization Data Explorer User's Guide).

Script Language Example

In this example, the module traces the use of time by Isosurface.

    electrondensity = Import("/usr/local/dx/samples/data/watermolecule");
    electrondensity = Partition(electrondensity);
    camera = AutoCamera(electrondensity, width=5);
    Trace("time", 1);
    isosurface = Isosurface(electrondensity, 0.3);
    Trace("time", 0);
    Display(isosurface, \camera);

See Also

Usage

[ OpenDX Home at IBM | OpenDX.org ]