SWIG priorities

[aprokop]

Ordered from high to low:

• [x] docstring Needed for generating Doxygen documentation for ForTrilinos.Block #126.
• [ ] 2d array Needed for MultiVector::get2dCopy and such.
• [ ] return by value For examples, functions like Teuchos::ArrayRCP<double> f();
• [x] ierr See #119
• [x] template matching Why Map<LO,GO,NO> in Tpetra_Map.i not work?
• [x] typemap matching Why %typemap(in) LO a %{ ... %} not work while %typemap(in) int a %{ ... %} does? See Tpetra_Map.i for example.
• [x] string For std::string description()

[aprokop]

@sethrj

[sethrj]

@aprokop To get the 2D array views, can you give me C++ code that gives

• the pointer to the first element of the full contiguous 2D array
• the sizes of the full array
• the ranges of the slices ? Otherwise I think we can only support copying multivectors.

[aprokop]

@sethrj If you have a Tpetra::MultiVector<...>, the code you want is

  Tpetra::MultiVector<...> X;
   // The following returns multi-dimensional Kokkos::View
   // Right now, all the data is going to be on the host
   auto Xview = X->getLocalView();
   double* ptr = Xview.data();
   size_t dim_0 = Xview.extent(0);
   size_t dim_1 = Xview.extent(1);

This gives you the full 2D array data (not tested, though). The allocation should be contiguous (I don't think there is any padding). I'm not sure what you mean by the ranges of slices. We only need the full 2D array.

[sethrj]

I can get these last items done once #217 and #220 are merged.