MBCoupler: parallel solution transfer between meshes

For a paper describing this capability, see http://www.mcs.anl.gov/~tautges/downloads/scalablecoupling2.pdf.

To run mbcoupler_test, do the following:

   mpiexec -np 2  mbcoupler_test -meshes <MOAB_DIR>/MeshFiles/unittest/64bricks_1khex.h5m <MOAB_DIR>/MeshFiles/unittest/64bricks_12ktet.h5m -itag vertex_field -outfile dum.h5m

where <MOAB_DIR> is your MOAB source directory.

To see syntax for running the tool, just type ./mbcoupler_test.

On my dual-core laptop, the output of the above test is:

tautges@tautges-e4300:$ mpiexec -np 2  ~/code/MOABpar/tools/mbcoupler/mbcoupler_test -meshes 64bricks_1khex.h5m 64bricks_12ktet.h5m -itag vertex_field -outfile dum.h5m
Parallel Read times: 
  0.0941911 PARALLEL READ PART
  0.091558 PARALLEL RESOLVE_SHARED_ENTS
  0.030874 PARALLEL EXCHANGE_GHOSTS
  0.00243878 PARALLEL RESOLVE_SHARED_SETS
  0.215919 PARALLEL TOTAL
Parallel Read times: 
  0.187757 PARALLEL READ PART
  0.14653 PARALLEL RESOLVE_SHARED_ENTS
  0.129782 PARALLEL EXCHANGE_GHOSTS
  0.00410199 PARALLEL RESOLVE_SHARED_SETS
  0.465946 PARALLEL TOTAL
Proc 1: box min/max, tree depth = (-0.5,-0.5,-0.5), (3.5,1.5,3.5), 12
Proc 0: box min/max, tree depth = (-0.5,1.5,-0.5), (3.5,3.5,3.5), 12
point location: wanted 1096 got 1019 locally, 77 remote, missing 0
point location: wanted 1376 got 1193 locally, 183 remote, missing 0

Max time : 2.28864 0.0607822 0.00296688 (inst loc interp -- 2 procs )
Wrote dum.h5m
mbcoupler_test complete.
WriteHDF5:           0.160172
  gather mesh:       0.033056
  create file:       0.095634
    create nodes:    0.00828218
    negotiate types: 6.29425e-05
    craete elem:     0.000479937
    file id exch:    0.0386569
    create adj:      0.0107481
    create set:      0.00482583
      shared ids:    2.09808e-05
      shared data:   5.4121e-05
      set offsets:   0.00468326
    create tags:     0.038074
  coordinates:       0.000541925
  connectivity:      0.016875
  sets:              0.00612497
    set descrip:     0.000552893
    set content:     0.00394988
    set parent:      0.000825882
    set child:       0.000779152
  adjacencies:       1.09673e-05
  tags:              0.017395
    dense data:      0.00216842
    sparse data:     0.015111
    var-len data:    0
Wrote dum.h5m
mbcoupler_test complete.
