 # Phase Portrait of Van der Pol Oscillator

A phase portrait of a dynamical system is a geometric representation that depicts the system's trajectories in the phase plane. In this tutorial, we will learn how to draw the phase portrait of Van Der Pol oscillator in LaTeX using TikZ and Pgfplots. ## Let's start by the Limit Cycle

The Van der Pol oscillator can be represented by the following differential equations:

\begin{aligned} \dot{x} & = y\\ \dot{y} & = \mu (1-x^2)y-x \end{aligned}

where $\mu$ is a scalar parameter indicating the damping strength. For $\mu>0$, the nonlinear system has a stable limit cycle. However, it doesn't have an analytic solution that we can plot it directly in LaTeX using PGFplots package 😔.

💡 To remedy this issue, we can follow these steps:

1. Solve the differential equations of the Van der Pol oscillator numerically (e.g. Matlab, python).
2. Export the solution as a table of x and y.
3. Plot it by following the method shown in "How to Plot Function and Data in LaTeX".

### 1. Plot data using Pgfplots

In my case, I used Matlab/Simulink to simulate Van der Pol equations for $\mu=0.8$. Then, I exported the solution (x and y) to the workspace of Matlab and extracted steady state data that corresponds to the limit cycle trajectory. N.B. I used Matlab R2018a. Let me know if you need to export it to a previous version. Download Van der Pol Simulink file!

The next LaTeX code plots the limit cycle from an external file, named data.txt, using the $\verb|\addplot|$ command. Check "How to Plot Function and Data in LaTeX" for more details!

\documentclass[border=0.2cm]{standalone}

\usepackage{pgfplots}

\begin{document}
\begin{tikzpicture}
\begin{axis}[
grid=both,
grid style={dashed,red!20},
xmin = -4, xmax = 4,
ymin = -4, ymax = 4,
width = \textwidth,
height = 0.7\textwidth,
xlabel = {$x$},
ylabel = {$y$},
title={Phase Portrait of Van Der Pol Oscillator}
]

% Plot the Limit Cycle

\end{axis}
\end{tikzpicture}

\end{document} It should be noted that we plotted the state y in function of the state x but we need to highlight the evolution direction using small arrows.

### 2. Draw an arrow along a path

In the previous tutorial, "Electric Field of Line Charge in TikZ", we have presented different methods that can be used in order to add an arrowhead along a path. We will use method 2 based on decorations.markings library (repeated arrows case). Inspired by this post, A slight modification is considered.

\documentclass[border=0.2cm]{standalone}

\usepackage{pgfplots}

% Define arrow's style
\usetikzlibrary{decorations.markings}

\tikzset{decorated arrows/.style={
postaction={
decorate,
decoration={
markings,
mark=between positions 0 and 1 step 15mm with {\arrow[black]{stealth};}
}
},
}
}

\begin{document}
\begin{tikzpicture}

\begin{axis}[
grid=both,
grid style={dashed,red!20},
xmin = -4, xmax = 4,
ymin = -4, ymax = 4,
width = \textwidth,
height = 0.7\textwidth,
xlabel = {$x$},
ylabel = {$y$},
title={Limit Cycle of Van Der Pol Oscillator}
]

% Plot the Limit Cycle
\addplot[ultra thick, red, decorated arrows] file {data.txt};

\end{axis}
\end{tikzpicture}

\end{document}


• A TikZ style, named decorated arrows, is created using $\verb|\tikzset|$ command.
• It creates repetitive arrows between 0 (start of the path) and 1 (end of the path). A 15mm distance between successive arrows.
• Arrowhead style is chosen $\verb|stealth|$ with black color.
• The created style (decorated arrows) is add as an option to $\verb|\addplot|$ which draws the path in question. ### 3. Plot trajectories (transient and steady states)

In the previous subsection, we plotted the limit cycle of Van der Pol oscillator, which is obtained by removing the transient part of the system's trajectory (this works as we are dealing with a stable limit cycle). To add trajectories starting from different initial conditions, we will follow the same steps as above.  Here is an example of two trajectories starting from different initial conditions outside the limit cycle:

\documentclass[border=0.2cm]{standalone}

\usepackage{pgfplots}

% Define arrow's style
\usetikzlibrary{decorations.markings}

% Arrow style 1
\tikzset{decorated arrows/.style={
postaction={
decorate,
decoration={
markings,
mark=between positions 0 and 1 step 15mm with {\arrow[black]{stealth};}
}
},
}
}

% Arrow style 2
\tikzset{decorated arrows2/.style={
postaction={
decorate,
decoration={
markings,
mark=at position 15mm with {\arrow[black]{stealth};}
}
},
}
}

\begin{document}
\begin{tikzpicture}

\begin{axis}[
grid=both,
grid style={dashed},
xmin = -4, xmax = 4,
ymin = -4, ymax = 4,
width = \textwidth,
height = 0.7\textwidth,
xlabel = {$x$},
ylabel = {$y$},
title={Phase Portrait of Van Der Pol Oscillator}
]

% Trajectories
\addplot[very thick, decorated arrows2] file {data1.txt};
\addplot[very thick, decorated arrows2] file {data2.txt};

% Plot the Limit Cycle
\addplot[ultra thick, red, decorated arrows] file {data.txt};

\end{axis}
\end{tikzpicture}

\end{document}


• As trajectories converge to the limit cycle and to avoid too much arrows on the limit cycle's path, we decorated trajectories with only one arrow head, positioned at 15mm from the starting the point. ## Plot Vector Field

