icetcreatempicommunicator(3) [debian man page]

icetCreateMPICommunicator(3)					  IceT Reference				      icetCreateMPICommunicator(3)

NAME

       icetCreateMPICommunicator -- Converts an MPI communicator to an IceT communicator.

Synopsis
       #include <IceTMPI.h>

       IceTCommunicator icetCreateMPICommunicator(
					MPI_Comm  mpi_comm  );

Description
       IceT requires a communicator in order to perform correctly. An application is free to build its own communicator, but many will simply pre-
       fer to use MPI, which is a well established parallel communication tool. Thus, IceT comes with an implementation of  IceTCommunicator  that
       uses the MPI communication layer underneath.

       icetCreateMPICommunicator is used to create an IceTCommunicator that uses the mpi_comm MPI communication object. The resulting IceTCommuni-
       cator shares the same process group and process rank as the original MPI_Comm communicator.

       mpi_comm is duplicated, which has two consiquences. First, all process in mpi_comm's group may need to  call  icetCreateMPICommunicator	in
       order  for  any of them to proceed (depending on the MPI implementation). Second, mpi_comm and the resulting IceTCommunicator are decoupled
       from each other.  Communications in one cannot affect another. Also, one communicator may be destroyed without affecting the other.

Return Value
       An IceTCommunicator with the same process group and rank as mpi_comm.  The communicator may be destroyed with a call to	icetDestroyMPICom-
       municator.

Errors
       None.

Warnings
       None.

Bugs
       All MPI errors are ignored.

Copyright
       Copyright (C)2003 Sandia Corporation

       Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software.

       This source code is released under the New BSD License.

See Also
       icetDestroyMPICommunicator(3), icetCreateContext(3)

IceT Reference							  August  9, 2010				      icetCreateMPICommunicator(3)

Check Out this Related Man Page

icetImageNull(3)						  IceT Reference						  icetImageNull(3)

NAME

       icetImageNull -- retrieve a placeholder for an empty image.

Synopsis
       #include <IceT.h>

       IceTImage icetImageNull(   void	 );

Description
       Images  are  created internally by the IceT library. Sometimes it is convenient to have a placeholder for a .igimage!null``null'' image, an
       image that does not and cannot hold data. Null images require no allocated memory to function.

       If your code has the potential of using an IceTImage image object that might not otherwise be initialized, use icetImageNull to set it to a
       null object. This will ensure that IceT image functions that operate on it will behave deterministically.

       A  null	image simply looks like an image with no pixels and has no color buffers. icetImageGetWidth, icetImageGetHeight, and icetImageGet-
       NumPixels all return 0 for a null image.  icetSetColorFormatand icetSetDepthFormatreturn ICET_IMAGE_COLOR_NONE  and  ICET_IMAGE_DEPTH_NONE,
       respectively.

       You can identify a null image with the icetImageIsNull function.

Return Value
       A null image object.

Errors
       None.

Warnings
       None.

Bugs
       None known.

Copyright
       Copyright (C)2010 Sandia Corporation

       Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software.

       This source code is released under the New BSD License.

See Also
       icetImageIsNull(3)

IceT Reference							September 20, 2010						  icetImageNull(3)

Linux and UNIX Man Pages

icetcreatempicommunicator(3) [debian man page]

Check Out this Related Man Page

We Also Found This Discussion For You

1. Programming

Application with communication between process

Discussion started by: chercheur857