B.13 par2yaml

par2yaml converts PPW performance data archive files (PAR files) to the YAML ASCII serializations format and prints the result to the standard output. The YAML format is similar in some respects to XML, except much simpler. From the YAML website:

YAML(tm) (rhymes with “camel”) is a straightforward machine parsable data serialization format designed for human readability and interaction with scripting languages such as Perl and Python. YAML is optimized for data serialization, configuration settings, log files, Internet messaging and filtering. YAML(tm) is a balance of the following design goals:

• YAML documents are very readable by humans.
• YAML interacts well with scripting languages.
• YAML uses host languages' native data structures.
• YAML has a consistent information model.
• YAML enables stream-based processing.
• YAML is expressive and extensible.
• YAML is easy to implement.

The output from the par2yaml command is a direct representation of the internal PPW data file format and is not processed in any significant way. This makes the output inconvenient for human consumption, but allows accurate exports of the underlying performance data into other arbitrary formats via further processing from 3rd-party/user-written utilities. If you want more human-readable ASCII output, see the ppwprof(1) command.

B.13.1 Invoking par2yaml

To invoke par2yaml, use the following syntax:

     
     par2yaml filename.par
     

B.13.2 par2yaml Command Options

par2yaml does not have any command-line options.

B.13.3 par2yaml Notes

This command is a Perl script and tends to run much slower than ppwprof(1) with files containing data from a larger number of nodes. Additionally, this script does not support reading gzipped PAR data files.