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 geometry 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)