diff --git a/src/cluster/cluster.cpp b/src/cluster/cluster.cpp
index 94bec3c35c601f5433b063b2350673b482e33625..4591b28aa6bda3f1483f0e0190af7bea94d934f2 100644
--- a/src/cluster/cluster.cpp
+++ b/src/cluster/cluster.cpp
@@ -8,6 +8,10 @@
#include <fstream>
#include <string>
+#ifndef INCLUDE_ERRORS_H_
+#include "../include/errors.h"
+#endif
+
#ifndef INCLUDE_CONFIGURATION_H_
#include "../include/Configuration.h"
#endif
diff --git a/src/include/Configuration.h b/src/include/Configuration.h
index 99dc090cfc656a350db6db9b30c0d8291a5c871e..f3c4df91bcc64e6673865b739b5f7dd9a06af5a3 100644
--- a/src/include/Configuration.h
+++ b/src/include/Configuration.h
@@ -28,52 +28,6 @@
#ifndef INCLUDE_CONFIGURATION_H_
#define INCLUDE_CONFIGURATION_H_
-/**
- * \brief Exception for open file error handlers.
- */
-class OpenConfigurationFileException: public std::exception {
-protected:
- //! \brief Name of the file that was accessed.
- std::string file_name;
-
-public:
- /**
- * \brief Exception instance constructor.
- *
- * \param name: `string` Name of the file that was accessed.
- */
- OpenConfigurationFileException(std::string name) { file_name = name; }
-
- /**
- * \brief Exception message.
- */
- virtual const char* what() const throw() {
- return file_name.c_str();
- }
-};
-
-/**
- * \brief Exception for unrecognized configuration data sets.
- */
-class UnrecognizedConfigurationException: public std::exception {
-protected:
- //! Description of the problem.
- std::string message;
-public:
- /**
- * \brief Exception instance constructor.
- *
- * \param problem: `string` Description of the problem that occurred.
- */
- UnrecognizedConfigurationException(std::string problem) { message = problem; }
- /**
- * \brief Exception message.
- */
- virtual const char* what() const throw() {
- return message.c_str();
- }
-};
-
/**
* \brief A class to represent the configuration of the scattering geometry.
*
diff --git a/src/include/List.h b/src/include/List.h
index 8c51bd1ce7bb5816a48bd958c2c6656216e5a0fa..f97ebc6004c0867ce552480c69e16a11d671bc07 100644
--- a/src/include/List.h
+++ b/src/include/List.h
@@ -6,38 +6,7 @@
#ifndef INCLUDE_LIST_H_
#define INCLUDE_LIST_H_
-/**
- * \brief Exception for out of bounds List requests.
- */
-class ListOutOfBoundsException: public std::exception {
-protected:
- //! Description of the problem.
- std::string message;
-
-public:
- /**
- * \brief Exception instance constructor.
- *
- * \param requested: `int` The index that was requested.
- * \param min: `int` The minimum index allowed by the list.
- * \param max: `int` The maximum index allowed by the list.
- */
- ListOutOfBoundsException(int requested, int min, int max) {
- message = "Error: requested index " + std::to_string(requested)
- + " out of list allowed bounds [" + std::to_string(min) + ", "
- + std::to_string(max - 1) + "]";
- }
-
- /**
- * \brief Exception message.
- */
- virtual const char* what() const throw() {
- return message.c_str();
- }
-};
-
-/**
- * \brief A class to represent dynamic lists.
+/*! \brief A class to represent dynamic lists.
*
* This class helps in the creation and management of dynamic lists of
* objects, whose size is not known in advance. List offers the advantage
diff --git a/src/include/TransitionMatrix.h b/src/include/TransitionMatrix.h
index 25e5cf86b0b5b3a801bca5db26e274c510f7e748..447457f43eb009556fcc422b75e1fd171f636ed0 100644
--- a/src/include/TransitionMatrix.h
+++ b/src/include/TransitionMatrix.h
@@ -6,28 +6,6 @@
#ifndef INCLUDE_TRANSITIONMATRIX_H_
#define INCLUDE_TRANSITIONMATRIX_H_
-/**
- * \brief Exception for unrecognized file formats.
- */
-class UnrecognizedFormatException: public std::exception {
-protected:
- //! Description of the problem.
- std::string message;
-public:
- /**
- * \brief Exception instance constructor.
- *
- * \param problem: `string` Description of the problem that occurred.
- */
- UnrecognizedFormatException(std::string problem) { message = problem; }
- /**
- * \brief Exception message.
- */
- virtual const char* what() const throw() {
- return message.c_str();
- }
-};
-
/*! \brief Class to represent the Transition Matrix.
*/
class TransitionMatrix {
diff --git a/src/include/errors.h b/src/include/errors.h
new file mode 100644
index 0000000000000000000000000000000000000000..8730b36b70c251e93d4d2707b8900bdcd13870e3
--- /dev/null
+++ b/src/include/errors.h
@@ -0,0 +1,161 @@
+/*! \file errors.h
+ *
+ * \brief Collection of proprietary code exceptions.
+ *
+ * There are many circumstances that can prevent the correct execution
+ * of a code. These range from user mistakes, to improper configuration,
+ * to unsupported hardware and all the way up to various system failures.
+ * Although it is not possible to grant proper execution in all cases,
+ * it is often possible to design a code in such a way that the program
+ * detects unexpected conditions, informs the user and takes the proper
+ * actions, eventually stopping without crash, if no other options are
+ * available. C++ handles such unexpected circumstances by means of
+ * `exceptions`. These are special procedures that can be launched
+ * whenever an unexpected situation occurs and they allow to restore the
+ * code work-flow and attempt recovery. Exceptions can be divided in
+ * different cathegories, which respond to various types of problems.
+ * This library contains a set of exceptions designed to the most common
+ * problems that may occur while executing an application of the `NP_TMcode`
+ * suite.
+ */
+
+#ifndef INCLUDE_ERRORS_H_
+#define INCLUDE_ERRORS_H_
+
+/*! \brief Exception for out of bounds List requests.
+ */
+class ListOutOfBoundsException: public std::exception {
+protected:
+ //! Description of the problem.
+ std::string message;
+
+public:
+ /**
+ * \brief Exception instance constructor.
+ *
+ * \param requested: `int` The index that was requested.
+ * \param min: `int` The minimum index allowed by the list.
+ * \param max: `int` The maximum index allowed by the list.
+ */
+ ListOutOfBoundsException(int requested, int min, int max) {
+ message = "Error: requested index " + std::to_string(requested)
+ + " out of list allowed bounds [" + std::to_string(min) + ", "
+ + std::to_string(max - 1) + "]";
+ }
+
+ /**
+ * \brief Exception message.
+ */
+ virtual const char* what() const throw() {
+ return message.c_str();
+ }
+};
+
+/*! \brief Exception for open file error handlers.
+ */
+class OpenConfigurationFileException: public std::exception {
+protected:
+ //! \brief Name of the file that was accessed.
+ std::string file_name;
+
+public:
+ /**
+ * \brief Exception instance constructor.
+ *
+ * \param name: `string` Name of the file that was accessed.
+ */
+ OpenConfigurationFileException(std::string name) { file_name = name; }
+
+ /**
+ * \brief Exception message.
+ */
+ virtual const char* what() const throw() {
+ return file_name.c_str();
+ }
+};
+
+/*! \brief Exception for access requests out of matrix bounds.
+ */
+class MatrixOutOfBoundsException: public std::exception {
+protected:
+ //! Description of the problem.
+ std::string message;
+public:
+ /**
+ * \brief Exception instance constructor.
+ *
+ * \param problem: `string` Description of the problem that occurred.
+ */
+ MatrixOutOfBoundsException(std::string problem) { message = problem; }
+ /**
+ * \brief Exception message.
+ */
+ virtual const char* what() const throw() {
+ return message.c_str();
+ }
+};
+
+/*! \brief Exception for unrecognized configuration data sets.
+ */
+class UnrecognizedConfigurationException: public std::exception {
+protected:
+ //! Description of the problem.
+ std::string message;
+public:
+ /**
+ * \brief Exception instance constructor.
+ *
+ * \param problem: `string` Description of the problem that occurred.
+ */
+ UnrecognizedConfigurationException(std::string problem) { message = problem; }
+ /**
+ * \brief Exception message.
+ */
+ virtual const char* what() const throw() {
+ return message.c_str();
+ }
+};
+
+/*! \brief Exception for unrecognized file formats.
+ */
+class UnrecognizedFormatException: public std::exception {
+protected:
+ //! Description of the problem.
+ std::string message;
+public:
+ /**
+ * \brief Exception instance constructor.
+ *
+ * \param problem: `string` Description of the problem that occurred.
+ */
+ UnrecognizedFormatException(std::string problem) { message = problem; }
+ /**
+ * \brief Exception message.
+ */
+ virtual const char* what() const throw() {
+ return message.c_str();
+ }
+};
+
+/*! \brief Exception for unrecognized parameters.
+ */
+class UnrecognizedParameterException: public std::exception {
+protected:
+ //! Description of the problem.
+ std::string message;
+public:
+ /**
+ * \brief Exception instance constructor.
+ *
+ * \param problem: `string` Description of the problem that occurred.
+ */
+ UnrecognizedParameterException(std::string problem) { message = problem; }
+ /**
+ * \brief Exception message.
+ */
+ virtual const char* what() const throw() {
+ return message.c_str();
+ }
+};
+
+#endif
diff --git a/src/include/tfrfme.h b/src/include/tfrfme.h
index e9efff3ea1a8afb9cca52b1ea252acbce8f33430..19174277cdf07c1d118cfca9ac6dd2f34d9e5ae0 100644
--- a/src/include/tfrfme.h
+++ b/src/include/tfrfme.h
@@ -6,50 +6,6 @@
#ifndef INCLUDE_TFRFME_H_
#define INCLUDE_TFRFME_H_
-/**
- * \brief Exception for unrecognized parameters.
- */
-class MatrixOutOfBoundsException: public std::exception {
-protected:
- //! Description of the problem.
- std::string message;
-public:
- /**
- * \brief Exception instance constructor.
- *
- * \param problem: `string` Description of the problem that occurred.
- */
- MatrixOutOfBoundsException(std::string problem) { message = problem; }
- /**
- * \brief Exception message.
- */
- virtual const char* what() const throw() {
- return message.c_str();
- }
-};
-
-/**
- * \brief Exception for unrecognized parameters.
- */
-class UnrecognizedParameterException: public std::exception {
-protected:
- //! Description of the problem.
- std::string message;
-public:
- /**
- * \brief Exception instance constructor.
- *
- * \param problem: `string` Description of the problem that occurred.
- */
- UnrecognizedParameterException(std::string problem) { message = problem; }
- /**
- * \brief Exception message.
- */
- virtual const char* what() const throw() {
- return message.c_str();
- }
-};
-
/*! \brief Class to represent the trapping configuration.
*/
class TFRFME {
diff --git a/src/libnptm/Configuration.cpp b/src/libnptm/Configuration.cpp
index 399370c4d173d9aa8d074af89ceec9876c646988..e7ed703baf80b284252177a8732fe28930616c8c 100644
--- a/src/libnptm/Configuration.cpp
+++ b/src/libnptm/Configuration.cpp
@@ -12,6 +12,10 @@
#include <regex>
#include <string>
+#ifndef INCLUDE_ERRORS_H_
+#include "../include/errors.h"
+#endif
+
#ifndef INCLUDE_LIST_H_
#include "../include/List.h"
#endif
diff --git a/src/libnptm/Parsers.cpp b/src/libnptm/Parsers.cpp
index 3f8c9ff5116126b909baa9b7755f9bad09659642..22ff56db05a692980df8f4140f97a1ba6c227c12 100644
--- a/src/libnptm/Parsers.cpp
+++ b/src/libnptm/Parsers.cpp
@@ -3,10 +3,21 @@
* \brief Implementation of the parsing functions.
*/
+#include <exception>
#include <fstream>
#include <string>
+
+#ifndef INCLUDE_ERRORS_H_
+#include "../include/errors.h"
+#endif
+
+#ifndef INCLUDE_LIST_H_
#include "../include/List.h"
+#endif
+
+#ifndef INCLUDE_PARSERS_H_
#include "../include/Parsers.h"
+#endif
std::string *load_file(std::string file_name, int *count = 0) {
std::fstream input_file(file_name.c_str(), std::ios::in);
diff --git a/src/libnptm/TransitionMatrix.cpp b/src/libnptm/TransitionMatrix.cpp
index 3e192fa8a555bce9f39e4aeaa2ffd094ba3fb834..30126ff17ad8cf8511ce395ce3fa0df3f69b80e4 100644
--- a/src/libnptm/TransitionMatrix.cpp
+++ b/src/libnptm/TransitionMatrix.cpp
@@ -8,6 +8,10 @@
#include <hdf5.h>
#include <string>
+#ifndef INCLUDE_ERRORS_H_
+#include "../include/errors.h"
+#endif
+
#ifndef INCLUDE_LIST_H_
#include "../include/List.h"
#endif
diff --git a/src/libnptm/file_io.cpp b/src/libnptm/file_io.cpp
index 0c0b0c170009bb40abf290564ee838b68f1260a9..f960e26c6bd3317031d63aae225ff4729d19ef52 100644
--- a/src/libnptm/file_io.cpp
+++ b/src/libnptm/file_io.cpp
@@ -2,11 +2,15 @@
*
* \brief Implementation of file I/O operations.
*/
-#include <stdexcept>
+#include <exception>
#include <regex>
#include <string>
#include <hdf5.h>
+#ifndef INCLUDE_ERRORS_H_
+#include "../include/errors.h"
+#endif
+
#ifndef INCLUDE_LIST_H_
#include "../include/List.h"
#endif
@@ -126,7 +130,7 @@ HDFFile* HDFFile::from_schema(
delete[] max_dims;
} else {
string message = "unrecognized type \"" + rec_types[ri] + "\"\n";
- throw runtime_error(message);
+ throw UnrecognizedParameterException(message);
}
}
@@ -159,7 +163,7 @@ herr_t HDFFile::read(
case 2:
mem_type_id = H5T_NATIVE_DOUBLE; break;
default:
- throw runtime_error("Unrecognized data type \"" + data_type + "\"");
+ throw UnrecognizedParameterException("unrecognized data type \"" + data_type + "\"");
}
if (dataset_id != H5I_INVALID_HID) {
status = H5Dread(dataset_id, mem_type_id, mem_space_id, file_space_id, dxpl_id, buffer);
@@ -169,7 +173,7 @@ herr_t HDFFile::read(
status = (herr_t)-1;
}
} else {
- throw runtime_error("Unrecognized data type \"" + data_type + "\"");
+ throw UnrecognizedParameterException("unrecognized data type \"" + data_type + "\"");
}
return status;
}
@@ -198,7 +202,7 @@ herr_t HDFFile::write(
case 2:
mem_type_id = H5T_NATIVE_DOUBLE; break;
default:
- throw runtime_error("Unrecognized data type \"" + data_type + "\"");
+ throw UnrecognizedParameterException("unrecognized data type \"" + data_type + "\"");
}
if (dataset_id != H5I_INVALID_HID) {
status = H5Dwrite(dataset_id, mem_type_id, mem_space_id, file_space_id, dxpl_id, buffer);
@@ -208,7 +212,7 @@ herr_t HDFFile::write(
status = (herr_t)-1;
}
} else {
- throw runtime_error("Unrecognized data type \"" + data_type + "\"");
+ throw UnrecognizedParameterException("unrecognized data type \"" + data_type + "\"");
}
return status;
}
diff --git a/src/libnptm/tfrfme.cpp b/src/libnptm/tfrfme.cpp
index 27941bcb57d8fa1eafa6084ed62b6b2fc88e75a9..2b649f86e58968167b5fb3deb442fb952c180e65 100644
--- a/src/libnptm/tfrfme.cpp
+++ b/src/libnptm/tfrfme.cpp
@@ -9,6 +9,10 @@
#include <hdf5.h>
#include <string>
+#ifndef INCLUDE_ERRORS_H_
+#include "../include/errors.h"
+#endif
+
#ifndef INCLUDE_LIST_H_
#include "../include/List.h"
#endif
diff --git a/src/sphere/sphere.cpp b/src/sphere/sphere.cpp
index efad7ad1819f879ab0128b2ed08e10ca7fd4b33f..7016d8361eb8d61fef8437f504516352f0444948 100644
--- a/src/sphere/sphere.cpp
+++ b/src/sphere/sphere.cpp
@@ -8,6 +8,10 @@
#include <fstream>
#include <string>
+#ifndef INCLUDE_ERRORS_H_
+#include "../include/errors.h"
+#endif
+
#ifndef INCLUDE_CONFIGURATION_H_
#include "../include/Configuration.h"
#endif
diff --git a/src/testing/test_TEDF.cpp b/src/testing/test_TEDF.cpp
index b384cc1df0d0faa9982ec12a45a3b8322c615d24..98a681d3895a63659978cd130352083a7028c6e7 100644
--- a/src/testing/test_TEDF.cpp
+++ b/src/testing/test_TEDF.cpp
@@ -2,11 +2,25 @@
#include <complex>
#include <cstdio>
+#include <exception>
#include <hdf5.h>
#include <string>
+
+#ifndef INCLUDE_ERRORS_H_
+#include "../include/errors.h"
+#endif
+
+#ifndef INCLUDE_LIST_H_
#include "../include/List.h"
+#endif
+
+#ifndef INCLUDE_FILE_IO_H_
#include "../include/file_io.h"
+#endif
+
+#ifndef INCLUDE_CONFIGURATION_H_
#include "../include/Configuration.h"
+#endif
using namespace std;
diff --git a/src/testing/test_TTMS.cpp b/src/testing/test_TTMS.cpp
index 3b054359c0ef366f74b9f10b5b023f0bca45f7f4..7c55d16a7939a67ba211f90644b23ba2d329852e 100644
--- a/src/testing/test_TTMS.cpp
+++ b/src/testing/test_TTMS.cpp
@@ -2,11 +2,25 @@
#include <complex>
#include <cstdio>
+#include <exception>
#include <hdf5.h>
#include <string>
+
+#ifndef INCLUDE_ERRORS_H_
+#include "../include/errors.h"
+#endif
+
+#ifndef INCLUDE_LIST_H_
#include "../include/List.h"
+#endif
+
+#ifndef INCLUDE_FILE_IO_H_
#include "../include/file_io.h"
+#endif
+
+#ifndef INCLUDE_TRANSITIONMATRIX_H_
#include "../include/TransitionMatrix.h"
+#endif
using namespace std;