Annotating datasets

You can add annotation strings to saved data files in order to distinguish between different data files and to record special data-collection circumstances, such as high network traffic or the use of special data files.

Use the API function quantify_add_annotation to add an annotation string to the next binary data file saved using quantify_save_data, quantify_save_data_to_file, or program exit. You can add as many annotations to a dataset as you want. You can also add annotations to an existing binary data file using the qv option -add-annotation. For example:

% qv -add-annotation="Run to collect dynamic library data" \ testHash.pure.dynamic.5172.0.qv

Quantify automatically adds an annotation indicating the type of machine on which the data was collected. If a fatal signal is received without a user-defined signal handler, Quantify automatically saves the data to that point in the run and adds an annotation indicating the type of signal received.

To view the annotations in a data file, use the qv option -print-annotations. For example: