Prepare a new release

.github/workflows/build.yml

@@ -2,6 +2,10 @@
 
 name: Build and installation tests
 
+# Restrict permissions at top-level to 'read' as a minimal explicit permission.
+permissions:
+  contents: read
+
 on:
   push:
     branches: ['master', 'devel']
@@ -21,9 +25,9 @@ jobs:
         python-version: ["3.12", "3.13"]
       fail-fast: false
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v6
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
     - name: Build and install
@@ -46,21 +50,16 @@ jobs:
       # Add multiple Python versions here to run tests on new(er) versions.
         python-version: ["3.12", "3.13"]
       fail-fast: false
-    # Step 1 to make GUIs work, see https://pytest-qt.readthedocs.io/en/latest/troubleshooting.html
-    env:
-      DISPLAY: ':99.0'
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v6
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
-    # Step 2 to make GUIs work
-    - uses: tlambert03/setup-qt-libs@v1
+    - name: Setup headless display
+      uses: pyvista/setup-headless-display-action@v3
     - name: Build and install
       run: |
-        # Step 3 to make GUIs work
-        /sbin/start-stop-daemon --start --quiet --pidfile /tmp/custom_xvfb_99.pid --make-pidfile --background --exec /usr/bin/Xvfb -- :99 -screen 0 1920x1200x24 -ac +extension GLX
         # Install same requirements as to be used during regression testing
         source $CONDA/etc/profile.d/conda.sh
         conda create -n my_env python=${{ matrix.python-version }}

.github/workflows/coding-style.yml

@@ -22,9 +22,9 @@ jobs:
         # Add the Python versions here to run tests on new(er) versions.
         python-version: ["3.13"]
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v6
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
@@ -45,9 +45,9 @@ jobs:
         # Add multiple Python versions here to run tests on new(er) versions.
         python-version: ["3.13"]
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v6
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies

.github/workflows/housekeeping.yml

@@ -18,7 +18,7 @@ jobs:
       pull-requests: write
 
     steps:
-    - uses: actions/stale@v5
+    - uses: actions/stale@v10
       with:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
         stale-issue-message: >

.github/workflows/python-publish.yml

@@ -18,9 +18,9 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v6
       with:
         python-version: '3.x'
     - name: Install dependencies
@@ -30,7 +30,7 @@ jobs:
     - name: Build package
       run: python -m build
     - name: Store the distribution packages
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: python-package-distributions
         path: dist/
@@ -47,7 +47,7 @@ jobs:
       id-token: write  # IMPORTANT: mandatory for trusted publishing
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v8
       with:
         name: python-package-distributions
         path: dist/

.github/workflows/regression-tests.yml

@@ -1,6 +1,11 @@
 # This workflow will run some regression tests.
 name: Regression Tests
 
+# Restrict permissions at top-level to 'read' as a minimal explicit permission.
+# This will apply to all jobs that do not define their own permissions.
+permissions:
+  contents: read
+
 on:
   push:
     branches: ['master', 'devel']
@@ -23,43 +28,36 @@ jobs:
       matrix:
         # Add multiple Python versions here to run tests on new(er) versions.
         python-version: ["3.13"]
-    # Step 1 to make GUIs work, see https://pytest-qt.readthedocs.io/en/latest/troubleshooting.html
-    env:
-      DISPLAY: ':99.0'
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v6
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
-    # Step 2 to make GUIs work
-    - uses: tlambert03/setup-qt-libs@v1
-    - name: Install dependencies
+    - name: Setup headless display
+      uses: pyvista/setup-headless-display-action@v3
+    - name: Build and install
       run: |
-        # Step 3 to make GUIs work
-        /sbin/start-stop-daemon --start --quiet --pidfile /tmp/custom_xvfb_99.pid --make-pidfile --background --exec /usr/bin/Xvfb -- :99 -screen 0 1920x1200x24 -ac +extension GLX
         # Install same requirements as to be used during regression testing
         source $CONDA/etc/profile.d/conda.sh
-        conda config --add channels conda-forge
-        conda config --set channel_priority strict
-        conda create -n pytest_env python=${{ matrix.python-version }}
-        conda activate pytest_env
-        conda install -y -q --file ./tests/list_of_packages.txt  || true
-        # Install the package itself to make sure that all imports work.
+        conda create -n my_env python=${{ matrix.python-version }}
+        conda activate my_env
+        conda install -y -q -c conda-forge --file ./tests/list_of_packages.txt || true
+        # Install with -e (in editable mode) to allow the tracking of the test coverage
         pip install -e .[extras,test]
     - name: Analysing the code with pytest
       run: |
         source $CONDA/etc/profile.d/conda.sh
-        conda activate pytest_env
+        conda activate my_env
         # Run the actual testing of the code with pytest
         # Using python -m pytest is necessary because pytest has the habit of not looking in the site-packages of the venv
         python -m pytest -v --basetemp=./tmp -k 'test_unittests or test_gui or test_integration_public' --cov=loadskernel  --cov=modelviewer --cov=loadscompare --junitxml=testresult.xml
         # Create some reports
         coverage report
         coverage xml -o coverage.xml
         coverage html --directory ./coverage
