Output

Cambrian produces three kinds of output:

• Standard output: the best seen individual JSON if the run succeeds.

• Standard error (only if the user passed the --verbose or -v option): logging

• Reporting files (only if the user passed the --out-dir or -o option): files created in the specified output directory. Below is a description if the different kinds of files that cambrian creates. The last three are created only if a run of the objective function program returns a non-zero exit status, which causes cambrian to abort the optimization:

  • detailed_report.csv: a CSV file containing a row for each attempted objective function evaluation. The columns include the JSON representing the parameters passed, execution time, result, and other data. The CSV has a header row with descriptive column names. This file gets written in real time, which means if the run fails, the user might still be able to recover some information.

  • best_seen.json: Contains the best seen parameter instance formatted in JSON. If the run succeeds, the content of this file will be identical to the standard output. Otherwise it will contain the best seen individual prior to failure of the run.

  • failed_obj_func_arg: Contains the JSON representing the individual passed to the failed objective function program

  • failed_obj_func_stdout: Contains the standard output of the failed objective function program run

  • failed_obj_func_stderr: Contains the standard error of the failed objective function program run