Contents:
  example_trace1.txt: an ascii trace file
  example_trace2.txt: an ascii trace file
  atr2btr.c: utility for generating a binary trace from an ascii trace
  btr2atr.c: utility for generating an ascii trace from a binary trace

Note:  The example trace files are in ascii format, so they must first
be converted to binary format before they can be used by any of the
simulators.


Converting ASCII Traces to Binary
---------------------------------

The 'atr2btr' program generates a binary trace file from an ascii
trace file.  Usage is as follows:

  atr2btr <input_ascii_trace> <output_binary_trace>

The resulting binary trace file can be used to drive any of the
simulators.

It should be noted that the ascii trace file must contain only the
data fields of the trace, such as the files generated by the 'btr2atr
-nolabels' program will produce.


Converting Binary Traces to ASCII
---------------------------------

The 'btr2atr' program generates an ascii trace file from a binary
trace file.  Usage is as follows:

  btr2atr [-nolabels] <input_binary_trace>

Output appears on stdout.  If the -nolables option is used, only the
values of the trace fields are printed out.  Otherwise, each trace
record is numbered, and each field is labled.