-    - name: Upload test restults and coverage as an artifact
-      uses: actions/upload-artifact@v4
+    - name: Upload test results and coverage as an artifact
+      uses: actions/upload-artifact@v7
       with:
         name: test results and coverage
         path: |
@@ -69,28 +67,28 @@ jobs:
         if-no-files-found: ignore
 
   Jupyter:
-    # Building the Jupyter book is not really a regression test. However, it has to be in this workflow due to the handling of 
-    # the artifacts.
+    # Building the Jupyter book is not really a regression test, but it makes sure that the notebooks are still working.
+    # In addition, it has to be in this workflow due to the handling of the artifacts.
     runs-on: ubuntu-latest
     strategy:
       matrix:
         # Select Python version to be used for compiling here.
         python-version: ["3.13"]
     steps:
-    - uses: actions/checkout@v4
-    - uses: actions/setup-node@v4
+    - uses: actions/checkout@v6
+    - uses: actions/setup-node@v6
       with:
         node-version: 18.x
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
-    - name: Install dependencies
+    - name: Build and install
       run: |
         python -m pip install --upgrade pip
         # Install the package itself to make sure that all imports work.
         pip install .[test]
-    - name: Assemble the tutorials to a jupyter book and build htlm pages
+    - name: Assemble the tutorials to a jupyter book and build html pages
       run: |
         cd ./doc/tutorials
         jupyter-book build --execute --html
@@ -99,7 +97,7 @@ jobs:
         mkdir ./doc/html
         mv ./doc/tutorials/_build/html ./doc/html/tutorials
     - name: Upload Jupyter book as an artifact
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: tutorials
         path: ./doc/html
@@ -110,7 +108,7 @@ jobs:
     # Add a dependency to the build job
     needs: [Jupyter, Pytest]
     steps:
-    - uses: actions/download-artifact@v4.1.7
+    - uses: actions/download-artifact@v8
       with:
         merge-multiple: true
     - name: See what we've got and merge artifacts
@@ -121,7 +119,7 @@ jobs:
         mv ./coverage ./pages/coverage
     - name: Upload artifact for pages
       # This is not a normal artifact but one that can be deployed to the GitHub pages in the next step
-      uses: actions/upload-pages-artifact@v3
+      uses: actions/upload-pages-artifact@v5
       with:
         name: github-pages  # This name may not be changed according to the documentation
         path: ./pages  # There must be only one path
@@ -142,7 +140,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Setup GitHub Pages
-        uses: actions/configure-pages@v4
+        uses: actions/configure-pages@v6
       - name: Deploy to Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5

AUTHORS.md

@@ -16,6 +16,7 @@ Schulze, Matthias, Institute of Aeroelasticity, Deutsches Zentrum für Luft- und
 Handojo, Vega, Institute of Aeroelasticity, Deutsches Zentrum für Luft- und Raumfahrt e.V.
 Baier, Jan, Institute of Aeroelasticity, Deutsches Zentrum für Luft- und Raumfahrt e.V.
 Carvalho, Francisco, Institute of Aeroelasticity, Deutsches Zentrum für Luft- und Raumfahrt e.V.
