2.9.7. Extracting Profile Data from Results Files

When profiles have been read into the CFX-Solver, a summary of the files is written to the CFX-Solver Output file under the section Profile Data. All profile data is written to the results file and can be extracted using the command line utility cfx5dfile. Depending on your preference setting for internal or external CSV data storage, profile data might be read into the solver each time the solver is started/restarted, in which case the results file contains the profile data that was most recent at the time.

cfx5dfile can be run from the command line and is located in the <CFXROOT>/bin/ directory.

The remainder of this section describes the cfx5dfile command. You can also get help from the command line by using the -help switch.

To find out which profile data is stored in the current results file, enter:

cfx5dfile <results file name> -list-profile-data

This outputs a list of all profile data stored in or referenced by the results file, one profile per line. The data for any of the listed profiles can be extracted with the -read-profile-data switch.

Enter:

cfx5dfile <results file name> -read-profile-data -function <function name>

to print the profile data corresponding to the named function to standard output (for example, your terminal window), or to the file specified with the -output switch.

Enter:

cfx5dfile <results file name> -extract-profile-data -function <function name>

to write the profile data corresponding to the named function to the current directory to a file with an automatically-determined file name. The file will be named according to the function name (for internally-stored profile data) or based on the original file name (for external profile data). If this file already exists in the current directory, it will not be overwritten. The function name is the CCL object name.

This is equivalent to using -read-profile-data -function <function name>, and using -output to set the destination file name.

Enter:

cfx5dfile <results file name> -write-profile-data -function <function name> <filename>

to insert the contents of the specified file into the results file as profile data to be used for the specified function. Note that this profile data is used when restarting a run from the results file.

For any file referenced in the results file, enter:

cfx5dfile <results file name> -read-profile-data -filename <filename>

to print the profile data that was originally initialized from the CSV file <filename> to standard output (for example, your terminal window), or to the file specified with the -output switch. This is only applicable in this form for externally-stored profile data. For internal CSV data, the -filename argument behaves the same way as the -function argument.

Alternatively, enter:

cfx5dfile <results file name> -extract-profile-data -filename <filename>

to write the profile data that was originally initialized from the CSV file <filename> to the current directory in a file of the same name. This is equivalent to using -read-profile-data -filename <filename>, and using -output to set the destination file name. This is only applicable in this form for externally-stored profile data. For internal CSV data, the -filename argument behaves the same way as the -function argument.

Enter:

cfx5dfile <results file name> -extract-all-profile-data

to save all the profile data contained in the results file to a set of files in the current directory. If any of the files exist locally, they will not be overwritten.


Note:  If you use cfx5cmds to update CCL, and/or you use cfx5dfile to update the profile data or table data stored within the case, then you must, in addition to updating an mdef file, also perform the same update to any associated .def or .cfg files.