memory-graph 0.3.38__tar.gz → 0.3.40__tar.gz

{memory_graph-0.3.38/memory_graph.egg-info → memory_graph-0.3.40}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memory_graph
-Version: 0.3.38
+Version: 0.3.40
 Summary: Teaching tool and debugging aid in context of references, mutable data types, and shallow and deep copy.
 Author-email: Bas Terwijn <bterwijn@gmail.com>
 License-Expression: BSD-2-Clause
@@ -25,8 +25,11 @@ pip install --upgrade memory_graph
 ```
 Additionally [Graphviz](https://graphviz.org/download/) needs to be installed.
 
-# Highlight #
+# Highlights #
 ![vscode_copying.gif](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/vscode_copying.gif)
+- learn the right **mental model** to think about Python data (references, mutability, shallow vs deep copy)
+- **visualize the structure of your data** to easily understand and debug any data structure
+- understand function calls, variable scope, and the **complete program state** through call stack visualization
 
 # Videos #
 | [![Quick Intro](https://img.youtube.com/vi/23_bHcr7hqo/0.jpg)](https://www.youtube.com/watch?v=23_bHcr7hqo) | [![Mutability](https://img.youtube.com/vi/pvIJgHCaXhU/0.jpg)](https://www.youtube.com/watch?v=pvIJgHCaXhU) |
@@ -61,7 +64,7 @@ mg.render(data) # renders to default: 'memory_graph.pdf'
 ```
 
 # Sharing Values #
-In Python, assigning the list from variable `a` to variable `b` causes both variables to reference the same list value and thus share it. Consequently, any change applied through one variable will impact the other. This behavior can lead to elusive bugs if a programmer incorrectly assumes that list `a` and `b` are independent.
+In Python, assigning a list from variable `a` to variable `b` causes both variables to reference the same list value and thus share it. Consequently, any change applied through one variable will impact the other. This behavior can lead to elusive bugs if a programmer incorrectly assumes that list `a` and `b` are independent.
 
 <table><tr><td> 
 
@@ -100,7 +103,7 @@ b: 4, 3, 2, 1
 ids: 126432214913216 126432214913216
 identical?: True
 ```
-A better way to understand what data is shared is to draw a graph of the data using the [memory_graph](https://pypi.org/project/memory-graph/) package.
+A better way to understand what data is shared is to draw a graph using [memory_graph](https://pypi.org/project/memory-graph/).
 
 # Chapters #
 
@@ -108,20 +111,18 @@ A better way to understand what data is shared is to draw a graph of the data us
 
 [Call Stack](#call-stack)
 
-[Global Import Trick](#global-import-trick)
-
 [Debugging](#debugging)
 
 [Data Structure Examples](#data-structure-examples)
 
 [Configuration](#configuration)
 
-[Extensions](#extensions)
-
 [Introspection](#introspection)
 
 [Graph Depth](#graph-depth)
 
+[Extensions](#extensions)
+
 [Jupyter Notebook](#jupyter-notebook)
 
 [ipython](#ipython)
@@ -148,7 +149,7 @@ ___
 ___
 
 # Python Data Model #
-The [Python Data Model](https://docs.python.org/3/reference/datamodel.html) makes a distiction between immutable and mutable types:
+Learn the right **mental model** to think about Python data. The [Python Data Model](https://docs.python.org/3/reference/datamodel.html) makes a distiction between immutable and mutable types:
 
 * **immutable**: bool, int, float, complex, str, tuple, bytes, frozenset
 * **mutable**: list, set, dict, classes, ... (most other types)
@@ -182,7 +183,7 @@ a = [4, 3, 2]
 b = a
 mg.render(locals(), 'mutable1.png')
 
-b += [1] # equivalent to:  b.append(1)
+b += [1]  # equivalent to:  b.append(1)
 mg.render(locals(), 'mutable2.png')
 ```
 | ![mutable1.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/mutable1.png) | ![mutable2.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/mutable2.png) |
@@ -198,11 +199,11 @@ Python offers three different "copy" options that we will demonstrate using a ne
 import memory_graph as mg
 import copy
 
-a = [ [1, 2], ['x', 'y'] ] # a nested list (a list containing lists)
+a = [ [1, 2], ['x', 'y'] ]  # a nested list (a list containing lists)
 
 # three different ways to make a "copy" of 'a':
 c1 = a
