awvPrintWaveform

awvPrintWaveform(
o_waveform1 [ o_waveform2 ... ]
[ ?output t_fileName | port ]
[ ?numSigDigits x_numSigDigits ]
[ ?format s_format ]
[ ?numSpaces x_numSpaces ]
[ ?width x_width ]
[ ?from x_from ]
[ ?to x_to ]
[ ?step x_stepValue ]
)
=> t / nil

Description

Prints text data of waveforms specified in a list of waveforms to the Results Display Window or to the specified file.

There is a limitation of awvPrintWaveform function for precision. It works up to 30 digits for the Solaris port and 18 digits for HP and AIX. If the data is too lengthy to be displayed in the print window, a pop-up form appears, indicating this and notifying you that the data will be sent to a default output file or to a filename you specify.

Arguments

o_waveform1	Waveform object.
?output t_fileName
	Name of the file in which you want to print waveform data.
?numSigDigits x_numSigDigits
	The number of significant digits to print. This value overrides any global precision value set with the setup command. Valid values are integer values from 1 through 16. Default value is 6.
?format s_format	Format of notation in which information is printed. Valid values are: 'engineering: Uses the engineering notation. For example, 28.88E-9s. 'scientific: Uses the scientific notation. For example, 2.888E-8s. 'suffix: Uses the suffix notation. For example, 28.88ns. 'none: Turns off formatting, which helps you speed up printing large data. To further speed up printing, use the 'none value and set the ?output argument to a filename or a port, so that output does not go to CIW. Default value is 'suffix.
?numSpaces x_numSpaces
	The number of spaces between columns. Valid values are integers greater than or equal to 1. Default value is 4.
?width x_width	Width of each column. Valid values are integers greater than or equal to 4. Default value is 14.
?from x_from	x-axis value after which you want to save waveform data.
?to x_to	x-axis value upto which you want to save waveform data.
?step x_step	Step value to be used.

Value Returned

t	Waveform data is printed.
nil	Waveform data cannot be printed because of an error.

Examples

The following example creates a Waveform window and returns the ID of the Waveform window.

awvCreatePlotWindow()

=> window:3

The following example opens simulation results stored in the specified results directory ampsim.raw.

openResults("/servers/user/design/ampsim.raw")

=> "/servers/user/design/ampsim.raw"

The following example returns ID of the waveform of the signal out, which is available in the tran-tran result of the results directory ampsim.raw.

w1=v("out" ?result "tran-tran")

=> srrWave:0x36368020

The following example returns ID of the waveform that is obtained after applying the flip function to the signal out, which is available in the tran-tran result of the results directory ampsim.raw.

w2=flip(v("out" ?result "tran-tran"))

=> srrWave:0x36368040

The following example passes waveform objects w1 and w2 into a list named waves.

waves=list(w1 w2)

=> (srrWave:0x36368020 srrWave:0x36368040)

The following example prints waveform data for w1 and w2 in the Results Display Window.

awvPrintWaveform(w1 w2 ?from 100ns ?to 200ns ?step 1ns ?numSpaces 4 ?width 50 ?format 'suffix ?numSigDigits 10)

=> t

The following example prints waveform data for w1 and w2 to myFile.txt file.

awvPrintWaveform(?from 100ns ?to 200ns ?step 1ns ?numSpaces 4 ?width 50 ?format 'suffix ?numSigDigits 10 ?output "myFile.txt" w1 w2)

=> t

Return to top