ClusterCollection.h

Go to the documentation of this file.

// AUTOMATICALLY GENERATED FILE - DO NOT EDIT
 
#ifndef EDM4EIC_ClusterCollection_H
#define EDM4EIC_ClusterCollection_H
 
// datamodel specific includes
#include "edm4eic/Cluster.h"
#include "edm4eic/MutableCluster.h"
#include "edm4eic/ClusterObj.h"
#include "edm4eic/ClusterCollectionData.h"
 
// podio specific includes
#include "podio/ICollectionProvider.h"
#include "podio/CollectionBase.h"
#include "podio/detail/Pythonizations.h"
#include "podio/utilities/TypeHelpers.h"
 
#if defined(PODIO_JSON_OUTPUT) && !defined(__CLING__)
#include "nlohmann/json_fwd.hpp"
#endif
 
#include <string_view>
#include <vector>
#include <algorithm>
#include <ostream>
#include <mutex>
#include <memory>
#include <cstddef>
 
namespace podio {
  struct RelationNames;
}
 
namespace edm4eic {
 
 
 
class ClusterCollectionIterator {
public:
  using value_type = Cluster;
  using difference_type = ptrdiff_t;
  using reference = Cluster;
  using pointer = Cluster*;
  using iterator_category = std::input_iterator_tag;
  // `std::forward_iterator` is supported except that the pointers obtained with `operator->()`
  // remain valid as long as the iterator is valid, not as long as the range is valid.
  using iterator_concept = std::random_access_iterator_tag;
 
  ClusterCollectionIterator(size_t index, const ClusterObjPointerContainer* collection) : m_index(index), m_object(podio::utils::MaybeSharedPtr<ClusterObj>{nullptr}), m_collection(collection) {}
  ClusterCollectionIterator() = default;
 
  ClusterCollectionIterator(const ClusterCollectionIterator&) = default;
  ClusterCollectionIterator(ClusterCollectionIterator&&) = default;
  ClusterCollectionIterator& operator=(const ClusterCollectionIterator&) = default;
  ClusterCollectionIterator& operator=(ClusterCollectionIterator&&) = default;
  ~ClusterCollectionIterator() = default;
 
  constexpr auto operator<=>(const ClusterCollectionIterator& other) const {
    return m_index <=> other.m_index;
  }
 
  constexpr bool operator==(const ClusterCollectionIterator& x) const {
    return m_index ==  x.m_index;
  }
 
  reference operator*() const;
  pointer operator->();
  ClusterCollectionIterator& operator++();
  ClusterCollectionIterator operator++(int);
  ClusterCollectionIterator& operator--();
  ClusterCollectionIterator operator--(int);
  ClusterCollectionIterator& operator+=(difference_type n);
  ClusterCollectionIterator operator+(difference_type n) const;
  friend ClusterCollectionIterator operator+(difference_type n, const ClusterCollectionIterator& it);
  ClusterCollectionIterator& operator-=(difference_type n);
  ClusterCollectionIterator operator-(difference_type n) const;
  reference operator[](difference_type n) const;
  difference_type operator-(const ClusterCollectionIterator& other) const;
 
private:
  size_t m_index{0};
  Cluster m_object { podio::utils::MaybeSharedPtr<ClusterObj>{nullptr} };
  const ClusterObjPointerContainer* m_collection{nullptr};
};
 
 
class ClusterMutableCollectionIterator {
public:
  using value_type = Cluster;
  using difference_type = ptrdiff_t;
  using reference = MutableCluster;
  using pointer = MutableCluster*;
  using iterator_category = std::input_iterator_tag;
  // `std::forward_iterator` is supported except that the pointers obtained with `operator->()`
  // remain valid as long as the iterator is valid, not as long as the range is valid.
  using iterator_concept = std::random_access_iterator_tag;
 
  ClusterMutableCollectionIterator(size_t index, const ClusterObjPointerContainer* collection) : m_index(index), m_object(podio::utils::MaybeSharedPtr<ClusterObj>{nullptr}), m_collection(collection) {}
  ClusterMutableCollectionIterator() = default;
 