-c2 = copy.copy(a) # equivalent to:  a.copy() a[:] list(a)
+c2 = copy.copy(a)  # equivalent to:  a.copy() a[:] list(a)
 c3 = copy.deepcopy(a)
 
 mg.show(locals())
@@ -260,7 +261,7 @@ mg.render(locals(), 'rebinding2.png')
 | rebinding1.png | rebinding2.png |
 
 # Call Stack #
-The `mg.stack()` function retrieves the entire call stack, including the local variables for each function on the stack. This enables us to visualize the local variables across all active functions simultaneously. By examining the graph, we can determine whether any local variables from different functions share data. For instance, consider the function `add_one()` which adds the value `1` to each of its parameters `a`, `b`, and `c`.
+The `mg.stack()` function retrieves the entire call stack, including the local variables for each function on the stack. This enables us to understand function calls, variable scope, and the **complete program state** through call stack visualization. By examining the graph, we can determine whether any local variables from different functions share data. For instance, consider the function `add_one()` which adds the value `1` to each of its parameters `a`, `b`, and `c`.
 
 ```python
 import memory_graph as mg
@@ -333,9 +334,9 @@ def get_subsets(subsets, data, i, subset):
         subsets.append(subset.copy())
         return
     subset.append(data[i])
-    get_subsets(subsets, data, i+1, subset) #    do include data[i]
+    get_subsets(subsets, data, i+1, subset)  #    do include data[i]
     subset.pop()
-    get_subsets(subsets, data, i+1, subset) # don't include data[i]
+    get_subsets(subsets, data, i+1, subset)  # don't include data[i]
     mg.block(mg.show, mg.stack())
 
 def power_set(data):
@@ -423,13 +424,13 @@ and pressing &lt;Enter&gt; a number of times, results in:
 ![debugging.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/debugging.gif)
 
 # Data Structure Examples #
-Package memory_graph can be very useful in a data structures course, some examples:
+Package memory_graph can **visualize the structure of your data** to easily understand and debug data structures, some examples:
 
 ## Circular Doubly Linked List ##
 ```python
 import memory_graph as mg
 import random
-random.seed(0) # use same random numbers each run
+random.seed(0)  # use same random numbers each run
 
 class Linked_List:
     """ Circular doubly linked list """
@@ -455,7 +456,7 @@ n = 100
 for i in range(n):
     value = random.randrange(n)
     linked_list.add_back(value)
-    mg.block(mg.show, locals()) # <--- draw locals
+    mg.block(mg.show, locals())  # <--- draw locals
 ```
 ![linked_list.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/linked_list.png)
 
@@ -489,7 +490,7 @@ class BinTree:
                 self.larger = BinTree(value)
             else:
                 self.larger.add(value)
-        mg.block(mg.show, mg.stack()) # <--- draw stack
+        mg.block(mg.show, mg.stack())  # <--- draw stack
 
 tree = BinTree()
 n = 100
@@ -508,7 +509,7 @@ Here we show values being inserted in a Binary Tree in Visual Studio Code. When
 ```python
 import memory_graph as mg
 import random
-random.seed(0) # use same random numbers each run
+random.seed(0)  # use same random numbers each run
 
 class HashSet:
 
@@ -521,7 +522,7 @@ class HashSet:
             self.buckets[index] = []
         bucket = self.buckets[index]
         bucket.append(value)
-        mg.block(mg.show, locals()) # <--- draw locals
+        mg.block(mg.show, locals())  # <--- draw locals
 
     def contains(self, value):
         index = hash(value) % len(self.buckets)
@@ -549,6 +550,9 @@ Here we show values being inserted in a HashSet in PyCharm. When inserting the l
 # Configuration #
 Different aspects of memory_graph can be configured. The default configuration can be reset by calling 'mg.config_default.reset()'.
 
+- ***mg.config.reopen_viewer*** : bool
+  - If True the viewer is reopened each time show() is called, this might change window focus, default True.
+
 - ***mg.config.render_filename*** : str
   - The default filename to render to, default 'memory_graph.pdf'.
 
@@ -603,7 +607,7 @@ a = [100, 200, 300]
 b = a.copy()
 mg.render(locals(), 'not_node_types1.png')
 
