isaacsim.common.exceptions#

isaacsim.common.exceptions defines the C++ and Python exception hierarchy raised by Isaac Sim’s own validation code. Every exception derives from a common IsaacSimException base, so callers can catch any Isaac Sim exception generically, or catch a specific subtype to inspect the structured data it carries.

Four concrete exceptions are provided:

  • PrimPathError — a USD prim path does not refer to a usable prim. Carries the offending path.

  • PrimPathStringError — a string does not parse as a valid USD prim path. Carries the offending string.

  • AttributeNameError — a caller referenced an attribute name that does not exist or is not accepted. Carries the offending attribute name.

  • ValueTypeError — a value’s type does not match the type expected for an attribute. Carries the attribute name, the expected type, and the actual type.

Each exception formats a human-readable message from its fields, available through what() in C++ and str(exception) in Python. The C++ base derives from std::exception, so callers may also catch std::exception when they only need a generic failure signal.

Python usage#

from isaacsim.common.exceptions import PrimPathError, IsaacSimException

try:
    ...
except PrimPathError as error:
    print(error.prim_path)
except IsaacSimException:
    # Handles any other Isaac Sim exception.
    raise

See C++ guide and API reference and Python guide and API reference for language-specific references.