itaps-parallel A couple of proposals for new iMesh functions

Carl Ollivier-Gooch cfog at mech.ubc.ca
Fri Sep 12 12:33:23 CDT 2008


Here are a couple of things that came up while I was working on
swapping, and came across a couple of missing things in the interface. 
Mark S and Onkar should pay particular attention to this, as the other 
major stakeholders were present for a bootcamp discussion of this.

I'm proposing that we add this function:


     /**\brief  Get information about how this implementation can create 
entities
      *
      * Get information about the types of low-dimensional entities that 
an implementation can use to create high-dimensional entities.  The 
result is an adjacency table-style array.  This table is a 4x4 array, 
with indices 0-based, where A(i,j) (i=row, j=column) is lower triangular 
(i < j), where a non-zero values states that the implementation can 
create entities of type j from entities of type i.
      * \param instance iMesh instance handle
      * \param *adjacency_table Array representing adjacency table
      *        passed to function
      * \param adjacency_table_size Size of adjacency table (should be 16)
      * \param *err Pointer to error type returned from function
      */
   void iMesh_getEntCreateTable (iMesh_Instance instance,
                           /*in*/ int* adjacency_table,
                           /*in*/ int adjacency_table_size,
                           /*out*/ int *err);

Also, I suggest that we add an ENTITY_IN_USE error code, to be used when 
an entity deletion is requested for an entity that is still in use as a 
downward adjacency.  This is currently spec'ed as an error, but 
INVALID_ARGUMENT is a fairly non-diagnostic error code for this.....  I 
don't expect to add this to iBase.h until we start adding error codes 
for parallel.

Carl

-- 
------------------------------------------------------------------------
Dr. Carl Ollivier-Gooch, P.Eng.                   Voice: +1-604-822-1854
Associate Professor                                 Fax: +1-604-822-2403
Department of Mechanical Engineering             email: cfog at mech.ubc.ca
University of British Columbia              http://www.mech.ubc.ca/~cfog
Vancouver, BC  V6T 1Z4                  http://tetra.mech.ubc.ca/ANSLab/
------------------------------------------------------------------------




More information about the itaps-parallel mailing list