IItemFamily.h

// -*- tab-width: 2; indent-tabs-mode: nil; coding: utf-8-with-signature -*-
//-----------------------------------------------------------------------------
// Copyright 2000-2023 CEA (www.cea.fr) IFPEN (www.ifpenergiesnouvelles.com)
// See the top-level COPYRIGHT file for details.
// SPDX-License-Identifier: Apache-2.0
//-----------------------------------------------------------------------------
/*---------------------------------------------------------------------------*/
/* IItemFamily.h                                               (C) 2000-2024 */
/*                                                                           */
/* Interface d'une famille d'entités.                                        */
/*---------------------------------------------------------------------------*/
#ifndef ARCANE_IITEMFAMILY_H
#define ARCANE_IITEMFAMILY_H
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#include "arcane/ArcaneTypes.h"
#include "arcane/ItemTypes.h"
#include "arcane/VariableTypedef.h"
#include "arcane/Parallel.h"
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
namespace Arcane
{
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
class IParallelMng;
class IDataOperation;
class ItemUniqueId;
class IItemInternalSortFunction;
class IVariableSynchronizer;
class IParticleFamily;
class GroupIndexTable;
class IItemConnectivityInfo;
class IItemConnectivityMng;
class IItemConnectivity;
class IExtraGhostItemsBuilder;
class IIncrementalItemConnectivity;
class IItemFamilyPolicyMng;
class IItemFamilyTopologyModifier;
class ItemInternalConnectivityList;
class Properties;
 
namespace mesh
{
  class ItemDataList;
  class DynamicMesh;
  class ItemFamily;
}
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
class ARCANE_CORE_EXPORT IItemFamily
{
  friend class mesh::DynamicMesh;
  friend class mesh::ItemFamily;
 
 public:
 
  virtual ~IItemFamily() {} //<! Libère les ressources
 
 public:
 
  virtual void build() =0;
 
 public:
 
  virtual String name() const =0;
 
  virtual String fullName() const =0;
 
  virtual eItemKind itemKind() const =0;
  
  virtual Integer nbItem() const =0;
 
  virtual Int32 maxLocalId() const =0;
 
 public:
 
  // TODO: a supprimer. Utiliser itemInfoListView à la place
  virtual ItemInternalArrayView itemsInternal() =0;
 
 public:
 
  virtual ItemInfoListView itemInfoListView() =0;
 
  virtual IItemFamily* parentFamily() const = 0;
 
  virtual void setParentFamily(IItemFamily* parent) = 0;
 
  virtual Integer parentFamilyDepth() const = 0;
 
  virtual void addChildFamily(IItemFamily* family) = 0;
 
  virtual IItemFamilyCollection childFamilies() = 0;
 
  virtual VariableItemInt32& itemsNewOwner() =0;
  
  virtual void checkValid() =0;
 
  virtual void checkValidConnectivity() =0;
 
  virtual void checkUniqueIds(Int64ConstArrayView unique_ids) =0;
 
 public:
 
  virtual ItemVectorView view(Int32ConstArrayView local_ids) =0;
 
  virtual ItemVectorView view() =0;
 
  virtual void removeItems2(mesh::ItemDataList& item_data_list) =0;
 
  virtual void removeNeedRemoveMarkedItems() =0;
 
  ARCANE_DEPRECATED_REASON("Use MeshUtils::findOneItem() instead")
  virtual ItemInternal* findOneItem(Int64 unique_id) =0;
 
  virtual void endUpdate() =0;
 
  virtual void partialEndUpdate() =0;
 
  virtual void partialEndUpdateGroup(const ItemGroup& group) =0;
  
  virtual void partialEndUpdateVariable(IVariable* variable) =0;
 
  virtual void notifyItemsOwnerChanged() =0;
 
  virtual void notifyItemsUniqueIdChanged() =0;
 
 public:
 
  virtual IItemConnectivityInfo* localConnectivityInfos() const =0;
 
  virtual IItemConnectivityInfo* globalConnectivityInfos() const =0;
 
 public:
 
  virtual void setHasUniqueIdMap(bool v) =0;
 
  virtual bool hasUniqueIdMap() const =0;
 
 public:
 
  virtual void itemsUniqueIdToLocalId(Int32ArrayView local_ids,
                                      Int64ConstArrayView unique_ids,
                                      bool do_fatal=true) const =0;
 