  ClusterMutableCollectionIterator(const ClusterMutableCollectionIterator&) = default;
  ClusterMutableCollectionIterator(ClusterMutableCollectionIterator&&) = default;
  ClusterMutableCollectionIterator& operator=(const ClusterMutableCollectionIterator&) = default;
  ClusterMutableCollectionIterator& operator=(ClusterMutableCollectionIterator&&) = default;
  ~ClusterMutableCollectionIterator() = default;
 
  constexpr auto operator<=>(const ClusterMutableCollectionIterator& other) const {
    return m_index <=> other.m_index;
  }
 
  constexpr bool operator==(const ClusterMutableCollectionIterator& x) const {
    return m_index ==  x.m_index;
  }
 
  reference operator*() const;
  pointer operator->();
  ClusterMutableCollectionIterator& operator++();
  ClusterMutableCollectionIterator operator++(int);
  ClusterMutableCollectionIterator& operator--();
  ClusterMutableCollectionIterator operator--(int);
  ClusterMutableCollectionIterator& operator+=(difference_type n);
  ClusterMutableCollectionIterator operator+(difference_type n) const;
  friend ClusterMutableCollectionIterator operator+(difference_type n, const ClusterMutableCollectionIterator& it);
  ClusterMutableCollectionIterator& operator-=(difference_type n);
  ClusterMutableCollectionIterator operator-(difference_type n) const;
  reference operator[](difference_type n) const;
  difference_type operator-(const ClusterMutableCollectionIterator& other) const;
 
private:
  size_t m_index{0};
  MutableCluster m_object { podio::utils::MaybeSharedPtr<ClusterObj>{nullptr} };
  const ClusterObjPointerContainer* m_collection{nullptr};
};
 
 
/**
A Collection is identified by an ID.
*/
class ClusterCollection : public podio::CollectionBase {
public:
  using value_type = Cluster;
  using mutable_type = MutableCluster;
  using const_iterator = ClusterCollectionIterator;
  using iterator = ClusterMutableCollectionIterator;
  using difference_type = ptrdiff_t;
  using size_type = size_t;
  using const_reverse_iterator = std::reverse_iterator<const_iterator>;
  using reverse_iterator = std::reverse_iterator<iterator>;
 
  ClusterCollection() = default;
  ClusterCollection(ClusterCollectionData&& data, bool isSubsetColl);
  // This is a move-only type
  ClusterCollection(const ClusterCollection& ) = delete;
  ClusterCollection& operator=(const ClusterCollection& ) = delete;
  ClusterCollection(ClusterCollection&&) = default;
  ClusterCollection& operator=(ClusterCollection&&) = default;
 
  ~ClusterCollection() override;
#if defined(__cpp_lib_containers_ranges)
  template<podio::detail::RangeConvertibleTo<value_type> R>
  ClusterCollection(std::from_range_t, R&& range);
#endif
 
  /// Construct a Cluster collection from a range of mutable or
  /// immutable handles
  template<podio::detail::RangeConvertibleTo<value_type> R>
  static ClusterCollection from(R&& range);
 
  constexpr static std::string_view typeName = "edm4eic::ClusterCollection";
  constexpr static std::string_view valueTypeName = "edm4eic::Cluster";
  constexpr static std::string_view dataTypeName = "edm4eic::ClusterData";
 
  void clear() final;
 
  /// Cppyy protocol to setup the pythonizations for this class. Not to be called directly.
  static void __cppyy_pythonize__(PyObject* klass, const std::string& name){
        podio::detail::pythonizations::pythonize_subscript(klass, name);
  }
 
  /// Print this collection to the passed stream
  void print(std::ostream& os=std::cout, bool flush=true) const final;
 
  /// Append a new object to the collection, and return this object.
  MutableCluster create();
 
  /// Append a new object to the collection, and return this object.
  /// Initialized with the parameters given
  template<typename... Args>
  MutableCluster create(Args&&... args);
 
  /// number of elements in the collection
  std::size_t size() const final;
 
  /// maximal number of elements in the collection
  std::size_t max_size() const final;
 
  /// Is the collection empty
  bool empty() const final;
 
