README.md

-<img src="logo.png" width="278" height="100">
+<img src="logos/logo.png" width="278" height="100">
 
 # B-ASIC - Better ASIC Toolbox
 

b_asic/gui_utils/about_window.py

+import pathlib
 import sys  # ONLY FOR DEBUG
 
 from qtpy.QtCore import Qt
@@ -43,13 +44,18 @@ class AboutWindow(QDialog):
         # |3 links     |4  OK  |  <- layout34
 
         label1 = QLabel(
-            "# B-ASIC / Better ASIC Toolbox\n*Construct, simulate and analyze"
-            " components of an ASIC.*\n\nB-ASIC is an open source tool using"
-            " the B-ASIC library to construct, simulate and analyze"
-            " ASICs.\n\nB-ASIC is developed under the MIT-license and any"
-            " extension to the program should follow that same license.\n\nTo"
-            " read more about how the GUI works please refer to the FAQ under"
-            f" 'Help'.\n\n*Version: {__version__}*"
+            "# B-ASIC\n__Better ASIC and FPGA Signal Processing"
+            " Toolbox__\n\n*Construct, simulate and analyze signal processing"
+            " algorithms aimed at implementation on an ASIC or"
+            " FPGA.*\n\nB-ASIC is developed by the <a"
+            " href=\"https://liu.se/en/organisation/liu/isy/da\">Division of"
+            " Computer Engineering</a> at <a"
+            " href=\"https://liu.se/?l=en\">Linköping University</a>,"
+            " Sweden.\n\nB-ASIC is released under the <a"
+            " href=\"https://gitlab.liu.se/da/B-ASIC/-/blob/master/LICENSE\">MIT-license</a>"
+            " and any extension to the program should follow that same"
+            f" license.\n\n*Version: {__version__}*\n\nCopyright 2020-2023,"
+            " Oscar Gustafsson et al."
         )
         label1.setTextFormat(Qt.MarkdownText)
         label1.setWordWrap(True)
@@ -58,15 +64,17 @@ class AboutWindow(QDialog):
 
         self.logo2 = QLabel(self)
         self.logo2.setPixmap(
-            QPixmap("../../small_logo.png").scaledToWidth(100)
+            QPixmap(
+                str(pathlib.Path(__file__).parent.resolve())
+                + "/../../logos/small_logo.png"
+            ).scaledToWidth(100)
         )
         self.logo2.setFixedWidth(100)
 
         label3 = QLabel(
-            """See: <a href="https://da.gitlab-pages.liu.se/B-ASIC/">documentation</a>,"""
-            """ <a href="https://gitlab.liu.se/da/B-ASIC/">git</a>,"""
-            """ <a href="https://www.liu.se/?l=en">liu.se</a>,"""
-            """ <a href="https://liu.se/organisation/liu/isy/da">Computer Engineering</a>."""
+            """Additional resources: <a href="https://da.gitlab-pages.liu.se/B-ASIC/">documentation</a>,"""
+            """ <a href="https://gitlab.liu.se/da/B-ASIC/">git repository</a>,"""
+            """ <a href="https://gitlab.liu.se/da/B-ASIC/-/issues">report issues and suggestions</a>."""
         )
         label3.setOpenExternalLinks(True)
         label3.linkHovered.connect(self.hoverText)

b_asic/research/interleaver.py

