maeRunLogDiagnostics

maeRunLogDiagnostics(
[ ?session t_session ]
[ ?lib t_libName ]
[ ?cell t_cellName ]
[ ?view t_viewName ]
[ ?directory t_directory ]
[ ?historyName t_historyName ]
[ ?points l_points ]
[ ?testNames l_testNames ]
[ ?checks l_checks ]
[ ?jobs x_jobs ]
[ ?tolerance x_tolerance ] 
[ ?display g_display ] 
[ ?log t_log ] 
)
=> x_ID / nil

Description

Runs a list of checks on the log files for the specified history and generates the ADE Diagnostics report. Troubleshooting simulation errors using log files can be a difficult task because ADE Assembler saves multiple log files that are generated by different components of the LSCS architecture. The ADE diagnostics reports provides a detailed analysis of such errors and helps in debugging.

Arguments

`?session` t_session
	Name of the maestro session.
`?lib` t_libName	Library name for the maestro cellview associated to the specified history.
`?cell` t_cellName	Cell name for the maestro cellview associated to the specified history.
`?view` t_viewName	View name for the maestro cellview associated to the specified history.
`?directory` t_directory
	Name of the directory exported by the Log packer window that contains all the logs for the specified history. If all of the following arguments are specified, the precedence order is: `?lib` t_libName, `?cell` t_cellName, and `?view` t_viewName `?session` t_session `?directory` t_directoryName.
`?historyName` t_historyName
	Name of the history for which the ADE diagnostics report is to be generated. It is mandatory to specify this argument.
`?points` l_points	List of points for which the checks are to be run. By default, the checks are run for all points.
`?testNames` l_testNames
	List of names of the tests for which the checks are to be run. By default, the checks are run for all tests.
`?checks` l_checks	List of checks or the categories of checks to be run for the generation of the ADE Diagnostics report. By default, all checks are run. For more information, see Checks Performed by ADE Diagnostics.
`?jobs` x_jobs	Number of threads to be used for processing. This argument can be used to speed up the analysis for larger simulation runs.
`?tolerance` x_tolerance
	Tolerance in miliseconds (ms). It is used when comparing timestamps to account for clock drift between hosts.
`?display` g_display
	When set to `t`, the ADE diagnostics report is displayed in the browser after the checks are run. Specifying the `?display` g_display argument blocks the maestro session until the checks are run. To avoid this, use the function `maeDisplayLogDiagnostics` after `maeRunLogDiagnostics` is run instead of specifying this argument.
`?log` t_log	Name of the file where the output log for the diagnostics run is to be saved. If not specified, the output is logged to the CIW or `CDS.log`.

Value Returned

x_ID	Returns a unique identifier for the diagnostics run. This ID is used with `maeDisplayLogDiagnostics` to display the ADE diagnostics report in a web browser.
`nil`	Indicates an error.

Examples

Displays the ADE diagnostics report in the web browser for the history Interactive.1 in the cellview Two_Stage_Opamp/Opamp/maestro.

maeRunLogDiagnostics(?lib "Two_Stage_Opamp" ?cell "OpAmp" ?view "maestro" ?historyName "Interactive.1" ?display t)
=> 1

Virtuoso ADE SKILL Reference
Product Version IC23.1, November 2023