icetDataReplicationGroup(3)					  IceT Reference				       icetDataReplicationGroup(3)

NAME

       icetDataReplicationGroup -- define data replication.

Synopsis
       #include <IceT.h>

       void icetDataReplicationGroup(	IceTInt 	  size,
					const IceTInt *   processes  );

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.

       Each  group  can be declared by calling icetDataReplicationGroup and defining the group of processes that share the geometry with the local
       process. size indicates how many processes belong to the group, and processes is an array of ids of processes that  belong  to  the  group.
       Each process that belongs to a particular group must call icetDataReplicationGroup with the exact same list of processes in the same order.

       You can alternately use icetDataReplicationGroupColor to select data replication groups.

       By default, each process belongs to a group of size one containing just the local processes (i.e. there is no data replication).

Errors
       ICET_INVALID_VALUE
	       processes does not contain the local process rank.

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
       icetDataReplicationGroupColor(3), icetBoundingVertices(3), icetBoundingBox(3)

IceT Reference							September 20, 2010				       icetDataReplicationGroup(3)