PR to pull back changes of IIC branch

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,32 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: hpretl
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Environment:**
+ - OS: [e.g. Windows, macOS, Linux]
+ - Operating mode: [e.g. VNC, X11]
+ - Version tag [e.g. 2022.12]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: hpretl
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/devcontainer-docker.yaml

@@ -0,0 +1,59 @@
+name: "Build and publish devcontainer"
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Container version'
+        required: true
+        default: 'latest'
+
+env:
+  REGISTRY: ghcr.io
+  # This does not work as the lowercase conversion does not work then,
+  # and we don't want the name of the docker container to clash
+  #IMAGE_NAME: ${{ github.repository }}
+  IMAGE_NAME: ${{ github.repository_owner }}/iic-osic-tools-devcontainer
+
+jobs:
+  build-and-push-image:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}    
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@9ec57ed1fcdbf14dcef7dfbe97b2010124a938b7
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+
+      - name: Build and push Docker image
+        id: push
+        uses: docker/build-push-action@f2a1d5e99d037542a71f64918e516c093c6f3fc4
+        with:
+          context: "./_build/devcontainer/image/"
+          push: true
+          tags: "${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ github.event.inputs.version }}"
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: VERSION=${{ github.event.inputs.version }}
+
+      - name: Generate artifact attestation
+        uses: actions/attest-build-provenance@v1
+        with:
+          subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME}}
+          subject-digest: ${{ steps.push.outputs.digest }}
+          push-to-registry: true

.github/workflows/devcontainer-template.yaml

@@ -0,0 +1,24 @@
+name: "Release devcontainer template"
+on:
+  workflow_dispatch:
+
+jobs:
+  deploy-templates:
+    if: ${{ github.ref == 'refs/heads/main' }}
+    runs-on: ubuntu-latest
+    permissions:
+      packages: write
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: "Publish Templates"
+        uses: devcontainers/action@v1
+        with:
+          publish-templates: "true"
+          base-path-to-templates: "./_build/devcontainer/iic-osic-tools"
+          generate-docs: "true"
+
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,2 +1,20 @@
-**/*.pyc
-**/.DS_Store
+# ========================================================================
+# Editor swap/backup files
+# ========================================================================
+*~
+*swp
+
+# ========================================================================
+# Python compiled files
+# ========================================================================
+*.pyc
+
+# ========================================================================
+# macOS files
+# ========================================================================
+.DS_Store
+
+# ========================================================================
+# Misc configuration files
+# ========================================================================
+eda_user_credentials*.json

CITATION.cff

@@ -0,0 +1,15 @@
+cff-version: 1.2.0
+message: "If you use this Docker container or base your work on it, please cite it as below."
+authors:
+- family-names: Pretl
+  given-names: Harald
+  orcid: https://orcid.org/0000-0003-1519-076X
+- family-names: Zachl
+  given-names: Georg
+  orcid: https://orcid.org/0009-0006-7676-6389
+title: "GitHub repository of the IIC-OSIC-TOOLS"
+date-released: 2023-09-18
+url: https://github.com/iic-jku/IIC-OSIC-TOOLS
+identifiers:
+  - type: doi
+    value: 10.5281/zenodo.14387234

KNOWN_ISSUES.md

@@ -0,0 +1,47 @@
+# IIC-OSIC-TOOLS Known Issues
+
+## Container
+
+### Starting the Container
+
+If you run into problems when starting the container (mostly in combination with SELinux), try to run the container with the following environment variable set to `DOCKER_EXTRA_PARAMS='--security-opt seccomp=unconfined'`. This will overwrite the Docker Default security settings so use with it care!
+
+Example:
+
+```bash
+DOCKER_EXTRA_PARAMS='--security-opt seccomp=unconfined' ./start_x.sh
+```
+
+### Frequent crashes of `xschem` on Windows 11
+
+Since the update of the image to Ubuntu 24.04 LTS with tag `2025.01` there are reports of frequent crashes of `xschem` under Windows 11 using certain versions of specific X-servers. It has been found that using <https://vcxsrv.com> version `64.1.17.2.0` under Windows 11 works well (see [issue 92](https://github.com/iic-jku/IIC-OSIC-TOOLS/issues/92)).
+
+### Issues with OpenGL on some environments
+
+A few applications are using OpenGL graphics, which can lead to issues on some computing environments. A (potential) remedy is to enable SW-rendering with can be achieved by setting the following environment variable inside the Docker VM:
+
+`LIBGL_ALWAYS_INDIRECT=0`
+
+### The OpenROAD Flow Scripts (ORFS)
+
+The ORFS required a recent version of `openroad`. Since image tag `2024.12` a recent version is installed alongside the OpenROAD version required by `openlane`. In order to use the ORFS, before calling the `make` script make sure to set the following env vars:
+
+```bash
+export YOSYS_EXE=$TOOLS/yosys/bin/yosys
+export OPENROAD_EXE=$TOOLS/openroad-latest/bin/openroad
+export OPENSTA_EXE=$TOOLS/openroad-latest/bin/sta
+```
+
+### Surfer crashing
+
+As of image `2025.01` Surfer has been added. Surfer is known to crash on quite a few platforms due to issues with OpenGL drivers. If Surfer works on your platform, great. If Surfer does crash then this is not good, but there is currently no solution available. Please do not file bug reports. As soon as we are aware of a solution for these crashes we will implement the fixes.
+
+### OpenEMS
+
+The visualization tool "AppCSXCAD" will not work in the container with our default settings (`vtkXOpenGLRenderWindow (0x....): Cannot create GLX context.  Aborting.`). The issue has been located to be connected with the environment variable "LIBGL_ALWAYS_INDIRECT". As a workaround, we suggest either unsetting the variable or setting it to 0 (`unset LIBGL_ALWAYS_INDIRECT` or `export LIBGL_ALWAYS_INDIRECT=0`) which is persistent for the running terminal or run AppCSXCAD with the variable set to zero inline: `LIBGL_ALWAYS_INDIRECT=0 AppCSXCAD`.
+
+### PyOPUS
+
+`PyOPUS` is removed, as build fails, and it forces `numpy` to version 1.
+
+## Build

LICENSE

@@ -186,7 +186,8 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2021-2022 Institute for Integrated Circuits, 
+   Johannes Kepler University, Linz, Austria
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.