OneMeshItemAdder.h

// -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
//-----------------------------------------------------------------------------
// Copyright 2000-2026 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
// See the top-level COPYRIGHT file for details.
// SPDX-License-Identifier: Apache-2.0
//-----------------------------------------------------------------------------
/*---------------------------------------------------------------------------*/
/* OneMeshItemAdder.h                                          (C) 2000-2025 */
/*                                                                           */
/* Cell creation utility                                                     */
/*---------------------------------------------------------------------------*/
#ifndef ARCANE_MESH_ONEITEMADDER_H
#define ARCANE_MESH_ONEITEMADDER_H
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#include "arcane/utils/TraceAccessor.h"
 
#include "arcane/core/Item.h"
#include "arcane/core/NodesOfItemReorderer.h"
 
#include "arcane/mesh/MeshGlobal.h"
#include "arcane/mesh/FullItemInfo.h"
#include "arcane/mesh/CellFamily.h"
#include "arcane/mesh/NodeFamily.h"
#include "arcane/mesh/FaceFamily.h"
#include "arcane/mesh/EdgeFamily.h"
#include "arcane/mesh/MeshInfos.h"
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arcane::mesh
{
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
class DynamicMesh;
class DynamicMeshIncrementalBuilder;
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
class OneMeshItemAdder
: public TraceAccessor
{
 private:
 
  // Class used to make FullCellInfo data
  // and fragmented cell description data compatible
  class CellInfoProxy;
 
 public:
 
  explicit OneMeshItemAdder(DynamicMeshIncrementalBuilder* mesh_builder);
  ~OneMeshItemAdder() {}
 
 public:
 
  ItemInternal* addOneNode(Int64 node_uid, Int32 owner);
 
  ItemInternal* addOneFace(ItemTypeId type_id,
                           Int64 face_uid,
                           Int32 owner_rank,
                           Int64ConstArrayView nodes_uid);
 
  ItemInternal* addOneEdge(Int64 edge_uid,
                           Int32 sub_domain_id,
                           Int64ConstArrayView nodes_uid);
 
  ItemInternal* addOneCell(ItemTypeId type_id,
                           Int64 cell_uid,
                           Int32 sub_domain_id,
                           Int64ConstArrayView nodes_uid,
                           bool allow_build_face);
 
  ItemInternal* addOneParentItem(const Item& item,
                                 const eItemKind submesh_kind,
                                 const bool fatal_on_existing_item = true);
 
  ItemInternal* addOneCell(const FullCellInfo& cell_info);
 
  // NOTE GG: Previously more used
  ARCANE_DEPRECATED_REASON("Y2022: Use addOneItem2() instead")
  ItemInternal* addOneItem(IItemFamily* family,
                           IItemFamilyModifier* family_modifier,
                           ItemTypeId type_id,
                           Int64 item_uid,
                           Int32 item_owner,
                           Int32 sub_domain_id,
                           Integer nb_connected_family,
                           Int64ConstArrayView connectivity_info);
 
  ItemInternal* addOneItem2(IItemFamily* family,
                            IItemFamilyModifier* family_modifier,
                            ItemTypeId type_id,
                            Int64 item_uid,
                            Int32 item_owner,
                            Int32 sub_domain_id,
                            Integer nb_connected_family,
                            Int64ConstArrayView connectivity_info);
 
  Integer nbNode() const { return m_mesh_info.getNbNode(); }
  Integer nbFace() const { return m_mesh_info.getNbFace(); }
  Integer nbCell() const { return m_mesh_info.getNbCell(); }
  Integer nbEdge() const { return m_mesh_info.getNbEdge(); }
 
  void setNextFaceUid(Int64 face_uid) { m_next_face_uid = face_uid; }
  void setNextEdgeUid(Int64 edge_uid) { m_next_edge_uid = edge_uid; }
 
  Int64 nextFaceUid() const { return m_next_face_uid; }
  Int64 nextEdgeUid() const { return m_next_edge_uid; }

  void resetAfterDeallocate();

  void setUseNodeUniqueIdToGenerateEdgeAndFaceUniqueId(bool v);
 
 private:
 
  template <typename CellInfo>
  ItemInternal* _addOneCell(const CellInfo& cell_info);
 
  template <typename CellInfo>
  void _addNodesToCell(Cell cell, const CellInfo& cell_info);
 
  template <typename CellInfo>
  bool _isReorder(Integer i_face,
                  const ItemTypeInfo::LocalFace& lf,
                  const CellInfo& cell_info);
 
  template <typename CellInfo>
  Face _findInternalFace(Integer i_face,
                         const CellInfo& cell_info,
                         bool& is_add);
 
  template <typename CellInfo>
  Edge _findInternalEdge(Integer i_edge,
                         const CellInfo& cell_info,
                         Int64 first_node,
                         Int64 second_node,
                         bool& is_add);
  template <typename CellInfo>
  void _AMR_Patch(Cell cell, const CellInfo& cell_info);
 
  void _clearConnectivity(ItemLocalId item, IIncrementalItemConnectivity* connectivity);
  void _clearReverseConnectivity(ItemLocalId item, IIncrementalItemConnectivity* connectivity, IIncrementalItemConnectivity* reverse_connectivity);
  void _printRelations(ItemInternal* item);
  void _checkSameItemCoherency(ItemWithNodes item, ConstArrayView<Int64> nodes_uid);
  Int64 _checkGenerateFaceUniqueId(Int64 uid, ConstArrayView<Int64> nodes_uid);
 
 private:
 
  DynamicMesh* m_mesh = nullptr;
  DynamicMeshIncrementalBuilder* m_mesh_builder = nullptr;
 
  CellFamily& m_cell_family;
  NodeFamily& m_node_family;
  FaceFamily& m_face_family;
  EdgeFamily& m_edge_family;
 
  ItemTypeMng* m_item_type_mng = nullptr;
 
  MeshInfos m_mesh_info; 
 
  Int64 m_next_face_uid = 0; 
  Int64 m_next_edge_uid = 0; 

  NodesOfItemReorderer m_face_reorderer;
  //UniqueArray<Int64> m_work_face_sorted_nodes;
  UniqueArray<Int64> m_work_face_orig_nodes_uid;
  UniqueArray<Int64> m_work_edge_sorted_nodes;
  UniqueArray<Int64> m_work_edge_orig_nodes_uid;

  bool m_use_hash_for_edge_and_face_unique_id = false;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // End namespace Arcane::mesh
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#endif