A vector field is an assignment of a small vector (with a given magnitude and direction) to each point in the phase plane. The direction and magnitude depends on the system dynamics.

vector field can be drawn in LaTeX usign Pgfplots with quiver option. The first thing that we need is a set of points that fill the plane. Then we add small arrows, tangent to the system's trajectories, at each point.

You may wonder how one can create a set of points that fills the phase plane using Pgfplots? This can be achieved as follows:

1. Move to a 3D plot by using the command $\verb|\addplot3|$
2. define x and y domains (-4 to 4 in this example)
3. Choose your function z=0, this will provides a set of points that fills the xy-plane with z=0
4. Change the view from 3D to a 2D version (xy plane) Here is the corresponding code:

\documentclass[border=0.2cm]{standalone}

\usepackage{pgfplots}

% Define arrow's style
\usetikzlibrary{decorations.markings}

% Arrow style
\tikzset{decorated arrows/.style={
postaction={
decorate,
decoration={
markings,
mark=between positions 0 and 1 step 15mm with {\arrow[black]{stealth};}
}
},
}
}

\begin{document}
\begin{tikzpicture}

\begin{axis}[
grid=both,
grid style={dashed,red!20},
xmin = -4, xmax = 4,
ymin = -4, ymax = 4,
width = \textwidth,
height = 0.7\textwidth,
xlabel = {$x$},
ylabel = {$y$},
title={Phase Portrait of Van Der Pol Oscillator},
view = {0}{90},
]

% Vector Field
quiver = {
u = {y/sqrt(y^2+(0.8*(1-x^2)*y-x)^2)},
v = {(0.8*(1-x^2)*y-x)/sqrt(y^2+(0.8*(1-x^2)*y-x)^2)},
scale arrows = 0.25,
},
-stealth,
domain = -4:4,
domain y = -4:4,
lightgray]
{0};

% Plot the Limit Cycle
\addplot[ultra thick, red, decorated arrows] file {data.txt};

\end{axis}
\end{tikzpicture}

\end{document}


• The option $\verb|view{0}{90}|$ projects the plot into xy plane.
• $\verb|quiver|$ is used as an option to $\verb|\addplot3|$. We provide a normalized version of $\dot{x}$ and $\dot{y}$ to $\verb|quiver|$.
• Normalized equations yields clean results with normalized vectors. Magnitude information is lost in this case but we can add a color mapping, check "Plot Vector Field in LaTeX using TikZ".
• Arrowhead style is chosen $\verb|stealth|$

## Isocline Method

At this level, we learned how to draw the phase portrait of Van der Pol Oscillator, and it can be used for second order dynamical systems in general.

In control systems, there are methods that can be used to sketch the phase portrait by hand and isocline method is one of them. The term Isocline derives from the Greek word "same slope". We will draw small lines with the same slope in the phase plane. To simplify the idea, Let's consider three cases of slope values:

### Slope $\alpha=\infty$

We have:

\begin{aligned} \frac{\dot{y}}{\dot{x}} & = \alpha=\infty \end{aligned}

From the Van der Pol equations, we get $y=0$, which corresponds to the x-axis. Hence, along the x-axis we will draw small vertical (slope=$\infty$) lines. \documentclass[border=0.2cm]{standalone}

\usepackage{pgfplots}

% Define arrow's style
\usetikzlibrary{decorations.markings}

% Arrow style
\tikzset{decorated arrows/.style={
postaction={
decorate,
decoration={
markings,
mark=between positions 0 and 1 step 15mm with {\arrow[black]{stealth};}
}
},
}
}

\begin{document}
\begin{tikzpicture}

\begin{axis}[
grid=both,
grid style={dashed,red!20},
xmin = -4, xmax = 4,
ymin = -4, ymax = 4,
width = \textwidth,
height = 0.7\textwidth,
xlabel = {$x$},
ylabel = {$y$},
title={Van Der Pol Oscillator (Isocline: $\alpha=\infty$)},
]

% Plot the Limit Cycle
\addplot[ultra thick, red, decorated arrows] file {data.txt};

% Isocline alpha=8'

quiver = {
u = {y/sqrt(y^2+(0.8*(1-x^2)*y-x)^2)},
v = {(0.8*(1-x^2)*y-x)/sqrt(y^2+(0.8*(1-x^2)*y-x)^2)},
scale arrows = 0.2,
},
samples=50,
domain = -4:4,
]
{0};

smooth,
thick,
domain = -4:4,
]
{0};

\end{axis}
\end{tikzpicture}

\end{document}


• For isocline method, we do not draw vectors in the whole plane but along specific paths. This can be achieved by 2D plot command $\verb|\addplot|$ where we will provide the function of the path (in this case y=0)
• We used $\verb|\addplot|$ twice: to draw the small lines and to draw the function.

### Slope $\alpha=1$

In this case, we have:

\begin{aligned} \frac{\dot{y}}{\dot{x}} & = \alpha=1 \end{aligned}

From the Van der Pol equations, we get

\begin{aligned} y & = \frac{-x}{0.2+0.8x^2} \end{aligned}

Along this function, we will draw small lines with slope=$1$.

### Slope $\alpha=-1$

We have:

\begin{aligned} \frac{\dot{y}}{\dot{x}} & = \alpha=-1 \end{aligned}

From the Van der Pol equations, we get

\begin{aligned} y & = \frac{x}{1.8-0.8x^2} \end{aligned}

Along this function, we will draw small lines with slope=$-1$  We have reached the end of this tutorial, I hope you find it useful 🥰.

If you have any remarks or suggestions, do not hesitate to contact me, I will be happy to hear from you!

Thanks!