Added description

app.py

@@ -8,9 +8,9 @@ np.set_printoptions(precision=3)
 xlim = (-10,10)
 ylim = (-10,10)
 
-st.title("Eigen Values and Eigen Vectors")
+st.title("Visualizing Eigenvectors with 2x2 Linear Transformations")
 st.write(
-    "This app shows the effect of linear transformation with respect to eigen values and eigen vectors")
+    "This app shows the effect of a 2x2 linear transformation on simple shapes to understand the role of eigenvectors and eigenvalues in quantifying the nature of a transformation.")
 
 with st.sidebar:
     data = st.selectbox('Select type of dataset', ['Square', 'Circle'])
@@ -68,10 +68,13 @@ ax.set_yticks([])
 fig.legend(bbox_to_anchor=(1.05, 0.86), loc=1, borderaxespad=0., fontsize=8)
 st.pyplot(fig)
 
-df = pd.DataFrame({'Eigen Values': evl, 'Eigen Vectors': [str(evec[:,0]), str(evec[:,1])],\
-    'Transformed Eigen Vectors': [str(evec[:,0]*evl[0]), str(evec[:,1]*evl[1])]})
+df = pd.DataFrame({'Eigenvalues': evl, 'Eigenvectors': [str(evec[:,0]), str(evec[:,1])],\
+    'Transformed Eigenvectors': [str(evec[:,0]*evl[0]), str(evec[:,1]*evl[1])]})
 st.table(df)
 
 if np.iscomplex(evl).any() or np.iscomplex(evec).any():
-    st.write("Due to complex eigen vectors or eigne values, the transformed eigen vectors are not\
-        displayed...")
+    st.write("Due to complex eigenvectors and eigenvalues, the transformed eigenvectors are not\
+        displayed...")
+    
+file = open("description.md", "r")
+st.markdown(file.read())

description.md

@@ -0,0 +1,42 @@
+You might observe that sometimes the shapes collapse to a line, or sometimes the eigenvectors won't show due to them being complex. Let us look at why this happens in some detail.
+
+A point $(x, y)$ transforms under $A$ to $(x',y')$ as follows
+
+$$ 
+\begin{bmatrix} x'\\ y' \end{bmatrix} = \underbrace{\begin{bmatrix} a_{00} & a_{01} \\ a_{10} & a_{11} \end{bmatrix}}_{A} \begin{bmatrix} x\\ y \end{bmatrix}
+$$
+
+It is helpful to see where the unit basis vectors map to under the transformation. 
+
+$$ 
+\begin{bmatrix}
+1\\
+0
+\end{bmatrix} \stackrel{A}{\longrightarrow} \begin{bmatrix}
+a_{00}\\
+a_{10}
+\end{bmatrix} \;\;\;\;\;\;\;\;
+\begin{bmatrix}
+0\\
+1
+\end{bmatrix} \stackrel{A}{\longrightarrow} \begin{bmatrix}
+a_{01}\\
+a_{11}
+\end{bmatrix} 
+$$
+
+Eigenvectors are precisely those vectors that satisfy the following property 
+$$ Av = \lambda v $$
+They determine the directions that remain invariant under the transformation. Their corresponding eigenvalues $\lambda$ determine how much the space is stretched or squished in that direction. An eigenvalue of zero would imply that the transformed space collapses in that direction. Since the determinant is the product of the eigenvalues, it quantifies how much the transform amplifies the area measure.
+
+To obtain the eigenvalues, we solve the characteristic equation $\left| A - \lambda I \right| = 0$ which in our case expands to 
+
+$$ \lambda^2 -(a_{00}+a_{11})\lambda + (a_{00}a_{11} - a_{01}a_{10})=0 $$
+
+When the matrix $A$ is singular, then the transformed space collapses to a line. We can verify that $\lambda = 0$ is a solution only when $\left|A\right| = a_{00}a_{11} - a_{01}a_{10} = 0$. The following conditions are also equivalent to $A$ being singular:
+* A row is a multiple of the other. Trivially true when any row is identically zero. Same is true for the columns.
+* Three (or more) elements are zero.
+
+Solving for $\lambda$, we get $$ \frac{1}{2} \left(a_{00}+a_{11}\pm \sqrt{a_{00}^2-2 a_{11} a_{00}+a_{11}^2+4 a_{01} a_{10}}\right) $$
+
+The quantity under the square root sign is called the Discriminant, denoted by $D$. When $D < 0$, the eigenvalues and consequently the eigenvectors are complex. On the other hand, when $A$ is symmetric $a_{01} = a_{10}$, then the discriminant is always positive and the eigendecomposition is real.