IndexedItemConnectivityView.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
//-----------------------------------------------------------------------------
/*---------------------------------------------------------------------------*/
/* IndexedItemConnectivityView.h                               (C) 2000-2026 */
/*                                                                           */
/* Views on connectivities using indices.                                    */
/*---------------------------------------------------------------------------*/
#ifndef ARCANE_CORE_INDEXEDITEMCONNECTIVITYVIEW_H
#define ARCANE_CORE_INDEXEDITEMCONNECTIVITYVIEW_H
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#include "ArcaneTypes.h"
#include "arcane/core/Item.h"
#include "arcane/core/IItemFamily.h"
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arcane
{
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class ARCANE_CORE_EXPORT IndexedItemConnectivityViewBase
{
  friend class IndexedItemConnectivityViewBase2;
 
 public:
 
  IndexedItemConnectivityViewBase() = default;
  constexpr IndexedItemConnectivityViewBase(ItemConnectivityContainerView container_view,
                                            eItemKind source_kind, eItemKind target_kind)
  : m_container_view(container_view)
  , m_source_kind(source_kind)
  , m_target_kind(target_kind)
  {
  }
 
 public:

  constexpr ARCCORE_HOST_DEVICE Int32 nbSourceItem() const { return m_container_view.nbItem(); }
  constexpr ARCCORE_HOST_DEVICE Int32 nbItem(ItemLocalId lid) const { return m_container_view.m_nb_connected_items[lid]; }
  constexpr ARCCORE_HOST_DEVICE ItemLocalIdListViewT<Item> items(ItemLocalId lid) const
  {
    return m_container_view.itemsIds<Item>(lid);
  }
  eItemKind sourceItemKind() const { return m_source_kind; }
  eItemKind targetItemKind() const { return m_target_kind; }

  ARCANE_DEPRECATED_REASON("Y2022: This method is internal to Arcane and should be replaced by call to constructor")
  void init(SmallSpan<const Int32> nb_item, SmallSpan<const Int32> indexes,
            SmallSpan<const Int32> list_data, eItemKind source_kind, eItemKind target_kind)
  {
    SmallSpan<Int32> mutable_list_data(const_cast<Int32*>(list_data.data()), list_data.size());
    m_container_view = ItemConnectivityContainerView(mutable_list_data, indexes, nb_item);
    m_source_kind = source_kind;
    m_target_kind = target_kind;
  }
 
 public:
 
  void set(IndexedItemConnectivityViewBase view)
  {
    m_container_view = view.m_container_view;
    m_source_kind = view.m_source_kind;
    m_target_kind = view.m_target_kind;
  }
 
 protected:
 
  ItemConnectivityContainerView m_container_view;
  eItemKind m_source_kind = IK_Unknown;
  eItemKind m_target_kind = IK_Unknown;
 
 protected:
 
  [[noreturn]] void _badConversion(eItemKind k1, eItemKind k2) const;
 
 public:
 
  void _checkValid(eItemKind k1, eItemKind k2) const
  {
    if (k1 != m_source_kind || k2 != m_target_kind)
      _badConversion(k1, k2);
  }
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class ARCANE_CORE_EXPORT IndexedItemConnectivityViewBase2
{
 public:
 
  IndexedItemConnectivityViewBase2() = default;
 
 protected:
 
  explicit IndexedItemConnectivityViewBase2(IndexedItemConnectivityViewBase view)
  : m_container_view(view.m_container_view)
  {
  }
 
 public:

  constexpr ARCCORE_HOST_DEVICE Int32 nbSourceItem() const { return m_container_view.nbItem(); }
  constexpr ARCCORE_HOST_DEVICE Int32 nbItem(ItemLocalId lid) const { return m_container_view.m_nb_connected_items[lid]; }
  constexpr ARCCORE_HOST_DEVICE ItemLocalIdListViewT<Item> items(ItemLocalId lid) const
  {
    return m_container_view.itemsIds<Item>(lid);
  }
 
 protected:
 
  ItemConnectivityContainerView m_container_view;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

template <typename ItemType1, typename ItemType2>
class IndexedItemConnectivityGenericViewT
: public IndexedItemConnectivityViewBase2
{
 public:
 
  using ItemType1Type = ItemType1;
  using ItemType2Type = ItemType2;
  using ItemLocalId1 = ItemType1::LocalIdType;
  using ItemLocalId2 = ItemType2::LocalIdType;
  using ItemLocalIdViewType = ItemLocalIdListViewT<ItemType2>;
 
 public:
 
  explicit(false) IndexedItemConnectivityGenericViewT(IndexedItemConnectivityViewBase view)
  : IndexedItemConnectivityViewBase2(view)
  {
#ifdef ARCANE_CHECK
    eItemKind k1 = ItemTraitsT<ItemType1>::kind();
    eItemKind k2 = ItemTraitsT<ItemType2>::kind();
    view._checkValid(k1, k2);
#endif
  }
  IndexedItemConnectivityGenericViewT() = default;
 
 public:

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType items(ItemLocalId1 lid) const
  {
    return m_container_view.itemsIds<ItemType2>(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType itemIds(ItemLocalId1 lid) const
  {
    return m_container_view.itemsIds<ItemType2>(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalId2 itemId(ItemLocalId1 lid, Int32 index) const
  {
    return m_container_view.itemId<ItemLocalId2>(lid, index);
  }
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

template <typename ItemType>
class IndexedItemConnectivityViewT<ItemType, Node>
: public IndexedItemConnectivityGenericViewT<ItemType, Node>
{
 public:
 
  using BaseClass = IndexedItemConnectivityGenericViewT<ItemType, Node>;
  using ItemLocalIdType = ItemType::LocalIdType;
  using ItemLocalIdViewType = BaseClass::ItemLocalIdViewType;
  using ItemLocalId2 = BaseClass::ItemLocalId2;
 
 public:
 
  explicit(false) IndexedItemConnectivityViewT(IndexedItemConnectivityViewBase view)
  : BaseClass(view)
  {}
  IndexedItemConnectivityViewT() = default;
 
 public:

  constexpr ARCCORE_HOST_DEVICE Int32 nbNode(ItemLocalIdType lid) const
  {
    return BaseClass::nbItem(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType nodes(ItemLocalIdType lid) const
  {
    return BaseClass::items(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType nodeIds(ItemLocalIdType lid) const
  {
    return BaseClass::itemIds(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalId2 nodeId(ItemLocalIdType lid, Int32 index) const
  {
    return BaseClass::itemId(lid, index);
  }
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

template <typename ItemType>
class IndexedItemConnectivityViewT<ItemType, Edge>
: public IndexedItemConnectivityGenericViewT<ItemType, Edge>
{
 public:
 
  using BaseClass = IndexedItemConnectivityGenericViewT<ItemType, Edge>;
  using ItemLocalIdType = ItemType::LocalIdType;
  using ItemLocalIdViewType = BaseClass::ItemLocalIdViewType;
  using ItemLocalId2 = BaseClass::ItemLocalId2;
 
 public:
 
  explicit(false) IndexedItemConnectivityViewT(IndexedItemConnectivityViewBase view)
  : BaseClass(view)
  {}
  IndexedItemConnectivityViewT() = default;
 
 public:

  constexpr ARCCORE_HOST_DEVICE Int32 nbEdge(ItemLocalIdType lid) const
  {
    return BaseClass::nbItem(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType edges(ItemLocalIdType lid) const
  {
    return BaseClass::items(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType edgeIds(ItemLocalIdType lid) const
  {
    return BaseClass::items(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalId2 edgeId(ItemLocalIdType lid, Int32 index) const
  {
    return BaseClass::itemId(lid, index);
  }
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

template <typename ItemType>
class IndexedItemConnectivityViewT<ItemType, Face>
: public IndexedItemConnectivityGenericViewT<ItemType, Face>
{
 public:
 
  using BaseClass = IndexedItemConnectivityGenericViewT<ItemType, Face>;
  using ItemLocalIdType = ItemType::LocalIdType;
  using ItemLocalIdViewType = BaseClass::ItemLocalIdViewType;
  using ItemLocalId2 = BaseClass::ItemLocalId2;
 
 public:
 
  explicit(false) IndexedItemConnectivityViewT(IndexedItemConnectivityViewBase view)
  : BaseClass(view)
  {}
  IndexedItemConnectivityViewT() = default;
 
 public:

  constexpr ARCCORE_HOST_DEVICE Int32 nbFace(ItemLocalIdType lid) const
  {
    return BaseClass::nbItem(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType faces(ItemLocalIdType lid) const
  {
    return BaseClass::items(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType faceIds(ItemLocalIdType lid) const
  {
    return BaseClass::items(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalId2 faceId(ItemLocalIdType lid, Int32 index) const
  {
    return BaseClass::itemId(lid, index);
  }
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

template <typename ItemType>
class IndexedItemConnectivityViewT<ItemType, Cell>
: public IndexedItemConnectivityGenericViewT<ItemType, Cell>
{
 public:
 
  using BaseClass = IndexedItemConnectivityGenericViewT<ItemType, Cell>;
  using ItemLocalIdType = ItemType::LocalIdType;
  using ItemLocalIdViewType = BaseClass::ItemLocalIdViewType;
  using ItemLocalId2 = BaseClass::ItemLocalId2;
 
 public:
 
  explicit(false) IndexedItemConnectivityViewT(IndexedItemConnectivityViewBase view)
  : BaseClass(view)
  {}
  IndexedItemConnectivityViewT() = default;
 
 public:

  constexpr ARCCORE_HOST_DEVICE Int32 nbCell(ItemLocalIdType lid) const
  {
    return BaseClass::nbItem(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType cells(ItemLocalIdType lid) const
  {
    return BaseClass::items(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType cellIds(ItemLocalIdType lid) const
  {
    return BaseClass::items(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalId2 cellId(ItemLocalIdType lid, Int32 index) const
  {
    return BaseClass::itemId(lid, index);
  }
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

template <typename ItemType>
class IndexedItemConnectivityViewT<ItemType, DoF>
: public IndexedItemConnectivityGenericViewT<ItemType, DoF>
{
 public:
 
  using BaseClass = IndexedItemConnectivityGenericViewT<ItemType, DoF>;
  using ItemLocalIdType = ItemType::LocalIdType;
  using ItemLocalIdViewType = BaseClass::ItemLocalIdViewType;
  using ItemLocalId2 = BaseClass::ItemLocalId2;
 
 public:
 
  explicit(false) IndexedItemConnectivityViewT(IndexedItemConnectivityViewBase view)
  : BaseClass(view)
  {}
  IndexedItemConnectivityViewT() = default;
 
 public:

  constexpr ARCCORE_HOST_DEVICE Int32 nbDof(ItemLocalIdType lid) const
  {
    return BaseClass::nbItem(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType dofs(ItemLocalIdType lid) const
  {
    return BaseClass::items(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalIdViewType dofIds(ItemLocalIdType lid) const
  {
    return BaseClass::items(lid);
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalId2 dofId(ItemLocalIdType lid, Int32 index) const
  {
    return BaseClass::itemId(lid, index);
  }
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class ARCANE_CORE_EXPORT IndexedParticleCellConnectivityView
: public IndexedItemConnectivityGenericViewT<Particle, Cell>
{
 public:
 
  using BaseClass = IndexedItemConnectivityGenericViewT<Particle, Cell>;
  using ItemLocalIdType = Particle::LocalIdType;
  using ItemLocalIdViewType = BaseClass::ItemLocalIdViewType;
  using ItemLocalId2 = BaseClass::ItemLocalId2;
 
 public:
 
  explicit(false) IndexedParticleCellConnectivityView(IndexedItemConnectivityViewBase view)
  : BaseClass(view)
  {}
  explicit IndexedParticleCellConnectivityView(IParticleFamily* pf);
  explicit IndexedParticleCellConnectivityView(IItemFamily* pf);
  IndexedParticleCellConnectivityView() = default;
 
 public:

  constexpr ARCCORE_HOST_DEVICE bool hasCell(ItemLocalIdType lid) const
  {
    return !cellId(lid).isNull();
  }

  constexpr ARCCORE_HOST_DEVICE ItemLocalId2 cellId(ItemLocalIdType lid) const
  {
    return BaseClass::itemId(lid, 0);
  }
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/

class ARCANE_CORE_EXPORT MutableIndexedParticleCellConnectivityView
: public IndexedParticleCellConnectivityView
{
 public:
 
  using BaseClass = IndexedItemConnectivityGenericViewT<Particle, Cell>;
  using ItemLocalIdType = Particle::LocalIdType;
  using ItemLocalIdViewType = BaseClass::ItemLocalIdViewType;
  using ItemLocalId2 = BaseClass::ItemLocalId2;
 
 public:
 
  explicit MutableIndexedParticleCellConnectivityView(IParticleFamily* pf);
  explicit MutableIndexedParticleCellConnectivityView(IItemFamily* pf);
 
 public:

  ARCCORE_HOST_DEVICE void setCellId(ParticleLocalId particle_lid, CellLocalId cell_lid) const
  {
    m_container_view._setParticleCellId(particle_lid, cell_lid);
  }
 
 private:
 
  IItemFamily* m_family = nullptr;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
using IndexedCellNodeConnectivityView = IndexedItemConnectivityViewT<Cell, Node>;
using IndexedCellEdgeConnectivityView = IndexedItemConnectivityViewT<Cell, Edge>;
using IndexedCellFaceConnectivityView = IndexedItemConnectivityViewT<Cell, Face>;
using IndexedCellCellConnectivityView = IndexedItemConnectivityViewT<Cell, Cell>;
using IndexedCellDoFConnectivityView = IndexedItemConnectivityViewT<Cell, DoF>;
 
using IndexedFaceNodeConnectivityView = IndexedItemConnectivityViewT<Face, Node>;
using IndexedFaceEdgeConnectivityView = IndexedItemConnectivityViewT<Face, Edge>;
using IndexedFaceFaceConnectivityView = IndexedItemConnectivityViewT<Face, Face>;
using IndexedFaceCellConnectivityView = IndexedItemConnectivityViewT<Face, Cell>;
using IndexedFaceDoFConnectivityView = IndexedItemConnectivityViewT<Face, DoF>;
 
using IndexedEdgeNodeConnectivityView = IndexedItemConnectivityViewT<Edge, Node>;
using IndexedEdgeEdgeConnectivityView = IndexedItemConnectivityViewT<Edge, Edge>;
using IndexedEdgeFaceConnectivityView = IndexedItemConnectivityViewT<Edge, Face>;
using IndexedEdgeCellConnectivityView = IndexedItemConnectivityViewT<Edge, Cell>;
using IndexedEdgeDoFConnectivityView = IndexedItemConnectivityViewT<Edge, DoF>;
 
using IndexedNodeNodeConnectivityView = IndexedItemConnectivityViewT<Node, Node>;
using IndexedNodeEdgeConnectivityView = IndexedItemConnectivityViewT<Node, Edge>;
using IndexedNodeFaceConnectivityView = IndexedItemConnectivityViewT<Node, Face>;
using IndexedNodeCellConnectivityView = IndexedItemConnectivityViewT<Node, Cell>;
using IndexedNodeDoFConnectivityView = IndexedItemConnectivityViewT<Node, DoF>;
 
using IndexedDoFNodeConnectivityView = IndexedItemConnectivityViewT<DoF, Node>;
using IndexedDoFEdgeConnectivityView = IndexedItemConnectivityViewT<DoF, Edge>;
using IndexedDoFFaceConnectivityView = IndexedItemConnectivityViewT<DoF, Face>;
using IndexedDoFCellConnectivityView = IndexedItemConnectivityViewT<DoF, Cell>;
using IndexedDoFDoFConnectivityView = IndexedItemConnectivityViewT<DoF, DoF>;
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // End namespace Arcane
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#endif