Python Variables in GRC

From GNU Radio
Jump to navigation Jump to search

Template:TutorialNavigation

This tutorial describes how Python data types are used in GRC and how the variables are displayed.

The previous tutorial, Your First Flowgraph, shows how to build your first simple flowgraph. The next tutorial, Variables in Flowgraphs, describes how to use and modify variables in a more sophisticated flowgraph.

Floats and Integers in GRC

GNU Radio Companion (GRC) uses Python data types to represent variables. The simplest data type are numbers. Numbers in Python can be floating point or integers:

floatNumber = 3.14
integerNumber = 2

Integers can be converted to floating point by casting using float(), and floating point numbers can be converted to integers using int():

floatNumber = float(2)
integerNumber = int(3.14)

Type conversion can be done within the variable blocks:

FloatToIntProperties.png


The value is then displayed as an integer:

FloatToIntVariable.png


However, GRC displays numbers in a different fashion than Python. For example, when you create a new flowgraph you will be given the samp_rate block.

SampRateVariable.png


Double-click the samp_rate variable to edit the properties:

SampRateProperties.png


You'll notice that the value is 32000 yet GRC displays the value in the flowgraph as 32k. This is because GRC converts all numbers into SI Units. Note that how the number is entered into GRC may be different than how GRC displays the number.

For another example, drag and drop a variable into the workspace. Double-click to edit the properties:

  • Id: floatNumber
  • Value: 0.25

FloatNumberProperties.png


GRC now displays the value 0.25 as 250m because it has been converted to SI units:

FloatNumberVariable.png

Strings in GRC

Python uses both single quotes ' and double quotes " to contain strings:

singleQuoteString = 'string1'
doubleQuoteString = "string2"

Strings can be used as variables in GRC:

StringProperties.png


The string is then displayed in GRC:

StringVariable.png

Lists and Tuples in GRC

Variables in GRC can use lists:

ListProperties.png


The list is then displayed in GRC:

ListVariable.png


Variables in GRC can use tuples:

TupleProperties.png


The tuple is then displayed in GRC:

TupleVariable.png


List Comprehension

Each Variable acts as a single line in Python:

Id = Value

List comprehension can be used as a way to implement a function in a Variable. For example, list comprehension is used to loop through a list, add +1 to all entries, and multiply the result by 2:

listVariable = [0, 1, 2, 3]
listComprehensionExample = [(i+1)*2 for i in listVariable]

This is accomplished in GNU Radio by using two variables, listVariable and listComprehensionExample, and entering their associated values:

ListVariableProperties.png

ListComprehensionVariableProperties.png


The next tutorial, Variables in Flowgraphs, describes how to use and modify variables in a more sophisticated flowgraph.

ListComprehensionVariables.png