diff --git a/.idea/preferred-vcs.xml b/.idea/preferred-vcs.xml
new file mode 100644
index 0000000..848cfc4
--- /dev/null
+++ b/.idea/preferred-vcs.xml
@@ -0,0 +1,6 @@
+
+
+
+ ApexVCS
+
+
\ No newline at end of file
diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index 267722a..032fd6f 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -2,8 +2,9 @@
+
-
+
@@ -13,7 +14,7 @@
-
+
@@ -24,11 +25,11 @@
-
+
-
-
+
+
@@ -36,6 +37,61 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -45,6 +101,7 @@
@@ -99,7 +156,7 @@
-
+
@@ -117,7 +174,7 @@
-
+
@@ -151,7 +208,7 @@
-
+
@@ -170,14 +227,12 @@
-
-
+
@@ -198,24 +253,27 @@
-
+
-
-
-
-
+
+
+
+
-
+
-
-
+
+
-
+
-
+
+
+
+
@@ -236,7 +294,83 @@
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -244,5 +378,85 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/README.md b/README.md
index 1202543..979de61 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,22 @@
-# sim_bin_tree
+
+#### Simulation of a Markov chain walk in a binary tree
+
+File *mcBinTree.py* runs several simulations and takes the mean of
+each experiment and outputs the plot of the mean and the stopping
+time of the simulation.
+
+File *oneRunMC.py* is just a single experiment of the simulation.
+
+File *mcSim.py* shows how fast in Total Variation norm does the
+Markov Chain converges to the stationary distribution.
+
+File *makeTree.py* build a special tree data structure.
+
+File *mcMatrix.py* builds a matrix from a tree created by *makeTree.py*.
+
+File *totalVariationNorm.py* has two of the ways to measure the TV
+norm.
+
+**Note:** the n-arity of the tree can be changed, but the code might
+have to be changed a bit.
+