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
icetDataReplicationGroupColor(3) IceT Reference icetDataReplicationGroupColor(3) NAME
icetDataReplicationGroupColor -- define data replication. Synopsis #include <IceT.h> void icetDataReplicationGroupColor( IceTInt color ); Description IceT has the ability to take advantage of geometric data that is replicated among processes. If a group of processes share the same geome- try data, then IceT will split the region of the display that the data projects onto among the processes, thereby reducing the total amount of image composition work that needs to be done. Despite the name of the function, icetDataReplicationGroupColor has nothing to do the color of the data being replicated. Instead, color is used to mark the local process as part of a given group. When icetDataReplicationGroupColor is called, it finds all other processes that have the same color and builds a group based on this information. icetDataReplicationGroupColor must be called on every processes before the function will return. Errors None. Warnings None. Bugs IceT assumes that icetDataReplicationGroup is called with the exact same parameters on all processes belonging to a given group. Likewise, IceT also assumes that all processes have called icetBoundingVertices or icetBoundingBox with the exact same parameters on all processes belonging to a given group. These requirements are not strictly enforced, but failing to do so may cause some of the geometry to not be rendered. 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 icetDataReplicationGroup(3), icetBoundingVertices(3), icetBoundingBox(3) IceT Reference September 20, 2010 icetDataReplicationGroupColor(3)