+Chang Xu, Visonary Aircraft Concepts, Bauhaus Luftfahrt e.V.
 
 ```
 

CHANGELOG.md

@@ -1,6 +1,15 @@
 # Note
 New releases are marked in the repository using tags. Simply checkout the master branch for the lastest version or use git checkout if you require a specific release, for example 'git checkout 2022.10'.
 
+# Release 2026.05
+- New interface for Nastran 95
+- CFD simulations with SU2: tested with RANS, found and fixed a bug during splining
+- Loads Compare can now plot time histories per subcase
+- New tool Response Viewer to plot time histories of aircraft states per subcase (e.g. velocities, rates, angles, alpha, beta, etc.)
+- Dropped support for Python versions lower than 3.12
+- Dependencies: removed version limitation of Pandas
+- Testing: Maintenance of continuous integration workflows
+
 # Release 2026.01
 - Added gust and flutter simulation in the frequency domain based of GAFs obtained from linearized CFD (using SU2 and via pulse simulations). This is work is still very new and therefore needs more testing and/or applications.
 - Refactoring of 'equations'

doc/DMAPs/DMAPforNastran95.alter

@@ -0,0 +1,29 @@
+ID    My,Aircraft
+$ The modal anaylsis is called SOL 3 in Nastran 95.
+SOL   3
+$ Print the DMAP code and insert the output command after line 52.
+$ I haven't found an option so specify a filename of the op2 file, 
+$ in my case the resulting file was named 'none'. So remember to keep 
+$ track of your filenames when working with multiple mass configurations.
+DIAG 14,18
+ALTER 52
+OUTPUT2 KGG,MGG,GM,USET,//0/11////*MSC* $
+ENDALTER
+CEND
+$
+METHOD=100
+ECHO=NONE
+$
+BEGIN BULK
+PARAM    GRDPNT   0
+$ Calculate all modes between 0.1 and 15.0 Hz using the modified Givens method.
+$ Because we only want the system matrices, the modal analysis is (stricly speaking)
+$ not necessary but allows to compare eigenvalues calculated in Loads Kernel with
+$ those found by Nastran 95 as a cross-check.
+$------><------><------><------><------><------><------><------><------>
+EIGR    100     MGIV    0.1     15.0
+$
+$ Insert structural model below here (include statements are not supported by Nastran 95).
+$
+$ Explicitly terminate file.
+ENDDATA

doc/jcl_template.py

@@ -51,20 +51,25 @@ def __init__(self):
                      # bdf file with GRID-cards, 1st file -> 1st monstation
                      'filename_monstations': ['monstation_MON1.bdf', 'monstation_MON2.bdf'],
                      # The following matrices are required for some mass methods. However, the stiffness is geometry
-                     # and not mass dependent. Overview:
-                     # KGG via DMAP Alter (.op4 or .h5)      - required for mass method = 'modalanalysis', 'guyan' or 'B2000'
-                     # GM via DMAP Alter (.op4 or .h5)       - required for mass method = 'modalanalysis', 'guyan'
-                     # USET via DMAP Alter and OP2           - required for mass method = 'modalanalysis', 'guyan'
-                     # bdf file(s) with ASET1-card           - required for mass method = 'guyan'
-                     # matrix R_trans from B2000             - required for mass method = 'B2000'
+                     # and not mass dependent and is organized here for better overview. You can gerente these matrices
+                     # with a DMAP Alter, see the scripts folder.
+                     # Overview:
+                     # KGG via DMAP Alter (.op4, .h5, .csv)  - required for mass method Nastran or B2000
+                     # GM via DMAP Alter (.op4 or .h5)       - required for mass method Nastran
+                     # USET via DMAP Alter (.op2)            - required for mass method Nastran
+                     # R_trans from B2000                    - required for mass method B2000
+                     # bdf file(s) with ASET1-card           - required Guyan reduction
                      # The HDF5 file format is preferred over OP4 due to better performance and higher precision. Because the
                      # uset is a table, not a matrix, it can't be included in the HDF5 file and still needs to be given as OP2.
                      'filename_h5': 'SOL103.mtx.h5',
                      'filename_KGG': 'KGG.dat',
                      'filename_GM': 'GM.dat',
                      'filename_uset': 'uset.op2',
-                     'filename_aset': 'aset.bdf',
                      'filename_Rtrans': 'Rtrans.csv',
+                     'filename_aset': 'aset.bdf',
+                     # If you really want to, the matrices Kgg and GM may also be given in OP2 format, e.g. when using
+                     # Nastran 95. Note that the OP2 file is binary so that it is difficult to check its content.
+                     'filename_op2': 'matrices_from_Nastran95.op2',
                      }
         # Settings for the aerodynamic model
         self.aero = {'method': 'mona_steady',
@@ -147,15 +152,25 @@ def __init__(self):
                        'filename_splinegrid': ['splinegrid.bdf']
                        }
         # Settings for the structural dynamics.
-        self.mass = {'method': 'modalanalysis', # Inplemented interfaces: 'f06', 'modalanalysis', 'guyan', 'CoFE', 'B2000'
+        self.mass = {'method': 'modalanalysis',
+                     # 'modalanalysis', 'guyan' - Eigenvalue / -vector analysis, optionally incl. Guyan reduction,
+                     #                            based on system matrices obtained from Nastran (MSC or Siemens NX)
+                     # 'f06'                    - Eigenvalues and -vectors calculated with SOL 103 and parsed from f06-file
+                     # 'CoFE'                   - Matrices from Nastran Compatible Finite Elements (CoFE)
+                     # 'B2000'                  - Matrices from DLR's version of B2000++
+                     # 'Nastran95'              - Matrices from open-source NASA Structural Analysis System (Nastran 95)
+                     # Note that the the stiffness is geometry dependent and is therfor given in the geom setion. All mass
+                     # cases share the same geometry and stiffness matrix.
                      'key': ['M1', 'M2'],
-                     # MGG via DMAP Alter and HDF5
-                     'filename_h5': ['SOL103_M1.mtx.h5', 'SOL103_M2.mtx.h5'],
                      # MGG via DMAP Alter and OP4
                      'filename_MGG': ['MGG_M1.dat', 'MGG_M2.dat'],
+                     # MGG via DMAP Alter and HDF5
+                     'filename_h5': ['SOL103_M1.mtx.h5', 'SOL103_M2.mtx.h5'],
+                     # MGG via DMAP Alter and OP2
+                     'filename_op2': ['MGG_M1.op2', 'MGG_M2.op2'],
                      # eigenvalues and eigenvectors from .f06-file - required for 'mona'
                      'filename_S103': ['SOL103_M1.f06', 'SOL103_M1.f06'],
-                     # eigenvalues and eigenvectors from .f06-file - required for 'mona'
+                     # eigenvalues and eigenvectors from .mat-file - required for 'CoFe'
                      'filename_CoFE': ['M1.mat', 'M2.mat'],
                      # True or False, omits first six modes
                      'omit_rb_modes': False,