include/mmph_intf.h

Go to the documentation of this file.

/************************************************************************
File mmph_intf.h - interface of parallel mesh manipulation modules of the code.

  mmpr_init_mesh - to initialize the parallel mesh data structure

  mmpr_el_owner - to get an owning processor identifier of an element
  mmpr_el_set_owner - to set an owning processor identifier of an element
  mmpr_fa_owner - to get an owning processor identifier of a face
  mmpr_fa_set_owner - to set an owning processor identifier of a face
  mmpr_ed_owner - to get an owning processor identifier of an edge
  mmpr_ed_set_owner - to set an owning processor identifier of an edge
  mmpr_ve_owner - to get an owning processor identifier of a vertex
  mmpr_ve_set_owner - to set an owning processor identifier of a vertex
  mmpr_el_id_at_owner - to get an local identifier of an element
  mmpr_el_set_id_at_owner - to set an local identifier of an element
  mmpr_fa_id_at_owner - to get an local identifier of a face
  mmpr_fa_set_id_at_owner - to set an local identifier of a face
  mmpr_ed_id_at_owner - to get an local identifier of an edge
  mmpr_ed_set_id_at_owner - to set an local identifier of an edge
  mmr_ve_id_at_owner - to get an local identifier of a vertex
  mmpr_ve_set_id_at_owner - to set an local identifier of a vertex

  mmpr_create_subdomains - to decompose the mesh and create subdomains

  mmpr_mesh_ent_ovl - to create tables (for each mesh entity type) of local
                     numbers and storing processors for each mesh entity owned
                     by a given processor but stored also on other processors
  mmpr_update_ipid - to update interprocessor ID for all mesh entities
                    using interprocessor communication
  mmpr_free_mesh_ovl - to free data structure with overlap info
  mmpr_update_ref_list - to update list of refined elements due to irregularity
                      constraint using inter-processor communication
  mmpr_exchange_list_ref - to update the list of refined elements
                          using inter-processor communication
  mmpr_balance_load - to ... (what you think?)

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

#ifndef _mmph_intf_
#define _mmph_intf_


#ifdef __cplusplus
extern "C"{
#endif


/*** CONSTANTS ***/
#define MMPC_MAX_NUM_SUB 1024     
//#define MMPC_MAX_NUM_SUB 128     
/*** FUNCTION DECLARATIONS - headers for external functions ***/

extern int mmpr_init_mesh(  
  int Control,
  int Mesh_id,
  int Nr_proc,
  int My_proc_id
  );

extern int mmpr_check_mesh(  
  int Mesh_id
  );


extern int mmpr_el_owner(
  int Mesh_id,   
  int El         
  );


extern int mmpr_el_set_owner( 
  int Mesh_id,  
  int El,   
  int Owner 
  );


extern int mmpr_fa_owner(
  int Mesh_id,  
  int Fa        
  );

extern int mmpr_fa_set_owner(  
  int Mesh_id,  
  int Fa,       
  int Owner      
  );

extern int mmpr_ed_owner(
  int Mesh_id,    
  int Ed          
  );

extern int mmpr_ed_set_owner(  
  int Mesh_id,  
  int Ed,       
  int Owner      
  );


extern int mmpr_ve_owner(
  int Mesh_id,  
  int Ve        
  );


extern int mmpr_ve_set_owner(  
  int Mesh_id,  
  int Ve,       
  int Owner      
  );


extern int mmpr_el_id_at_owner(
  int Mesh_id,   
  int El         
  );

extern int mmpr_el_set_id_at_owner(
  int Mesh_id,  
  int El,   
  int Id_At_Owner 
  );


extern int mmpr_fa_id_at_owner( 
  int Mesh_id,  
  int Fa        
  );


extern int mmpr_fa_set_id_at_owner(
  int Mesh_id,  
  int Fa,       
  int Id_At_Owner      
  );


extern int mmpr_ed_id_at_owner( 
  int Mesh_id,    
  int Ed          
  );

extern int mmpr_ed_set_id_at_owner(
  int Mesh_id,  
  int Ed,       
  int Id_At_Owner      
  );

extern int mmpr_ve_id_at_owner(
  int Mesh_id,  
  int Ve        
  );

extern int mmpr_ve_set_id_at_owner(
  int Mesh_id,  
  int Ve,       
  int Id_At_Owner      
  );


extern int mmpr_create_subdomains( 
  int Mesh_id,       
  int Control        
  );

extern int mmpr_init_ref(  
  int Mesh_id   
  );

extern int mmpr_is_ready_for_proj_dof_ref(
  int Mesh_id
);

extern int mmpr_final_ref(  
  int Mesh_id   
  );

extern int mmpr_mesh_ent_ovl( 
  int Mesh_id   
  );

extern int mmpr_update_ipid( 
  int Mesh_id   
  );

extern int mmpr_free_mesh_ovl(
  int Mesh_id     
  );


extern int mmpr_balance_load(
  int Mesh_id  
  );


  // NEW PROCEDURES NOT SUPPORTED BY MMPD_PRISM

extern int mmpr_update_ref_list(
  const int Mesh_id,     
  int *Nr_ref,     
  int **List_ref   
  );

extern int mmpr_n_neighbouring_procs( // returns number of procs connected with caller proc
        const int Mesh_id //in: mesh id
        );

extern int mmpr_neighbouring_procs( // returns number of procs connected with caller proc
        const int Mesh_id,  //in: mesh id
        int * Neigh_proc_ids //out:[mmpr_ipc_n_connected_procs]
                                   // connected negibouring procs ids
        );

extern int mmpr_ipc_faces_connected_to_proc( // returns number of faces
        const int Mesh_id, //in: mesh id
        const int Proc_id, //in: proc id to check
        int * Faces //out: [upto Connected_proc_n_links for Proc_id]
        );

extern int mmpr_ipc_other_subdomain_neigh(const int Mesh_id,
        const int Fa,
        int *Neig_el_id_at_owner,
        int *Neig_el_owner
        );
 // end of group


#ifdef __cplusplus
}
#endif



#endif

---