X-Git-Url: https://www.fleuret.org/cgi-bin/gitweb/gitweb.cgi?a=blobdiff_plain;ds=sidebyside;f=README.md;h=1d6f5bd811b5706b39890c13fe4d5404dc7768c1;hb=07a8c54a66b01f342e4d03ca2cf99710d56806d0;hp=f370b71e9ec62c0f2af82de24b78de461a375cc1;hpb=5ab7bf38f7a5d2a7d6656177471b887d67fbf5cd;p=dagnn.git diff --git a/README.md b/README.md index f370b71..1d6f5bd 100644 --- a/README.md +++ b/README.md @@ -48,13 +48,18 @@ Note that DAG:connect allows to add a bunch of edges at once. This is particularly useful to add anonymous modules which have a single predecessor and successor. +#Usage# + ##Input and output## -If a node has a single predecessor, its output is taken as-is. If it -has multiple predecessors, all the outputs are collected into a table, -and the table is used as input. The indexes of the outputs in that -table reflects the order in which the predecessors appeared in the -DAG:connect() commands. +The DAG can deal with modules which take as input and produce as +output tensors and nested tables of tensors. + +If a node has a single predecessor, the output of the latter is taken +as-is as the input of the former. If it has multiple predecessors, all +the outputs are collected into a table, and the table is used as +input. The indexes of the outputs in that table reflects the order in +which the edges where created in the DAG:connect() commands. The input to the DAG (respectively the produced output) is a nested table of inputs reflecting the structure of the nested table of @@ -65,13 +70,13 @@ input, since it is the input to the module a, and its output will is a table composed of two tensors, corresponding to the outputs of d and e respectively. -#Usage# +##Functions## -##nn.DAG()## +###nn.DAG()### Create a new empty DAG, which inherits from nn.Container. -##nn.DAG:connect([module1 [, module2 [, ...]]])## +###nn.DAG:connect([module1 [, module2 [, ...]]])### Add new nodes corresponding to the modules passed as arguments if they are not already existing. Add edges between every two nodes @@ -80,21 +85,21 @@ corresponding to a pair of successive modules in the arguments. Calling it with n > 2 arguments is strictly equivalent to calling it n-1 times on the pairs of successive arguments. -##nn.DAG:setInput(i)## +###nn.DAG:setInput(i)### Defines the content and structure of the input. The argument should be -either a module, or a (nested) table of module. The input to the DAG -should be a (nested) table of inputs with the corresponding structure. +either a module, or a (nested) table of modules. The input to the DAG +should be a (nested) table of inputs, with the corresponding structure. -##nn.DAG:setOutput(o)## +###nn.DAG:setOutput(o)### Similar to DAG:setInput(). -##nn.DAG:print()## +###nn.DAG:print()### Prints the list of nodes. -##nn.DAG:saveDot(filename)## +###nn.DAG:saveDot(filename)### Save a dot file to be used by the Graphviz set of tools for graph visualization. This dot file can than be used for instance to produce @@ -104,17 +109,5 @@ a pdf file with dot graph.dot -T pdf -o graph.pdf ``` -##nn.DAG:updateOutput(input)## - -See the torch documentation. - -##nn.DAG:updateGradInput(input, gradOutput)## - -See the torch documentation. - -##nn.DAG:accGradParameters(input, gradOutput, scale)## - -See the torch documentation. - -- *Francois Fleuret, Jan 13th, 2017*