-mg.config.not_node_types.remove(int) # now show separate nodes for int values
+mg.config.not_node_types.remove(int)  # now show separate nodes for int values
 
 mg.render(locals(), 'not_node_types2.png')
 ```
@@ -624,51 +628,13 @@ data = [ list(range(20)) for i in range(1,5)]
 highlight = data[2]
 
 mg.show( locals(),
-    colors                = {id(highlight): "red"   }, # set color to red
-    vertical_orientations = {id(highlight): False   }, # set horizontal orientation
-    slicers               = {id(highlight): Slicer()}  # set no slicing 
+    colors                = {id(highlight): "red"   },  # set color to red
+    vertical_orientations = {id(highlight): False   },  # set horizontal orientation
+    slicers               = {id(highlight): Slicer()}   # set no slicing
 )
 ```
 ![highlight.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/highlight.png)
 
-# Extensions #
-Different extensions are available for types from other Python packages. 
-
-## Numpy ##
-Numpy types `array` and `matrix` and `ndarray` can be graphed with "memory_graph.extension_numpy":
-
-```python
-import memory_graph as mg
-import numpy as np
-import memory_graph.extension_numpy
-np.random.seed(0) # use same random numbers each run
-
-array = np.array([1.1, 2, 3, 4, 5])
-matrix = np.matrix([[i*20+j for j in range(20)] for i in range(20)])
-ndarray = np.random.rand(20,20)
-mg.show(locals())
-```
-![extension_numpy.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_numpy.png)
-
-## Pandas ##
-Pandas types `Series` and `DataFrame` can be graphed with "memory_graph.extension_pandas":
-
-```python
-import memory_graph as mg
-import pandas as pd
-import memory_graph.extension_pandas
-
-series = pd.Series( [i for i in range(20)] )
-dataframe1 = pd.DataFrame({  "calories": [420, 380, 390],
-                             "duration": [50, 40, 45] })
-dataframe2 = pd.DataFrame({  'Name'   : [ 'Tom', 'Anna', 'Steve', 'Lisa'],
-                             'Age'    : [    28,     34,      29,     42],
-                             'Length' : [  1.70,   1.66,    1.82,   1.73] },
-                            index=['one', 'two', 'three', 'four']) # with row names
-mg.show(locals())
-```
-![extension_pandas.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_pandas.png)
-
 # Introspection #
 This section is likely to change. Sometimes the introspection fails or is not as desired. For example the `bintrees.avltree.Node` object doesn't show any attributes in the graph below.
 
@@ -810,7 +776,7 @@ For binary search we can use a List_View class to represent a particular sublist
 ```python
 import memory_graph as mg
 import random
-random.seed(2) # same random numbers each run
+random.seed(2)  # same random numbers each run
 
 class List_View:
 
@@ -828,7 +794,7 @@ class List_View:
 def bin_search(view, value):
     mid = view.get_mid()
     if view.begin == mid:
-        mg.show(mg.stack()) # <--- show stack
+        mg.show(mg.stack())  # <--- show stack
         return view.begin
     if value < view[mid]:
         return bin_search(List_View(view.lst, view.begin, mid), value)
@@ -925,6 +891,44 @@ mg.show(locals())
 ```
 ![extension_numpy.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/hidden_edges.png)
 
+# Extensions #
+Different extensions are available for types from other Python packages. 
+
+## Numpy ##
+Numpy types `array` and `matrix` and `ndarray` can be graphed with "memory_graph.extension_numpy":
+
+```python
+import memory_graph as mg
+import numpy as np
+import memory_graph.extension_numpy
+np.random.seed(0) # use same random numbers each run
+
+array = np.array([1.1, 2, 3, 4, 5])
+matrix = np.matrix([[i*20+j for j in range(20)] for i in range(20)])
+ndarray = np.random.rand(20,20)
+mg.show(locals())
+```
+![extension_numpy.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_numpy.png)
+
+## Pandas ##
+Pandas types `Series` and `DataFrame` can be graphed with "memory_graph.extension_pandas":
+
+```python
+import memory_graph as mg
+import pandas as pd
+import memory_graph.extension_pandas
+
+series = pd.Series( [i for i in range(20)] )
+dataframe1 = pd.DataFrame({  "calories": [420, 380, 390],
+                             "duration": [50, 40, 45] })
+dataframe2 = pd.DataFrame({  'Name'   : [ 'Tom', 'Anna', 'Steve', 'Lisa'],
+                             'Age'    : [    28,     34,      29,     42],
+                             'Length' : [  1.70,   1.66,    1.82,   1.73] },
+                            index=['one', 'two', 'three', 'four']) # with row names
+mg.show(locals())
+```
+![extension_pandas.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_pandas.png)
+
 # Jupyter Notebook #
 In Jupyter Notebook `locals()` has additional variables that cause problems in the graph, use `mg.locals_jupyter()` to get the local variables with these problematic variables filtered out. Use `mg.stack_jupyter()` to get the whole call stack with these variables filtered out.
 

