A comprehensive log system is useful to explain and document the analysis process to aid in understanding of the results and the inputs and conditions that affected it. The objective of this task was to develop a log system for the PHT Analysis Tool to create a process history log that records errors, warnings, and key actions that occur during the analysis.
The log system for PHT analysis engine collects and records key information for each PHT step during the run-time analysis, and provides a sequential log file for the whole analysis procedure. The information in the log file contains
The log information provided by the log system is beneficial to both PHT users and developers. As a PHT user, the information can be used to trace each key analysis step, understand the engineering process, verify analysis result during each step, and identify potential issues caused by input data. To PHT developers, the information can be used to assist the program debug, identify programs bugs, and improve the code maintenance efficiency.
Data communication between PHT user interface and PHT analysis engine is through an in-memory dataset. However, the log information size can be very big and it is not efficient to pass the log information by dataset or through computer memory. Rather, the log system generates a log file and PHT user interface reads and interprets the log file for log information. There are three types of log message:
The PHT log system records the following information.
The log files generated by the PHT analysis are stored on the systems hard drive and are referenced by the PHT analysis results stored in the PHT database. By default, all the analysis log files are stored in the following directory:
The following excerpt of the PHT log for the analysis of a highway section illustrates some of the types of messages that may appear in the log system.
| Record Index: 1
<Info> ID = 1
<Info> YearRecod = 2011
<Info> StateCode = 4
<Info> data check passed
<Info> The maximum service life=15
<Info> ACType = 4
<Info> Precipitation = 11.3
<Info> FI = 53.9
<Info> FTCYC = 51.7
<Info> GMT = 40
<Info> AverageTemperature = 65.24166
<Info> AirVoid = 5.14
<Info> EffectBinder = 9.86
<Info> base modulus = 1500000
<Info> Clay_Percents = 6.1
<Info> Sand_Percent = 42.4
<Info> Silt_Percent = 14.2
<Info> Overall RSL Age =5, Accumulated ESALs=1.062762E+07
<Info> DistressType=2, Terminal Value=20, MaxServiceLife=46
<Info> DistressType=2, Terminal Age=46, TotalESALs=97774080
<Info> DistressType=0, Terminal Value=170, MaxServiceLife=46
<Info> DistressType=0, Terminal Age=46, TotalESALs=97774080
<Info> anaylsis succeeded for this project
The use of the log system has a negative impact on the overall runtime of the PHT analysis and is therefore disabled by default. When fully enabled for all logging, the overall analysis runtime increases on average of about two fold as shown in Figure 67.
The PHT log system is controlled from Logging tab of the PHT Properties dialog window as shown in Figure 68. This window is used to enable the PHT analysis logging capability and to specify the level of logging to be captured. When logging is enabled, the level of logging indicated will be captured; however, logging can significantly increase the analysis runtime and should be disabled when the log is not of interest.
When an analysis log has been captured, the logging for the analysis for each individual highway section is available on the Log tab of the PHT results window. The Log tab in the vertical panel of the Result Viewer is only available if a log file has been captured during the analysis and is available for display as shown in Figure 69.