Exp matcher

Makefile

@@ -2,7 +2,7 @@
 
 tests:
 	rm -f tests_log.txt
-	make test_utils test_ir test_transformer test_frontend
+	make test_utils test_ir test_transformer test_frontend test_matcher
 
 test_%:
 	@if [ -d .venv ]; then \
@@ -12,4 +12,4 @@ test_%:
 	 fi;
 
 clean:
-	rm -f tests_log.txt
+	rm -f tests_log.txt *.pdf

Pipfile

@@ -4,7 +4,7 @@ verify_ssl = true
 name = "pypi"
 
 [packages]
-"e1839a8" = {path = ".", editable = true}
+e1839a8 = {path = ".",editable = true}
 
 [dev-packages]
 pylint = "*"
@@ -14,3 +14,4 @@ rope = "*"
 pillow = "*"
 scipy = "*"
 graphviz = "*"
+sphinx = "*"

README.md

@@ -79,9 +79,33 @@ In graph theory terminology, they are `leaf` nodes of your graph.
 
 Run `utensor-cli convert --help` for detailed information.
 
-# Example
+# Use `utensor_cgen` as Library
+
+## Subgraph Isomorphic Matcher and Nodes Fusion
+
+With `uTensorGraphMatcher`, performing a subgraph isomorphic match, replace or manipulate the matched subgraph is just a few line of code!
+
+### Node Fusion
+
+![conv-pool-fuce](images/conv_pool_fuse.png)
+
+- Left: original graph
+- Middle: matched convolution layer
+- Right: replace the matched layer with specialized `QuantConvPool` node
+
+### Dropout Layer Removal
+
+![cnn-dropout](images/cnn_dropout.png)
+
+- Left: original graph with dropout Layers
+- Middle: matched dropout layers
+- Right: graph with dropout layers removed
+
+# Examples
+
+- [Deep Multilayer Perceptron](https://github.com/uTensor/utensor_cgen/tree/develop/tests/deep_mlp)
+- [End-to-End Convolution NN](https://github.com/uTensor/simple_cnn_tutorial)
 
-Please refer to [tests/deep_mlp](https://github.com/uTensor/utensor_cgen/tree/develop/tests/deep_mlp) for detailed example
 
 # User Guide
 
@@ -100,12 +124,6 @@ Following steps are a general guild for user how to porting a `TensorFlow` proto
 2. run `make tests`
     - Or you can use `pipenv run pytest tests` instead
 
-# Known Limitations
-
-- If you want to use dropout with placeholders for the `keep_prob`, you have to name the `keep_prob` placeholder by any name that starts with "keep_prob".
-    - You can still use any input tensor with name starts with "keep_prob" as long as it's not the output tensor of a placeholder node.
-    - You can't wrap `dropout` in any `namescope` 
-
 # Philosophy
 
 - [12 Factor CLI App](https://medium.com/@jdxcode/12-factor-cli-apps-dd3c227a0e46?fbclid=IwAR1Gfq0D7oh3b-mXaIMV3RwYu39TAPrPXfz5sBKC4Rz1t-cckvC8WjBVl_w)

setup.py

@@ -29,7 +29,7 @@
         ]},
     install_requires=[
         'Jinja2',
-        'tensorflow',
+        'tensorflow==1.13.1',
         'idx2numpy',
         'attrs',
         'click',