{memory_graph-0.3.38 → memory_graph-0.3.40}/README.md

@@ -5,8 +5,11 @@ pip install --upgrade memory_graph
 ```
 Additionally [Graphviz](https://graphviz.org/download/) needs to be installed.
 
-# Highlight #
+# Highlights #
 ![vscode_copying.gif](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/vscode_copying.gif)
+- learn the right **mental model** to think about Python data (references, mutability, shallow vs deep copy)
+- **visualize the structure of your data** to easily understand and debug any data structure
+- understand function calls, variable scope, and the **complete program state** through call stack visualization
 
 # Videos #
 | [![Quick Intro](https://img.youtube.com/vi/23_bHcr7hqo/0.jpg)](https://www.youtube.com/watch?v=23_bHcr7hqo) | [![Mutability](https://img.youtube.com/vi/pvIJgHCaXhU/0.jpg)](https://www.youtube.com/watch?v=pvIJgHCaXhU) |
@@ -41,7 +44,7 @@ mg.render(data) # renders to default: 'memory_graph.pdf'
 ```
 
 # Sharing Values #
-In Python, assigning the list from variable `a` to variable `b` causes both variables to reference the same list value and thus share it. Consequently, any change applied through one variable will impact the other. This behavior can lead to elusive bugs if a programmer incorrectly assumes that list `a` and `b` are independent.
+In Python, assigning a list from variable `a` to variable `b` causes both variables to reference the same list value and thus share it. Consequently, any change applied through one variable will impact the other. This behavior can lead to elusive bugs if a programmer incorrectly assumes that list `a` and `b` are independent.
 
 <table><tr><td> 
 
@@ -80,7 +83,7 @@ b: 4, 3, 2, 1
 ids: 126432214913216 126432214913216
 identical?: True
 ```
-A better way to understand what data is shared is to draw a graph of the data using the [memory_graph](https://pypi.org/project/memory-graph/) package.
+A better way to understand what data is shared is to draw a graph using [memory_graph](https://pypi.org/project/memory-graph/).
 
 # Chapters #
 
@@ -88,20 +91,18 @@ A better way to understand what data is shared is to draw a graph of the data us
 
 [Call Stack](#call-stack)
 
-[Global Import Trick](#global-import-trick)
-
 [Debugging](#debugging)
 
 [Data Structure Examples](#data-structure-examples)
 
 [Configuration](#configuration)
 
-[Extensions](#extensions)
-
 [Introspection](#introspection)
 
 [Graph Depth](#graph-depth)
 
+[Extensions](#extensions)
+
 [Jupyter Notebook](#jupyter-notebook)
 
 [ipython](#ipython)
@@ -128,7 +129,7 @@ ___
 ___
 
 # Python Data Model #
-The [Python Data Model](https://docs.python.org/3/reference/datamodel.html) makes a distiction between immutable and mutable types:
+Learn the right **mental model** to think about Python data. The [Python Data Model](https://docs.python.org/3/reference/datamodel.html) makes a distiction between immutable and mutable types:
 
 * **immutable**: bool, int, float, complex, str, tuple, bytes, frozenset
 * **mutable**: list, set, dict, classes, ... (most other types)
@@ -162,7 +163,7 @@ a = [4, 3, 2]
 b = a
 mg.render(locals(), 'mutable1.png')
 
-b += [1] # equivalent to:  b.append(1)
+b += [1]  # equivalent to:  b.append(1)
 mg.render(locals(), 'mutable2.png')
 ```
 | ![mutable1.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/mutable1.png) | ![mutable2.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/mutable2.png) |
@@ -178,11 +179,11 @@ Python offers three different "copy" options that we will demonstrate using a ne
 import memory_graph as mg
 import copy
 
-a = [ [1, 2], ['x', 'y'] ] # a nested list (a list containing lists)
+a = [ [1, 2], ['x', 'y'] ]  # a nested list (a list containing lists)
 
 # three different ways to make a "copy" of 'a':
 c1 = a
-c2 = copy.copy(a) # equivalent to:  a.copy() a[:] list(a)
+c2 = copy.copy(a)  # equivalent to:  a.copy() a[:] list(a)
 c3 = copy.deepcopy(a)
 
 mg.show(locals())
