Importing Libraries

From GNU Radio
Jump to navigation Jump to search

The import block enables calls to Python-based libraries such as NumPy within GRC, allowing for more sophistication in the use and creation of variables and parameters for blocks.

Import Block

Drag the Import block into the flowgraph.

Importing libraries import block.png

Double-click the Import block to bring up the properties. The Import field receives any legal Python import statement. For this example, the Numpy library is imported as np.

Importing libraries import statement.png

The Import block then displays the imported library as np.

Importing libraries after numpy import.png

Running the flowgraph generates a Python flowgraph of the same name, ending in .py. Opening the .py file displays the import statement:

Importing libraries numpy import in python.png

Variables Using Libraries

Variables and parameters in GRC can now use the NumPy library directly, both for the creation and manipulation of values. For example, the sequentialArray variable is created using NumPy’s arange() function:

Importing libraries sequential array variable.png

The sequentialArray variable is then manipulated by the reversedArray variable, reversing the order of the array:

Importing libraries reversed array variable.png

Randomized Variables

NumPy’s random number generators can be used to randomize values within a flowgraph. Create a variable named randomAmplitude and assign the value using a uniform random variable from 0.1 to 1:

Importing libraries random amplitude variable.png

Add a Signal Source to the flowgraph and use the randomAmplitude variable as the Amplitude:

Importing libraries signal source random amplitude.png

Connect the Signal Source to a QT GUI Time Sink. Note that the randomAmplitude value is different between the Variable and Signal Source blocks. This difference in values is because GRC evaluates the variable once the block property window is closed, and since the two windows were closed at different times it evaluated to two different values.

Importing libraries random amplitude flowgraph.png

However, this is not reflected in the underlying Python code. Instead, the variable text is unevaluated until run-time, allowing for proper randomization.

Importing libraries random amplitude in python.png

Running the flowgraph demonstrates that the amplitude is randomized. The following two QT GUI Time Sink plots shows two different amplitude values for the Signal Source output.

Importing libraries random amplitude example 1.png

Importing libraries random amplitude example 2.png