+"""
+Functions to generate memory-variable test data that are used for research.
+"""
+
+import random
+from typing import Optional, Set
+
+from b_asic.process import PlainMemoryVariable
+
+
+def _insert_delays(inputorder, outputorder, min_lifetime, cyclic):
+    size = len(inputorder)
+    maxdiff = min(outputorder[i] - inputorder[i] for i in range(size))
+    outputorder = [o - maxdiff + min_lifetime for o in outputorder]
+    maxdelay = max(outputorder[i] - inputorder[i] for i in range(size))
+    if cyclic:
+        if maxdelay < size:
+            outputorder = [o % size for o in outputorder]
+        else:
+            inputorder = inputorder + [i + size for i in inputorder]
+            outputorder = outputorder + [o + size for o in outputorder]
+    return inputorder, outputorder
+
+
+def generate_random_interleaver(
+    size: int, min_lifetime: int = 0, cyclic: bool = True
+) -> Set[PlainMemoryVariable]:
+    """
+    Generate a ProcessCollection with memory variable corresponding to a random
+    interleaver with length *size*.
+
+    Parameters
+    ----------
+    size : int
+        The size of the random interleaver sequence.
+    min_lifetime : int, default: 0
+        The minimum lifetime for a memory variable. Default is 0 meaning that at least
+        one variable is passed from the input to the output directly,
+    cyclic : bool, default: True
+        If the interleaver should operate continuously in a cyclic manner. That is,
+        start a new interleaving operation directly after the previous.
+
+    Returns
+    -------
+        ProcessCollection
+
+    """
+    inputorder = list(range(size))
+    outputorder = inputorder[:]
+    random.shuffle(outputorder)
+    print(inputorder, outputorder)
+    inputorder, outputorder = _insert_delays(
+        inputorder, outputorder, min_lifetime, cyclic
+    )
+    print(inputorder, outputorder)
+    return {
+        PlainMemoryVariable(inputorder[i], 0, {0: outputorder[i]})
+        for i in range(size)
+    }
+
+
+def generate_matrix_transposer(
+    height: int,
+    width: Optional[int] = None,
+    min_lifetime: int = 0,
+    cyclic: bool = True,
+) -> Set[PlainMemoryVariable]:
+    r"""
+    Generate a ProcessCollection with memory variable corresponding to transposing a
+    matrix of size *height* :math:`\times` *width*. If *width* is not provided, a
+    square matrix of size *height* :math:`\times` *height* is used.
+
+    Parameters
+    ----------
+    height : int
+        Matrix height.
+    width : int, optional
+        Matrix width. If not provided assumed to be equal to height, i.e., a square
+        matrix.
+    min_lifetime : int, default: 0
+        The minimum lifetime for a memory variable. Default is 0 meaning that at
+        least one variable is passed from the input to the output directly,
+    cyclic : bool, default: True
+        If the interleaver should operate continuously in a cyclic manner. That is,
+        start a new interleaving operation directly after the previous.
+
+    Returns
+    -------
+        ProcessCollection
+    """
+    if width is None:
+        width = height
+
+    inputorder = []
+    for row in range(height):
+        for col in range(width):
+            inputorder.append(col + width * row)
+
+    outputorder = []
+    for row in range(width):
+        for col in range(height):
+            outputorder.append(col * width + row)
+
+    print(inputorder, outputorder)
+    inputorder, outputorder = _insert_delays(
+        inputorder, outputorder, min_lifetime, cyclic
+    )
+    print(inputorder, outputorder)
+    return {
+        PlainMemoryVariable(inputorder[i], 0, {0: outputorder[i]})
+        for i in range(width * height)
+    }

docs_sphinx/Makefile

+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    = -W --keep-going
+SPHINXBUILD   = python -msphinx
+SPHINXPROJ    = b_asic
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# workaround because sphinx does not completely clean up (#11139)
+clean:
+	@$(SPHINXBUILD) -M clean "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	rm -rf "$(SOURCEDIR)/examples"
+
+show:
+	@python -c "import webbrowser; webbrowser.open_new_tab('file://$(shell pwd)/_build/html/index.html')"
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs_sphinx/conf.py

@@ -10,7 +10,7 @@ import shutil
 project = 'B-ASIC'
 copyright = '2020-2023, Oscar Gustafsson et al'
 author = 'Oscar Gustafsson et al'
-html_logo = "../logo_tiny.png"
+html_logo = "../logos/logo_tiny.png"
 
 pygments_style = 'sphinx'
 

docs_sphinx/gui_utils.rst

+gui\_utils package
+==================
+
+gui\_utils.about\_window module
+-------------------------------
+
+.. automodule:: b_asic.gui_utils.about_window
+   :members:
+   :undoc-members:

docs_sphinx/index.rst

@@ -28,4 +28,6 @@ Table of Contents
    api/index
    GUI
    scheduler_gui
+   gui_utils
    examples/index
+   research

docs_sphinx/research.rst

+Research functions
+==================
+
+research.interleaver module
+---------------------------
+
+.. automodule:: b_asic.research.interleaver
+   :members:
+   :undoc-members: