perun.backend.hwmon_grace ========================= .. py:module:: perun.backend.hwmon_grace .. autoapi-nested-parse:: Defines Linux Hardware Monitoring (hwmon) backend classes. Attributes ---------- .. autoapisummary:: perun.backend.hwmon_grace.log perun.backend.hwmon_grace.HWMON_PATH perun.backend.hwmon_grace.POWER_AVERAGE_RGX Classes ------- .. autoapisummary:: perun.backend.hwmon_grace.HWMonGraceBackend Module Contents --------------- .. py:data:: log .. py:data:: HWMON_PATH :value: '/sys/class/hwmon/' .. py:data:: POWER_AVERAGE_RGX :value: 'power(\\d+)_average$' .. py:class:: HWMonGraceBackend Bases: :py:obj:`perun.backend.backend.Backend` Hardware Monitoring (hwmon) backend for reading system sensors. Uses the Linux hwmon sysfs interface to gather power measurements from device subdirectories. Docs: https://docs.nvidia.com/dccpu/grace-perf-tuning-guide/power-thermals.html .. py:attribute:: id :value: 'hwmon-grace' .. py:attribute:: name :value: 'Hardware Monitor (Grace)' .. py:attribute:: description :value: 'Reads power measurements from hwmon sysfs device subdirectories for Grace systems.' .. py:method:: setup() -> None Initialize hwmon backend and discover available sensors. .. py:method:: close() -> None Backend shutdown code, closes all open sensor files. .. py:method:: availableSensors() -> dict[str, tuple[str, perun.data_model.sensor.DeviceType, perun.data_model.measurement_type.Unit]] Return string id set of visible devices. :returns: Set with visible device ids. :rtype: set[str] .. py:method:: getSensors(deviceList: set[str]) -> list[perun.data_model.sensor.Sensor] Gather device objects based on a set of device ids. :param deviceList: Set of device ids. :type deviceList: set[str] :returns: Device objects. :rtype: list[Sensor]