diff --git a/docs/source/user/api_change.rst b/docs/source/user/api_change.rst index b0600ac517..522c41702e 100644 --- a/docs/source/user/api_change.rst +++ b/docs/source/user/api_change.rst @@ -13,15 +13,56 @@ OpenFAST v4.0.3 to OpenFAST v4.1.0 ---------------------------------- Supercontroller module has been removed from FAST.Farm. -============================================= ==== =============== ======================================================================================================================================================================================================== +============================================= ==== ================== =============================================================================================================================================================================================================================================================================================================================================================================================================================================================== Removed in OpenFAST `v4.1.0` ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- -Module Line Flag Name Example Value -============================================= ==== =============== ======================================================================================================================================================================================================== -FAST.Farm 7 UseSC False UseSC - Use a super controller? (flag) -FAST.Farm 11 na --- SUPER CONTROLLER --- [used only for UseSC=True] -FAST.Farm 12 SC_FileName "SC_DLL.dll" SC_FileName Name/location of the dynamic library {.dll [Windows] or .so [Linux]} containing the Super Controller algorithms (quoted string) -============================================= ==== =============== ======================================================================================================================================================================================================== +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- +Module Line Flag Name Example Value +============================================= ==== ================== =============================================================================================================================================================================================================================================================================================================================================================================================================================================================== +FAST.Farm 7 UseSC False UseSC - Use a super controller? (flag) +FAST.Farm 11 na --- SUPER CONTROLLER --- [used only for UseSC=True] +FAST.Farm 12 SC_FileName "SC_DLL.dll" SC_FileName Name/location of the dynamic library {.dll [Windows] or .so [Linux]} containing the Super Controller algorithms (quoted string) +============================================= ==== ================== =============================================================================================================================================================================================================================================================================================================================================================================================================================================================== + +Line numbers are not provided in the table below because the line numbers can change depending on the number of entries in the input files. Please refer to the User Documentation on the input files for examples. + +============================================= ========= ================== =============================================================================================================================================================================================================================================================================================================================================================================================================================================================== +Added/Modified in OpenFAST `v4.1.0` +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ +Module Change Flag Name Example Value +============================================= ========= ================== =============================================================================================================================================================================================================================================================================================================================================================================================================================================================== +HydroDyn Modified na ---------------- CYLINDRICAL MEMBER CROSS-SECTION PROPERTIES ------------------- +HydroDyn Modified NPropSetsCyl 1 NPropSetsCyl - Number of cylindrical member property sets (-) +HydroDyn Added na ---------------- RECTANGULAR MEMBER CROSS-SECTION PROPERTIES ------------------- +HydroDyn Added NPropSetsRec 1 NPropSetsRec - Number of rectangular member property sets (-) +HydroDyn Added na PropSetID PropA PropB PropThck +HydroDyn Added na (-) (m) (m) (m) +HydroDyn Modified na -------- SIMPLE CYLINDRICAL-MEMBER HYDRODYNAMIC COEFFICIENTS (model 1) --------- +HydroDyn Added na -------- SIMPLE RECTANGULAR-MEMBER HYDRODYNAMIC COEFFICIENTS (model 1) --------- +HydroDyn Added na SimplCdA SimplCdAMG SimplCdB SimplCdBMG SimplCaA SimplCaAMG SimplCaB SimplCaBMG SimplCp SimplCpMG SimplAxCd SimplAxCdMG SimplAxCa SimplAxCaMG SimplAxCp SimplAxCpMG SimplCb SimplCbMG +HydroDyn Added na (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) +HydroDyn Modified na ------ DEPTH-BASED CYLINDRICAL-MEMBER HYDRODYNAMIC COEFFICIENTS (model 2) ------- +HydroDyn Modified NCoefDpthCyl 0 NCoefDpthCyl - Number of depth-dependent cylindrical member coefficients (-) +HydroDyn Added na ------ DEPTH-BASED RECTANGULAR-MEMBER HYDRODYNAMIC COEFFICIENTS (model 2) ------- +HydroDyn Added NCoefDpthRec 0 NCoefDpthRec - Number of depth-dependent rectangular member coefficients (-) +HydroDyn Added na Dpth DpthCdA DpthCdAMG DpthCdB DpthCdBMG DpthCaA DpthCaAMG DpthCaB DpthCaBMG DpthCp DpthCpMG DpthAxCd DpthAxCdMG DpthAxCa DpthAxCaMG DpthAxCp DpthAxCpMG DpthCb DpthCbMG +HydroDyn Added na `(m)` (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) +HydroDyn Modified na ------ MEMBER-BASED CYLINDRICAL-MEMBER HYDRODYNAMIC COEFFICIENTS (model 3) ------ +HydroDyn Modified NCoefMembersCyl 0 NCoefMembersCyl - Number of member-based cylindrical member coefficients (-) +HydroDyn Added na ------ MEMBER-BASED RECTANGULAR-MEMBER HYDRODYNAMIC COEFFICIENTS (model 3) ------ +HydroDyn Added NCoefMembersRec 0 NCoefMembersRec - Number of member-based rectangular member coefficients (-) +HydroDyn Added na MemberID MemberCdA1 MemberCdA2 MemberCdAMG1 MemberCdAMG2 MemberCdB1 MemberCdB2 MemberCdBMG1 MemberCdBMG2 MemberCaA1 MemberCaA2 MemberCaAMG1 MemberCaAMG2 MemberCaB1 MemberCaB2 MemberCaBMG1 MemberCaBMG2 MemberCp1 MemberCp2 MemberCpMG1 MemberCpMG2 MemberAxCd1 MemberAxCd2 MemberAxCdMG1 MemberAxCdMG2 MemberAxCa1 MemberAxCa2 MemberAxCaMG1 MemberAxCaMG2 MemberAxCp1 MemberAxCp2 MemberAxCpMG1 MemberAxCpMG2 MemberCb1 MemberCb2 MemberCbMG1 MemberCbMG2 +HydroDyn Added na (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) +HydroDyn Modified na MemberID MJointID1 MJointID2 MPropSetID1 MPropSetID2 MSecGeom MSpinOrient MDivSize MCoefMod MHstLMod PropPot [MCoefMod=1: use simple coeff table, 2: use depth-based coeff table, 3: use member-based coeff table] [PropPot/=0 if member is modeled with potential-flow theory] +HydroDyn Modified na (-) (-) (-) (-) (-) (switch) (deg) (m) (switch) (switch) (flag) +SubDyn Modified na MemberID MJointID1 MJointID2 MPropSetID1 MPropSetID2 MType MSpin/COSMID ![MType={1c:beam circ., 1r:beam rect., 2:cable, 3:rigid, 4:beam arb., 5:spring}. COMSID={-1:none}] +SubDyn Modified na (-) (-) (-) (-) (-) (-) (deg/-) +SubDyn Added na ----------------- RECTANGULAR BEAM CROSS-SECTION PROPERTIES --------------------------- +SubDyn Added na 0 NPropSets - Number of structurally unique cross-sections (if 0 the following table is ignored) +SubDyn Added na PropSetID YoungE ShearG MatDens XsecSa XsecSb XsecT +SubDyn Added na (-) (N/m2) (N/m2) (kg/m3) (m) (m) (m) +SubDyn Modified na PropSetID YoungE ShearG MatDens XsecA XsecAsx XsecAsy XsecJxx XsecJyy XsecJ0 XsecJt +SubDyn Modified na (-) (N/m2) (N/m2) (kg/m3) (m2) (m2) (m2) (m4) (m4) (m4) (m4) +============================================= ========= ================== =============================================================================================================================================================================================================================================================================================================================================================================================================================================================== OpenFAST v4.0.3 to OpenFAST v4.0.4 diff --git a/docs/source/user/hydrodyn/appendix.rst b/docs/source/user/hydrodyn/appendix.rst index b58c4717b9..558914dbaf 100644 --- a/docs/source/user/hydrodyn/appendix.rst +++ b/docs/source/user/hydrodyn/appendix.rst @@ -120,24 +120,36 @@ structure:: 42 14.43376 25.00000 -19.94000 1 0 43 -28.86751 0.00000 -19.94000 1 0 44 14.43376 -25.00000 -19.94000 1 0 - ---------------------- MEMBER CROSS-SECTION PROPERTIES ------------------------- - 4 NPropSets - Number of member property sets (-) + ---------------- CYLINDRICAL MEMBER CROSS-SECTION PROPERTIES ------------------- + 4 NPropSetsCyl - Number of cylindrical member property sets (-) PropSetID PropD PropThck (-) (m) (m) 1 6.50000 0.03000 ! Main Column 2 12.00000 0.06000 ! Upper Columns 3 24.00000 0.06000 ! Base Columns 4 1.60000 0.01750 ! Pontoons - ---------------------- SIMPLE HYDRODYNAMIC COEFFICIENTS (model 1) -------------- + ---------------- RECTANGULAR MEMBER CROSS-SECTION PROPERTIES ------------------- + 0 NPropSetsRec - Number of rectangular member property sets (-) + MPropSetID PropA PropB PropThck + (-) (m) (m) (m) + -------- SIMPLE CYLINDRICAL-MEMBER HYDRODYNAMIC COEFFICIENTS (model 1) --------- SimplCd SimplCdMG SimplCa SimplCaMG SimplCp SimplCpMG SimplAxCd SimplAxCdMG SimplAxCa SimplAxCaMG SimplAxCp SimplAxCpMG SimplCb SimplCbMG (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) 0.00 0.00 0.00 0.00 1.00 1.00 0.00 0.00 0.00 0.00 1.00 1.00 1.00 1.00 - ---------------------- DEPTH-BASED HYDRODYNAMIC COEFFICIENTS (model 2) --------- - 0 NCoefDpth - Number of depth-dependent coefficients (-) + -------- SIMPLE RECTANGULAR-MEMBER HYDRODYNAMIC COEFFICIENTS (model 1) --------- + SimplCdA SimplCdAMG SimplCdB SimplCdBMG SimplCaA SimplCaAMG SimplCaB SimplCaBMG SimplCp SimplCpMG SimplAxCd SimplAxCdMG SimplAxCa SimplAxCaMG SimplAxCp SimplAxCpMG SimplCb SimplCbMG + (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) + 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 1.0 1.0 + ------ DEPTH-BASED CYLINDRICAL-MEMBER HYDRODYNAMIC COEFFICIENTS (model 2) ------- + 0 NCoefDpthCyl - Number of depth-dependent cylindrical member coefficients (-) Dpth DpthCd DpthCdMG DpthCa DpthCaMG DpthCp DpthCpMG DpthAxCd DpthAxCdMG DpthAxCa DpthAxCaMG DpthAxCp DpthAxCpMG DpthCb DpthCbMG (m) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) - ---------------------- MEMBER-BASED HYDRODYNAMIC COEFFICIENTS (model 3) -------- - 25 NCoefMembers - Number of member-based coefficients (-) + ------ DEPTH-BASED RECTANGULAR-MEMBER HYDRODYNAMIC COEFFICIENTS (model 2) ------- + 0 NCoefDpthRec - Number of depth-dependent rectangular member coefficients (-) + Dpth DpthCdA DpthCdAMG DpthCdB DpthCdBMG DpthCaA DpthCaAMG DpthCaB DpthCaBMG DpthCp DpthCpMG DpthAxCd DpthAxCdMG DpthAxCa DpthAxCaMG DpthAxCp DpthAxCpMG DpthCb DpthCbMG + (m) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) + ------ MEMBER-BASED CYLINDRICAL-MEMBER HYDRODYNAMIC COEFFICIENTS (model 3) ------ + 25 NCoefMembersCyl - Number of member-based cylindrical member coefficients (-) MemberID MemberCd1 MemberCd2 MemberCdMG1 MemberCdMG2 MemberCa1 MemberCa2 MemberCaMG1 MemberCaMG2 MemberCp1 MemberCp2 MemberCpMG1 MemberCpMG2 MemberAxCd1 MemberAxCd2 MemberAxCdMG1 MemberAxCdMG2 MemberAxCa1 MemberAxCa2 MemberAxCaMG1 MemberAxCaMG2 MemberAxCp1 MemberAxCp2 MemberAxCpMG1 MemberAxCpMG2 MemberCb1 MemberCb2 MemberCbMG1 MemberCbMG2 (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) 1 0.56 0.56 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 1.00 1.00 1.00 1.00 ! Main Column @@ -165,35 +177,39 @@ structure:: 20 0.63 0.63 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 1.00 1.00 1.00 1.00 ! Cross Brace 1 21 0.63 0.63 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 1.00 1.00 1.00 1.00 ! Cross Brace 2 22 0.63 0.63 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 1.00 1.00 1.00 1.00 ! Cross Brace 3 + ------ MEMBER-BASED RECTANGULAR-MEMBER HYDRODYNAMIC COEFFICIENTS (model 3) ------ + 0 NCoefMembersRec - Number of member-based rectangular member coefficients (-) + MemberID MemberCdA1 MemberCdA2 MemberCdAMG1 MemberCdAMG2 MemberCdB1 MemberCdB2 MemberCdBMG1 MemberCdBMG2 MemberCaA1 MemberCaA2 MemberCaAMG1 MemberCaAMG2 MemberCaB1 MemberCaB2 MemberCaBMG1 MemberCaBMG2 MemberCp1 MemberCp2 MemberCpMG1 MemberCpMG2 MemberAxCd1 MemberAxCd2 MemberAxCdMG1 MemberAxCdMG2 MemberAxCa1 MemberAxCa2 MemberAxCaMG1 MemberAxCaMG2 MemberAxCp1 MemberAxCp2 MemberAxCpMG1 MemberAxCpMG2 MemberCb1 MemberCb2 MemberCbMG1 MemberCbMG2 + (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) -------------------- MEMBERS ------------------------------------------------- 25 NMembers - Number of members (-) - MemberID MJointID1 MJointID2 MPropSetID1 MPropSetID2 MDivSize MCoefMod MHstLMod PropPot [MCoefMod=1: use simple coeff table, 2: use depth-based coeff table, 3: use member-based coeff table] [ PropPot/=0 if member is modeled with potential-flow theory] - (-) (-) (-) (-) (-) (m) (switch) (switch) (flag) - 1 1 2 1 1 1.0000 3 1 TRUE ! Main Column - 2 3 4 2 2 1.0000 3 1 TRUE ! Upper Column 1 - 3 5 6 2 2 1.0000 3 1 TRUE ! Upper Column 2 - 4 7 8 2 2 1.0000 3 1 TRUE ! Upper Column 3 - 5 42 3 3 3 1.0000 3 1 TRUE ! Base Column 1 - 6 43 5 3 3 1.0000 3 1 TRUE ! Base Column 2 - 7 44 7 3 3 1.0000 3 1 TRUE ! Base Column 3 - 23 9 42 3 3 1.0000 3 1 TRUE ! Base column cap 1 - 24 10 43 3 3 1.0000 3 1 TRUE ! Base column cap 2 - 25 11 44 3 3 1.0000 3 1 TRUE ! Base column cap 3 - 8 12 13 4 4 1.0000 3 1 TRUE ! Delta Pontoon, Upper 1 - 9 14 15 4 4 1.0000 3 1 TRUE ! Delta Pontoon, Upper 2 - 10 16 17 4 4 1.0000 3 1 TRUE ! Delta Pontoon, Upper 3 - 11 18 19 4 4 1.0000 3 1 TRUE ! Delta Pontoon, Lower 1 - 12 20 21 4 4 1.0000 3 1 TRUE ! Delta Pontoon, Lower 2 - 13 22 23 4 4 1.0000 3 1 TRUE ! Delta Pontoon, Lower 3 - 14 24 25 4 4 1.0000 3 1 TRUE ! Y Pontoon, Upper 1 - 15 26 27 4 4 1.0000 3 1 TRUE ! Y Pontoon, Upper 2 - 16 28 29 4 4 1.0000 3 1 TRUE ! Y Pontoon, Upper 3 - 17 30 31 4 4 1.0000 3 1 TRUE ! Y Pontoon, Lower 1 - 18 32 33 4 4 1.0000 3 1 TRUE ! Y Pontoon, Lower 2 - 19 34 35 4 4 1.0000 3 1 TRUE ! Y Pontoon, Lower 3 - 20 36 37 4 4 1.0000 3 1 TRUE ! Cross Brace 1 - 21 38 39 4 4 1.0000 3 1 TRUE ! Cross Brace 2 - 22 40 41 4 4 1.0000 3 1 TRUE ! Cross Brace 3 + MemberID MJointID1 MJointID2 MPropSetID1 MPropSetID2 MSecGeom MSpinOrient MDivSize MCoefMod MHstLMod PropPot [MCoefMod=1: use simple coeff table, 2: use depth-based coeff table, 3: use member-based coeff table] [ PropPot/=0 if member is modeled with potential-flow theory] + (-) (-) (-) (-) (-) (switch) (deg) (m) (switch) (switch) (flag) + 1 1 2 1 1 1 0 1.0000 3 1 TRUE ! Main Column + 2 3 4 2 2 1 0 1.0000 3 1 TRUE ! Upper Column 1 + 3 5 6 2 2 1 0 1.0000 3 1 TRUE ! Upper Column 2 + 4 7 8 2 2 1 0 1.0000 3 1 TRUE ! Upper Column 3 + 5 42 3 3 3 1 0 1.0000 3 1 TRUE ! Base Column 1 + 6 43 5 3 3 1 0 1.0000 3 1 TRUE ! Base Column 2 + 7 44 7 3 3 1 0 1.0000 3 1 TRUE ! Base Column 3 + 23 9 42 3 3 1 0 1.0000 3 1 TRUE ! Base column cap 1 + 24 10 43 3 3 1 0 1.0000 3 1 TRUE ! Base column cap 2 + 25 11 44 3 3 1 0 1.0000 3 1 TRUE ! Base column cap 3 + 8 12 13 4 4 1 0 1.0000 3 1 TRUE ! Delta Pontoon, Upper 1 + 9 14 15 4 4 1 0 1.0000 3 1 TRUE ! Delta Pontoon, Upper 2 + 10 16 17 4 4 1 0 1.0000 3 1 TRUE ! Delta Pontoon, Upper 3 + 11 18 19 4 4 1 0 1.0000 3 1 TRUE ! Delta Pontoon, Lower 1 + 12 20 21 4 4 1 0 1.0000 3 1 TRUE ! Delta Pontoon, Lower 2 + 13 22 23 4 4 1 0 1.0000 3 1 TRUE ! Delta Pontoon, Lower 3 + 14 24 25 4 4 1 0 1.0000 3 1 TRUE ! Y Pontoon, Upper 1 + 15 26 27 4 4 1 0 1.0000 3 1 TRUE ! Y Pontoon, Upper 2 + 16 28 29 4 4 1 0 1.0000 3 1 TRUE ! Y Pontoon, Upper 3 + 17 30 31 4 4 1 0 1.0000 3 1 TRUE ! Y Pontoon, Lower 1 + 18 32 33 4 4 1 0 1.0000 3 1 TRUE ! Y Pontoon, Lower 2 + 19 34 35 4 4 1 0 1.0000 3 1 TRUE ! Y Pontoon, Lower 3 + 20 36 37 4 4 1 0 1.0000 3 1 TRUE ! Cross Brace 1 + 21 38 39 4 4 1 0 1.0000 3 1 TRUE ! Cross Brace 2 + 22 40 41 4 4 1 0 1.0000 3 1 TRUE ! Cross Brace 3 ---------------------- FILLED MEMBERS ------------------------------------------ 2 NFillGroups - Number of filled member groups (-) [If FillDens = DEFAULT, then FillDens = WtrDens; FillFSLoc is related to MSL2SWL] FillNumM FillMList FillFSLoc FillDens diff --git a/docs/source/user/hydrodyn/input_files.rst b/docs/source/user/hydrodyn/input_files.rst index 49c0593d60..b93aaa8035 100644 --- a/docs/source/user/hydrodyn/input_files.rst +++ b/docs/source/user/hydrodyn/input_files.rst @@ -618,103 +618,52 @@ water depth results in static pressure loads being applied. Member Cross-Sections --------------------- -Members in HydroDyn are assumed to be straight circular (and possibly -tapered) cylinders. Apart from the hydrodynamic coefficients, the -circular cross-section properties needed for the hydrodynamic load -calculations are member outer diameter, **PropD**, and member thickness, -**PropThck**. You will need to create an entry in this table, -distinguished by **PropSetID**, for each unique combination of these two -properties. The member property-set table contains **NPropSets** rows. -The member property sets are referred to by their **PropSetID** in the -MEMBERS table, as described in :numref:`hd-members` below. **PropD** -determines the static buoyancy loads exterior to a member, as well as -the area used in the viscous-drag calculation and the volume used in the -added-mass and fluid-inertia calculations. **PropThck** determines the -interior volume for fluid-filled (flooded/ballasted) members. +Members in HydroDyn are assumed to be straight with either a circular cross section or a rectangular cross section. In either case, tapering is allowed, including independent tapering of the two sides of a member with rectangular cross sections. However, twisting of rectangular members is not allowed, and the four side walls of the member must remain planar. + +The HydroDyn primary input file contains two separate sections for member cross-section properties. The first section is for circular sections, and the second one is for rectangular sections. + +In the first section labeled CYLINDRICAL MEMBER CROSS-SECTION PROPERTIES, **NPropSetsCyl** different section defintions can be entered, with each section definition on a separate line identified by its **PropSetID**. The **PropSetID** is used in the MEMBERS table, as described in :numref:`hd-members` below. For each section definition, the user needs to provide the member outer diameter, **PropD**, and member wall thickness, **PropThck**. **PropD** determines the static buoyancy loads exterior to a member, as well as the area used in the viscous-drag calculation and the volume used in the added-mass and fluid-inertia load calculations. **PropThck** determines the interior volume for fluid-filled (flooded/ballasted) members. + +In the second section labeled RECTANGULAR MEMBER CROSS-SECTION PROPERTIES, **NPropSetsRec** different section definitions can be entered, with each section definition on a separate line identified by its **PropSetID**. The **PropSetID** is referenced in the MEMBERS table, as described in :numref:`hd-members` below. For each section definition, the user needs to provide the member outer side lengths of the rectangular section. **PropA** is the outer length of Side A, and **PropB** is the outer length of Side B (see :numref:`hd-members` on how the two sides are identified). **PropThck** is again the section wall thickness. Currently, we assume the four side walls of each rectangular section have the same uniform wall thickness, so only one **PropThck** can be specified for each rectangular section. + +Note that the **PropSetID** for circular and rectangular sections are independent. For instance, it is allowed to have a circular section and a rectangular section both having the same **PropSetID**. Depending on the section shape specified for each member, HydroDyn will look up the correct section properties. Hydrodynamic Coefficients ------------------------- -HydroDyn computes distributed viscous-drag, added-mass, fluid-inertia, -and static buoyancy loads along members. - -The hydrodynamic coefficients for the distributed strip-theory loads are -specified using any of three models, which we refer to as the simple -model, a depth-based model, and a member-based model. All of these -models require the specification of both transverse and axial -hydrodynamic coefficients for viscous drag, added mass, and dynamic -pressure. The added-mass -coefficient influences both the added-mass loads and the scattering -component of the fluid-inertia loads. There are separate set of -hydrodynamic coefficients both with and without marine growth. A given -element will either use the marine growth or the standard version of a -coefficient, but never both. Note that input members are split into -elements, one of the splitting rules guarantees the -previous statement is true. Which members have marine growth is defined -by the MARINE GROWTH table of :numref:`hd-marine-growth`. You can specify only one -model type, **MCoefMod**, for any given member in the MEMBERS table. -However, different members can specify different coefficient models. +HydroDyn computes distributed viscous-drag, added-mass, fluid-inertia, and static buoyancy loads along members. + +The hydrodynamic coefficients for the distributed strip-theory loads are specified using any of the three available models, which we refer to as the simple model (model 1), a depth-based model (model 2), and a member-based model (model 3). All of these models require the specification of both transverse and axial hydrodynamic coefficients for viscous drag, added mass, and dynamic pressure. The added-mass coefficient influences both the added-mass loads and the scattering component of the fluid-inertia loads. There are two separate sets of hydrodynamic coefficients with one set for the part of a member with marine growth and the other for the part without. Which members have marine growth is defined by the MARINE GROWTH table of :numref:`hd-marine-growth`. You can specify only one model type (**MCoefMod** = 1, 2, or 3) for any given member in the MEMBERS table. However, different members can use different coefficient models. .. elements per Section 7.5.2, one of the splitting rules guarantees the .. TODO 7.5.2 is the theory section which does not yet exist. -In the hydrodynamic coefficient input parameters, **Cd**, **Ca**, and -**Cp** refer to the viscous-drag, added-mass, and dynamic-pressure -coefficients, respectively. **MG** identifies the coefficients to be -applied for members with marine growth (the standard values are -identified without **MG**), and **Ax** identifies the axial coefficients -to be applied for tapered members (the transverse coefficients are -identified without **Ax**). The **Cb** coefficients allow the user to -scale the hydrostatic load for, e.g., non-circular member cross sections. -To avoid unphysical hydrostatic loads, the **Cb** coefficients are not -used to directly scale the distributed hydrostatic load. Instead, the -local member diameter (with marine growth if specified) is scaled by -the square root of **Cb** when computing the hydrostatic load. This -scaling also affects the hydrostatic load on member endplates for -consistency. - -While the strip-theory solution assumes circular cross sections, the -hydrodynamic coefficients can include shape corrections; however, there -is no distinction made in HydroDyn between different transverse -directions. - -Simple Model -++++++++++++ -This table consists of a single complete set of hydrodynamic -coefficients as follows: **SimplCd**, **SimplCdMG**, **SimplCa**, -**SimplCaMG**, **SimplCp**, **SimplCpMG**, **SimplAxCa**, -**SimplAxCaMG**, **SimplAxCp**, and **SimplAxCpMG**. These hydrodynamic -coefficients are referenced in the members table of :numref:`hd-members` by -selecting **MCoefMod** = 1. - -Depth-Based Model -+++++++++++++++++ -The depth-based coefficient model allows you to specify a series of -depth-dependent coefficients. **NCoefDpth** is the user-specified number -of depths and determines the number of rows in the subsequent table. -Currently, this table requires that the rows are ordered by increasing -depth, **Dpth**; this is equivalent to a decreasing global -*Z*-coordinate. The hydrodynamic coefficients at each depth are as -follows: **DpthCd**, **DpthCdMG**, **DpthCa**, **DpthCaMG**, **DpthCp**, -**DpthCpMG**, **DpthAxCa**, **DpthAxCaMG**, **DpthAxCp**, and -**DpthAxCpMG**. Members use these hydrodynamic coefficients by setting -**MCoefMod** = 2. The HydroDyn module will interpolate coefficients for -a node whose *Z*-coordinate lies between table *Z*-coordinates. - -Member-Based Model -++++++++++++++++++ -The member-based coefficient model allows you to specify a hydrodynamic -coefficients for each particular member. **NCoefMembers** is the -user-specified number of members with member-based coefficients and -determines the number of rows in the subsequent table. The hydrodynamic -coefficients for a member distinguished by **MemberID** are as follows: -**MemberCd1**, **MemberCd2**, **MemberCdMG1**, **MemberCdMG2**, -**MemberCa1**, **MemberCa2**, **MemberCaMG1**, **MemberCaMG2**, -**MemberCp1**, **MemberCp2**, **MemberCpMG1**, **MemberCpMG2**, -**MemberAxCa1**, **MemberAxCa2**, **MemberAxCaMG1**, **MemberAxCaMG2**, -**MemberAxCp1**, **MemberAxCp2**, **MemberAxCpMG1**, and -**MemberAxCpMG2**, where *1* and *2* identify the starting and ending -joint of the member, respectively. Members use these hydrodynamic -coefficients by setting **MCoefMod** = 3. +In the hydrodynamic coefficient tables, **Cd**, **Ca**, and **Cp** refer to the viscous-drag, added-mass, and dynamic-pressure coefficients, respectively. For circular sections, these coefficients apply to loads in any radial direction due to axisymmetry. For rectangular sections, two sets of transverse **Cd** and **Ca** coefficients must be provided, with one set having the letter "A" appended for load components normal to Side A of the section (e.g., **CdA**) and the other with the letter "B" appended for load components normal to Side B of the section (e.g., **CaB**). Note that only the transverse **Cd** and **Ca** (with and without marine growth) make a distinction between the two transverse directions of rectangular sections. None of the other coefficients make this distinction. **MG** identifies the coefficients to be applied on member sections with marine growth (the standard values are identified without **MG**), and **Ax** identifies the axial coefficients to be applied for tapered members (the transverse coefficients are identified without **Ax**). The **Cb** coefficients allow the user to scale the hydrostatic load for, e.g., non-circular and non-rectangular member cross sections. To avoid unphysical hydrostatic loads, the **Cb** coefficients are not used to directly scale the distributed hydrostatic load. Instead, the local member diameter or side lengths (with marine growth if specified) are scaled by the square root of **Cb** when computing the hydrostatic loads. This scaling also affects the hydrostatic loads on member endplates for consistency. While the strip-theory solution assumes either a circular or a rectangular cross section, the hydrodynamic coefficients can include shape corrections. + +For each of the three available coefficient models, there are two separate input sections with the first one for circular sections and the second for rectangular sections. These are explained below. + +Simple Model for Circular Sections +++++++++++++++++++++++++++++++++++ +This table consists of a single complete set of hydrodynamic coefficients for circular sections as follows: **SimplCd**, **SimplCdMG**, **SimplCa**, **SimplCaMG**, **SimplCp**, **SimplCpMG**, **SimplAxCd**, **SimplAxCdMG**, **SimplAxCa**, **SimplAxCaMG**, **SimplAxCp**, **SimplAxCpMG**, **SimplCb**, and **SimplCbMG**. These hydrodynamic coefficients are referenced in the MEMBERS table of :numref:`hd-members` by selecting **MCoefMod** = 1. + +Simple Model for Rectangular Sections ++++++++++++++++++++++++++++++++++++++ +This table consists of a single complete set of hydrodynamic coefficients for rectangular sections as follows: **SimplCdA**, **SimplCdAMG**, **SimplCdB**, **SimplCdBMG**, **SimplCaA**, **SimplCaAMG**, **SimplCaB**, **SimplCaBMG**, **SimplCp**, **SimplCpMG**, **SimplAxCd**, **SimplAxCdMG**, **SimplAxCa**, **SimplAxCaMG**, **SimplAxCp**, **SimplAxCpMG**, **SimplCb**, and **SimplCbMG**. These hydrodynamic coefficients are referenced in the MEMBERS table of :numref:`hd-members` by selecting **MCoefMod** = 1. + +Depth-Based Model for Circular Sections ++++++++++++++++++++++++++++++++++++++++ +The depth-based coefficient model allows you to specify a series of depth-dependent coefficients for circular sections. **NCoefDpthCyl** is the user-specified number of depths and determines the number of rows in the subsequent table. Currently, this table requires that the rows are ordered by increasing depth, **Dpth**; this is equivalent to a decreasing global *Z*-coordinate. The hydrodynamic coefficients at each depth are as follows: **DpthCd**, **DpthCdMG**, **DpthCa**, **DpthCaMG**, **DpthCp**, **DpthCpMG**, **DpthAxCd**, **DpthAxCdMG**, **DpthAxCa**, **DpthAxCaMG**, **DpthAxCp**, **DpthAxCpMG**, **DpthCb**, and **DpthCbMG**. Members use these hydrodynamic coefficients by setting **MCoefMod** = 2. The HydroDyn module will linearly interpolate coefficients for a node whose *Z*-coordinate lies between table *Z*-coordinates. + +Depth-Based Model for Rectangular Sections +++++++++++++++++++++++++++++++++++++++++++ +The depth-based coefficient model allows you to specify a series of depth-dependent coefficients for rectangular sections. **NCoefDpthRec** is the user-specified number of depths and determines the number of rows in the subsequent table. Currently, this table requires that the rows are ordered by increasing depth, **Dpth**; this is equivalent to a decreasing global *Z*-coordinate. The hydrodynamic coefficients at each depth are as follows: **DpthCdA**, **DpthCdAMG**, **DpthCdB**, **DpthCdBMG**, **DpthCaA**, **DpthCaAMG**, **DpthCaB**, **DpthCaBMG**, **DpthCp**, **DpthCpMG**, **DpthAxCd**, **DpthAxCdMG**, **DpthAxCa**, **DpthAxCaMG**, **DpthAxCp**, **DpthAxCpMG**, **DpthCb**, and **DpthCbMG**. Members use these hydrodynamic coefficients by setting **MCoefMod** = 2. The HydroDyn module will linearly interpolate coefficients for a node whose *Z*-coordinate lies between table *Z*-coordinates. + +Member-Based Model for Circular Sections +++++++++++++++++++++++++++++++++++++++++ +The member-based coefficient model allows you to specify a set of hydrodynamic coefficients for each member. **NCoefMembersCyl** is the user-specified number of members with member-based coefficients and determines the number of rows in the subsequent table. The hydrodynamic coefficients for a member distinguished by **MemberID** are as follows: **MemberCd1**, **MemberCd2**, **MemberCdMG1**, **MemberCdMG2**, **MemberCa1**, **MemberCa2**, **MemberCaMG1**, **MemberCaMG2**, **MemberCp1**, **MemberCp2**, **MemberCpMG1**, **MemberCpMG2**, **MemberAxCd1**, **MemberAxCd2**, **MemberAxCdMG1**, **MemberAxCdMG2**, **MemberAxCa1**, **MemberAxCa2**, **MemberAxCaMG1**, **MemberAxCaMG2**, **MemberAxCp1**, **MemberAxCp2**, **MemberAxCpMG1**, **MemberAxCpMG2**, **MemberCb1**, **MemberCb2**, **MemberCbMG1**, and **MemberCbMG2**, where *1* and *2* identify the starting and ending joint of the member, respectively. Members use these hydrodynamic coefficients by setting **MCoefMod** = 3. + +Member-Based Model for Rectangular Sections ++++++++++++++++++++++++++++++++++++++++++++ +The member-based coefficient model allows you to specify a set of hydrodynamic coefficients for each member. **NCoefMembersRec** is the user-specified number of members with member-based coefficients and determines the number of rows in the subsequent table. The hydrodynamic coefficients for a member distinguished by **MemberID** are as follows: **MemberCdA1**, **MemberCdA2**, **MemberCdAMG1**, **MemberCdAMG2**, **MemberCdB1**, **MemberCdB2**, **MemberCdBMG1**, **MemberCdBMG2**, **MemberCaA1**, **MemberCaA2**, **MemberCaAMG1**, **MemberCaAMG2**, **MemberCaB1**, **MemberCaB2**, **MemberCaBMG1**, **MemberCaBMG2**, **MemberCp1**, **MemberCp2**, **MemberCpMG1**, **MemberCpMG2**, **MemberAxCd1**, **MemberAxCd2**, **MemberAxCdMG1**, **MemberAxCdMG2**, **MemberAxCa1**, **MemberAxCa2**, **MemberAxCaMG1**, **MemberAxCaMG2**, **MemberAxCp1**, **MemberAxCp2**, **MemberAxCpMG1**, **MemberAxCpMG2**, **MemberCb1**, **MemberCb2**, **MemberCbMG1**, and **MemberCbMG2**, where *1* and *2* identify the starting and ending joint of the member, respectively. Members use these hydrodynamic coefficients by setting **MCoefMod** = 3. MacCamy-Fuchs diffraction load model ++++++++++++++++++++++++++++++++++++ @@ -741,6 +690,8 @@ diameter. To ensure it is approximately applicable while still allowing for some flexibility, some constraints are placed on members when applying the MacCamy-Fuchs model: +* The member must have a circular cross section. + * The member must be surface-piercing at least when the structure is undisplaced in calm water. * The member must be nearly vertical with an inclination from vertical less than 10 deg. @@ -760,61 +711,22 @@ the available wave-stretching models. Members ------- -**NMembers** is the user-specified number of members and determines the -number of rows in the subsequent table. For each member distinguished by -**MemberID**, **MJointID1** specifies the starting joint and -**MJointID2** specifies the ending joint, corresponding to an identifier -(**JointID**) from the MEMBER JOINTS table. Likewise, **MPropSetID1** -corresponds to the starting cross-section properties and **MProSetID2** -specify the ending cross-section properties, allowing for tapered -members. **MDivSize** determines the maximum spacing (in meters) between -simulation nodes where the distributed loads are actually computed; the -smaller the number, the finer the resolution and longer the -computational time. Each member in your model will have hydrodynamic -coefficients, which are specified using one of the three models (**MCoefMod**). -Model 1 uses a single set of coefficients found in the SIMPLE HYDRODYNAMIC -COEFFICIENTS section. Model 2 is depth-based, and is determined via the table found -in the DEPTH-BASED HYDRODYNAMIC COEFFICIENTS section. Model 3 specifies -coefficients for a particular member, by referring to the MEMBER-BASED -HYDRODYNAMIC COEFFICIENTS section. The **MHstLMod** switch controls the -computation of hydrostatic loads on strip-theory members when **PropPot** -= FALSE. Setting **MHstLMod** to 0 disables hydrostatic load. If set to 1, -hydrostatic loads will be computed analytically. This approach is efficient, -but it only works for fully submerged or surface-piercing members -that are far from horizontal without partially wetted endplates. -For nearly horizontal members close to the free surface or members that experience -partially wetted endplates, a semi-numerical approach for hydrostatic load -can be selected by setting **MHstLMod** to 2. This approach works with any -member positioning in relation to the free surface at the cost of slightly -longer computing time. The **PropPot** flag indicates whether the corresponding -member coincides with the body represented by the potential-flow solution. -When **PropPot** = TRUE, only viscous-drag loads and ballasting loads will -be computed for that member. +**NMembers** is the user-specified number of members and determines the number of rows in the subsequent table. For each member distinguished by **MemberID**, **MJointID1** specifies the starting joint, and **MJointID2** specifies the ending joint, corresponding to an identifier (**JointID**) from the MEMBER JOINTS table. Likewise, **MPropSetID1** corresponds to the starting cross-section properties, and **MProSetID2** specify the ending cross-section properties, allowing for tapered members. **MSecGeom** indicates the cross-section shape of the member. It can be set to either 1 for circular cross section or 2 for rectangular cross section. Depending on **MSecGeom**, **MPropSetID1** and **MPropSetID2** either refer to entries in the CYLINDRICAL MEMBER CROSS-SECTION PROPERTIES table or the RECTANGULAR MEMBER CROSS-SECTION PROPERTIES table. **MSpinOrient** is an angle in degrees that specifies the spin orientation of each member, i.e., the rotation about the member axis. When **MSpinOrient** = 0, Side A of a rectangular section referenced in previous sections is parallel to the horizontal plane. If the member is perfectly vertical, Side A is parallel to the global *X*-axis when **MSpinOrient** = 0. Setting **MSpinOrient** to a nonzero value will rotate the member about its axis (pointing from the starting joint to the ending joint) following the right-hand convention by the prescribed angle. **MSpinOrient** should be specified for both members with rectangular cross sections and members with circular cross sections; however, it has no effect on the latter. **MDivSize** determines the maximum spacing (in meters) between simulation nodes where the distributed loads are actually computed; the smaller the number, the finer the resolution and longer the computational time. + +Each member in your model will have hydrodynamic coefficients, which are specified using one of the three models (**MCoefMod**). Model 1 uses a single set of coefficients found in the SIMPLE HYDRODYNAMIC COEFFICIENTS sections. Model 2 is depth-based, and is determined via the table found in the DEPTH-BASED HYDRODYNAMIC COEFFICIENTS sections. Model 3 specifies coefficients for a particular member, by referring to the MEMBER-BASED HYDRODYNAMIC COEFFICIENTS sections. Depending on **MSecGeom**, HydroDyn will either use the hydrodynamic coefficients from the input tables for circular sections or rectangular sections as appropriate. The **MHstLMod** switch controls the computation of hydrostatic loads on strip-theory members when **PropPot** = FALSE. Setting **MHstLMod** to 0 disables hydrostatic load. If set to 1, hydrostatic loads will be computed analytically. This approach is efficient, but it only works for fully submerged or surface-piercing members that are far from horizontal without partially wetted endplates. For nearly horizontal members close to the free surface or members that experience partially wetted endplates, a semi-numerical approach for hydrostatic load can be selected by setting **MHstLMod** to 2. This approach works with any member positioning in relation to the free surface at the cost of slightly longer computing time. Note that for members with rectangular cross sections, **MHstLMod** must be either 0 or 2. The analytical approach with **MHstLMod** set to 1 is not available for rectangular members. The **PropPot** flag indicates whether the corresponding member is included in the potential-flow solution. When **PropPot** = TRUE, only viscous-drag loads and ballasting loads will be computed for that member, with the assumption that all other load components are already included in the potential-flow solution. .. TODO 7.5.2 is the theory section which does not yet exist. .. Section 7.5.2 discusses the difference between the user-supplied discretization and the simulation discretization. Filled Members -------------- -Members—whether they are also modeled with potential-flow or not—may be -fluid-filled, meaning that they are flooded and/or ballasted. -Fluid-filled members introduce interior buoyancy that subtracts from the -exterior buoyancy and a mass. Both distributed loads along a member and -lumped loads at joints are applied. The volume of fluid in the member is -derived from the outer diameter and thickness of the member and a -fluid-filled free-surface level. The fluid in the member is assumed to -be compartmentalized such that it does not slosh. Rotational inertia of -the fluid in the member is ignored. A member’s filled configuration is -defined by the filled-fluid density and the free-surface level. Filled -members that have the same configuration are collected into fill groups. - -**NFillGroups** specifies the number of fluid-filled member groups and -determines the number of rows in the subsequent table. **FillNumM** -specifies the number of members in the fill group. **FillMList** is a -list of **FillNumM** whitespace-separated **MemberID**\ s. **FillFSLoc** -specifies the *Z*-height of the free-surface (0 for MSL). **FillDens** -is the density of the fluid. If **FillDens** = DEFAULT, then -**FillDens** = **WtrDens**. +Members—whether they are also modeled with potential-flow or not—may be fluid-filled, meaning that they are flooded and/or ballasted. The internal fluid introduces hydrostatic pressure on the inner wall(s) of a flooded/ballasted member. It also adds mass and moment of inertia to the member. Both distributed loads along a member and lumped loads at joints/endplates are applied. + +The volume of fluid in a flooded member is derived from the outer diameter/side lengths and the wall thickness of the member and a fluid-filled level. The member is either partially flooded from the lower end joint to the fluid-filled level, if the fluid-filled level is in the middle of the member, or fully flooded, if the fluid-filled level is above the top end joint of the member. In either case, a watertight bulkhead normal to the member centerline is assumed to bound the filled section of a member on either end, so there is no internal free surface nor sloshing. Furthermore, the fluid in the member is assumed to be compartmentalized such that it moves with the member in a rigid-body fashion for the purpose of computing inertial loads on the member. However, when computing the internal hydrostatic pressure, we do not assume the compartmentalization to be watertight. Therefore, the entire filled volume of a member share a single contiguous hydrostatic pressure field. As an example, a consequence of this modeling assumption is that the weight of all ballast water inside a perfectly vertical untapered spar will rest solely on the bottom endplate of the spar instead of being distributed along the spar. + +Furthermore, we introduce the concept of filled member groups with each group potentially containing multiple members. The internal flooded volumes of all members belonging to the same filled member group are treated as interconnected and, therefore, share the same contiguous hydrostatic pressure field. Each filled member groups is classed as either open or closed. If at least one member in a given filled member group is partially buried in the seabed, such as a monopile, we treat this group as open to the external body of sea water through the bottom opening of the partially buried member and the porous seabed. In this case, the hydrostatic pressure of the internal fluid is in equilibrium with the external body of water with zero hydrostatic pressure at the external still water level. Furthermore, the filled level of an open filled member group cannot be higher than the external still water level, and the density of the internal fluid must exactly match the external water density. Note that any member partially buried in the seabed is considered to have an open bottom, so that there is neither external nor internal hydrostatic pressure on the bottom end of the member. If none of the members of a filled member group crosses the seabed, the filled member group is considered to be closed off from the external body of water, such as the ballast chamber of a floating platform. In this case, the internal hydrostatic pressure is zero at the instantaneous highest point of the internal fluid-filled volumes of all members belonging to this group at each time step. + +In this input section, **NFillGroups** specifies the number of fluid-filled member groups and determines the number of rows in the subsequent table. **FillNumM** specifies the number of members in the filled group. **FillMList** is a list of **FillNumM** whitespace-separated **MemberID**\ s. **FillFSLoc** specifies the *Z*-height of the filled level (0 for MSL). **FillDens** is the density of the fluid. If **FillDens** = DEFAULT, then **FillDens** = **WtrDens**. This option is convenient for open filled member groups, which requires the internal fluid density to match the external water density exactly. .. _hd-marine-growth: diff --git a/docs/source/user/subdyn/appendixD.rst b/docs/source/user/subdyn/appendixD.rst index 3cf6bcef2c..2da791afe9 100644 --- a/docs/source/user/subdyn/appendixD.rst +++ b/docs/source/user/subdyn/appendixD.rst @@ -51,54 +51,54 @@ Table C-1. List of Output Channels. +---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ | *Node Kinematics* | | +---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| :math:`{M \alpha N \beta}` TDxss, | (m) | Nodal translational displacements of :math:`M \alpha N \beta` | -| | | | -| :math:`M \alpha N \beta` TDyss, | | | -| | | (up to 81 designated locations) in SS coordinate system | -| :math:`M \alpha N \beta` TDzss, | | | -+---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| :math:`{M \alpha N \beta}` RDxe, | (rad) | Nodal rotational displacements of :math:`M \alpha N \beta` | -| | | | -| :math:`{M \alpha N \beta}` RDye, | | | +| :math:`{M \alpha N \beta}` TDxss, | (m) | Nodal total translational displacements of :math:`M \alpha N \beta` | +| | | | +| :math:`M \alpha N \beta` TDyss, | | | +| | | (up to 81 designated locations) in SS coordinate system | +| :math:`M \alpha N \beta` TDzss, | | | ++---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| :math:`{M \alpha N \beta}` RDxe, | (rad) | Nodal rotational elastic deflection of :math:`M \alpha N \beta` relative to the rigid-body configuration | +| | | | +| :math:`{M \alpha N \beta}` RDye, | | | | | | (up to 81 designated locations) in member local coordinate system | -| :math:`{M \alpha N \beta}` RDze | | | +| :math:`{M \alpha N \beta}` RDze | | | +---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| :math:`{M \alpha N \beta}` TAxe, | (:math:`{m/s^2}`) | Nodal translational accelerations of :math:`M \alpha N \beta` | -| | | | -| :math:`{M \alpha N \beta}` TAye, | | | -| | | (up to 81 designated locations) in member local coordinate system | -| :math:`{M \alpha N \beta}` TAze | | | +| :math:`{M \alpha N \beta}` TAxe, | (:math:`{m/s^2}`) | Nodal translational accelerations of :math:`M \alpha N \beta` | +| | | | +| :math:`{M \alpha N \beta}` TAye, | | | +| | | (up to 81 designated locations) in member local coordinate system | +| :math:`{M \alpha N \beta}` TAze | | | +---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| :math:`{M \alpha N \beta}` RAxe, | (:math:`{rad/s^2}`) | Nodal rotational accelerations of :math:`M \alpha N \beta` | -| | | | -| :math:`{M \alpha N \beta}` RAye, | | | -| | | (up to 81 designated locations) in member local coordinate system | -| :math:`{M \alpha N \beta}` RAze | | | +| :math:`{M \alpha N \beta}` RAxe, | (:math:`{rad/s^2}`) | Nodal rotational accelerations of :math:`M \alpha N \beta` | +| | | | +| :math:`{M \alpha N \beta}` RAye, | | | +| | | (up to 81 designated locations) in member local coordinate system | +| :math:`{M \alpha N \beta}` RAze | | | +---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ | *Node Forces and Moments* | | +---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| :math:`{M \alpha N \beta}` FKxe, | (N), | Static (elastic) component of reaction forces and moments | -| | | | -| :math:`{M \alpha N \beta}` FKye, | (N), | at :math:`M \alpha N \beta` along local member coordinate system | -| | | | -| :math:`{M \alpha N \beta}` FKze | (N), | | -| | | | -| :math:`{M \alpha N \beta}` MKxe, | (Nm), | | -| | | | -| :math:`{M \alpha N \beta}` MKye, | (Nm), | | -| | | | -| :math:`{M \alpha N \beta}` MKze | (Nm) | | -+---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ -| :math:`{M \alpha N \beta}` FMxe, | (N), | Dynamic (inertial) component of reaction forces and moments | -| | | | -| :math:`{M \alpha N \beta}` FMye, | (N), | at :math:`M \alpha N \beta` along local member coordinate system | -| | | | -| :math:`{M \alpha N \beta}` FMze | (N), | | -| | | | -| :math:`{M \alpha N \beta}` MMxe, | (Nm), | | -| | | | -| :math:`{M \alpha N \beta}` MMye, | (Nm), | | -| | | | -| :math:`{M \alpha N \beta}` MMze | (Nm) | | +| :math:`{M \alpha N \beta}` FKxe, | (N), | Static (elastic) component of reaction forces and moments | +| | | | +| :math:`{M \alpha N \beta}` FKye, | (N), | at :math:`M \alpha N \beta` along local member coordinate system | +| | | | +| :math:`{M \alpha N \beta}` FKze | (N), | | +| | | | +| :math:`{M \alpha N \beta}` MKxe, | (Nm), | | +| | | | +| :math:`{M \alpha N \beta}` MKye, | (Nm), | | +| | | | +| :math:`{M \alpha N \beta}` MKze | (Nm) | | ++---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ +| :math:`{M \alpha N \beta}` FMxe, | (N), | Dynamic (inertial) component of reaction forces and moments | +| | | | +| :math:`{M \alpha N \beta}` FMye, | (N), | at :math:`M \alpha N \beta` along local member coordinate system | +| | | | +| :math:`{M \alpha N \beta}` FMze | (N), | | +| | | | +| :math:`{M \alpha N \beta}` MMxe, | (Nm), | | +| | | | +| :math:`{M \alpha N \beta}` MMye, | (Nm), | | +| | | | +| :math:`{M \alpha N \beta}` MMze | (Nm) | | +---------------------------------------+--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------+ diff --git a/docs/source/user/subdyn/examples/OC4_Jacket_SD_Input.dat b/docs/source/user/subdyn/examples/OC4_Jacket_SD_Input.dat index 2c7cf3dcfe..174470d517 100644 --- a/docs/source/user/subdyn/examples/OC4_Jacket_SD_Input.dat +++ b/docs/source/user/subdyn/examples/OC4_Jacket_SD_Input.dat @@ -5,12 +5,10 @@ False Echo - Echo input data to ".SD.ech" (flag) "DEFAULT" SDdeltaT - Local Integration Step. If "default", the glue-code integration step will be used. 3 IntMethod - Integration Method [1/2/3/4 = RK4/AB4/ABM4/AM2]. True SttcSolve - Solve dynamics about static equilibrium point -True GuyanLoadCorrection - Include extra moment from lever arm at interface and rotate FEM for floating. -------------------- FEA and CRAIG-BAMPTON PARAMETERS --------------------------------- 3 FEMMod - FEM switch: element model in the FEM. [1= Euler-Bernoulli(E-B); 2=Tapered E-B (unavailable); 3= 2-node Timoshenko; 4= 2-node tapered Timoshenko (unavailable)] 2 NDiv - Number of sub-elements per member -True CBMod - [T/F] If True perform C-B reduction, else full FEM dofs will be retained. If True, select Nmodes to retain in C-B reduced system. - 8 Nmodes - Number of internal modes to retain (ignored if CBMod=False). If Nmodes=0 --> Guyan Reduction. + 8 Nmodes - Number of internal modes to retain. If Nmodes=0 --> Guyan Reduction. If Nmodes<0 --> retain all modes. 1 JDampings - Damping Ratios for each retained mode (% of critical) If Nmodes>0, list Nmodes structural damping ratios for each retained mode (% of critical), or a single damping ratio to be applied to all retained modes. (last entered value will be used for all remaining modes). 0 GuyanDampMod - Guyan damping {0=none, 1=Rayleigh Damping, 2=user specified 6x6 matrix} 0.000, 0.000 RayleighDamp - Mass and stiffness proportional damping coefficients (Rayleigh Damping) [only if GuyanDampMod=1] @@ -111,120 +109,120 @@ IJointID ItfTDXss ItfTDYss ItfTDZss ItfRDXss ItfRDYss ItfRDZss 56 1 1 1 1 1 1 ----------------------------------- MEMBERS ------------------------------------------- 112 NMembers - Number of members (-) -MemberID MJointID1 MJointID2 MPropSetID1 MPropSetID2 MType COSMID ![MType={1:beam circ., 2:cable, 3:rigid, 4:beam arb., 5:spring}. COMSID={-1:none}] - (-) (-) (-) (-) (-) (-) (-) - 1 1 2 2 2 1 -1 - 2 2 3 2 2 1 -1 - 3 3 4 2 2 1 -1 - 4 4 5 2 2 1 -1 - 5 6 7 2 2 1 -1 - 6 7 8 2 2 1 -1 - 7 8 9 2 2 1 -1 - 8 9 10 2 2 1 -1 - 9 11 12 2 2 1 -1 - 10 12 13 2 2 1 -1 - 11 13 14 2 2 1 -1 - 12 14 15 2 2 1 -1 - 13 16 17 2 2 1 -1 - 14 17 18 2 2 1 -1 - 15 18 19 2 2 1 -1 - 16 19 20 2 2 1 -1 - 17 5 21 3 3 1 -1 - 18 21 22 3 3 1 -1 - 19 22 23 3 3 1 -1 - 20 23 24 3 3 1 -1 - 21 10 25 3 3 1 -1 - 22 25 26 3 3 1 -1 - 23 26 27 3 3 1 -1 - 24 27 28 3 3 1 -1 - 25 15 29 3 3 1 -1 - 26 29 30 3 3 1 -1 - 27 30 31 3 3 1 -1 - 28 31 32 3 3 1 -1 - 29 20 33 3 3 1 -1 - 30 33 34 3 3 1 -1 - 31 34 35 3 3 1 -1 - 32 35 36 3 3 1 -1 - 33 8 3 1 1 1 -1 - 34 13 8 1 1 1 -1 - 35 13 18 1 1 1 -1 - 36 18 3 1 1 1 -1 - 37 4 37 1 1 1 -1 - 38 37 20 1 1 1 -1 - 39 19 37 1 1 1 -1 - 40 37 5 1 1 1 -1 - 41 9 38 1 1 1 -1 - 42 38 15 1 1 1 -1 - 43 14 38 1 1 1 -1 - 44 38 10 1 1 1 -1 - 45 4 39 1 1 1 -1 - 46 39 10 1 1 1 -1 - 47 9 39 1 1 1 -1 - 48 39 5 1 1 1 -1 - 49 19 40 1 1 1 -1 - 50 40 15 1 1 1 -1 - 51 14 40 1 1 1 -1 - 52 40 20 1 1 1 -1 - 53 5 41 1 1 1 -1 - 54 41 33 1 1 1 -1 - 55 20 41 1 1 1 -1 - 56 41 21 1 1 1 -1 - 57 10 42 1 1 1 -1 - 58 42 29 1 1 1 -1 - 59 15 42 1 1 1 -1 - 60 42 25 1 1 1 -1 - 61 5 43 1 1 1 -1 - 62 43 25 1 1 1 -1 - 63 10 43 1 1 1 -1 - 64 43 21 1 1 1 -1 - 65 20 44 1 1 1 -1 - 66 44 29 1 1 1 -1 - 67 15 44 1 1 1 -1 - 68 44 33 1 1 1 -1 - 69 21 45 1 1 1 -1 - 70 45 34 1 1 1 -1 - 71 33 45 1 1 1 -1 - 72 45 22 1 1 1 -1 - 73 25 46 1 1 1 -1 - 74 46 30 1 1 1 -1 - 75 29 46 1 1 1 -1 - 76 46 26 1 1 1 -1 - 77 21 47 1 1 1 -1 - 78 47 26 1 1 1 -1 - 79 25 47 1 1 1 -1 - 80 47 22 1 1 1 -1 - 81 33 48 1 1 1 -1 - 82 48 30 1 1 1 -1 - 83 29 48 1 1 1 -1 - 84 48 34 1 1 1 -1 - 85 22 49 1 1 1 -1 - 86 49 35 1 1 1 -1 - 87 34 49 1 1 1 -1 - 88 49 23 1 1 1 -1 - 89 26 50 1 1 1 -1 - 90 50 31 1 1 1 -1 - 91 30 50 1 1 1 -1 - 92 50 27 1 1 1 -1 - 93 22 51 1 1 1 -1 - 94 51 27 1 1 1 -1 - 95 26 51 1 1 1 -1 - 96 51 23 1 1 1 -1 - 97 34 52 1 1 1 -1 - 98 52 31 1 1 1 -1 - 99 30 52 1 1 1 -1 - 100 52 35 1 1 1 -1 - 101 24 53 4 4 1 -1 - 102 28 54 4 4 1 -1 - 103 32 56 4 4 1 -1 - 104 36 55 4 4 1 -1 - 105 58 1 5 5 1 -1 - 106 57 16 5 5 1 -1 - 107 60 6 5 5 1 -1 - 108 59 11 5 5 1 -1 - 109 62 58 6 6 1 -1 - 110 61 57 6 6 1 -1 - 111 64 60 6 6 1 -1 - 112 63 59 6 6 1 -1 +MemberID MJointID1 MJointID2 MPropSetID1 MPropSetID2 MType MSpin/COSMID ![MType={1c:beam circ., 1r:beam rect., 2:cable, 3:rigid, 4:beam arb., 5:spring}. COMSID={-1:none}] + (-) (-) (-) (-) (-) (-) (deg/-) + 1 1 2 2 2 1c 0 + 2 2 3 2 2 1c 0 + 3 3 4 2 2 1c 0 + 4 4 5 2 2 1c 0 + 5 6 7 2 2 1c 0 + 6 7 8 2 2 1c 0 + 7 8 9 2 2 1c 0 + 8 9 10 2 2 1c 0 + 9 11 12 2 2 1c 0 + 10 12 13 2 2 1c 0 + 11 13 14 2 2 1c 0 + 12 14 15 2 2 1c 0 + 13 16 17 2 2 1c 0 + 14 17 18 2 2 1c 0 + 15 18 19 2 2 1c 0 + 16 19 20 2 2 1c 0 + 17 5 21 3 3 1c 0 + 18 21 22 3 3 1c 0 + 19 22 23 3 3 1c 0 + 20 23 24 3 3 1c 0 + 21 10 25 3 3 1c 0 + 22 25 26 3 3 1c 0 + 23 26 27 3 3 1c 0 + 24 27 28 3 3 1c 0 + 25 15 29 3 3 1c 0 + 26 29 30 3 3 1c 0 + 27 30 31 3 3 1c 0 + 28 31 32 3 3 1c 0 + 29 20 33 3 3 1c 0 + 30 33 34 3 3 1c 0 + 31 34 35 3 3 1c 0 + 32 35 36 3 3 1c 0 + 33 8 3 1 1 1c 0 + 34 13 8 1 1 1c 0 + 35 13 18 1 1 1c 0 + 36 18 3 1 1 1c 0 + 37 4 37 1 1 1c 0 + 38 37 20 1 1 1c 0 + 39 19 37 1 1 1c 0 + 40 37 5 1 1 1c 0 + 41 9 38 1 1 1c 0 + 42 38 15 1 1 1c 0 + 43 14 38 1 1 1c 0 + 44 38 10 1 1 1c 0 + 45 4 39 1 1 1c 0 + 46 39 10 1 1 1c 0 + 47 9 39 1 1 1c 0 + 48 39 5 1 1 1c 0 + 49 19 40 1 1 1c 0 + 50 40 15 1 1 1c 0 + 51 14 40 1 1 1c 0 + 52 40 20 1 1 1c 0 + 53 5 41 1 1 1c 0 + 54 41 33 1 1 1c 0 + 55 20 41 1 1 1c 0 + 56 41 21 1 1 1c 0 + 57 10 42 1 1 1c 0 + 58 42 29 1 1 1c 0 + 59 15 42 1 1 1c 0 + 60 42 25 1 1 1c 0 + 61 5 43 1 1 1c 0 + 62 43 25 1 1 1c 0 + 63 10 43 1 1 1c 0 + 64 43 21 1 1 1c 0 + 65 20 44 1 1 1c 0 + 66 44 29 1 1 1c 0 + 67 15 44 1 1 1c 0 + 68 44 33 1 1 1c 0 + 69 21 45 1 1 1c 0 + 70 45 34 1 1 1c 0 + 71 33 45 1 1 1c 0 + 72 45 22 1 1 1c 0 + 73 25 46 1 1 1c 0 + 74 46 30 1 1 1c 0 + 75 29 46 1 1 1c 0 + 76 46 26 1 1 1c 0 + 77 21 47 1 1 1c 0 + 78 47 26 1 1 1c 0 + 79 25 47 1 1 1c 0 + 80 47 22 1 1 1c 0 + 81 33 48 1 1 1c 0 + 82 48 30 1 1 1c 0 + 83 29 48 1 1 1c 0 + 84 48 34 1 1 1c 0 + 85 22 49 1 1 1c 0 + 86 49 35 1 1 1c 0 + 87 34 49 1 1 1c 0 + 88 49 23 1 1 1c 0 + 89 26 50 1 1 1c 0 + 90 50 31 1 1 1c 0 + 91 30 50 1 1 1c 0 + 92 50 27 1 1 1c 0 + 93 22 51 1 1 1c 0 + 94 51 27 1 1 1c 0 + 95 26 51 1 1 1c 0 + 96 51 23 1 1 1c 0 + 97 34 52 1 1 1c 0 + 98 52 31 1 1 1c 0 + 99 30 52 1 1 1c 0 + 100 52 35 1 1 1c 0 + 101 24 53 4 4 1c 0 + 102 28 54 4 4 1c 0 + 103 32 56 4 4 1c 0 + 104 36 55 4 4 1c 0 + 105 58 1 5 5 1c 0 + 106 57 16 5 5 1c 0 + 107 60 6 5 5 1c 0 + 108 59 11 5 5 1c 0 + 109 62 58 6 6 1c 0 + 110 61 57 6 6 1c 0 + 111 64 60 6 6 1c 0 + 112 63 59 6 6 1c 0 ------------------ CIRCULAR BEAM CROSS-SECTION PROPERTIES ----------------------------- 6 NPropSets - Number of structurally unique circular cross-sections PropSetID YoungE ShearG MatDens XsecD XsecT @@ -235,10 +233,14 @@ PropSetID YoungE ShearG MatDens XsecD X 4 2.10000e+11 8.07690e+10 7850.00 1.200000 0.040000 5 2.10000e+11 8.07690e+10 3339.12 2.082000 0.491000 6 2.10000e+11 8.07690e+10 7850.00 2.082000 0.060000 +----------------- RECTANGULAR BEAM CROSS-SECTION PROPERTIES --------------------------- + 0 NPropSets - Number of structurally unique cross-sections (if 0 the following table is ignored) +PropSetID YoungE ShearG MatDens XsecSa XsecSb XsecT + (-) (N/m2) (N/m2) (kg/m3) (m) (m) (m) ----------------- ARBITRARY BEAM CROSS-SECTION PROPERTIES ----------------------------- 0 NXPropSets - Number of structurally unique non-circular cross-sections (if 0 the following table is ignored) -PropSetID YoungE ShearG MatDens XsecA XsecAsx XsecAsy XsecJxx XsecJyy XsecJ0 - (-) (N/m2) (N/m2) (kg/m3) (m2) (m2) (m2) (m4) (m4) (m4) +PropSetID YoungE ShearG MatDens XsecA XsecAsx XsecAsy XsecJxx XsecJyy XsecJ0 XsecJt + (-) (N/m2) (N/m2) (kg/m3) (m2) (m2) (m2) (m4) (m4) (m4) (m4) -------------------------- CABLE PROPERTIES ------------------------------------------- 0 NCablePropSets - Number of cable cable properties PropSetID EA MatDens T0 CtrlChannel diff --git a/docs/source/user/subdyn/input_files.rst b/docs/source/user/subdyn/input_files.rst index 8e7f5a3ae5..d417fc3d85 100644 --- a/docs/source/user/subdyn/input_files.rst +++ b/docs/source/user/subdyn/input_files.rst @@ -404,33 +404,35 @@ specifies the ending joint, corresponding to an identifier **MPropSetID1** corresponds to the identifier **PropSetID** from the MEMBER X-SECTION PROPERTY table (discussed next) for starting cross-section properties and **MPropSetID2** specifies the identifier -for ending cross-section properties, allowing for tapered members. +for ending cross-section properties, allowing for tapered members. +Note that tapering is not allowed with user-defined generic beams (*MType=4*) below. +Therefore, **MPropSetID1** and **MPropSetID2** must be the same for this beam type. The sixth column specify the member type **MType**. A member is one of the four following types (see :numref:`SD_FEM`): -- Beams (*MType=1*), Euler-Bernoulli (*FEMMod=1*) or Timoshenko (*FEMMod=3*) +- Beams with circular cross sections (*MType=1c* or *MType=1*), Euler-Bernoulli (*FEMMod=1*) or Timoshenko (*FEMMod=3*) + +- Beams with rectangular cross sections (*MType=1r*), Euler-Bernoulli (*FEMMod=1*) or Timoshenko (*FEMMod=3*) - Pretension cables (*MType=2*) - Rigid link (*MType=3*) -- Spring element (*MType=5*) +- Beam with arbitrary user-defined cross-section properties (*MType=4*), Euler-Bernoulli (*FEMMod=1*) or Timoshenko (*FEMMod=3*) -**COSMID** refers to the IDs of the members' cosine matrices for noncircular -members and spring elements; the current release uses SubDyn's default direction cosine convention -if it's not present or when COSMID values are -1. Spring elements are defined between joints that -are coincident in the space and the direction cosine must be provided. +- Spring element (*MType=5*) +The required input for **MSpin/COSMID** depends on the member type. For all beam types (*MType=1c*, *1r*, or *4*), users can specify a spin angle **MSpin** in degrees. This is a rotation of the beam member about its axis (pointing from the starting joint to the ending joint) following the right-hand convention. When **MSpin** = 0, the default SubDyn member orientation is used with the element local *x_e* axis parallel to the global *XY* plane. (If the beam is perfectly vertical, the element local *x_e* axis is parallel to the global *X* axis.) A nonzero **MSpin** effectively rotates the element local coordinate system about the member axis. For a beam with a rectangular cross section, Side A of the rectangular section is always parallel to the *x_e* axis, and setting **MSpin** allows the rectangular section to be reoriented as needed. Note that this convention is consistent with how HydroDyn defines rectangular members. Using the same member spin angle in SubDyn and HydroDyn ensures consistency across the two modules. With *MType=4*, the user-defined cross-section properties are also about the element local axes. Again, setting **MSpin** allows the cross section to be reoriented as needed. Finally, for beams with cylindrical cross sections, **MSpin** has no physical effect, but it does influence output channels based on the element local coordinate system. Setting **MSpin** allows these outputs to be given in a more convenient coordinate system orientation. For spring elements (*MType=5*), users can provide the IDs of user-defined member cosine matrices (**COSMID**\ ); the current release uses SubDyn's default direction cosine convention if **COSMID** is -1. Spring elements are defined between joints that are coincident in space and the direction cosine must be provided. An example of member table is given below .. code:: 2 NMembers - Number of frame members - MemberID MJointID1 MJointID2 MPropSetID1 MPropSetID2 MType COSMID - (-) (-) (-) (-) (-) (-) (-) - 10 101 102 2 2 1 - 11 102 103 2 2 1 + MemberID MJointID1 MJointID2 MPropSetID1 MPropSetID2 MType MSpin/COSMID + (-) (-) (-) (-) (-) (-) (deg/-) + 10 101 102 2 2 1c 0 + 11 102 103 2 2 1c 0 @@ -438,38 +440,51 @@ An example of member table is given below Member Cross-Section Properties ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Members in SubDyn are assumed to be straight, circular, possibly -tapered, and hollow cylinders. Future releases will allow for generic -cross-sections to be employed. These special cross-section members will -be defined in the second of two tables in the input file (Member -X-Section Property data 2/2), which is currently ignored. +Beam members in SubDyn are assumed to be straight, possibly +tapered, and hollow, with circular, rectangular, or user-defined generic +cross sections. These beam cross-section properties are defined in three +separate tables. -For the circular cross-section members, properties needed by SubDyn are +Properties of circular beam cross sections needed by SubDyn are material Young’s modulus, **YoungE**, shear modulus, **ShearG**, and -density, **MatDens**, member outer diameter, **XsecD**, and member -thickness, **XsecT**. Users will need to create an entry in the first -table within this section of the input file distinguished by +density, **MatDens**, member outer diameter, **XsecD**, and member wall +thickness, **XsecT**. Note that setting **XsecT** to a value less than +or equal to zero implies a solid section. Users will need to create an +entry in the first table within this section of the input file identified by **PropSetID**, for each unique combination of these five properties. The member property-set table contains **NPropSets** rows. The member property sets are referred to by their **PropSetID** in the MEMBERS -table, as described in Section . Note, however, that although diameter -and thickness will be linearly interpolated within an individual member, -SubDyn will not allow *material* properties to change within an -individual member. - -The second table in this section of the input file (not to be used in -this release) will have **NXPropSets** rows (assumed to be zero for -this release), and have additional entries when compared to the previous +table above. Note, however, that although diameter and thickness will +be linearly interpolated within an individual member, SubDyn will not +allow *material* properties to change within an individual member. + +Properties of rectangular beam cross sections needed by SubDyn are the +same as those for circular beam cross sections, except that the section +diameter **XsecD** is replaced with the lengths of the two sides of the +rectangular section **XsecSa** (length of Side A) and **XsecSb** (length of +Side B). Side A is parallel to the element local *x_e* axis and Side B is +parallel to the element local *y_e* axis. Again, setting **XsecT** to a +value less than or equal to zero implies a solid section. Note that SubDyn +can automatically compute the shear areas and torsion constant for solid +rectangular sections and thin-walled rectangular sections. For sections +of intermediate wall thickness, the thin-walled approximation will be used, +which might not be accurate. This is different from circular sections for +which the shear area and torsion constant can be automatically computed by +SubDyn for arbitrary wall thickness. The properties of unique rectangular +beam sections are entered on separate rows of the second table of this input +file section. Again, the table should have **NPropSets** rows. + +The third table in this section of the input file have **NXPropSets** +rows and have additional entries when compared to the previous table, including: cross-sectional area (**XsecA**), cross-sectional shear area along the local principal axes *x* and *y* (**XsecAsx**, **XsecAsy**), cross-sectional area second moment of inertia about *x* -and *y* (**XsecJxx**, **XsecJyy**), and cross-sectional area polar -moment of inertia (**XsecJ0**). The member cosine matrix section (see -Section ) will help determine the correct orientation of the members -within the assembly. - - - +and *y* (**XsecJxx**, **XsecJyy**), cross-sectional polar area +moment of inertia (**XsecJ0**), and the cross-sectional torsion constant +(**XsecJt**). The cross-section properties defined in this section can be +used with the arbitrary beam type with *MType=4* in the MEMBERS table. +The cross section can be reoriented through the **MSpin** input in the MEMBERS +section, similar to rectangular members. Cable Properties