PetscSFFetchAndOpEnd#
end operation started in matching call to PetscSFFetchAndOpBegin() or PetscSFFetchAndOpWithMemTypeBegin() to fetch values from roots and update atomically by applying operation using leafdata
Synopsis#
#include "petscsf.h"
PetscErrorCode PetscSFFetchAndOpEnd(PetscSF sf, MPI_Datatype unit, void *rootdata, const void *leafdata, void *leafupdate, MPI_Op op)
Collective
Input Parameters#
sf - star forest
unit - data type
leafdata - leaf values to use in reduction
op - operation to use for reduction
Output Parameters#
rootdata - root values to be updated, input state is seen by first process to perform an update
leafupdate - state at each leaf’s respective root immediately prior to atomic update
Notes#
For device buffers, this routine synchronizes the SF device stream when the current PetscDeviceContext
uses PETSC_STREAM_DEFAULT_WITH_BARRIER or PETSC_STREAM_NONBLOCKING_WITH_BARRIER. Otherwise, device work
may remain pending after this routine returns.
Use the same current device context for the matching Begin/End calls. Before using the same PetscSF on
a different context, complete all outstanding Begin/End pairs and call PetscDeviceContextSynchronize()
on the previous context. This also applies when using different user buffers, since SF may reuse internal buffers.
See PetscSFSetFromOptions() for the additional Kokkos, MPIX, and NVSHMEM stream limitations.
See Also#
PetscSF - an alternative to low-level MPI calls for data communication, PetscSF, PetscSFComputeDegreeEnd(), PetscSFReduceEnd(), PetscSFSetGraph(), PetscSFFetchAndOpBegin(), PetscSFFetchAndOpWithMemTypeBegin()
Level#
advanced
Location#
Examples#
src/vec/is/sf/tutorials/ex1.c
src/vec/is/sf/tests/ex1.c
src/vec/is/sf/tests/ex22.c
src/vec/is/sf/tests/ex26.c
src/vec/is/sf/tests/ex3.c
Implementations#
PetscSFFetchAndOpEnd_Allgatherv() in src/vec/is/sf/impls/basic/allgatherv/sfallgatherv.c
PetscSFFetchAndOpEnd_Basic() in src/vec/is/sf/impls/basic/sfbasic.c
PetscSFFetchAndOpEnd_Window() in src/vec/is/sf/impls/window/sfwindow.c
Index of all PetscSF routines
Table of Contents for all manual pages
Index of all manual pages