Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Pack/Unpack data for user-data #1224

Open
wants to merge 86 commits into
base: main
Choose a base branch
from
Open

Pack/Unpack data for user-data #1224

wants to merge 86 commits into from

Conversation

Davknapp
Copy link
Collaborator

@Davknapp Davknapp commented Aug 20, 2024

An interface for arbitrary data.
For new user-data it suffies to implement how a single element should be packed/unpacked.
The routines for vectors of user-data make use of this routine and pack/unpack the data accordingly.

Furthermore it provides a wrapper around the send/recv routine from MPI for to avoid code duplication and easy usage. This part of the interface should be extended in the future to other MPI send/recv routines.

All these boxes must be checked by the reviewers before merging the pull request:

As a reviewer please read through all the code lines and make sure that the code is fully understood, bug free, well-documented and well-structured.

General

  • The reviewer executed the new code features at least once and checked the results manually

  • The code follows the t8code coding guidelines

  • New source/header files are properly added to the Makefiles

  • The code is well documented

  • All function declarations, structs/classes and their members have a proper doxygen documentation

  • All new algorithms and data structures are sufficiently optimal in terms of memory and runtime (If this should be merged, but there is still potential for optimization, create a new issue)

Tests

  • The code is covered in an existing or new test case using Google Test

Github action

  • The code compiles without warning in debugging and release mode, with and without MPI (this should be executed automatically in a github action)

  • All tests pass (in various configurations, this should be executed automatically in a github action)

    If the Pull request introduces code that is not covered by the github action (for example coupling with a new library):

    • Should this use case be added to the github action?
    • If not, does the specific use case compile and all tests pass (check manually)

Scripts and Wiki

  • If a new directory with source-files is added, it must be covered by the script/find_all_source_files.scp to check the indentation of these files.
  • If this PR introduces a new feature, it must be covered in an example/tutorial and a Wiki article.

Licence

  • The author added a BSD statement to doc/ (or already has one)

@Davknapp Davknapp added New feature Adds a new feature to the code draft Enhance the visibility that this is a draft. C++ priority: low Should be solved eventually workload: medium Would take a week or less labels Aug 20, 2024
@sandro-elsweijer sandro-elsweijer removed the draft Enhance the visibility that this is a draft. label Oct 1, 2024
@Davknapp Davknapp assigned sandro-elsweijer and unassigned Davknapp Oct 1, 2024
Copy link
Collaborator

@sandro-elsweijer sandro-elsweijer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe its just a pet peeve of mine, but none of your docstrings is indented

along with t8code; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please adapt the file description to the format we use in other files: https://github.com/DLR-AMR/t8code/blob/main/src/t8_eclass.h#L23-L29

*
* This function unpacks data from a given buffer into the provided data structure.
*
* \tparam T The type of the data to be unpacked.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above

/**
* Packs the given data into a buffer for communication.
*
* \tparam T The type of the data to be packed.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since the class is templated and not the member function I would remove this. And if we leave it T->TType

return size;
}

void
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

inline? 😇

SC_CHECK_MPI (mpiret);
}

void
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

inline? 😇

template <>
class t8_single_data_handler<enlarged_data<double>> {
public:
int
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

inline? You get the drill ^^

t8code is a C library to manage a collection (a forest) of multiple
connected adaptive space-trees of general element classes in parallel.

Copyright (C) 2024 the developers
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Copyright (C) 2024 the developers
Copyright (C) 2025 the developers

Happy New Year 🥳

along with t8code; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For all files, the other formats are also off

*
* @tparam T the type of data
*/
template <typename T>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please rename the parameter

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
C++ New feature Adds a new feature to the code priority: low Should be solved eventually workload: medium Would take a week or less
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants