COMMAND NAME:

        TRACE

ABBREVIATION:

        TR

USAGE:
        TRACE {'signal-name' | pt} [,radix]

        Traces the specified signal.  The argument "radix" is
        an optional parameter which may be specified using either 
        numerals (2, 8, 10, or 16) or characters:
                B(b) for binary, 
                O(o) for octal, 
                D(d) for decimal, 
                H(h) for hexadecimal.
        If no radix is specified, the global trace radix is used
        (see TRACE RADIX below).  If the signal is a primary I/O
        signal, the trace radix will be forced to be binary.
    
        TRACE CLOSE 

        Writes a terminating statement into the tabular output
        file and closes the file.  This happens automatically
        if you exit the simulator.

        TRACE INTERVAL number

        For Tabular I/O format, causes a trace record to be
        output every "number" ticks ( irrespective of
        whether or not there is a transition in any of the
        signals being traced ) during the simulation.
    
        The argument "number" must be >= 0. If "number" is 0 
        (the default), a trace record is written every time 
        there is at least one transition in any of the 
        signals being traced. 

        In SCL, "number" can be an expression.  For example,
        TRACE INTERVAL C sets the trace interval to the 
        global clock period using the built-in variable C
        which is automatically set to the clock period in
        ticks.

        The keyword INTERVAL can be abbreviated to IN.

        TRACE OPEN 

        Opens the trace output file "tabfile.dat".   The
        keyword OPEN can be abbreviated to O.

        TRACE PRIMARY_IO 

        Traces all primary I/O signals in the primary i/o trace
        format.  Primary i/os are specified by attaching a FLAG
        body to the signal on the top level (root drawing) logic
        schematic.  The keyword PRIMARY_IO can be abbreviated to
        PIO.

        TRACE RADIX [ 2 | 8 | 10 | 16 | b | o | d | h ] 

        Changes the radix used for tracing to the specified
        value. The value specified may be either
                 2 or B for binary, 
                 8 or O for octal, 
                10 or D for decimal, 
                16 or H for hexadecimal.  
        The default trace radix is binary.  If no parameter is
        specified, the current global trace radix is output in
        the simulator's message window.
	
        TRACE READ "filename"

        Reads in a Tabular I/O trace file from a previous run
        (or manually generated) to stimulate the circuit. As
        simulation time reaches the time values specified in
        the second part of the file, signal values for that
        time are deposited into the signals specified in the
        first part of the file.  

        The filename is actually an SCL expression.  This means
        that you can construct the name using variables.
    
        TRACE RESET 

        Resets (disables) stimulation from a tabular input file.
        This command can be given at any time to turn off 
        circuit stimulation. 
      
        If stimulus from more than one tabular input file is 
        desired, the TRACE RESET command can be used to reset the
        stimuli after each file has been used.  A different 
        tabular input file may then be specified with the TRACE
        READ command.
    
        TRACE START 

        Begins tracing the outputs specified by the TRACE command. 
        TRACE START can be given any number of times during a
        simulation run.

        TRACE STOP 

        Discontinues tracing until another TRACE START command is
        entered.

