AEntityFactory.hpp

Go to the documentation of this file.

#ifndef AENTITY_FACTORY_HPP
#define AENTITY_FACTORY_HPP

#ifndef IS_BUILDING_MB
#error "AEntityFactory.hpp isn't supposed to be included into an application"
#endif

#include "moab/Forward.hpp"
#include <vector>

namespace moab {

typedef std::vector<EntityHandle> AdjacencyVector;
class Core;

class AEntityFactory 
{
public:

  AEntityFactory(Core *mdb);

  ~AEntityFactory();
  
  ErrorCode add_adjacency(EntityHandle from_ent,
                             EntityHandle to_ent,
                             const bool both_ways = false);

  ErrorCode remove_adjacency(EntityHandle base_entity,
                                EntityHandle adjacency_to_remove);

  ErrorCode remove_all_adjacencies(EntityHandle base_entity,
                                     const bool delete_adj_list = false);

  ErrorCode get_elements(EntityHandle source_entity,
                            const unsigned int target_dimension,
                            std::vector<EntityHandle> &target_entities,
                            const bool create_if_missing,
                            const int create_adjacency_option = -1);

  ErrorCode get_polyhedron_vertices(const EntityHandle source_entity, 
                                      std::vector<EntityHandle> &target_entities);
  
  ErrorCode get_associated_meshsets( EntityHandle source_entity, 
                                        std::vector<EntityHandle> &target_entities );

  ErrorCode get_element(const EntityHandle *vertex_list,
                           const int vertex_list_size,
                           const EntityType target_type,
                           EntityHandle &target_entity,
                           const bool create_if_missing,
                           const EntityHandle source_entity = 0,
                           const int create_adjacency_option = -1);

  ErrorCode get_adjacencies(const EntityHandle entity,
                               const unsigned int to_dimension,
                               bool create_if_missing,
                               std::vector<EntityHandle> &adjacent_entities);

  ErrorCode get_adjacencies(EntityHandle entity,
                               const EntityHandle *&adjacent_entities,
                               int &num_entities) const;
                               
  ErrorCode get_adjacencies( EntityHandle entity,
                               std::vector<EntityHandle>*& adj_vec_ptr_out,
                               bool create_if_missing = false );
  
  ErrorCode get_adjacencies(EntityHandle entity,
                               std::vector<EntityHandle>& adjacent_entities) const;
  

  ErrorCode create_vert_elem_adjacencies();

  bool vert_elem_adjacencies() const { return mVertElemAdj; }

  ErrorCode notify_delete_entity(EntityHandle entity);

  ErrorCode notify_create_entity(const EntityHandle entity, 
                                    const EntityHandle *node_array,
                                    const int number_nodes);

  ErrorCode notify_change_connectivity(EntityHandle entity, 
                                          const EntityHandle* old_array,
                                          const EntityHandle* new_array, int number_nodes);

  bool explicitly_adjacent(const EntityHandle ent1,
                           const EntityHandle ent2);

  ErrorCode merge_adjust_adjacencies(EntityHandle entity_to_keep,
                                       EntityHandle entity_to_remove);
  
  void get_memory_use( unsigned long& total_entity_storage,
                       unsigned long& total_storage );
  ErrorCode get_memory_use( const Range& entities,
                              unsigned long& total_entity_storage,
                              unsigned long& total_amortized_storage );
  
private:

  ErrorCode get_adjacency_ptr( EntityHandle, std::vector<EntityHandle>*& );
  ErrorCode get_adjacency_ptr( EntityHandle, const std::vector<EntityHandle>*& ) const;
  ErrorCode set_adjacency_ptr( EntityHandle, std::vector<EntityHandle>* );
  
  ErrorCode get_vertices( EntityHandle h,
                            const EntityHandle*& vect_out,
                            int& count_out,
                            std::vector<EntityHandle>& storage );

  AEntityFactory();

  Core *thisMB;

  bool mVertElemAdj;
  
  bool entities_equivalent(const EntityHandle this_entity, 
                           const EntityHandle *vertex_list, 
                           const int vertex_list_size,
                           const EntityType target_type);

  ErrorCode get_zero_to_n_elements(EntityHandle source_entity,
                            const unsigned int target_dimension,
                            std::vector<EntityHandle> &target_entities,
                            const bool create_if_missing,
                            const int create_adjacency_option = -1);

  ErrorCode get_down_adjacency_elements(EntityHandle source_entity,
                            const unsigned int target_dimension,
                            std::vector<EntityHandle> &target_entities,
                            const bool create_if_missing,
                            const int create_adjacency_option = -1);

  ErrorCode get_down_adjacency_elements_poly(EntityHandle source_entity,
                                               const unsigned int target_dimension,
                                               std::vector<EntityHandle> &target_entities,
                                               const bool create_if_missing,
                                               const int create_adjacency_option = -1);

  ErrorCode get_up_adjacency_elements(EntityHandle source_entity,
                            const unsigned int target_dimension,
                            std::vector<EntityHandle> &target_entities,
                            const bool create_if_missing,
                            const int create_adjacency_option = -1);

  ErrorCode check_equiv_entities(EntityHandle entity_to_keep,
                                   EntityHandle entity_to_remove);
  
  ErrorCode create_explicit_adjs(EntityHandle this_ent);
  
};
 
} // namespace moab

#endif