Miscellaneous

Saving and Loading Waveforms

The components making up a waveform can be loaded into the workspace by passing the path and name of the waveform's Software Assembly Descriptor (SAD) XML file to the loadSADFile() method. Note that usesdevice relationships are ignored when loading a SAD file onto the sandbox.

>>> sb.loadSADFile("/path/to/sad/file/waveform.sad.xml")

The instantiated components and their associated connections can also be saved as a waveform. To perform this operation, pass the desired waveform name to the generateSADXML() method.

This method returns an XML string representing the contents of the SAD file; this string may then be written to a file:

>>> sadString = sb.generateSADXML("waveform_name")
>>> fp=open("/path/to/sad/file/waveform_name.sad.xml","w")
>>> fp.write(sadString)
>>> fp.close()

Debug Statements and Standard Out

Standard out and standard error can be redirected to a file:

>>> sb.redirectSTDOUT("/path/to/file/file.txt")

Debug statements can be set explicitly.

To set the debug output status, pass True or False to the setDEBUG() method:

>>> sb.setDEBUG(True)

To get the current state of the debug output, use the getDEBUG() method:

>>> sb.getDEBUG()
True

Processing Components from the Command Line

To process individual components from the command line, use the proc() function. The following command is an example of the proc() function call with sample arguments:

>>>sb.proc("my_component","input_file",sink="output_file",sourceFmt="16t",sinkFmt="8u",sampleRate=10000,execparams={"execprop1":5},configure={"prop2":4},providesPortName="input",usesPortName="output",timeout=10)

proc() Function Arguments