maeStmGenerateWaveforms

maeStmGenerateWaveforms(
t_libName 
t_cellName
t_viewName
[ ?test t_testName ]
[ ?reportFile t_reportFile ]
[ ?force g_force ]
)
=> t / nil

Description

Generates preview stimuli waveforms for the stimuli added for a maestro cellview that contains stimuli definitions added through the Stimuli Assignment form. These stimuli definitions are saved in the file lib-name/cell-name/view-name/namedStimuli/stimuli.xml.

The function examines each of the stimuli definitions for preview waveforms. If a stimuli definition has no associated preview waveform, or the waveform data is out of date, it generates a new SRR waveform data and saves it in the directory project-dir/lib-name/cell-name/view-name/namedStimuli.

Open the Stimuli Assignment form from a maestro cellview before using this function.

The waveform data is considered out-of-date if the time stamp of a stimuli XML definition is newer than its associated preview waveform data.

To view the waveforms generated by this function, open the Stimuli Assignment form, right-click on a stimuli and select the Plot Transient Waveform.

Arguments

t_libName	Name of the library.
t_cellName	Name of the cell.
t_viewName	Name of the view.
`?test` t_testName
	Name of the test to which the stimuli is associated. If no test name is specified, the tool uses the first test in the cellview.
`?reportFile` t_reportFile
	Name of the report file in which the status message for each stimuli waveform is printed. When no file name is provided, the default file path relative to the current working directory is used. The default value is `"./maeStmGenerateWaveforms.`lib`.`cell`.`view`.`test`.log"`.
`?force` g_force	Forces waveform generation for each stimuli. By default, the tool generates waveforms only when the stimuli information does not match the current waveforms, which could happen in the following scenarios: No waveform exists. Values of variables have been changed after waveform generation. Value of a stimuli parameter has been changed.

Value Returned

`t`	Preview stimuli waveforms are generated.
`nil`	Preview stimuli waveforms are not generated.

Examples

Generates stimuli waveforms.

maeStmGenerateWaveforms("testLib" "StimuliTest" "maestro")
=> t

Generates stimuli waveforms for all stimuli and prints the report in the given file.

maeStmGenerateWaveforms("testLib" "StimuliTest" "maestro" ?force t ?reportFile "./reports/stimuliReport.log")
=> t

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