.. _structure: ================== Structure of Rogue ================== Rogue uses a layered architecture that combines low-level performance with high-level application development. Mixed C++/Python Codebase ========================= Rogue combines Python ergonomics with C++ performance. User-facing APIs are exposed in Python, and most applications can be developed entirely in Python. For performance-critical paths, equivalent C++ APIs are available when native execution is required. * C++ base classes expose core methods into Python. * C++ threads handle bulk transport and communication mechanisms. * Python enables rapid iteration, orchestration, and system composition. * Performance-critical components can be implemented or migrated to C++. High-Level Python Interfaces ============================ At the application layer, Rogue uses a tree model that keeps system structure explicit and manageable. * :ref:`Tree-based ` structure for hierarchical system organization. * Devices can contain Variables, Commands, and other Devices. * These objects derive from the :ref:`Node ` base class. * :ref:`Variables ` describe register data (addressing, type, access behavior, and display semantics). * :ref:`Commands ` define operational procedures and control actions. Low-Level C++ Interfaces ======================== Below the Python layer, core interfaces provide deterministic access to data movement and register transactions. * :ref:`Stream Interface ` for bulk data movement and asynchronous messaging. * :ref:`Memory Interface ` for register and memory-mapped access. Additional Modules and Ecosystem Components =========================================== Rogue also includes ecosystem modules that round out integration, operations, and user-facing workflows. * :doc:`/built_in_modules/index` groups reusable integration modules, including: :ref:`Utilities ` for file I/O, PRBS tools, compression, and other support functions, :ref:`Protocols ` for transport/control integrations such as UDP, RSSI, SRP, and packetizer, and :ref:`Hardware ` interfaces for AXI and raw memory-mapped access paths. * :ref:`PyDM GUI support ` for Rogue channel integration and custom widgets used to monitor and control device trees.