# 7.1: Thonny

$$\newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} }$$

$$\newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}}$$

$$\newcommand{\id}{\mathrm{id}}$$ $$\newcommand{\Span}{\mathrm{span}}$$

( \newcommand{\kernel}{\mathrm{null}\,}\) $$\newcommand{\range}{\mathrm{range}\,}$$

$$\newcommand{\RealPart}{\mathrm{Re}}$$ $$\newcommand{\ImaginaryPart}{\mathrm{Im}}$$

$$\newcommand{\Argument}{\mathrm{Arg}}$$ $$\newcommand{\norm}[1]{\| #1 \|}$$

$$\newcommand{\inner}[2]{\langle #1, #2 \rangle}$$

$$\newcommand{\Span}{\mathrm{span}}$$

$$\newcommand{\id}{\mathrm{id}}$$

$$\newcommand{\Span}{\mathrm{span}}$$

$$\newcommand{\kernel}{\mathrm{null}\,}$$

$$\newcommand{\range}{\mathrm{range}\,}$$

$$\newcommand{\RealPart}{\mathrm{Re}}$$

$$\newcommand{\ImaginaryPart}{\mathrm{Im}}$$

$$\newcommand{\Argument}{\mathrm{Arg}}$$

$$\newcommand{\norm}[1]{\| #1 \|}$$

$$\newcommand{\inner}[2]{\langle #1, #2 \rangle}$$

$$\newcommand{\Span}{\mathrm{span}}$$ $$\newcommand{\AA}{\unicode[.8,0]{x212B}}$$

$$\newcommand{\vectorA}[1]{\vec{#1}} % arrow$$

$$\newcommand{\vectorAt}[1]{\vec{\text{#1}}} % arrow$$

$$\newcommand{\vectorB}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} }$$

$$\newcommand{\vectorC}[1]{\textbf{#1}}$$

$$\newcommand{\vectorD}[1]{\overrightarrow{#1}}$$

$$\newcommand{\vectorDt}[1]{\overrightarrow{\text{#1}}}$$

$$\newcommand{\vectE}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash{\mathbf {#1}}}}$$

$$\newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} }$$

$$\newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}}$$

The RPi (Raspberry Pi) comes with the Thonny IDE (Interactive Development Environment) installed on it and so it is simplest to install the Thonny IDE on your laptop. As of December 2022 the latest version of Thonny is Thonny 4.0.1, which will also instal Python 3.10.6, and so you do not need to install python.  If you are planning on doing machine learning or advanced data science applications you may want to install the Anaconda Package, which helps you update multiple packages without causing conflicts. But unless you are an advanced user, Thonny should be fine.

Thonny is now the default IDE for *.py and you can open it from either the start menu or by clicking on a *.py file.  If you want, you can also pin it to the taskbar.

## UI Modes

Thonny has three UI (User Interface) modes, Simple, Regular and Expert.  We will typically use the Simple or Regular mode.  On your PC you will probably want Regular as it has access to the file menu (fig. $$\PageIndex{2}$$), but if you have limited screen space, like are on a Pi with a low resolution monitor, you may wish to use simple mode to maximize the screen's realestate.

To switch to REGULAR mode you can click the text in the circle of the upper right in figure $$\PageIndex{1}$$. To switch from regular mode to simplemode go to tools/options/general/UI mode and pick the option you want (figure $$\PageIndex{2}$$).  Also, note that the blue oblong circle on the shell of figure $$\PageIndex{1}$$ shows that Thonny is running python 3.7.9, which was co-installed with Thonny, but in $$\PageIndex{2}$$ we can see that Python 3.9.7 is being run. That is, these images were taken when we were using different versions of Python, and in the next section you will install Python

To switch from regular mode to simple mode  choose Tools/General/UI mode/regular (Figure $$\PageIndex{2}$$). We will typically use the Regular mode.

When in Regular mode you have access to several menu items and it is prudent to go over these before starting.  Many of these like open and save will be familiar to you while others will be unfamiliar.  It is always a good idea to check out menu items on any software package before you start using it.

We will take a quick dive on several of the menu item features that your are probably not familiar with.

#### Edit

In some IDEs you need to save a file before you run it.  In Thonny you do not, and the moment you hit "RUN" it saves the file and then runs it.  This means it overwrites the code of the original file. So, a common error is to change some code and run it to see if it works, but you then lose the original code.  A good practice is to comment out code with the # symbol.  This means that text will not be operated on.  In the Edit menu you have the ability to comment or uncomment large blocks.

Note, the color coding above is a result of the option chosen in the tools/options/theme-fonts tab.

#### View

The View option allows you to select the interfaces you wish to work with. The code editor is always present and you probably want to run the Shell, which emulates a command line interface. In figure ($$\PageIndex{3}$$) the Shell, Variables and Assistant options have been opened. We will go over the utility of these features as the course proceeds, but these are probably the most common ones you will wish to work with.

You will also note that the View menu provides an option to increase or decrease font size with keyboard shortcuts of Ctrl + + and Ctrl + - (click the crtl followed by either plus or minus).  This is often very important when you are running a Pi in headless mode using the VNC viewer.

#### Run

The run tab allows you to execute python code in the editor and interact with it through the shell. You will often want to use the <F5> shortcut key.  You can also run the program in "debugger mode" that allows you to walk through the code one step at a time.  There are a lot of YouTube videos on the debugger and the following one goes over it (we are starting where the debugger part of the script is, but you may want to watch the entire video.

#### Tools

Tools is an important menu item, in fact we have already looked at in in figure $$\PageIndex{2}$$ when we switched the UI (User Interface) from simple to regular mode. Let's quickly look at some of the other features of the Tools, starting with the manage packages and manage plugins.  A Python package is a way to add new features to your program, like say math or time functions, and is essentially a directory of modules that you typically download from a service like the PyPI Python Package Index, that as of 1/22/2022 contains 351,947 projects. A package has a init_.py file sets how the packages are imported, while a directory could be a collection of python modules, but without the init_.py file, they will not be integrated into the interpreter.

We have already looked at the options submenu when we changed the UI (Figure $$\PageIndex{2}$$.

PEP 8, the Index of Python Enhancement Proposal style guide suggests a maximum line length of 79 characters and you can set a verticle line in your editor to warn you when your string of code is getting to long (figure $$\PageIndex{7}$$).

## Editor Options

Under the regular UI you can go to Tools/Options/Editor and do things like insert/remove line numbers, set the reccomended line length (standard python libraries limit line length to 79 characters with comments being recommended to be limited to 72)

Installing Modules

7.1: Thonny is shared under a not declared license and was authored, remixed, and/or curated by LibreTexts.