  /// fully qualified type name
  const std::string_view getTypeName() const final { return typeName; }
  /// fully qualified type name of elements - with namespace
  const std::string_view getValueTypeName() const final { return valueTypeName; }
  /// fully qualified type name of stored POD elements - with namespace
  const std::string_view getDataTypeName() const final { return dataTypeName; }
  /// schema version
  podio::SchemaVersionT getSchemaVersion() const final;
 
  bool isSubsetCollection() const final {
    return m_isSubsetColl;
  }
 
  void setSubsetCollection(bool setSubset=true) final;
 
  /// Returns the const object of given index
  Cluster operator[](std::size_t index) const;
  /// Returns the object of a given index
  MutableCluster operator[](std::size_t index);
  /// Returns the const object of given index
  Cluster at(std::size_t index) const;
  /// Returns the object of given index
  MutableCluster at(std::size_t index);
 
 
  /// Append object to the collection
  void push_back(const MutableCluster& object);
  /// Append an object to the (subset) collection
  void push_back(const Cluster& object);
 
  void prepareForWrite() const final;
  void prepareAfterRead() final;
  bool setReferences(const podio::ICollectionProvider* collectionProvider) final;
 
  /// Get the collection buffers for this collection
  podio::CollectionWriteBuffers getBuffers() final;
 
  void setID(uint32_t ID) final {
    m_collectionID = ID;
    if (!m_isSubsetColl) {
      std::for_each(m_storage.entries.begin(), m_storage.entries.end(),
                  [ID] (ClusterObj* obj) { obj->id = {obj->id.index, static_cast<uint32_t>(ID)}; }
      );
    }
  }
 
  uint32_t getID() const final {
    return m_collectionID;
  }
 
  /// check if the collection has a valid ID
  bool hasID() const final {
    return getID() != static_cast<uint32_t>(podio::ObjectID::untracked) &&
        getID() != static_cast<uint32_t>(podio::ObjectID::invalid);
  }
 
  [[deprecated("isValid will be removed, use hasID() if you want to check if it has an ID, otherwise assume the "
               "collection is valid")]]
  bool isValid() const final {
    return hasID();
  }
 
  size_t getDatamodelRegistryIndex() const final;
 
  // support for the iterator protocol
  iterator begin() {
    return iterator(0, &m_storage.entries);
  }
  const_iterator begin() const {
    return const_iterator(0, &m_storage.entries);
  }
  const_iterator cbegin() const {
    return begin();
  }
  iterator end() {
    return iterator(m_storage.entries.size(), &m_storage.entries);
  }
  const_iterator end() const {
    return const_iterator(m_storage.entries.size(), &m_storage.entries);
  }
  const_iterator cend() const {
    return end();
  }
  // reverse iterators
  reverse_iterator rbegin() {
    return reverse_iterator(end());
  }
  const_reverse_iterator rbegin() const {
    return const_reverse_iterator(end());
  }
  const_reverse_iterator crbegin() const {
    return rbegin();
  }
  reverse_iterator rend() {
    return reverse_iterator(begin());
  }
  const_reverse_iterator rend() const {
    return const_reverse_iterator(begin());
  }
  const_reverse_iterator crend() const {
    return rend();
  }
 
 
  std::vector<std::int32_t> type(const size_t nElem = 0) const;
  std::vector<float> energy(const size_t nElem = 0) const;
  std::vector<float> energyError(const size_t nElem = 0) const;
  std::vector<float> time(const size_t nElem = 0) const;
  std::vector<float> timeError(const size_t nElem = 0) const;
  std::vector<std::uint32_t> nhits(const size_t nElem = 0) const;
  std::vector<edm4hep::Vector3f> position(const size_t nElem = 0) const;
  std::vector<edm4eic::Cov3f> positionError(const size_t nElem = 0) const;
  std::vector<float> radius(const size_t nElem = 0) const;
  std::vector<float> dispersion(const size_t nElem = 0) const;
  std::vector<std::array<float, 3>> principalAxesLengthsXYZ(const size_t nElem = 0) const;
  std::vector<std::array<float, 2>> principalAxesLengthsThetaPhi(const size_t nElem = 0) const;
  std::vector<float> intrinsicTheta(const size_t nElem = 0) const;
  std::vector<float> intrinsicPhi(const size_t nElem = 0) const;
  std::vector<edm4eic::Cov2f> intrinsicDirectionError(const size_t nElem = 0) const;
 
private:
  // For setReferences, we need to give our own CollectionData access to our
  // private entries. Otherwise we would need to expose a public member function
  // that gives access to the Obj* which is definitely not what we want
  friend class ClusterCollectionData;
 
