Main Lemma Repository
Ви не можете вибрати більше 25 тем Теми мають розпочинатися з літери або цифри, можуть містити дефіси (-) і не повинні перевищувати 35 символів.

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163
  1. /* This file is part of Lemma, a geophysical modelling and inversion API */
  2. /* This Source Code Form is subject to the terms of the Mozilla Public
  3. * License, v. 2.0. If a copy of the MPL was not distributed with this
  4. * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
  5. /**
  6. @file
  7. @author Trevor Irons
  8. @date 06-13-2016
  9. **/
  10. #ifndef __LEMMAOBJECT_H
  11. #define __LEMMAOBJECT_H
  12. #include "helper.h"
  13. #include "lemma.h"
  14. #include "yaml-cpp/yaml.h"
  15. #include <chrono>
  16. #include <memory>
  17. namespace Lemma {
  18. /** \brief Abstract class providing common interface for Lemma Objects.
  19. * \details Lemma objects can be members of other Lemma, and may be members
  20. * of multiple objects. Since updates should be atomic, and objects
  21. * can be large, it becomes useful to count the number of
  22. * Classes an object is a member of.
  23. * Before C++-11, this was done internally in Lemma, with the inclusion of
  24. * more sophisticated smart pointers, this logic has been offloaded to the
  25. * standard. All Lemma objects should be created as C++-11 Smart pointers, using
  26. * the supplied New method. Calls to Delete are no longer necessary or available.
  27. */
  28. class LemmaObject {
  29. /**
  30. * Streams class information as YAML::Node
  31. */
  32. friend YAML::Emitter& operator << (YAML::Emitter& out, const LemmaObject &ob) ;
  33. friend class LemmaObjectDeleter;
  34. public:
  35. // ==================== LIFECYCLE ==============================
  36. // Needed because many derived classes have Eigen vectors as members,
  37. // causing alignment issues when vectorisation is enabled.
  38. EIGEN_MAKE_ALIGNED_OPERATOR_NEW
  39. // ==================== OPERATORS ==============================
  40. // ==================== OPERATIONS ==============================
  41. // ==================== ACCESS ==============================
  42. // ==================== INQUIRY ==============================
  43. /** Returns the name of the underlying class, similiar to Python's type */
  44. virtual inline std::string GetName() const {
  45. return this->CName;
  46. }
  47. /**
  48. * Uses YAML to serialize this object.
  49. * @return a YAML::Node
  50. * FOR NOT LemmaObject does not write out any YAML info,
  51. * in the future the reference count could be logged? But the utility
  52. * of that is minimal.
  53. * @note Not every Lemma class needs to be Serializable, for instance HankelTransform
  54. * classes will never need to be Serialized. There may be a need to differentiate these
  55. * two families in to a LemmaInternalClass without serializing and perhaps this class for
  56. * all external classes that might need to be serialized.
  57. */
  58. virtual YAML::Node Serialize() const {
  59. YAML::Node node = YAML::Node();
  60. node.SetTag( GetName() );
  61. std::time_t now = std::chrono::system_clock::to_time_t( std::chrono::system_clock::now() );
  62. node["Serialized"] = std::ctime(&now);
  63. return node;
  64. };
  65. protected:
  66. // ==================== LIFECYCLE ==============================
  67. /** Protected default constructor. This is an abstract class and
  68. * cannot be instantiated.
  69. */
  70. LemmaObject ( );
  71. /** Protected DeDerializing constructor, use factory DeSerialize method*/
  72. LemmaObject (const YAML::Node& node);
  73. /** Protected default destructor. This is an abstract class and
  74. * cannot be instantiated. Virtual is necessary so that if base class destructor is
  75. * called, we get the right behaviour.
  76. */
  77. virtual ~LemmaObject();
  78. private:
  79. // ==================== DATA MEMBERS ==============================
  80. /** ASCII string representation of the class name */
  81. static constexpr auto CName = "LemmaObject";
  82. }; // ----- end of class LemmaObject -----
  83. class LemmaObjectDeleter
  84. {
  85. public:
  86. void operator()(LemmaObject* p) { delete p; }
  87. };
  88. /////////////////////////////////////////////////////////////////
  89. // Error Classes
  90. /** Error called when DeSerializing breaks. If the node type is not the expected one
  91. * this error is thown.
  92. */
  93. class DeSerializeTypeMismatch : public std::runtime_error {
  94. public:
  95. DeSerializeTypeMismatch(const std::string& expected, const std::string& got);
  96. };
  97. /** If an assignment is made that is out of bounts, throw this.
  98. */
  99. class AssignmentOutOfBounds : public std::runtime_error {
  100. public:
  101. /** Throw when an assignment is out of bounds.
  102. * @param[in] ptr is a pointer to the class throwing the exception.
  103. */
  104. AssignmentOutOfBounds(LemmaObject *ptr);
  105. };
  106. /** If a pointer to a class is requested, but it is NULL valued, throw this
  107. */
  108. class RequestToReturnNullPointer : public std::runtime_error {
  109. public:
  110. /** Thrown when the pointer is NULL
  111. * @param[in] ptr is a pointer to the class throwing the exception.
  112. */
  113. RequestToReturnNullPointer(LemmaObject *ptr);
  114. };
  115. /** If an error in opening a .mat file is encountered, throw this.
  116. */
  117. class MatFileCannotBeOpened : public std::runtime_error {
  118. /** thown when a mat file fails to be opened.
  119. */
  120. public: MatFileCannotBeOpened();
  121. };
  122. /** Generic file I/O error. */
  123. class GenericFileIOError : public std::runtime_error {
  124. public: GenericFileIOError(LemmaObject *ptr, const std::string &filename);
  125. };
  126. }
  127. #endif // __LEMMAOBJECT_H