@@ -23,8 +23,8 @@ This repository is largely divided into two sub-packages:
23
23
[ documentation] ( g3doc/DRAGNN.md ) ,
24
24
[ paper] ( https://arxiv.org/pdf/1703.04474.pdf ) ** implements Dynamic Recurrent
25
25
Acyclic Graphical Neural Networks (DRAGNN), a framework for building
26
- multi-task, fully dynamically constructed computation graphs. Practically, we
27
- use DRAGNN to extend our prior work from [ Andor et al.
26
+ multi-task, fully dynamically constructed computation graphs. Practically,
27
+ we use DRAGNN to extend our prior work from [ Andor et al.
28
28
(2016)] ( http://arxiv.org/abs/1603.06042 ) with end-to-end, deep recurrent
29
29
models and to provide a much easier to use interface to SyntaxNet. * DRAGNN
30
30
is designed first and foremost as a Python library, and therefore much
@@ -54,20 +54,47 @@ There are three ways to use SyntaxNet:
54
54
55
55
### Docker installation
56
56
57
+ _ This process takes ~ 10 minutes._
58
+
57
59
The simplest way to get started with DRAGNN is by loading our Docker container.
58
60
[ Here] ( g3doc/CLOUD.md ) is a tutorial for running the DRAGNN container on
59
61
[ GCP] ( https://cloud.google.com ) (just as applicable to your own computer).
60
62
63
+ ### Ubuntu 16.10+ binary installation
64
+
65
+ _ This process takes ~ 5 minutes, but is only compatible with Linux using GNU libc
66
+ 3.4.22 and above (e.g. Ubuntu 16.10)._
67
+
68
+ Binary wheel packages are provided for TensorFlow and SyntaxNet. If you do not
69
+ need to write new binary TensorFlow ops, these should suffice.
70
+
71
+ * `apt-get install -y graphviz libgraphviz-dev libopenblas-base libpng16-16
72
+ libxft2 python-pip python-mock`
73
+ * `pip install pygraphviz
74
+ --install-option="--include-path=/usr/include/graphviz"
75
+ --install-option="--library-path=/usr/lib/graphviz/"`
76
+ * `pip install 'ipython<6.0' protobuf numpy scipy jupyter
77
+ syntaxnet-with-tensorflow`
78
+ * `python -m jupyter_core.command nbextension enable --py --sys-prefix
79
+ widgetsnbextension`
80
+
81
+ You can test that binary modules can be successfully imported by running,
82
+
83
+ * `python -c 'import dragnn.python.load_dragnn_cc_impl,
84
+ syntaxnet.load_parser_ops'`
85
+
61
86
### Manual installation
62
87
88
+ _ This process takes 1-2 hours._
89
+
63
90
Running and training SyntaxNet/DRAGNN models requires building this package from
64
91
source. You'll need to install:
65
92
66
93
* python 2.7:
67
94
* Python 3 support is not available yet
68
- * bazel:
95
+ * bazel 0.5.4 :
69
96
* Follow the instructions [ here] ( http://bazel.build/docs/install.html )
70
- * Alternately, Download bazel <.deb> from
97
+ * Alternately, Download bazel 0.5.4 <.deb> from
71
98
[ https://github.com/bazelbuild/bazel/releases ] ( https://github.com/bazelbuild/bazel/releases )
72
99
for your system configuration.
73
100
* Install it using the command: sudo dpkg -i <.deb file>
@@ -103,9 +130,12 @@ following commands:
103
130
bazel test --linkopt=-headerpad_max_install_names \
104
131
dragnn/... syntaxnet/... util/utf8/...
105
132
```
133
+
106
134
Bazel should complete reporting all tests passed.
107
135
108
- Now you can install the SyntaxNet and DRAGNN Python modules with the following commands:
136
+ Now you can install the SyntaxNet and DRAGNN Python modules with the following
137
+ commands:
138
+
109
139
``` shell
110
140
mkdir /tmp/syntaxnet_pkg
111
141
bazel-bin/dragnn/tools/build_pip_package --output-dir=/tmp/syntaxnet_pkg
@@ -116,8 +146,6 @@ Now you can install the SyntaxNet and DRAGNN Python modules with the following c
116
146
To build SyntaxNet with GPU support please refer to the instructions in
117
147
[ issues/248] ( https://github.com/tensorflow/models/issues/248 ) .
118
148
119
-
120
-
121
149
** Note:** If you are running Docker on OSX, make sure that you have enough
122
150
memory allocated for your Docker VM.
123
151
0 commit comments