  mutable bool m_isPrepared{false};
  bool m_isSubsetColl{false};
  uint32_t m_collectionID{static_cast<uint32_t>(podio::ObjectID::untracked)};
  mutable std::unique_ptr<std::mutex> m_storageMtx{std::make_unique<std::mutex>()};
  mutable ClusterCollectionData m_storage{};
};
 
std::ostream& operator<<(std::ostream& o, const ClusterCollection& v);
 
template<typename... Args>
MutableCluster ClusterCollection::create(Args&&... args) {
  if (m_isSubsetColl) {
    throw std::logic_error("Cannot create new elements on a subset collection");
  }
  auto obj = new ClusterObj({static_cast<int>(m_storage.entries.size()), m_collectionID}, {std::forward<Args>(args)...});
  m_storage.entries.push_back(obj);
 
  // Need to initialize the relation vectors manually for the {ObjectID, ClusterData} constructor
  obj->m_clusters = new std::vector<edm4eic::Cluster>();
  obj->m_hits = new std::vector<edm4eic::CalorimeterHit>();
  obj->m_particleIDs = new std::vector<edm4hep::ParticleID>();
  obj->m_shapeParameters = new std::vector<float>();
  obj->m_hitContributions = new std::vector<float>();
  obj->m_subdetectorEnergies = new std::vector<float>();
  m_storage.createRelations(obj);
  return MutableCluster(podio::utils::MaybeSharedPtr(obj));
}
 
 
#if defined(__cpp_lib_containers_ranges)
template<podio::detail::RangeConvertibleTo<ClusterCollection::value_type> R>
ClusterCollection::ClusterCollection(std::from_range_t, R&& range)
  : ClusterCollection() {
  setSubsetCollection(podio::detail::RangeOf<R, value_type>);
 
  for (auto&& elem : range) {
    push_back(std::forward<decltype(elem)>(elem));
  }
}
#endif
 
template<podio::detail::RangeConvertibleTo<ClusterCollection::value_type> R>
ClusterCollection ClusterCollection::from(R&& range) {
  ClusterCollection coll;
  if constexpr (podio::detail::RangeOf<R, value_type>) {
    coll.setSubsetCollection();
  }
 
  for (auto&& elem : range) {
    coll.push_back(std::forward<decltype(elem)>(elem));
  }
 
  return coll;
}
 
 
#if defined(PODIO_JSON_OUTPUT) && !defined(__CLING__)
void to_json(nlohmann::json& j, const ClusterCollection& collection);
#endif
 
} // namespace edm4eic
 
 
// This is needed to avoid triggering opening every library in LD_LIBRARY_PATH
// until it's fixed in ROOT. See https://github.com/root-project/root/issues/18489
// and https://github.com/AIDASoft/podio/issues/770
#if defined(__clang__)
  #pragma clang diagnostic push
  #pragma clang diagnostic ignored "-Wunknown-warning-option"
  #pragma clang diagnostic ignored "-Wdeprecated-redundant-constexpr-static-def"
  #pragma clang diagnostic ignored "-Wdeprecated"
constexpr std::string_view edm4eic::ClusterCollection::typeName;
constexpr std::string_view edm4eic::ClusterCollection::valueTypeName;
constexpr std::string_view edm4eic::ClusterCollection::dataTypeName;
  #pragma clang diagnostic pop
#elif defined(__GNUC__)
  #pragma GCC diagnostic push
  #pragma GCC diagnostic ignored "-Wdeprecated"
constexpr std::string_view edm4eic::ClusterCollection::typeName;
constexpr std::string_view edm4eic::ClusterCollection::valueTypeName;
constexpr std::string_view edm4eic::ClusterCollection::dataTypeName;
  #pragma GCC diagnostic pop
#endif
 
 
#endif