@@ -240,7 +241,7 @@ mg.render(locals(), 'rebinding2.png')
 | rebinding1.png | rebinding2.png |
 
 # Call Stack #
-The `mg.stack()` function retrieves the entire call stack, including the local variables for each function on the stack. This enables us to visualize the local variables across all active functions simultaneously. By examining the graph, we can determine whether any local variables from different functions share data. For instance, consider the function `add_one()` which adds the value `1` to each of its parameters `a`, `b`, and `c`.
+The `mg.stack()` function retrieves the entire call stack, including the local variables for each function on the stack. This enables us to understand function calls, variable scope, and the **complete program state** through call stack visualization. By examining the graph, we can determine whether any local variables from different functions share data. For instance, consider the function `add_one()` which adds the value `1` to each of its parameters `a`, `b`, and `c`.
 
 ```python
 import memory_graph as mg
@@ -313,9 +314,9 @@ def get_subsets(subsets, data, i, subset):
         subsets.append(subset.copy())
         return
     subset.append(data[i])
-    get_subsets(subsets, data, i+1, subset) #    do include data[i]
+    get_subsets(subsets, data, i+1, subset)  #    do include data[i]
     subset.pop()
-    get_subsets(subsets, data, i+1, subset) # don't include data[i]
+    get_subsets(subsets, data, i+1, subset)  # don't include data[i]
     mg.block(mg.show, mg.stack())
 
 def power_set(data):
@@ -403,13 +404,13 @@ and pressing &lt;Enter&gt; a number of times, results in:
 ![debugging.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/debugging.gif)
 
 # Data Structure Examples #
-Package memory_graph can be very useful in a data structures course, some examples:
+Package memory_graph can **visualize the structure of your data** to easily understand and debug data structures, some examples:
 
 ## Circular Doubly Linked List ##
 ```python
 import memory_graph as mg
 import random
-random.seed(0) # use same random numbers each run
+random.seed(0)  # use same random numbers each run
 
 class Linked_List:
     """ Circular doubly linked list """
@@ -435,7 +436,7 @@ n = 100
 for i in range(n):
     value = random.randrange(n)
     linked_list.add_back(value)
-    mg.block(mg.show, locals()) # <--- draw locals
+    mg.block(mg.show, locals())  # <--- draw locals
 ```
 ![linked_list.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/linked_list.png)
 
@@ -469,7 +470,7 @@ class BinTree:
                 self.larger = BinTree(value)
             else:
                 self.larger.add(value)
-        mg.block(mg.show, mg.stack()) # <--- draw stack
+        mg.block(mg.show, mg.stack())  # <--- draw stack
 
 tree = BinTree()
 n = 100
@@ -488,7 +489,7 @@ Here we show values being inserted in a Binary Tree in Visual Studio Code. When
 ```python
 import memory_graph as mg
 import random
-random.seed(0) # use same random numbers each run
+random.seed(0)  # use same random numbers each run
 
 class HashSet:
 
@@ -501,7 +502,7 @@ class HashSet:
             self.buckets[index] = []
         bucket = self.buckets[index]
         bucket.append(value)
-        mg.block(mg.show, locals()) # <--- draw locals
+        mg.block(mg.show, locals())  # <--- draw locals
 
     def contains(self, value):
         index = hash(value) % len(self.buckets)
@@ -529,6 +530,9 @@ Here we show values being inserted in a HashSet in PyCharm. When inserting the l
 # Configuration #
 Different aspects of memory_graph can be configured. The default configuration can be reset by calling 'mg.config_default.reset()'.
 
+- ***mg.config.reopen_viewer*** : bool
+  - If True the viewer is reopened each time show() is called, this might change window focus, default True.
+
 - ***mg.config.render_filename*** : str
   - The default filename to render to, default 'memory_graph.pdf'.
 
@@ -583,7 +587,7 @@ a = [100, 200, 300]
 b = a.copy()
 mg.render(locals(), 'not_node_types1.png')
 
-mg.config.not_node_types.remove(int) # now show separate nodes for int values
+mg.config.not_node_types.remove(int)  # now show separate nodes for int values
 
 mg.render(locals(), 'not_node_types2.png')
 ```
@@ -604,51 +608,13 @@ data = [ list(range(20)) for i in range(1,5)]
 highlight = data[2]
 
 mg.show( locals(),
-    colors                = {id(highlight): "red"   }, # set color to red
-    vertical_orientations = {id(highlight): False   }, # set horizontal orientation
-    slicers               = {id(highlight): Slicer()}  # set no slicing 
+    colors                = {id(highlight): "red"   },  # set color to red
+    vertical_orientations = {id(highlight): False   },  # set horizontal orientation
+    slicers               = {id(highlight): Slicer()}   # set no slicing
 )
 ```
 ![highlight.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/highlight.png)
 
