include/apph_intf.h

Go to the documentation of this file.

/************************************************************************
File apph_intf.h - interface of parallel approximation modules of the code.

Procedures:
  appr_get_ent_owner - to return owning process(or) ID
  appr_get_ent_id_at_owner

  appr_adjust_field - to adjust DOFs after domain decomposition

  appr_init_exchange_tables - to initialize data structure related to exchange 
                             of dofs
  appr_free_exchange_tables - to free data structure related to exchange 
                             of dofs

  appr_get_nr_dofs_owned - utility to calculate the number of dofs owned at
                          the finest level

Global functions that can be (should be?) parallelized
  appr_create_exchange_tables - to create lists of dof structures
                              exchanged between pairs of processors.
  appr_exchange_dofs - to exchange dofs between processors
  appr_sol_vec_norm - to compute a norm of global vector in parallel
  appr_sol_sc_prod - to compute a scalar product of two global vectors 

------------------------------              
History:        
    08.2008 - Krzysztof Banas, initial version      
*************************************************************************/

#ifndef _apph_intf_
#define _apph_intf_

#ifdef __cplusplus
extern "C" {
#endif

extern int appr_get_ent_owner( 
  int Field_id,    
  int Ent_type,      
  int Ent_id         
  );

extern int appr_get_ent_id_at_owner( 
  int Field_id,    
  int Ent_type,      
  int Ent_id         
  );

int appr_adjust_field(
  int Field_id    /* in: approximation field ID  */
              );

extern int appr_init_exchange_tables(/* returns: ID of created tables */
  int Nr_proc,      /* number of process(or)s */
  int My_proc_id,   /* executing process(or)s ID */
  int Field_id,
  int Nreq_offset,
  int Nreq,
  int Nr_levels    /* in: number of levels for each field */
  );

extern int appr_create_exchange_tables( 
  int Table_index,    /* in: exchange table index  */
  int Level_id,    
  int Nr_dof_ent,  
  int* L_dof_ent_type,
  int* L_dof_ent_id,  
  int* L_bl_nrdof,    
  int* L_bl_posg,     
  int* L_elem_to_bl,  
  int* L_face_to_bl,  
  int* L_edge_to_bl,  
  int* L_vert_to_bl  
  );

extern int appr_exchange_dofs(
  int Table_index,    /* in: exchange table index  */
  int Level_id,    
  double* Vec_dofs  
  );

extern double appr_sol_vec_norm( 
  int Table_index,    /* in: exchange table index  */
  int Level_id,    
  int Nrdof,            
  double* Vector        
  );

extern double appr_sol_sc_prod(
  int Table_index,    /* in: exchange table index  */
  int Level_id,    
  int Nrdof,           
  double* Vector1,     
  double* Vector2      
  );


extern int appr_get_nr_dofs_owned( 
  int Table_index    /* in: exchange table index  */
  );

extern int appr_free_exchange_tables( 
  int Table_index    /* in: exchange table index  */
  );
 // end of group


#ifdef __cplusplus
}
#endif

#endif

---