Skip to main content
Mathematics LibreTexts

10.2: Interactive Simulation with PyCX

  • Page ID
  • \( \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}}} \)

    We can build an interactive, dynamic simulation model in Python relatively easily, using PyCX’s“” file, which is available from pycx/files/ (it is also directly linked from the file name above if you are reading this electronically). This file implements a simple interactive graphical user interface (GUI) for your own dynamic simulation model, which is still structured in the three essential components—initialization, observation, and updating—just like we did in the earlier chapters.

    To use, you need to place that file in the directory where your simulation code is located. Your simulation code should be structured as follows:

    code 10.1.png

    code 10.1 pt2.png

    code 101 pt 3.png

    The first three lines and the last two lines should always be in place; no modification is needed.

    Let’s work on some simple example to learn how to use Here we build a model of a bunch of particles that are moving around randomly in a twodimensional space. We will go through the process of implementing this simulation model step by step.

    First, we need to import the necessary modules and define the parameters. In this particular example, a Gaussian random number generator is useful to simulate the random motion of the particles. It is available in the random module of Python. There are various parameters that are conceivable for this example. As an example, let’s consider the number of particles and the standard deviation of Gaussian noise used for random motion of particles, as model parameters. We write these in the beginning of the code as follows:

    code 10,2.png

    code 10.2 pt.png

    Next is the initialization function. In this model, the variables needed to describe the state of the system are the positions of particles. We can store their \(x-\) and \(y-\) coordinates in two separate lists, as follows:
    code 10.3.png

    Here we generate n particles whose initial positions are sampled from a Gaussian distribution with mean 0 and standard deviation 1.

    Then visualization. This is fairly easy. We can simply plot the positions of the particles as a scatter plot. Here is an example:

    code 10.4.png
    The last option, ’.’, in the plot function specifies that it draws a scatter plot instead of a curve. Finally, we need to implement the updating function that simulates the random motion of the particles. There is no interaction between the particles in this particular simulation model, so we can directly update xlist and ylist without using things like nextxlist or nextylist:

    code 10.5.png

    code 10.5 pt2.png

    Here, a small Gaussian noise with mean 0 and standard deviation sd is added to the \(x-\) and \(y-\)coordinates of each particle in every time step. Combining these components, the completed code looks like this:
    code 10.6.png

    code 10.6pt2.png

    code 10.6 pt 2.png

    Run this code, and you will find two windows popping up (Fig. 10.1.1; they may appear overlapped or they may be hidden under other windows on your desktop)12.

    Fig. 10.1.PNG
    Figure \(\PageIndex{1}\): Graphical user interface (GUI) generated by Left: Visualization window. Right: Control window.

    This interface is very minimalistic compared to other software tools, but you can still do basic interactive operations. Under the “Run” tab of the control window (which shows up by default), there are three self-explanatory buttons to run/pause the simulation, update the system just for one step, and reset the system’s state. When you run the simulation, the system’s state will be updated dynamically and continuously in the other visualization window. To close the simulator, close the control window.

    Under the “Settings” tab of the control window, you can change how many times the system is updated before each visualization (default = 1) and the length of waiting time between the visualizations (default = 0 ms). The other two tabs (“Parameters” and “Info”) are initially blank. You can include information to be displayed under the “Info” tab as a “docstring” (string placed as a first statement) in the initialize function. For example:
    code 10.7.png

    This additional docstring appears under the “Info” tab as shown in Fig. 10.1.2.

    Fig. 10.2.PNG
    Figure \(\PageIndex{2}\): Information about the simulation added as a “docstring” in the initialization function.
    Exercise \(\PageIndex{1}\)

    The animation generated by Code 10.6 frequently readjusts the plot range so that the result is rather hard to watch. Also, the aspect ratio of the plot is not 1, which makes it hard to see the actual shape of the particles’ distribution. Search matplotlib’s online documentation ( to find out how to fix these problems.

    1If you are using Anaconda Spyder, make sure you run the code in a plain Python console (not an IPython console). You can open a plain Python console from the “Consoles” menu.

    2If you are using Enthought Canopy and can’t run the simulation, try the following:

    1. Go to “Edit”→“Preferences”→“Python” tab in Enthought Canopy.

    2. Uncheck the “Use PyLab” check box, and click “OK.”

    3. Choose “Run”→“Restart kernel.”

    4. Run your code.

    If it still doesn’t work, re-check the “Use PyLab” check box, and try again.

    This page titled 10.2: Interactive Simulation with PyCX is shared under a CC BY-NC-SA 3.0 license and was authored, remixed, and/or curated by Hiroki Sayama (OpenSUNY) via source content that was edited to the style and standards of the LibreTexts platform; a detailed edit history is available upon request.