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

maeOpenResults

maeOpenResults(
[ ?session t_sessionName ]
[ ?history t_historyName ]
[ ?run t_runName ]
)
=> t / nil

Description

Opens the result for the given history or run plan, and sets the result pointer to be used by other functions.

Arguments

?session t_sessionName

Name of the ADE Assembler or Explorer session.

If not specified, the current session is used.

?history t_historyName

Name of the history or child history.

If a run saves child histories, specify the name of the child history to open results.

You can also use this argument to open the results of a history saved for a run in the run plan.

?run t_runName

Name of the run plan.

This argument is considered only when the ?historyName argument is not available. For example, while accessing the results of one run in another run of a run plan. Since the history is not yet created while you are writing the script, you can use the ?run argument to access the results of the specified run.

Use the ?run argument only inside the pre-run script of a run to access the results of another run. This argument does not work when the SKILL function is run from CIW.

Value Returned

t

The result for the given history or run plan is opened, and the result pointer is set to be used by other functions.

nil

The result for the given history or tun plan is not opened.

Examples

Opens the result for the history Interactive.1.

; Load the results for a history
maeOpenResults(?history "Interactive.1")
=> t
>
; Get the ouput value
maeGetOutputValue("outputA" "solutions:amptest:1")
=> 2.2
;close the results 
maeCloseResults()
=> t

Opens the result for a run plan.

If you are opening the results saved for a run plan, it is important to specify the name of a child history, Plan.0.Run.0, instead of the parent history, Plan.0.
maeOpenResults(?history "Plan.0.Run.0")

Loads the results of a run in the pre-run script of another run.


Return to top
 ⠀
X