include/edm4hep/RawTimeSeriesCollection.h

0001 // AUTOMATICALLY GENERATED FILE - DO NOT EDIT
0002
0003 #ifndef EDM4HEP_RawTimeSeriesCollection_H
0004 #define EDM4HEP_RawTimeSeriesCollection_H
0005
0006 // datamodel specific includes
0007 #include "edm4hep/MutableRawTimeSeries.h"
0008 #include "edm4hep/RawTimeSeries.h"
0009 #include "edm4hep/RawTimeSeriesCollectionData.h"
0010 #include "edm4hep/RawTimeSeriesObj.h"
0011
0012 // podio specific includes
0013 #include "podio/CollectionBase.h"
0014 #include "podio/ICollectionProvider.h"
0015 #include "podio/detail/Pythonizations.h"
0016
0017 #if defined(PODIO_JSON_OUTPUT) && !defined(__CLING__)
0018 #include "nlohmann/json_fwd.hpp"
0019 #endif
0020
0021 #include <algorithm>
0022 #include <cstddef>
0023 #include <memory>
0024 #include <mutex>
0025 #include <ostream>
0026 #include <string_view>
0027 #include <vector>
0028
0029 namespace podio {
0030 struct RelationNames;
0031 }
0032
0033 namespace edm4hep {
0034
0035 class RawTimeSeriesCollectionIterator {
0036 public:
0037   using value_type = RawTimeSeries;
0038   using difference_type = ptrdiff_t;
0039   using reference = RawTimeSeries;
0040   using pointer = RawTimeSeries*;
0041   using iterator_category = std::input_iterator_tag;
0042   // `std::forward_iterator` is supported except that the pointers obtained with `operator->()`
0043   // remain valid as long as the iterator is valid, not as long as the range is valid.
0044   using iterator_concept = std::random_access_iterator_tag;
0045
0046   RawTimeSeriesCollectionIterator(size_t index, const RawTimeSeriesObjPointerContainer* collection)
0047       : m_index(index), m_object(podio::utils::MaybeSharedPtr<RawTimeSeriesObj>{nullptr}), m_collection(collection) {}
0048   RawTimeSeriesCollectionIterator() = default;
0049
0050   RawTimeSeriesCollectionIterator(const RawTimeSeriesCollectionIterator&) = default;
0051   RawTimeSeriesCollectionIterator(RawTimeSeriesCollectionIterator&&) = default;
0052   RawTimeSeriesCollectionIterator& operator=(const RawTimeSeriesCollectionIterator&) = default;
0053   RawTimeSeriesCollectionIterator& operator=(RawTimeSeriesCollectionIterator&&) = default;
0054   ~RawTimeSeriesCollectionIterator() = default;
0055
0056   auto operator<=>(const RawTimeSeriesCollectionIterator& other) const { return m_index <=> other.m_index; }
0057
0058   bool operator==(const RawTimeSeriesCollectionIterator& x) const { return m_index == x.m_index; }
0059
0060   reference operator*() const;
0061   pointer operator->();
0062   RawTimeSeriesCollectionIterator& operator++();
0063   RawTimeSeriesCollectionIterator operator++(int);
0064   RawTimeSeriesCollectionIterator& operator--();
0065   RawTimeSeriesCollectionIterator operator--(int);
0066   RawTimeSeriesCollectionIterator& operator+=(difference_type n);
0067   RawTimeSeriesCollectionIterator operator+(difference_type n) const;
0068   friend RawTimeSeriesCollectionIterator operator+(difference_type n, const RawTimeSeriesCollectionIterator& it);
0069   RawTimeSeriesCollectionIterator& operator-=(difference_type n);
0070   RawTimeSeriesCollectionIterator operator-(difference_type n) const;
0071   reference operator[](difference_type n) const;
0072   difference_type operator-(const RawTimeSeriesCollectionIterator& other) const;
0073
0074 private:
0075   size_t m_index{0};
0076   RawTimeSeries m_object{podio::utils::MaybeSharedPtr<RawTimeSeriesObj>{nullptr}};
0077   const RawTimeSeriesObjPointerContainer* m_collection{nullptr};
0078 };
0079
0080 class RawTimeSeriesMutableCollectionIterator {
0081 public:
0082   using value_type = RawTimeSeries;
0083   using difference_type = ptrdiff_t;
0084   using reference = MutableRawTimeSeries;
0085   using pointer = MutableRawTimeSeries*;
0086   using iterator_category = std::input_iterator_tag;
0087   // `std::forward_iterator` is supported except that the pointers obtained with `operator->()`
0088   // remain valid as long as the iterator is valid, not as long as the range is valid.
0089   using iterator_concept = std::random_access_iterator_tag;
0090
0091   RawTimeSeriesMutableCollectionIterator(size_t index, const RawTimeSeriesObjPointerContainer* collection)
0092       : m_index(index), m_object(podio::utils::MaybeSharedPtr<RawTimeSeriesObj>{nullptr}), m_collection(collection) {}
0093   RawTimeSeriesMutableCollectionIterator() = default;
0094
0095   RawTimeSeriesMutableCollectionIterator(const RawTimeSeriesMutableCollectionIterator&) = default;
0096   RawTimeSeriesMutableCollectionIterator(RawTimeSeriesMutableCollectionIterator&&) = default;
0097   RawTimeSeriesMutableCollectionIterator& operator=(const RawTimeSeriesMutableCollectionIterator&) = default;
0098   RawTimeSeriesMutableCollectionIterator& operator=(RawTimeSeriesMutableCollectionIterator&&) = default;
0099   ~RawTimeSeriesMutableCollectionIterator() = default;
0100
0101   auto operator<=>(const RawTimeSeriesMutableCollectionIterator& other) const { return m_index <=> other.m_index; }
0102
0103   bool operator==(const RawTimeSeriesMutableCollectionIterator& x) const { return m_index == x.m_index; }
0104
0105   reference operator*() const;
0106   pointer operator->();
0107   RawTimeSeriesMutableCollectionIterator& operator++();
0108   RawTimeSeriesMutableCollectionIterator operator++(int);
0109   RawTimeSeriesMutableCollectionIterator& operator--();
0110   RawTimeSeriesMutableCollectionIterator operator--(int);
0111   RawTimeSeriesMutableCollectionIterator& operator+=(difference_type n);
0112   RawTimeSeriesMutableCollectionIterator operator+(difference_type n) const;
0113   friend RawTimeSeriesMutableCollectionIterator operator+(difference_type n,
0114                                                           const RawTimeSeriesMutableCollectionIterator& it);
0115   RawTimeSeriesMutableCollectionIterator& operator-=(difference_type n);
0116   RawTimeSeriesMutableCollectionIterator operator-(difference_type n) const;
0117   reference operator[](difference_type n) const;
0118   difference_type operator-(const RawTimeSeriesMutableCollectionIterator& other) const;
0119
0120 private:
0121   size_t m_index{0};
0122   MutableRawTimeSeries m_object{podio::utils::MaybeSharedPtr<RawTimeSeriesObj>{nullptr}};
0123   const RawTimeSeriesObjPointerContainer* m_collection{nullptr};
0124 };
0125
0126 /**
0127 A Collection is identified by an ID.
0128 */
0129 class RawTimeSeriesCollection : public podio::CollectionBase {
0130 public:
0131   using value_type = RawTimeSeries;
0132   using mutable_type = MutableRawTimeSeries;
0133   using const_iterator = RawTimeSeriesCollectionIterator;
0134   using iterator = RawTimeSeriesMutableCollectionIterator;
0135   using difference_type = ptrdiff_t;
0136   using size_type = size_t;
0137   using const_reverse_iterator = std::reverse_iterator<const_iterator>;
0138   using reverse_iterator = std::reverse_iterator<iterator>;
0139
0140   RawTimeSeriesCollection() = default;
0141   RawTimeSeriesCollection(RawTimeSeriesCollectionData&& data, bool isSubsetColl);
0142   // This is a move-only type
0143   RawTimeSeriesCollection(const RawTimeSeriesCollection&) = delete;
0144   RawTimeSeriesCollection& operator=(const RawTimeSeriesCollection&) = delete;
0145   RawTimeSeriesCollection(RawTimeSeriesCollection&&) = default;
0146   RawTimeSeriesCollection& operator=(RawTimeSeriesCollection&&) = default;
0147
0148   //  RawTimeSeriesCollection(RawTimeSeriesVector* data, uint32_t collectionID);
0149   ~RawTimeSeriesCollection() override;
0150
0151   constexpr static std::string_view typeName = "edm4hep::RawTimeSeriesCollection";
0152   constexpr static std::string_view valueTypeName = "edm4hep::RawTimeSeries";
0153   constexpr static std::string_view dataTypeName = "edm4hep::RawTimeSeriesData";
0154
0155   void clear() final;
0156
0157   /// Cppyy protocol to setup the pythonizations for this class. Not to be called directly.
0158   static void __cppyy_pythonize__(PyObject* klass, const std::string& name) {
0159     podio::detail::pythonizations::pythonize_subscript(klass, name);
0160   }
0161
0162   /// Print this collection to the passed stream
0163   void print(std::ostream& os = std::cout, bool flush = true) const final;
0164
0165   /// Append a new object to the collection, and return this object.
0166   MutableRawTimeSeries create();
0167
0168   /// Append a new object to the collection, and return this object.
0169   /// Initialized with the parameters given
0170   template <typename... Args>
0171   MutableRawTimeSeries create(Args&&... args);
0172
0173   /// number of elements in the collection
0174   std::size_t size() const final;
0175
0176   /// maximal number of elements in the collection
0177   std::size_t max_size() const final;
0178
0179   /// Is the collection empty
0180   bool empty() const final;
0181
0182   /// fully qualified type name
0183   const std::string_view getTypeName() const final { return typeName; }
0184   /// fully qualified type name of elements - with namespace
0185   const std::string_view getValueTypeName() const final { return valueTypeName; }
0186   /// fully qualified type name of stored POD elements - with namespace
0187   const std::string_view getDataTypeName() const final { return dataTypeName; }
0188   /// schema version
0189   podio::SchemaVersionT getSchemaVersion() const final;
0190
0191   bool isSubsetCollection() const final { return m_isSubsetColl; }
0192
0193   void setSubsetCollection(bool setSubset = true) final;
0194
0195   /// Returns the const object of given index
0196   RawTimeSeries operator[](std::size_t index) const;
0197   /// Returns the object of a given index
0198   MutableRawTimeSeries operator[](std::size_t index);
0199   /// Returns the const object of given index
0200   RawTimeSeries at(std::size_t index) const;
0201   /// Returns the object of given index
0202   MutableRawTimeSeries at(std::size_t index);
0203
0204   /// Append object to the collection
0205   void push_back(const MutableRawTimeSeries& object);
0206   /// Append an object to the (subset) collection
0207   void push_back(const RawTimeSeries& object);
0208
0209   void prepareForWrite() const final;
0210   void prepareAfterRead() final;
0211   bool setReferences(const podio::ICollectionProvider* collectionProvider) final;
0212
0213   /// Get the collection buffers for this collection
0214   podio::CollectionWriteBuffers getBuffers() final;
0215
0216   void setID(uint32_t ID) final {
0217     m_collectionID = ID;
0218     if (!m_isSubsetColl) {
0219       std::for_each(m_storage.entries.begin(), m_storage.entries.end(),
0220                     [ID](RawTimeSeriesObj* obj) { obj->id = {obj->id.index, static_cast<uint32_t>(ID)}; });
0221     }
0222   }
0223
0224   uint32_t getID() const final { return m_collectionID; }
0225
0226   /// check if the collection has a valid ID
0227   bool hasID() const final {
0228     return getID() != static_cast<uint32_t>(podio::ObjectID::untracked) &&
0229            getID() != static_cast<uint32_t>(podio::ObjectID::invalid);
0230   }
0231
0232   [[deprecated("isValid will be removed, use hasID() if you want to check if it has an ID, otherwise assume the "
0233                "collection is valid")]] bool
0234   isValid() const final {
0235     return hasID();
0236   }
0237
0238   size_t getDatamodelRegistryIndex() const final;
0239
0240   // support for the iterator protocol
0241   iterator begin() { return iterator(0, &m_storage.entries); }
0242   const_iterator begin() const { return const_iterator(0, &m_storage.entries); }
0243   const_iterator cbegin() const { return begin(); }
0244   iterator end() { return iterator(m_storage.entries.size(), &m_storage.entries); }
0245   const_iterator end() const { return const_iterator(m_storage.entries.size(), &m_storage.entries); }
0246   const_iterator cend() const { return end(); }
0247   // reverse iterators
0248   reverse_iterator rbegin() { return reverse_iterator(end()); }
0249   const_reverse_iterator rbegin() const { return const_reverse_iterator(end()); }
0250   const_reverse_iterator crbegin() const { return rbegin(); }
0251   reverse_iterator rend() { return reverse_iterator(begin()); }
0252   const_reverse_iterator rend() const { return const_reverse_iterator(begin()); }
0253   const_reverse_iterator crend() const { return rend(); }
0254
0255   std::vector<std::uint64_t> cellID(const size_t nElem = 0) const;
0256   std::vector<std::int32_t> quality(const size_t nElem = 0) const;
0257   std::vector<float> time(const size_t nElem = 0) const;
0258   std::vector<float> charge(const size_t nElem = 0) const;
0259   std::vector<float> interval(const size_t nElem = 0) const;
0260
0261 private:
0262   // For setReferences, we need to give our own CollectionData access to our
0263   // private entries. Otherwise we would need to expose a public member function
0264   // that gives access to the Obj* which is definitely not what we want
0265   friend class RawTimeSeriesCollectionData;
0266
0267   mutable bool m_isPrepared{false};
0268   bool m_isSubsetColl{false};
0269   uint32_t m_collectionID{static_cast<uint32_t>(podio::ObjectID::untracked)};
0270   mutable std::unique_ptr<std::mutex> m_storageMtx{std::make_unique<std::mutex>()};
0271   mutable RawTimeSeriesCollectionData m_storage{};
0272 };
0273
0274 std::ostream& operator<<(std::ostream& o, const RawTimeSeriesCollection& v);
0275
0276 template <typename... Args>
0277 MutableRawTimeSeries RawTimeSeriesCollection::create(Args&&... args) {
0278   if (m_isSubsetColl) {
0279     throw std::logic_error("Cannot create new elements on a subset collection");
0280   }
0281   auto obj =
0282       new RawTimeSeriesObj({static_cast<int>(m_storage.entries.size()), m_collectionID}, {std::forward<Args>(args)...});
0283   m_storage.entries.push_back(obj);
0284
0285   // Need to initialize the relation vectors manually for the {ObjectID, RawTimeSeriesData} constructor
0286   obj->m_adcCounts = new std::vector<std::int32_t>();
0287   m_storage.createRelations(obj);
0288   return MutableRawTimeSeries(podio::utils::MaybeSharedPtr(obj));
0289 }
0290
0291 #if defined(PODIO_JSON_OUTPUT) && !defined(__CLING__)
0292 void to_json(nlohmann::json& j, const RawTimeSeriesCollection& collection);
0293 #endif
0294
0295 } // namespace edm4hep
0296
0297 // This is needed to avoid triggering opening every library in LD_LIBRARY_PATH
0298 // until it's fixed in ROOT. See https://github.com/root-project/root/issues/18489
0299 // and https://github.com/AIDASoft/podio/issues/770
0300 #if defined(__clang__)
0301 #pragma clang diagnostic push
0302 #pragma clang diagnostic ignored "-Wunknown-warning-option"
0303 #pragma clang diagnostic ignored "-Wdeprecated-redundant-constexpr-static-def"
0304 #pragma clang diagnostic ignored "-Wdeprecated"
0305 constexpr std::string_view edm4hep::RawTimeSeriesCollection::typeName;
0306 constexpr std::string_view edm4hep::RawTimeSeriesCollection::valueTypeName;
0307 constexpr std::string_view edm4hep::RawTimeSeriesCollection::dataTypeName;
0308 #pragma clang diagnostic pop
0309 #elif defined(__GNUC__)
0310 #pragma GCC diagnostic push
0311 #pragma GCC diagnostic ignored "-Wdeprecated"
0312 constexpr std::string_view edm4hep::RawTimeSeriesCollection::typeName;
0313 constexpr std::string_view edm4hep::RawTimeSeriesCollection::valueTypeName;
0314 constexpr std::string_view edm4hep::RawTimeSeriesCollection::dataTypeName;
0315 #pragma GCC diagnostic pop
0316 #endif
0317
0318 #endif