  virtual void itemsUniqueIdToLocalId(Int32ArrayView local_ids,
                                      ConstArrayView<ItemUniqueId> unique_ids,
                                      bool do_fatal=true) const =0;
 
 public:
 
  virtual void setItemSortFunction(IItemInternalSortFunction* sort_function) =0;
 
  virtual IItemInternalSortFunction* itemSortFunction() const =0;
 
 public:
 
  ARCCORE_DEPRECATED_2020("Do not use this method. Try to get 'ISubDomain' from another way")
  virtual ISubDomain* subDomain() const =0;
 
  virtual ITraceMng* traceMng() const =0;
 
  virtual IMesh* mesh() const =0;
 
  virtual IParallelMng* parallelMng() const =0;
 
 public:
 
  virtual ItemGroup allItems() const =0;
 
  virtual ItemGroupCollection groups() const =0;
 
 public:
 
 
 
  virtual ItemGroup findGroup(const String& name) const =0;
 
  virtual ItemGroup findGroup(const String& name,bool create_if_needed) =0;
  
 
  virtual ItemGroup createGroup(const String& name,Int32ConstArrayView local_ids,bool do_override=false) =0;
 
  virtual ItemGroup createGroup(const String& name) =0;
 
  virtual void destroyGroups() =0;
 
  virtual ItemGroup createGroup(const String& name,const ItemGroup& parent,bool do_override=false) =0;
 
 
  virtual IVariable* findVariable(const String& name,bool throw_exception=false) =0;
 
  virtual void usedVariables(VariableCollection collection) =0;
 
 public:
 
  virtual void prepareForDump() =0;
 
  virtual void readFromDump() =0;
 
  virtual void copyItemsValues(Int32ConstArrayView source, Int32ConstArrayView destination) =0;
 
  virtual void copyItemsMeanValues(Int32ConstArrayView first_source,
                                   Int32ConstArrayView second_source,
                                   Int32ConstArrayView destination) = 0;
 
  virtual void clearItems() =0;
 
  virtual void compactItems(bool do_sort) =0;
 
 public:
 
  virtual void computeSynchronizeInfos() =0;
 
  virtual void getCommunicatingSubDomains(Int32Array& sub_domains) const =0;
 
 
 
  virtual IVariableSynchronizer* allItemsSynchronizer() =0;
  
  virtual void synchronize(VariableCollection variables) =0;
  
  // TODO: à rendre virtuelle pure (décembre 2024)
  virtual void synchronize(VariableCollection variables, Int32ConstArrayView local_ids);
  
  virtual void reduceFromGhostItems(IVariable* v,IDataOperation* operation) =0;
  virtual void reduceFromGhostItems(IVariable* v,Parallel::eReduceType operation) =0;
 
  virtual ItemPairGroup findAdjencyItems(const ItemGroup& group,
                                         const ItemGroup& sub_group,
                                         eItemKind link_kind,
                                         Integer nb_layer) =0;
  
  virtual IParticleFamily* toParticleFamily() =0;
 
  virtual IDoFFamily* toDoFFamily() { return nullptr; }
 
  virtual void internalRemoveItems(Int32ConstArrayView local_ids,bool keep_ghost=false) =0;
 
 
  virtual void addSourceConnectivity(IItemConnectivity* connectivity) =0;
  virtual void addTargetConnectivity(IItemConnectivity* connectivity) =0;
  virtual void removeSourceConnectivity(IItemConnectivity* connectivity) =0;
  virtual void removeTargetConnectivity(IItemConnectivity* connectivity) =0;
  virtual void setConnectivityMng(IItemConnectivityMng* connectivity_mng) =0;
 
  virtual void addGhostItems(Int64ConstArrayView unique_ids, Int32ArrayView items,
                             Int32ConstArrayView owners) =0;
 
 public:
 
  virtual IItemFamilyPolicyMng* policyMng() =0;
 
  virtual Properties* properties() =0;
 
 public:
 
  virtual void resizeVariables(bool force_resize) = 0;
 
 public:
 
  virtual IItemFamilyTopologyModifier* _topologyModifier() = 0;
 
 public:
 
  virtual IItemFamilyInternal* _internalApi() =0;
};
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
} // End namespace Arcane
 
/*---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------*/
 
#endif