RCCE_reduce.3 1.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
  1. .TH RCCE 3 2010-02-04 "RCCE MANPAGE" "RCCE Library"
  2. .SH NAME
  3. RCCE_reduce \- applies an element-wide reduction across UEs
  4. .SH SYNOPSIS
  5. .B #include <rcce.h>
  6. .sp
  7. .BI "int RCCE_reduce(char* " inbuf ", char* " outbuf ",int " number ",int " datatype ",int " operation ",int " root ",RCCE_comm " comm );
  8. .SH DESCRIPTION
  9. .BR RCCE_reduce()
  10. applies an element-wise reduction to an array of number
  11. words across a collection of UEs and places the result in one UE.
  12. .TP 10
  13. .B inbuf
  14. Starting address of input array (private memory).
  15. .TP
  16. .B outbuf
  17. Starting address of result array (private memory).
  18. .TP
  19. .B number
  20. Length of array (words) of values to be reduced.
  21. .TP
  22. .B datatype
  23. Constant indicating the numerical data type. Choices are
  24. RCCE_INT, RCCE_LONG, RCCE_FLOAT, and RCCE_DOUBLE.
  25. .TP
  26. .B operation
  27. Constant indicating the reduction operation. Choices are
  28. RCCE_SUM, RCCE_MAX, RCCE_MIN, and RCCE_PROD.
  29. .TP
  30. .B root
  31. Rank of the UE within communicator comm that receives the result
  32. of the reduction operation.
  33. .TP
  34. .B comm
  35. Communicator whose UEs all contribute to the reduction.
  36. .SH "RETURN VALUE"
  37. Upon successful completion
  38. .BR RCCE_reduce()
  39. returns
  40. .BR RCCE_SUCCESS .
  41. .SH ERRORS
  42. Look in
  43. .BR rcce.h
  44. for additional error codes.
  45. .SH "SEE ALSO"
  46. rcce.h(5)
  47. .SH EXAMPLE
  48. .PP
  49. To be supplied.