
  pprriinnttLLiinnkkVVaalluueess -- pprriinnttss vvaalluueess ffoorr ssppeecciiffiieedd lliinnkkss ttoo aa ffiillee

  UUSSAAGGEE

        printLinkValues <file> <printProc> <group-list1> <group-list2>
            [-type <link-type> | -append]

  DDEESSCCRRIIPPTTIIOONN

  This command is used to print information about links to a file. The first
  list of groups is the "senders" and the second list is the "receivers". The
  printProc Tcl procedure will be called once for each link from a sender to
  a receiver. If a link type is given, only links of that type will be
  printed.

  The printProc procedure should take six arguments. These are: the sending
  group path, the sending unit path, the receiving group path, the receiving
  unit path, the number of the link's block, and the number of the link in
  the receiving unit's incoming array.

  The string returned by each call to the procedure will be written to the
  file. The user, thus, determines the format of the output. The _f_o_r_m_a_t Tcl
  command may come in very handy here.

  The file can be specified using any of the standard Lens _f_i_l_e_ _t_y_p_e_s,
  including ordinary files, compressed files, pipelines, Tcl file handles,
  and a "-" for standard output. If you would like to periodically write
  values to a file, after each example for instance, you could _o_p_e_n a Tcl
  file, call printLinkValues after each example (maybe using the network's
  postExampleProc) and then _c_l_o_s_e the Tcl file, or simply use the -append
  flag, which causes the output to be appended to the file.

  Links to lesioned units are ignored when the values are printed.

  EEXXAAMMPPLLEESS

  In this example, the sending unit name, receiving unit name, and link
  weight are printed for every link of type "special" leaving the groups
  "input" and "hidden". The output is sent to standard output.

        lens> proc printStuff {g1 u1 g2 u2 b l} {
                format "%s->%s %.3f\n" [getObj $u1.name] [getObj $u2.name] \
                  [getObj $u2.incoming($l).weight]
              }
        lens> printLinkValues - printStuff {input hidden} * -t special

  SSEEEE AALLSSOO

  _p_r_i_n_t_U_n_i_t_V_a_l_u_e_s

  ---------------------------------------------------------------------------
    Last modified: Mon Jun 8.33:59:51 EDT 1998

