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.

Sign up for GitHub

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

Clarifying Team Collectives #452

Closed
wants to merge 3 commits into from
Closed

Clarifying Team Collectives #452

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
2fadde5
clarifying *team or* active set in shmem_alltoall
jamesaross Aug 24, 2020
f8f9b64
clarifying *team or* active set in shmem_alltoalls
jamesaross Aug 24, 2020
ccf1e64
clarifying *team or* active set in shmem_reductions
jamesaross Aug 24, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions content/shmem_alltoall.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,11 @@
\apiargument{IN}{team}{A valid \openshmem team handle to a team.}%

\apiargument{OUT}{dest}{Symmetric address of a data object large enough to receive
the combined total of \VAR{nelems} elements from each \ac{PE} in the
the combined total of \VAR{nelems} elements from each \ac{PE} in the team or
active set.
The type of \dest{} should match that implied in the SYNOPSIS section.}
\apiargument{IN}{source}{Symmetric address of a data object that contains \VAR{nelems}
elements of data for each \ac{PE} in the active set, ordered according to
elements of data for each \ac{PE} in the team or active set, ordered according to
destination \ac{PE}.
The type of \source{} should match that implied in the SYNOPSIS section.}
\apiargument{IN}{nelems}{
Expand Down Expand Up @@ -117,7 +117,7 @@
Before any \ac{PE} calls a \FUNC{shmem\_alltoall} routine,
the following conditions must be ensured:
\begin{itemize}
\item The \VAR{dest} data object on all \acp{PE} in the active set is
\item The \VAR{dest} data object on all \acp{PE} in the team or active set is
ready to accept the \FUNC{shmem\_alltoall} data.
\item For active-set-based routines, the \VAR{pSync} array
on all \acp{PE} in the active set is not still in use from a prior call
Expand Down
4 changes: 2 additions & 2 deletions content/shmem_alltoalls.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,11 @@
\apiargument{IN}{team}{A valid \openshmem team handle.}%

\apiargument{OUT}{dest}{Symmetric address of a data object large enough to receive
the combined total of \VAR{nelems} elements from each \ac{PE} in the
the combined total of \VAR{nelems} elements from each \ac{PE} in the team or
active set.
The type of \dest{} should match that implied in the SYNOPSIS section.}
\apiargument{IN}{source}{Symmetric address of a data object that contains \VAR{nelems}
elements of data for each \ac{PE} in the active set, ordered according to
elements of data for each \ac{PE} in the team or active set, ordered according to
destination \ac{PE}.
The type of \source{} should match that implied in the SYNOPSIS section.}
\apiargument{IN}{dst}{The stride between consecutive elements of the \dest{}
Expand Down
20 changes: 10 additions & 10 deletions content/shmem_reductions.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
\apisummary{
The following functions perform reduction operations across all
\acp{PE} in a set of \acp{PE}.
\acp{PE} in an \openshmem team or active set of \acp{PE}.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Would the sentence read better if we dropped "of \acp{PE}"?

Copy link
Collaborator

Choose a reason for hiding this comment

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

Also suggest dropping "of PEs" in the subsequent occurrences.

}

\begin{apidefinition}
Expand Down Expand Up @@ -32,7 +32,7 @@

\subsubsubsection{AND}
\label{subsec:shmem_and_reduce}
Performs a bitwise AND reduction across a set of \acp{PE}.\newline
Performs a bitwise AND reduction across an \openshmem team or active set of \acp{PE}.\newline

%% C11
\begin{C11synopsis}
Expand All @@ -56,7 +56,7 @@ \subsubsubsection{AND}

\subsubsubsection{OR}
\label{subsec:shmem_or_reduce}
Performs a bitwise OR reduction across a set of \acp{PE}.\newline
Performs a bitwise OR reduction across an \openshmem team or active set of \acp{PE}.\newline

%% C11
\begin{C11synopsis}
Expand All @@ -80,7 +80,7 @@ \subsubsubsection{OR}

\subsubsubsection{XOR}
\label{subsec:shmem_xor_reduce}
Performs a bitwise exclusive OR (XOR) reduction across a set of \acp{PE}.\newline
Performs a bitwise exclusive OR (XOR) reduction across an \openshmem team or active set of \acp{PE}.\newline

%% C11
\begin{C11synopsis}
Expand All @@ -104,7 +104,7 @@ \subsubsubsection{XOR}

\subsubsubsection{MAX}
\label{subsec:shmem_max_reduce}
Performs a maximum-value reduction across a set of \acp{PE}.\newline
Performs a maximum-value reduction across an \openshmem team or active set of \acp{PE}.\newline

%% C11
\begin{C11synopsis}
Expand All @@ -129,7 +129,7 @@ \subsubsubsection{MAX}

\subsubsubsection{MIN}
\label{subsec:shmem_min_reduce}
Performs a minimum-value reduction across a set of \acp{PE}.\newline
Performs a minimum-value reduction across an \openshmem team or active set of \acp{PE}.\newline

%% C11
\begin{C11synopsis}
Expand All @@ -154,7 +154,7 @@ \subsubsubsection{MIN}

\subsubsubsection{SUM}
\label{subsec:shmem_sum_reduce}
Performs a sum reduction across a set of \acp{PE}.\newline
Performs a sum reduction across an \openshmem team or active set of \acp{PE}.\newline

%% C11
\begin{C11synopsis}
Expand All @@ -179,7 +179,7 @@ \subsubsubsection{SUM}

\subsubsubsection{PROD}
\label{subsec:shmem_prod_reduce}
Performs a product reduction across a set of \acp{PE}.\newline
Performs a product reduction across an \openshmem team or active set of \acp{PE}.\newline

%% C11
\begin{C11synopsis}
Expand Down Expand Up @@ -291,8 +291,8 @@ \subsubsubsection{PROD}
\end{apiarguments}

\apidescription{
\openshmem reduction routines are collective routines over an active set or
existing \openshmem team that compute one or more reductions across symmetric
\openshmem reduction routines are collective routines over an \openshmem team or
active set that compute one or more reductions across symmetric
arrays on multiple \acp{PE}. A reduction performs an associative binary routine
across a set of values.

Expand Down