All the operations performed by Sci2 are logged and stored in the log files. Log files are simple text documents that track all the operations performed during a Sci2 session. Each time users start the tool a new log file will be created, and Sci2 will save these log files as long as the tool is installed on a machine. These files will help you better understand specifically how the algorithms employed during a session are processing the data, the log files will also give you information on who the implementer(s) and integrator(s) of the algorithms are, time and date information for algorithm executrion, algorithm input parameters, and specific information on any errors that may occur during Sci2 operation.
To see copies of the log files open your Sci2 directory and go to the logs directory:
You can select the log file for the Sci2 session you wish to examine:
Here is an example of a log file. Suppose you wanted to cite a particular algorithm that you used to process some data for a paper you are writing. The complete citation information and associated URLs for the algorithms used by Sci2 can be found directly in the log files:
Notice that the log files also display the URL for where the algorithm is documented on the Sci2/CIShell site:
When an error occurs the error is detailed in the log file:
As you can see the log file provides a lot of information that can be valuable to users. Not all of the data recorded in the log file will be easily understood by the average user, but it is a good place to look for more detailed information on error messages. It is also useful to for recreating workflows from previous sessions since all the algorithm input parameters will be saved in the log file. For example, say you want to see, step-by-step, how you created a visualization that you made two months ago. Using the log files, you will be able to see specifically what algorithms were used to process the data and what parameters were provided to end up with the visualization. In this way, the log files can be very useful for documenting workflows for future replication.