SWIG priorities

[aprokop]

Ordered from high to low:

• docstring
  Needed for generating Doxygen documentation for ForTrilinos.Block [WIP] doxy2swig based ForTrilinos documentation generation for Tpetra and Teuchos  #126.
• 2d array
  Needed for MultiVector::get2dCopy and such.
• return by value
  For examples, functions like Teuchos::ArrayRCP<double> f();
• ierr
  See ierr and serr module of origin #119
• template matching
  Why Map<LO,GO,NO> in Tpetra_Map.i not work?
• typemap matching
  Why %typemap(in) LO a %{ ... %} not work while %typemap(in) int a %{ ... %} does? See Tpetra_Map.i for example.
• 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.