From e9d2e7af8b16821c57ec904da7cdd5258b9ba0b7 Mon Sep 17 00:00:00 2001
From: Riccardo Riva <11406200+RRiva@users.noreply.github.com>
Date: Mon, 13 Jul 2026 12:59:17 +0200
Subject: [PATCH 1/3] Updated definition of structural damping

---
 windIO/schemas/turbine/turbine_schema.yaml | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/windIO/schemas/turbine/turbine_schema.yaml b/windIO/schemas/turbine/turbine_schema.yaml
index 9e6c069b..0b679f1b 100644
--- a/windIO/schemas/turbine/turbine_schema.yaml
+++ b/windIO/schemas/turbine/turbine_schema.yaml
@@ -3322,18 +3322,28 @@ definitions:
                             units: kg*m^2
                             # minimum: 0 # not 100% sure, but i_cp could be negative
             structural_damping:
-                description: Structural damping of the beam. For now, viscous damping is included
+                description: Structural damping ratios of the clamped beam in the undeflected configuration.
                 type: object
+                required:
+                    - mode_name
+                    - damping_ratio
                 properties:
-                    mu:
+                    mode_name:
+                        type: array
+                        default: ["mode_1"]
+                        description: Name of the modes associated to the damping ratios. For a blade, they may be: "flap_1",  "edge_1", ..., "torsion_1".
+                        items:
+                            type: string
+                            uniqueItems: true
+                    damping_ratio:
                         type: array
-                        default: [0.0, 0.0, 0.0, 0.0, 0.0, 0.0]
-                        description: Six damping coefficients to model viscous damping, where the damping forces are proportional to the strain rate
+                        default: [0.0]
+                        description: Damping ratios, computed as - Re(lambda) / abs(lambda), where lambda is an eigenvalue. A reasonable number is 0.003, i.e. 0.3%.
                         items:
                             type: number
-                            minItems: 6
-                            maxItems: 6
                             uniqueItems: false
+                            minimum: 0
+                            units: dimensionless
             point_mass:
                 type: object
                 required:

From f3a9b6148ed28fce78a436c2094215100684dc39 Mon Sep 17 00:00:00 2001
From: Riccardo Riva <11406200+RRiva@users.noreply.github.com>
Date: Tue, 14 Jul 2026 14:49:35 +0200
Subject: [PATCH 2/3] Specified "at standstill"

---
 windIO/schemas/turbine/turbine_schema.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/windIO/schemas/turbine/turbine_schema.yaml b/windIO/schemas/turbine/turbine_schema.yaml
index 0b679f1b..1e6ee400 100644
--- a/windIO/schemas/turbine/turbine_schema.yaml
+++ b/windIO/schemas/turbine/turbine_schema.yaml
@@ -3322,7 +3322,7 @@ definitions:
                             units: kg*m^2
                             # minimum: 0 # not 100% sure, but i_cp could be negative
             structural_damping:
-                description: Structural damping ratios of the clamped beam in the undeflected configuration.
+                description: Structural damping ratios of the clamped beam at standstill in the undeflected configuration.
                 type: object
                 required:
                     - mode_name

From eb18302d50dd3c9355a23729908a2b1580591e48 Mon Sep 17 00:00:00 2001
From: Riccardo Riva <11406200+RRiva@users.noreply.github.com>
Date: Fri, 17 Jul 2026 09:48:32 +0200
Subject: [PATCH 3/3] Specified BC

---
 windIO/schemas/turbine/turbine_schema.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/windIO/schemas/turbine/turbine_schema.yaml b/windIO/schemas/turbine/turbine_schema.yaml
index 1e6ee400..4d3ff57f 100644
--- a/windIO/schemas/turbine/turbine_schema.yaml
+++ b/windIO/schemas/turbine/turbine_schema.yaml
@@ -3322,7 +3322,7 @@ definitions:
                             units: kg*m^2
                             # minimum: 0 # not 100% sure, but i_cp could be negative
             structural_damping:
-                description: Structural damping ratios of the clamped beam at standstill in the undeflected configuration.
+                description: Structural damping ratios of the undeflected beam at standstill, subject to appropriate boundary conditions.
                 type: object
                 required:
                     - mode_name