Issue 502 - Implements new read_array templates dim3 absorbing boundaries write/read

[lsawade]

Description

This PR implements

• Further Kokkos::View reads of 2D and 3D views for read_array and read_index_array.
• Writing function in the Fortran code to write boundary indeces to write/read faces in the first dimension
• absorbing boundary struct
• templated stacey boundary mass matrices as part of the absorbing boundary struct
• free surface boundary struct
• reading of the free surface
• refactor of the reading catching errors to print information on the buffers
• function to read check values and printing the associated error (if there is one)

Issue Number

Closes #502

Checklist

Please make sure to check developer documentation on specfem docs.

• I ran the code through pre-commit to check style
• My code passes all the integration tests
• I have added sufficient unittests to test my changes
• I have added/updated documentation for the changes I am proposing
• I have updated CMakeLists to ensure my code builds
• My code builds across all platforms

[Rohit-Kakodkar]

One minor suggestion.

[Rohit-Kakodkar]

Should this be commented?

[lsawade]

Yes, I initially wrote a function to write an integer array instead of the boolean array. But the error was something else. I think here, I agree with the last comment, that we should assign integers to the array in terms of which element is what, and then read those integers on the CPP side into tags.

I did not do that yet to move on with the rest of the file since reading the boolean array was not the issue.

[Rohit-Kakodkar]

Should these be a single function? We could have a function like this -

template <typename ViewType>
void read_array(std::ifstream &stream, ViewType &array);

then have template specializations for different dimensions

[lsawade]

Yes, that can be done!