diff --git a/b_asic/GUI/drag_button.py b/b_asic/GUI/drag_button.py
index 9652b8a3d56df2ca397215e778bc9791b17380a8..d2ee6015b713f37d73c56b910e365209e445f101 100644
--- a/b_asic/GUI/drag_button.py
+++ b/b_asic/GUI/drag_button.py
@@ -28,7 +28,15 @@ class DragButton(QPushButton):
"""
Drag button class.
- This class creates a drag button which can be clicked, dragged and dropped.
+ This class creates a button which can be clicked, dragged and dropped.
+
+ Parameters
+ ----------
+ name
+ operation
+ is_show_name
+ window
+ parent
"""
connectionRequested = Signal(QPushButton)
diff --git a/b_asic/GUI/port_button.py b/b_asic/GUI/port_button.py
index 13e2e2187f4e145a4fe8206eb2b0749f9d2d4a6f..e9d448aea0621eed093eee5323583dc953bfefdb 100644
--- a/b_asic/GUI/port_button.py
+++ b/b_asic/GUI/port_button.py
@@ -1,8 +1,23 @@
+"""
+B-ASIC port button module.
+"""
from qtpy.QtCore import Qt, Signal
from qtpy.QtWidgets import QMenu, QPushButton
class PortButton(QPushButton):
+ """
+ A button corresponding to a port.
+
+ Parameters
+ ----------
+ name
+ operation
+ port
+ window
+ parent
+ """
+
connectionRequested = Signal(QPushButton)
moved = Signal()
diff --git a/b_asic/GUI/select_sfg_window.py b/b_asic/GUI/select_sfg_window.py
index 0dc2e3f3e80ae56df7eddc7d990d6139cb5e591a..a210544999db61562d9b956a190c6cfce07d2112 100644
--- a/b_asic/GUI/select_sfg_window.py
+++ b/b_asic/GUI/select_sfg_window.py
@@ -1,3 +1,7 @@
+"""
+B-ASIC select SFG window.
+"""
+
from qtpy.QtCore import Qt, Signal
from qtpy.QtWidgets import QComboBox, QDialog, QPushButton, QVBoxLayout
diff --git a/b_asic/GUI/show_pc_window.py b/b_asic/GUI/show_pc_window.py
index 0a8c7dad0c88e7bca738726be1d88d2a8987497e..43ffc5ea99a11b5b2d4d907090c20b485d70eaa8 100644
--- a/b_asic/GUI/show_pc_window.py
+++ b/b_asic/GUI/show_pc_window.py
@@ -1,3 +1,6 @@
+"""
+B-ASIC window to show precedence graph.
+"""
from qtpy.QtCore import Qt, Signal
from qtpy.QtWidgets import (
QCheckBox,
diff --git a/b_asic/GUI/simulate_sfg_window.py b/b_asic/GUI/simulate_sfg_window.py
index 926d63fa6ebfb901c33432bb2f6fd1c134337623..8989d75d09fd4d9334f3e3209697ca6d5cae959d 100644
--- a/b_asic/GUI/simulate_sfg_window.py
+++ b/b_asic/GUI/simulate_sfg_window.py
@@ -1,3 +1,6 @@
+"""
+B-ASIC window to simulate an SFG.
+"""
from matplotlib.backends.backend_qt5agg import (
FigureCanvasQTAgg as FigureCanvas,
)
diff --git a/b_asic/scheduler_gui/axes_item.py b/b_asic/scheduler_gui/axes_item.py
index 63b2ebd6cb8e23a2cf3e3e1ce95ecab85c015ccc..62afca240ae2cead20865a2605ec4e99d9b5508c 100644
--- a/b_asic/scheduler_gui/axes_item.py
+++ b/b_asic/scheduler_gui/axes_item.py
@@ -59,7 +59,7 @@ class AxesItem(QGraphicsItemGroup):
parent: Optional[QGraphicsItem] = None,
):
"""
- Constructs a AxesItem.
+ Construct an AxesItem.
*parent* is passed to QGraphicsItemGroup's constructor.
"""
super().__init__(parent=parent)
diff --git a/b_asic/scheduler_gui/scheduler_event.py b/b_asic/scheduler_gui/scheduler_event.py
index ce8c744facae0c688f691e30c69ea3b3c17228a6..ca40bd8a0d81437121ccf84bff2f61c81c053917 100644
--- a/b_asic/scheduler_gui/scheduler_event.py
+++ b/b_asic/scheduler_gui/scheduler_event.py
@@ -1,6 +1,7 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
-"""B-ASIC Scheduler-gui Graphics Graph Event Module.
+"""
+B-ASIC Scheduler-gui Graphics Graph Event Module.
Contains the scheduler-gui SchedulerEvent class containing event filters and handlers for SchedulerItem objects.
"""
@@ -27,7 +28,14 @@ from b_asic.scheduler_gui.timeline_item import TimelineItem
class SchedulerEvent: # PyQt5
- """Event filter and handlers for SchedulerItem"""
+ """
+ Event filter and handlers for SchedulerItem.
+
+ Parameters
+ ----------
+ parent : QGraphicsItem, optional
+ The parent QGraphicsItem.
+ """
class Signals(QObject): # PyQt5
"""A class representing signals."""
@@ -94,8 +102,10 @@ class SchedulerEvent: # PyQt5
...
def removeSceneEventFilters(self, filterItems) -> None:
- """Removes an event filter on 'filterItems' from 'self'. 'filterItems' can
- be one object or a list of objects."""
+ """
+ Removes an event filter on *filterItems* from *self*. *filterItems* can
+ be one object or a list of objects.
+ """
item: OperationItem
for item in filterItems:
item.removeSceneEventFilter(self)
@@ -220,7 +230,7 @@ class SchedulerEvent: # PyQt5
def comp_mousePressEvent(self, event: QGraphicsSceneMouseEvent) -> None:
"""
Changes the cursor to ClosedHandCursor when grabbing an object and
- stores the current position in item's parent coordinates. 'event' will
+ stores the current position in item's parent coordinates. *event* will
by default be accepted, and this item is then the mouse grabber. This
allows the item to receive future move, release and double-click events.
"""
@@ -284,7 +294,8 @@ class SchedulerEvent: # PyQt5
def timeline_mousePressEvent(
self, event: QGraphicsSceneMouseEvent
) -> None:
- """Store the current position in item's parent coordinates. 'event' will
+ """
+ Store the current position in item's parent coordinates. *event* will
by default be accepted, and this item is then the mouse grabber. This
allows the item to receive future move, release and double-click events.
"""
diff --git a/b_asic/scheduler_gui/scheduler_item.py b/b_asic/scheduler_gui/scheduler_item.py
index bfa7c647c06f94adb63b5fd426b8cb9d91767d48..c0b80a77b9bbb8aab76ac85f9b0aa94716fee93e 100644
--- a/b_asic/scheduler_gui/scheduler_item.py
+++ b/b_asic/scheduler_gui/scheduler_item.py
@@ -1,6 +1,7 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
-"""B-ASIC Scheduler-gui Graphics Graph Item Module.
+"""
+B-ASIC Scheduler-gui Graphics Graph Item Module.
Contains the scheduler-gui SchedulerItem class for drawing and
maintain a component in a graph.
diff --git a/b_asic/scheduler_gui/signal_item.py b/b_asic/scheduler_gui/signal_item.py
index b8ca7337adae75a640bbaf249d2e265048c1eec1..4529c475c6165fe90a5985b3142e7d93560f59b1 100644
--- a/b_asic/scheduler_gui/signal_item.py
+++ b/b_asic/scheduler_gui/signal_item.py
@@ -17,6 +17,21 @@ from b_asic.signal import Signal
class SignalItem(QGraphicsPathItem):
+ """
+ Class representing a signal in the scheduler GUI.
+
+ Parameters
+ ----------
+ src_operation : OperationItem
+ The operation that the signal is drawn from.
+ dest_operation : OperationItem
+ The operation that the signal is drawn to.
+ signal : Signal
+ The signal on the SFG level.
+ parent : QGraphicsItem, optional
+ The parent QGraphicsItem.
+ """
+
_path: Optional[QPainterPath] = None
_src_operation: OperationItem
_dest_operation: OperationItem
@@ -79,6 +94,7 @@ class SignalItem(QGraphicsPathItem):
self.setPath(path)
def refresh_pens(self):
+ """Create pens."""
pen = QPen(SIGNAL_ACTIVE)
pen.setWidthF(SIGNAL_WIDTH)
self._active_pen = pen
@@ -87,7 +103,10 @@ class SignalItem(QGraphicsPathItem):
self._inactive_pen = pen
def set_active(self):
+ """Set the signal color to represent that a connected operation is selected.
+ """
self.setPen(self._active_pen)
def set_inactive(self):
+ """Set the signal color to the default color."""
self.setPen(self._inactive_pen)