-# Extensions #
-Different extensions are available for types from other Python packages. 
-
-## Numpy ##
-Numpy types `array` and `matrix` and `ndarray` can be graphed with "memory_graph.extension_numpy":
-
-```python
-import memory_graph as mg
-import numpy as np
-import memory_graph.extension_numpy
-np.random.seed(0) # use same random numbers each run
-
-array = np.array([1.1, 2, 3, 4, 5])
-matrix = np.matrix([[i*20+j for j in range(20)] for i in range(20)])
-ndarray = np.random.rand(20,20)
-mg.show(locals())
-```
-![extension_numpy.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_numpy.png)
-
-## Pandas ##
-Pandas types `Series` and `DataFrame` can be graphed with "memory_graph.extension_pandas":
-
-```python
-import memory_graph as mg
-import pandas as pd
-import memory_graph.extension_pandas
-
-series = pd.Series( [i for i in range(20)] )
-dataframe1 = pd.DataFrame({  "calories": [420, 380, 390],
-                             "duration": [50, 40, 45] })
-dataframe2 = pd.DataFrame({  'Name'   : [ 'Tom', 'Anna', 'Steve', 'Lisa'],
-                             'Age'    : [    28,     34,      29,     42],
-                             'Length' : [  1.70,   1.66,    1.82,   1.73] },
-                            index=['one', 'two', 'three', 'four']) # with row names
-mg.show(locals())
-```
-![extension_pandas.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_pandas.png)
-
 # Introspection #
 This section is likely to change. Sometimes the introspection fails or is not as desired. For example the `bintrees.avltree.Node` object doesn't show any attributes in the graph below.
 
@@ -790,7 +756,7 @@ For binary search we can use a List_View class to represent a particular sublist
 ```python
 import memory_graph as mg
 import random
-random.seed(2) # same random numbers each run
+random.seed(2)  # same random numbers each run
 
 class List_View:
 
@@ -808,7 +774,7 @@ class List_View:
 def bin_search(view, value):
     mid = view.get_mid()
     if view.begin == mid:
-        mg.show(mg.stack()) # <--- show stack
+        mg.show(mg.stack())  # <--- show stack
         return view.begin
     if value < view[mid]:
         return bin_search(List_View(view.lst, view.begin, mid), value)
@@ -905,6 +871,44 @@ mg.show(locals())
 ```
 ![extension_numpy.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/hidden_edges.png)
 
+# Extensions #
+Different extensions are available for types from other Python packages. 
+
+## Numpy ##
+Numpy types `array` and `matrix` and `ndarray` can be graphed with "memory_graph.extension_numpy":
+
+```python
+import memory_graph as mg
+import numpy as np
+import memory_graph.extension_numpy
+np.random.seed(0) # use same random numbers each run
+
+array = np.array([1.1, 2, 3, 4, 5])
+matrix = np.matrix([[i*20+j for j in range(20)] for i in range(20)])
+ndarray = np.random.rand(20,20)
+mg.show(locals())
+```
+![extension_numpy.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_numpy.png)
+
+## Pandas ##
+Pandas types `Series` and `DataFrame` can be graphed with "memory_graph.extension_pandas":
+
+```python
+import memory_graph as mg
+import pandas as pd
+import memory_graph.extension_pandas
+
+series = pd.Series( [i for i in range(20)] )
+dataframe1 = pd.DataFrame({  "calories": [420, 380, 390],
+                             "duration": [50, 40, 45] })
+dataframe2 = pd.DataFrame({  'Name'   : [ 'Tom', 'Anna', 'Steve', 'Lisa'],
+                             'Age'    : [    28,     34,      29,     42],
+                             'Length' : [  1.70,   1.66,    1.82,   1.73] },
+                            index=['one', 'two', 'three', 'four']) # with row names
+mg.show(locals())
+```
+![extension_pandas.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_pandas.png)
+
 # Jupyter Notebook #
 In Jupyter Notebook `locals()` has additional variables that cause problems in the graph, use `mg.locals_jupyter()` to get the local variables with these problematic variables filtered out. Use `mg.stack_jupyter()` to get the whole call stack with these variables filtered out.