# Exceptions

## tecplot.exception

The class hierarchy for PyTecplot exceptions are as follows. Exceptions in parentheses are Python built-ins from which the PyTecplot exceptions derive. One can use either the Python native errors or the more specific “Tecplot” errors to catch exceptions:

    TecplotError (Exception)
     +--- TecplotConnectionError
     |     `--- TecplotTimeoutError
     +--- TecplotInitializationError (ImportError)
     |     +--- TecplotLicenseError
     |     +--- TecplotLibraryNotLoadedError
     |     `--- TecplotLibraryNotFoundError
     +--- TecplotLogicError (AssertionError)
     +--- TecplotLookupError (LookupError)
     |     +--- TecplotIndexError (IndexError)
     |     `--- TecplotKeyError (KeyError)
     +--- TecplotOSError (OSError)
     +--- TecplotRuntimeError (RuntimeError)
     |     +--- TecplotNotImplementedError (NotImplementedError)
     |     |     `--- TecplotOutOfDateEngineError
     |     `--- TecplotInterfaceChangeError (AttributeError)
     +--- TecplotSystemError (SystemError)
     |     +--- TecplotInterruptError
     |     `--- TecplotMacroError
     +--- TecplotTypeError (TypeError)
     `--- TecplotValueError (ValueError)

    TecplotWarning (Warning)
     +--- TecplotConversionWarning
     +--- TecplotDeprecationWarning (DeprecationWarning)
     +--- TecplotFutureWarning (FutureWarning)
     `--- TecplotPatternMatchWarning (SyntaxWarning)

exception `tecplot.exception.``TecplotAttributeError`

  Undefined attribute.

exception `tecplot.exception.``TecplotConnectionError`

  Unable to communcate with TecUtil Server.

exception `tecplot.exception.``TecplotConversionWarning`

  Implicit data conversion which loses precision.

exception `tecplot.exception.``TecplotDeprecationWarning`

  Removed feature.

exception `tecplot.exception.``TecplotError`

  Tecplot error.

exception `tecplot.exception.``TecplotFutureWarning`

  An interface has moved or been renamed.

exception `tecplot.exception.``TecplotIndexError`

  Index out of range or invalid.

exception `tecplot.exception.``TecplotInitializationError`

  Tecplot engine could not be initialized.

exception `tecplot.exception.``TecplotInterfaceChangeError`

  A method or property has been moved, renamed or removed.

exception `tecplot.exception.``TecplotInterruptError`(message=None)

  Tecplot 360 was interrupted.

exception `tecplot.exception.``TecplotInvalidMessage`

  Invalid message received when trying to connect.

exception `tecplot.exception.``TecplotKeyError`

  Key not found.

exception `tecplot.exception.``TecplotLibraryNotFoundError`

  Batch library was not found in PATH or DY/LD_LIBRARY_PATH.

exception `tecplot.exception.``TecplotLibraryNotLoadedError`

  Batch library could not be loaded.

exception `tecplot.exception.``TecplotLicenseError`

  Invalid or missing Tecplot license.

exception `tecplot.exception.``TecplotLogicError`

  TecUtil method contract was violated.

exception `tecplot.exception.``TecplotLookupError`

  Could not find requested object.

exception `tecplot.exception.``TecplotMacroError`(message=None)

  Macro command failed to execute.

exception `tecplot.exception.``TecplotNotImplementedError`

  Requested operation is planned but not implemented.

exception `tecplot.exception.``TecplotOSError`

  Operating system error.

exception `tecplot.exception.``TecplotOutOfDateEngineError`(sdk_version_supported, message=None)

  Requested action is implemented in a newer version of the engine.

exception `tecplot.exception.``TecplotOverflowError`

  Integer value out of required range.

exception `tecplot.exception.``TecplotPatternMatchWarning`(pattern, msg, mode='glob')

  Pattern not found in list of names.

exception `tecplot.exception.``TecplotRuntimeError`

  PyTecplot post-initialization error.

exception `tecplot.exception.``TecplotSystemError`(message=None)

  Tecplot Engine error or failure.

exception `tecplot.exception.``TecplotTimeoutError`

  TecUtil Server not responding in a timely fashion.

exception `tecplot.exception.``TecplotTypeError`

  Incorrect or invalid type was used.

exception `tecplot.exception.``TecplotValueError`

  Bad value.

exception `tecplot.exception.``TecplotWarning`

  General warnings issued from PyTecplot.