Application

initialize

pyrobotstructural.initialize(dll_path)

Initialize pythonnet and load RobotOM.dll. Must be called once before using the library.

Return type:

None

Parameters:

dll_path (str)

RobotApp

class pyrobotstructural.RobotApp

Bases: object

Main entry point for pyrobotstructural.

Wraps RobotApplication (the root COM object) and exposes four sub-facades as properties. Call pyrobotstructural.initialize() once with the path to Interop.RobotOM.dll before instantiating this class.

Examples

>>> import pyrobotstructural
>>> dll = r"C:\Program Files\Autodesk\Robot Structural Analysis Professional 2026\Exe\Interop.RobotOM.dll"
>>> pyrobotstructural.initialize(dll)
>>> app = pyrobotstructural.RobotApp()
>>> app.model.geometry.add_node(1, 0, 0, 0)
>>> app.calculate()

property model: ModelFacade

Facade for creating and editing the structural model.

Provides access to:

• geometry — nodes, bars, shells, cladding

• sections — cross-section definitions

• supports — nodal support definitions and assignment

• management — clear model, project management

Use app.model.begin_edit() as a context manager when adding many objects at once to batch COM calls for significantly better performance.

property loads: LoadsFacade

Facade for managing load cases, combinations, and applied loads.

Provides access to:

• cases — create and manage load cases

• combinations — create ULS/SLS combinations

• load — apply loads (self-weight, nodal, uniform, panel, etc.)

property query: QueryFacade

Read-only facade for querying the model and analysis results.

Provides access to:

• nodes — node coordinates and metadata

• bars — bar topology and section data

• loadcases — list and access load cases

• combinations — list and access combinations

• model — model file path and metadata

• results — bar member forces, deflections, and stresses

• shell_results — shell FE element forces and stresses

property view: ViewFacade

Facade for controlling the Robot viewport and capturing screenshots.

Provides access to:

• view — display controls, results visualisation, zoom/pan/rotate

• screenshots — capture and save view screenshots as PNG

calculate(ignore_warnings=False)

Run the structural analysis.

Parameters:

ignore_warnings (bool) – If True, analysis warnings are suppressed and the solver continues without stopping. Defaults to False.

Return type:

None