Merge pull request #3039 from luwang00/f/BldPitch

Blade pitch dynamics and actuation

Author: deslaughter

docs/OtherSupporting/OutListParameters.xlsx

@@ -54,6 +54,22 @@ AeroDyn driver                                25       SeaStFile            "MHK
 AeroDyn                                       \*       TwrCp                1.0         [additional column in *Tower Influence and Aerodynamics* table]
 AeroDyn                                       \*       TwrCa                1.0         [additional column in *Tower Influence and Aerodynamics* table]
 SeaState                                      18       WvCrntMod            0     WvCrntMod     - Combined wave-current modeling option {0: simple superposition, 1: include Doppler effect, 2: include both Doppler effect and wave amplitude/spectrum scaling} (switch)
+ElastoDyn                                     11       PitchDOF             False         PitchDOF    - Blade pitch DOF (flag)
+ElastoDyn                                     77       PBrIner(1)           200           PBrIner(1)  - Pitch bearing/actuator inertia, blade 1 (kg m^2)
+ElastoDyn                                     78       PBrIner(2)           200           PBrIner(2)  - Pitch bearing/actuator inertia, blade 2 (kg m^2)
+ElastoDyn                                     79       PBrIner(3)           200           PBrIner(3)  - Pitch bearing/actuator inertia, blade 3 (kg m^2) [unused for 2 blades]
+ElastoDyn                                     80       BlPIner(1)           28578         BlPIner(1)  - Pitch inertia of an undeflected blade, blade 1 (kg m^2)
+ElastoDyn                                     81       BlPIner(2)           28578         BlPIner(2)  - Pitch inertia of an undeflected blade, blade 2 (kg m^2)
+ElastoDyn                                     82       BlPIner(3)           28578         BlPIner(3)  - Pitch inertia of an undeflected blade, blade 3 (kg m^2) [unused for 2 blades]
+ServoDyn                                      9        PitNeut(1)           0             PitNeut(1)  - Blade 1 neutral pitch position--pitch spring moment is zero at this position *[unused when* **PCMode>0** and **t>=TPCOn** *]*
+ServoDyn                                      10       PitNeut(2)           0             PitNeut(2)  - Blade 2 neutral pitch position--pitch spring moment is zero at this position *[unused when* **PCMode>0** and **t>=TPCOn** *]*
+ServoDyn                                      11       PitNeut(3)           0             PitNeut(3)  - Blade 3 neutral pitch position--pitch spring moment is zero at this position *[unused when* **PCMode>0** and **t>=TPCOn** *]* *[unused for 2 blades]*
+ServoDyn                                      12       PitSpr(1)            3.6E7         PitSpr(1)   - Blade 1 pitch spring constant
+ServoDyn                                      13       PitSpr(2)            3.6E7         PitSpr(2)   - Blade 2 pitch spring constant
+ServoDyn                                      14       PitSpr(3)            3.6E7         PitSpr(3)   - Blade 3 pitch spring constant *[unused for 2 blades]*
+ServoDyn                                      15       PitDamp(1)           1.4E6         PitDamp(1)  - Blade 1 pitch damping constant
+ServoDyn                                      16       PitDamp(2)           1.4E6         PitDamp(2)  - Blade 2 pitch damping constant
+ServoDyn                                      17       PitDamp(3)           1.4E6         PitDamp(3)  - Blade 3 pitch damping constant *[unused for 2 blades]*
 ============================================= ======== ==================== ========================================================================================================================================================================================================
 
 

docs/source/user/api_change.rst

@@ -46,6 +46,8 @@ Degrees of Freedom
 
 **EdgeDOF**     - First edgewise blade mode DOF (flag)
 
+**PitchDOF**    - Blade pitch DOF (flag)
+
 **TeetDOF**     - Rotor-teeter DOF (flag) [unused for 3 blades]
 
 **DrTrDOF**     - Drivetrain rotational-flexibility DOF (flag)
@@ -179,6 +181,18 @@ Mass and Inertia
 
 **TipMass(3)**  - Tip-brake mass, blade 3 (kg) [unused for 2 blades]
 
+**PBrIner(1)**  - Pitch bearing/actuator inertia, blade 1 (kg m^2)
+
+**PBrIner(2)**  - Pitch bearing/actuator inertia, blade 2 (kg m^2)
+
+**PBrIner(3)**  - Pitch bearing/actuator inertia, blade 3 (kg m^2) [unused for 2 blades]
+
+**BlPIner(1)**  - Pitch inertia of an undeflected blade, blade 1 (kg m^2)
+
+**BlPIner(2)**  - Pitch inertia of an undeflected blade, blade 2 (kg m^2)
+
+**BlPIner(3)**  - Pitch inertia of an undeflected blade, blade 3 (kg m^2) [unused for 2 blades]
+
 **HubMass**     - Hub mass (kg)
 
 **HubIner**     - Hub inertia about rotor axis [3 blades] or teeter axis [2 blades] (kg m^2)

docs/source/user/elastodyn/input.rst

@@ -47,6 +47,45 @@ Pitch Control
 
    Time to enable active pitch control *[unused when* **PCMode==0** *]*
 
+**PitNeut(1)** [deg]
+
+   Blade 1 neutral pitch position--pitch spring moment is zero at this position
+   *[unused when* **PCMode>0** and **t>=TPCOn** *]*
+
+**PitNeut(2)** [deg]
+
+   Blade 2 neutral pitch position--pitch spring moment is zero at this position
+   *[unused when* **PCMode>0** and **t>=TPCOn** *]*
+
+**PitNeut(3)** [deg]
+
+   Blade 3 neutral pitch position--pitch spring moment is zero at this position
+   *[unused when* **PCMode>0** and **t>=TPCOn** *]* *[unused for 2 blades]*
+
+**PitSpr(1)** [N-m/rad]
+
+   Blade 1 pitch spring constant
+
+**PitSpr(2)** [N-m/rad]
+
+   Blade 2 pitch spring constant
+
+**PitSpr(3)** [N-m/rad]
+
+   Blade 3 pitch spring constant *[unused for 2 blades]*
+
+**PitDamp(1)** [N-m/(rad/s)]
+
+   Blade 1 pitch damping constant
+
+**PitDamp(2)** [N-m/(rad/s)]
+
+   Blade 2 pitch damping constant
+
+**PitDamp(3)** [N-m/(rad/s)]
+
+   Blade 3 pitch damping constant *[unused for 2 blades]*
+
 **TPitManS(1)** [sec]
 
    Time to start override pitch maneuver for blade 1 and end standard pitch