This page provides, for the end user, an overview of the different types of errors Hexed might produce, what they mean, and how to address them.

HIL Exception

hexed::Interpreter::Hil_unhandled_exception

This indicates that an error was encountered in the Hexed Interface Language frontend which was not handled with the except macro. It probably means you made a simple mistake in your input file. Basic errors in the Hexed Interface Language, such as undefined variables, invalid syntax, etc., will produce this exception.

User Error

hexed::assert::User_error

This one is almost certainly your fault. This type of error indicates a basic mistake in the input parameters (such as an invalid row_size or specifying the wrong number of freestream variables). Unlike a HIL Exception, this indicates that your input file is (probably) valid Hexed Interface Language code, but what you're specifying with that code doesn't make sense.

Numerical Exception

hexed::assert::Numerical_exception

The most frustrating thing about CFD is that no solver is guaranteed to converge for all meshes and all problems. This error indicates that apparently, you have found a case where this solver does not converge. For example, it will be thrown if the code encounters NaN values or nonphysical states (e.g. nonpositive density) and cannot recover. This error could likely be avoided by improvements to the algorithms or adjustments to your input parameters, but it is not necessarily the result of a blatant mistake on anyone's part. If you believe this error is actually the result of a bug or of some inputs you provided that were clearly wrong, please let me know.

Other Exceptions

std::runtime_error
Python builtin exceptions

These errors indicate that something went wrong in a way that I did not specifically anticipate. It could be the result of a mistake you made, or it could be the result of a bug. If you obtain one of these errors and it is not at all clear what, if anything, you did wrong, feel free to let me know.

Segmentation fault

Segmentation fault (core dumpted)
SIGSEGV

Woah, this is embarrassing. Please let me know and also laugh at me.