diff --git a/docs/source/user/hydrodyn/appendix.rst b/docs/source/user/hydrodyn/appendix.rst index 96447e6631..24a2e1b352 100644 --- a/docs/source/user/hydrodyn/appendix.rst +++ b/docs/source/user/hydrodyn/appendix.rst @@ -10,244 +10,216 @@ structure:: ------- HydroDyn Input File ---------------------------------------------------- NREL 5.0 MW offshore baseline floating platform HydroDyn input properties for the OC4 Semi-submersible. False Echo - Echo the input file data (flag) - ---------------------- ENVIRONMENTAL CONDITIONS -------------------------------- - "DEFAULT" WtrDens - Water density (kg/m^3) - "DEFAULT" WtrDpth - Water depth (meters) - "DEFAULT" MSL2SWL - Offset between still-water level and mean sea level (meters) [positive upward; unused when WaveMod = 6; must be zero if PotMod=1 or 2] - ---------------------- WAVES --------------------------------------------------- - 3 WaveMod - Incident wave kinematics model {0: none=still water, 1: regular (periodic), 1P#: regular with user-specified phase, 2: JONSWAP/Pierson-Moskowitz spectrum (irregular), 3: White noise spectrum (irregular), 4: user-defined spectrum from routine UserWaveSpctrm (irregular), 5: Externally generated wave-elevation time series, 6: Externally generated full wave-kinematics time series [option 6 is invalid for PotMod/=0]} (switch) - 0 WaveStMod - Model for stretching incident wave kinematics to instantaneous free surface {0: none=no stretching, 1: vertical stretching, 2: extrapolation stretching, 3: Wheeler stretching} (switch) [unused when WaveMod=0 or when PotMod/=0] - 4600 WaveTMax - Analysis time for incident wave calculations (sec) [unused when WaveMod=0; determines WaveDOmega=2Pi/WaveTMax in the IFFT] - 0.2 WaveDT - Time step for incident wave calculations (sec) [unused when WaveMod=0; 0.1<=WaveDT<=1.0 recommended; determines WaveOmegaMax=Pi/WaveDT in the IFFT] - 1.2646 WaveHs - Significant wave height of incident waves (meters) [used only when WaveMod=1, 2, or 3] - 10 WaveTp - Peak-spectral period of incident waves (sec) [used only when WaveMod=1 or 2] - "DEFAULT" WavePkShp - Peak-shape parameter of incident wave spectrum (-) or DEFAULT (string) [used only when WaveMod=2; use 1.0 for Pierson-Moskowitz] - 0.314159 WvLowCOff - Low cut-off frequency or lower frequency limit of the wave spectrum beyond which the wave spectrum is zeroed (rad/s) [unused when WaveMod=0, 1, or 6] - 1.570796 WvHiCOff - High cut-off frequency or upper frequency limit of the wave spectrum beyond which the wave spectrum is zeroed (rad/s) [unused when WaveMod=0, 1, or 6] - 0 WaveDir - Incident wave propagation heading direction (degrees) [unused when WaveMod=0 or 6] - 0 WaveDirMod - Directional spreading function {0: none, 1: COS2S} (-) [only used when WaveMod=2,3, or 4] - 1 WaveDirSpread - Wave direction spreading coefficient ( > 0 ) (-) [only used when WaveMod=2,3, or 4 and WaveDirMod=1] - 1 WaveNDir - Number of wave directions (-) [only used when WaveMod=2,3, or 4 and WaveDirMod=1; odd number only] - 0 WaveDirRange - Range of wave directions (full range: WaveDir +/- 1/2*WaveDirRange) (degrees) [only used when WaveMod=2,3,or 4 and WaveDirMod=1] - 123456789 WaveSeed(1) - First random seed of incident waves [-2147483648 to 2147483647] (-) [unused when WaveMod=0, 5, or 6] - 1011121314 WaveSeed(2) - Second random seed of incident waves [-2147483648 to 2147483647] (-) [unused when WaveMod=0, 5, or 6] - FALSE WaveNDAmp - Flag for normally distributed amplitudes (flag) [only used when WaveMod=2, 3, or 4] - "" WvKinFile - Root name of externally generated wave data file(s) (quoted string) [used only when WaveMod=5 or 6] - 1 NWaveElev - Number of points where the incident wave elevations can be computed (-) [maximum of 9 output locations] - 0 WaveElevxi - List of xi-coordinates for points where the incident wave elevations can be output (meters) [NWaveElev points, separated by commas or white space; usused if NWaveElev = 0] - 0 WaveElevyi - List of yi-coordinates for points where the incident wave elevations can be output (meters) [NWaveElev points, separated by commas or white space; usused if NWaveElev = 0] - ---------------------- 2ND-ORDER WAVES ----------------------------------------- [unused with WaveMod=0 or 6] - FALSE WvDiffQTF - Full difference-frequency 2nd-order wave kinematics (flag) - FALSE WvSumQTF - Full summation-frequency 2nd-order wave kinematics (flag) - 0 WvLowCOffD - Low frequency cutoff used in the difference-frequencies (rad/s) [Only used with a difference-frequency method] - 1.256637 WvHiCOffD - High frequency cutoff used in the difference-frequencies (rad/s) [Only used with a difference-frequency method] - 0.618319 WvLowCOffS - Low frequency cutoff used in the summation-frequencies (rad/s) [Only used with a summation-frequency method] - 3.141593 WvHiCOffS - High frequency cutoff used in the summation-frequencies (rad/s) [Only used with a summation-frequency method] - ---------------------- CURRENT ------------------------------------------------- [unused with WaveMod=6] - 0 CurrMod - Current profile model {0: none=no current, 1: standard, 2: user-defined from routine UserCurrent} (switch) - 0 CurrSSV0 - Sub-surface current velocity at still water level (m/s) [used only when CurrMod=1] - "DEFAULT" CurrSSDir - Sub-surface current heading direction (degrees) or DEFAULT (string) [used only when CurrMod=1] - 20 CurrNSRef - Near-surface current reference depth (meters) [used only when CurrMod=1] - 0 CurrNSV0 - Near-surface current velocity at still water level (m/s) [used only when CurrMod=1] - 0 CurrNSDir - Near-surface current heading direction (degrees) [used only when CurrMod=1] - 0 CurrDIV - Depth-independent current velocity (m/s) [used only when CurrMod=1] - 0 CurrDIDir - Depth-independent current heading direction (degrees) [used only when CurrMod=1] ---------------------- FLOATING PLATFORM --------------------------------------- [unused with WaveMod=6] - 1 PotMod - Potential-flow model {0: none=no potential flow, 1: frequency-to-time-domain transforms based on WAMIT output, 2: fluid-impulse theory (FIT)} (switch) - "HydroData/marin_semi" PotFile - Root name of potential-flow model data; WAMIT output files containing the linear, nondimensionalized, hydrostatic restoring matrix (.hst), frequency-dependent hydrodynamic added mass matrix and damping matrix (.1), and frequency- and direction-dependent wave excitation force vector per unit wave amplitude (.3) (quoted string) [MAKE SURE THE FREQUENCIES INHERENT IN THESE WAMIT FILES SPAN THE PHYSICALLY-SIGNIFICANT RANGE OF FREQUENCIES FOR THE GIVEN PLATFORM; THEY MUST CONTAIN THE ZERO- AND INFINITE-FREQUENCY LIMITS!] - 1 WAMITULEN - Characteristic body length scale used to redimensionalize WAMIT output (meters) [only used when PotMod=1] - 13917 PtfmVol0 - Displaced volume of water when the platform is in its undisplaced position (m^3) [only used when PotMod=1; USE THE SAME VALUE COMPUTED BY WAMIT AS OUTPUT IN THE .OUT FILE!] - 0 PtfmCOBxt - The xt offset of the center of buoyancy (COB) from the platform reference point (meters) [only used when PotMod=1] - 0 PtfmCOByt - The yt offset of the center of buoyancy (COB) from the platform reference point (meters) [only used when PotMod=1] - 1 ExctnMod - Wave Excitation model {0: None, 1: DFT, 2: state-space} (switch) [only used when PotMod=1; STATE-SPACE REQUIRES *.ssexctn INPUT FILE] - 1 RdtnMod - Radiation memory-effect model {0: no memory-effect calculation, 1: convolution, 2: state-space} (switch) [only used when PotMod=1; STATE-SPACE REQUIRES *.ss INPUT FILE] + 1 PotMod - Potential-flow model {0: none=no potential flow, 1: frequency-to-time-domain transforms based on WAMIT output, 2: fluid-impulse theory (FIT)} (switch) + 1 ExctnMod - Wave-excitation model {0: no wave-excitation calculation, 1: DFT, 2: state-space} (switch) [only used when PotMod=1; STATE-SPACE REQUIRES *.ssexctn INPUT FILE] + 0 ExctnDisp - Method of computing Wave Excitation {0: use undisplaced position, 1: use displaced position, 2: use low-pass filtered displaced position) [only used when PotMod=1 and ExctnMod>0 and SeaState's WaveMod>0]} (switch) + 10 ExctnCutOff - Cutoff (corner) frequency of the low-pass time-filtered displaced position (Hz) [>0.0] [used only when PotMod=1, ExctnMod>0, and ExctnDisp=2]) [only used when PotMod=1 and ExctnMod>0 and SeaState's WaveMod>0]} (switch) + 1 RdtnMod - Radiation memory-effect model {0: no memory-effect calculation, 1: convolution, 2: state-space} (switch) [only used when PotMod=1; STATE-SPACE REQUIRES *.ss INPUT FILE] 60 RdtnTMax - Analysis time for wave radiation kernel calculations (sec) [only used when PotMod=1 and RdtnMod>0; determines RdtnDOmega=Pi/RdtnTMax in the cosine transform; MAKE SURE THIS IS LONG ENOUGH FOR THE RADIATION IMPULSE RESPONSE FUNCTIONS TO DECAY TO NEAR-ZERO FOR THE GIVEN PLATFORM!] - "DEFAULT" RdtnDT - Time step for wave radiation kernel calculations (sec) [only used when PotMod=1 and RdtnMod=1; DT<=RdtnDT<=0.1 recommended; determines RdtnOmegaMax=Pi/RdtnDT in the cosine transform] + 0.0125 RdtnDT - Time step for wave radiation kernel calculations (sec) [only used when PotMod=1 and ExctnMod>0 or RdtnMod>0; DT<=RdtnDT<=0.1 recommended; determines RdtnOmegaMax=Pi/RdtnDT in the cosine transform] + 1 NBody - Number of WAMIT bodies to be used (-) [>=1; only used when PotMod=1. If NBodyMod=1, the WAMIT data contains a vector of size 6*NBody x 1 and matrices of size 6*NBody x 6*NBody; if NBodyMod>1, there are NBody sets of WAMIT data each with a vector of size 6 x 1 and matrices of size 6 x 6] + 1 NBodyMod - Body coupling model {1: include coupling terms between each body and NBody in HydroDyn equals NBODY in WAMIT, 2: neglect coupling terms between each body and NBODY=1 with XBODY=0 in WAMIT, 3: Neglect coupling terms between each body and NBODY=1 with XBODY=/0 in WAMIT} (switch) [only used when PotMod=1] + "marin_semi" PotFile - Root name of potential-flow model data; WAMIT output files containing the linear, nondimensionalized, hydrostatic restoring matrix (.hst), frequency-dependent hydrodynamic added mass matrix and damping matrix (.1), and frequency- and direction-dependent wave excitation force vector per unit wave amplitude (.3) (quoted string) [1 to NBody if NBodyMod>1] [MAKE SURE THE FREQUENCIES INHERENT IN THESE WAMIT FILES SPAN THE PHYSICALLY-SIGNIFICANT RANGE OF FREQUENCIES FOR THE GIVEN PLATFORM; THEY MUST CONTAIN THE ZERO- AND INFINITE-FREQUENCY LIMITS!] + 1 WAMITULEN - Characteristic body length scale used to redimensionalize WAMIT output (meters) [1 to NBody if NBodyMod>1] [only used when PotMod=1] + 0 PtfmRefxt - The xt offset of the body reference point(s) from (0,0,0) (meters) [1 to NBody] [only used when PotMod=1] + 0 PtfmRefyt - The yt offset of the body reference point(s) from (0,0,0) (meters) [1 to NBody] [only used when PotMod=1] + 0 PtfmRefzt - The zt offset of the body reference point(s) from (0,0,0) (meters) [1 to NBody] [only used when PotMod=1. If NBodyMod=2,PtfmRefzt=0.0] + 0 PtfmRefztRot - The rotation about zt of the body reference frame(s) from xt/yt (degrees) [1 to NBody] [only used when PotMod=1] + 13917 PtfmVol0 - Displaced volume of water when the body is in its undisplaced position (m^3) [1 to NBody] [only used when PotMod=1; USE THE SAME VALUE COMPUTED BY WAMIT AS OUTPUT IN THE .OUT FILE!] + 0 PtfmCOBxt - The xt offset of the center of buoyancy (COB) from (0,0) (meters) [1 to NBody] [only used when PotMod=1] + 0 PtfmCOByt - The yt offset of the center of buoyancy (COB) from (0,0) (meters) [1 to NBody] [only used when PotMod=1] ---------------------- 2ND-ORDER FLOATING PLATFORM FORCES ---------------------- [unused with WaveMod=0 or 6, or PotMod=0 or 2] - 0 MnDrift - Mean-drift 2nd-order forces computed {0: None; [7, 8, 9, 10, 11, or 12]: WAMIT file to use} [Only one of MnDrift, NewmanApp, or DiffQTF can be non-zero] - 0 NewmanApp - Mean- and slow-drift 2nd-order forces computed with Newman's approximation {0: None; [7, 8, 9, 10, 11, or 12]: WAMIT file to use} [Only one of MnDrift, NewmanApp, or DiffQTF can be non-zero. Used only when WaveDirMod=0] - 0 DiffQTF - Full difference-frequency 2nd-order forces computed with full QTF {0: None; [10, 11, or 12]: WAMIT file to use} [Only one of MnDrift, NewmanApp, or DiffQTF can be non-zero] - 0 SumQTF - Full summation -frequency 2nd-order forces computed with full QTF {0: None; [10, 11, or 12]: WAMIT file to use} - ---------------------- FLOATING PLATFORM FORCE FLAGS -------------------------- [unused with WaveMod=6] - True PtfmSgF - Platform horizontal surge translation force (flag) or DEFAULT - True PtfmSwF - Platform horizontal sway translation force (flag) or DEFAULT - True PtfmHvF - Platform vertical heave translation force (flag) or DEFAULT - True PtfmRF - Platform roll tilt rotation force (flag) or DEFAULT - True PtfmPF - Platform pitch tilt rotation force (flag) or DEFAULT - True PtfmYF - Platform yaw rotation force (flag) or DEFAULT - ---------------------- PLATFORM ADDITIONAL STIFFNESS AND DAMPING -------------- - 0 0 0 0 0 0 AddF0 - Additional preload (N, N-m) - 0 0 0 0 0 0 AddCLin - Additional linear stiffness (N/m, N/rad, N-m/m, N-m/rad) - 0 0 0 0 0 0 - 0 0 0 0 0 0 - 0 0 0 1451298897 0 0 - 0 0 0 0 1451298897 0 - 0 0 0 0 0 0 - 0 0 0 0 0 0 AddBLin - Additional linear damping(N/(m/s), N/(rad/s), N-m/(m/s), N-m/(rad/s)) - 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 0 0 0 0 AddBQuad - Additional quadratic drag(N/(m/s)^2, N/(rad/s)^2, N-m(m/s)^2, N-m/(rad/s)^2) - 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 MnDrift - Mean-drift 2nd-order forces computed {0: None; [7, 8, 9, 10, 11, or 12]: WAMIT file to use} [Only one of MnDrift, NewmanApp, or DiffQTF can be non-zero. If NBody>1, MnDrift /=8] + 0 NewmanApp - Mean- and slow-drift 2nd-order forces computed with Newman's approximation {0: None; [7, 8, 9, 10, 11, or 12]: WAMIT file to use} [Only one of MnDrift, NewmanApp, or DiffQTF can be non-zero. If NBody>1, NewmanApp/=8. Used only when WaveDirMod=0] + 0 DiffQTF - Full difference-frequency 2nd-order forces computed with full QTF {0: None; [10, 11, or 12]: WAMIT file to use} [Only one of MnDrift, NewmanApp, or DiffQTF can be non-zero] + 0 SumQTF - Full summation -frequency 2nd-order forces computed with full QTF {0: None; [10, 11, or 12]: WAMIT file to use} + ---------------------- PLATFORM ADDITIONAL STIFFNESS AND DAMPING -------------- [unused with PotMod=0 or 2] + 0 AddF0 - Additional preload (N, N-m) [If NBodyMod=1, one size 6*NBody x 1 vector; if NBodyMod>1, NBody size 6 x 1 vectors] + 0 + 0 + 0 + 0 + 0 + 0 0 0 0 0 0 AddCLin - Additional linear stiffness (N/m, N/rad, N-m/m, N-m/rad) [If NBodyMod=1, one size 6*NBody x 6*NBody matrix; if NBodyMod>1, NBody size 6 x 6 matrices] + 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 0 0 0 0 AddBLin - Additional linear damping (N/(m/s), N/(rad/s), N-m/(m/s), N-m/(rad/s)) [If NBodyMod=1, one size 6*NBody x 6*NBody matrix; if NBodyMod>1, NBody size 6 x 6 matrices] + 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 0 0 0 0 AddBQuad - Additional quadratic damping (N/(m/s)^2, N/(rad/s)^2, N-m(m/s)^2, N-m/(rad/s)^2) [If NBodyMod=1, one size 6*NBody x 6*NBody matrix; if NBodyMod>1, NBody size 6 x 6 matrices] + 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 + ---------------------- STRIP THEORY OPTIONS -------------------------------------- + 0 WaveDisp - Method of computing Wave Kinematics {0: use undisplaced position, 1: use displaced position) } (switch) + 0 AMMod - Method of computing distributed added-mass force. (0: Only and always on nodes below SWL at the undisplaced position. 2: Up to the instantaneous free surface) [overwrite to 0 when WaveMod = 0 or 6 or when WaveStMod = 0 in SeaState] ---------------------- AXIAL COEFFICIENTS -------------------------------------- - 2 NAxCoef - Number of axial coefficients (-) - AxCoefID AxCd AxCa AxCp - (-) (-) (-) (-) - 1 0.00 0.00 1.00 - 2 9.60 0.00 1.00 + 2 NAxCoef - Number of axial coefficients (-) + AxCoefID AxCd AxCa AxCp AxFDMod AxVnCOff AxFDLoFSc + (-) (-) (-) (-) (-) (-) (-) + 1 0.00 0.00 1.00 0 0.00 1.00 + 2 9.60 0.00 1.00 0 0.00 1.00 ---------------------- MEMBER JOINTS ------------------------------------------- 44 NJoints - Number of joints (-) [must be exactly 0 or at least 2] JointID Jointxi Jointyi Jointzi JointAxID JointOvrlp [JointOvrlp= 0: do nothing at joint, 1: eliminate overlaps by calculating super member] - (-) (m) (m) (m) (-) (switch) - 1 0.00000 0.00000 -20.00000 1 0 - 2 0.00000 0.00000 10.00000 1 0 - 3 14.43376 25.00000 -14.00000 1 0 - 4 14.43376 25.00000 12.00000 1 0 - 5 -28.86751 0.00000 -14.00000 1 0 - 6 -28.86751 0.00000 12.00000 1 0 - 7 14.43376 -25.00000 -14.00000 1 0 - 8 14.43376 -25.00000 12.00000 1 0 - 9 14.43375 25.00000 -20.00000 2 0 - 10 -28.86750 0.00000 -20.00000 2 0 - 11 14.43375 -25.00000 -20.00000 2 0 - 12 9.23760 22.00000 10.00000 1 0 - 13 -23.67130 3.00000 10.00000 1 0 - 14 -23.67130 -3.00000 10.00000 1 0 - 15 9.23760 -22.00000 10.00000 1 0 - 16 14.43375 -19.00000 10.00000 1 0 - 17 14.43375 19.00000 10.00000 1 0 - 18 4.04145 19.00000 -17.00000 1 0 - 19 -18.47520 6.00000 -17.00000 1 0 - 20 -18.47520 -6.00000 -17.00000 1 0 - 21 4.04145 -19.00000 -17.00000 1 0 - 22 14.43375 -13.00000 -17.00000 1 0 - 23 14.43375 13.00000 -17.00000 1 0 - 24 1.62500 2.81500 10.00000 1 0 - 25 11.43376 19.80385 10.00000 1 0 - 26 -3.25000 0.00000 10.00000 1 0 - 27 -22.87000 0.00000 10.00000 1 0 - 28 1.62500 -2.81500 10.00000 1 0 - 29 11.43376 -19.80385 10.00000 1 0 - 30 1.62500 2.81500 -17.00000 1 0 - 31 8.43376 14.60770 -17.00000 1 0 - 32 -3.25000 0.00000 -17.00000 1 0 - 33 -16.87000 0.00000 -17.00000 1 0 - 34 1.62500 -2.81500 -17.00000 1 0 - 35 8.43376 -14.60770 -17.00000 1 0 - 36 1.62500 2.81500 -16.20000 1 0 - 37 11.43376 19.80385 9.13000 1 0 - 38 -3.25000 0.00000 -16.20000 1 0 - 39 -22.87000 0.00000 9.13000 1 0 - 40 1.62500 -2.81500 -16.20000 1 0 - 41 11.43376 -19.80385 9.13000 1 0 - 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 + (-) (m) (m) (m) (-) (switch) + 1 0.00000 0.00000 -20.00000 1 0 + 2 0.00000 0.00000 10.00000 1 0 + 3 14.43376 25.00000 -14.00000 1 0 + 4 14.43376 25.00000 12.00000 1 0 + 5 -28.86751 0.00000 -14.00000 1 0 + 6 -28.86751 0.00000 12.00000 1 0 + 7 14.43376 -25.00000 -14.00000 1 0 + 8 14.43376 -25.00000 12.00000 1 0 + 9 14.43375 25.00000 -20.00000 2 0 + 10 -28.86750 0.00000 -20.00000 2 0 + 11 14.43375 -25.00000 -20.00000 2 0 + 12 9.23760 22.00000 10.00000 1 0 + 13 -23.67130 3.00000 10.00000 1 0 + 14 -23.67130 -3.00000 10.00000 1 0 + 15 9.23760 -22.00000 10.00000 1 0 + 16 14.43375 -19.00000 10.00000 1 0 + 17 14.43375 19.00000 10.00000 1 0 + 18 4.04145 19.00000 -17.00000 1 0 + 19 -18.47520 6.00000 -17.00000 1 0 + 20 -18.47520 -6.00000 -17.00000 1 0 + 21 4.04145 -19.00000 -17.00000 1 0 + 22 14.43375 -13.00000 -17.00000 1 0 + 23 14.43375 13.00000 -17.00000 1 0 + 24 1.62500 2.81500 10.00000 1 0 + 25 11.43376 19.80385 10.00000 1 0 + 26 -3.25000 0.00000 10.00000 1 0 + 27 -22.87000 0.00000 10.00000 1 0 + 28 1.62500 -2.81500 10.00000 1 0 + 29 11.43376 -19.80385 10.00000 1 0 + 30 1.62500 2.81500 -17.00000 1 0 + 31 8.43376 14.60770 -17.00000 1 0 + 32 -3.25000 0.00000 -17.00000 1 0 + 33 -16.87000 0.00000 -17.00000 1 0 + 34 1.62500 -2.81500 -17.00000 1 0 + 35 8.43376 -14.60770 -17.00000 1 0 + 36 1.62500 2.81500 -16.20000 1 0 + 37 11.43376 19.80385 9.13000 1 0 + 38 -3.25000 0.00000 -16.20000 1 0 + 39 -22.87000 0.00000 9.13000 1 0 + 40 1.62500 -2.81500 -16.20000 1 0 + 41 11.43376 -19.80385 9.13000 1 0 + 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 (-) + 4 NPropSets - Number of 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 + (-) (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) -------------- - SimplCd SimplCdMG SimplCa SimplCaMG SimplCp SimplCpMG SimplAxCa SimplAxCaMG SimplAxCp SimplAxCpMG - (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) - 0.00 0.00 0.00 0.00 1.00 1.00 0.00 0.00 1.00 1.00 + 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 (-) - Dpth DpthCd DpthCdMG DpthCa DpthCaMG DpthCp DpthCpMG DpthAxCa DpthAxCaMG DpthAxCp DpthAxCpMG - (m) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) + 0 NCoefDpth - Number of depth-dependent 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 (-) - MemberID MemberCd1 MemberCd2 MemberCdMG1 MemberCdMG2 MemberCa1 MemberCa2 MemberCaMG1 MemberCaMG2 MemberCp1 MemberCp2 MemberCpMG1 MemberCpMG2 MemberAxCa1 MemberAxCa2 MemberAxCaMG1 MemberAxCaMG2 MemberAxCp1 MemberAxCp2 MemberAxCpMG1 MemberAxCpMG2 - (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) (-) ! Main Column - 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 ! Upper Column 1 - 2 0.61 0.61 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 ! Upper Column 2 - 3 0.61 0.61 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 ! Upper Column 3 - 4 0.61 0.61 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 ! Base Column 1 - 5 0.68 0.68 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 ! Base Column 2 - 6 0.68 0.68 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 ! Base Column 3 - 7 0.68 0.68 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 ! Base column cap 1 - 23 0.68 0.68 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 ! Base column cap 2 - 24 0.68 0.68 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 ! Base column cap 3 - 25 0.68 0.68 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 ! Delta Pontoon, Upper 1 - 8 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 ! Delta Pontoon, Upper 2 - 9 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 ! Delta Pontoon, Upper 3 - 10 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 ! Delta Pontoon, Lower 1 - 11 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 ! Delta Pontoon, Lower 2 - 12 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 ! Delta Pontoon, Lower 3 - 13 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 ! Y Pontoon, Upper 1 - 14 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 ! Y Pontoon, Upper 2 - 15 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 ! Y Pontoon, Upper 3 - 16 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 ! Y Pontoon, Lower 1 - 17 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 ! Y Pontoon, Lower 2 - 18 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 ! Y Pontoon, Lower 3 - 19 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 ! Cross Brace 1 - 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 ! Cross Brace 2 - 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 ! Cross Brace 3 - 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 + 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 + 2 0.61 0.61 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 ! Upper Column 1 + 3 0.61 0.61 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 ! Upper Column 2 + 4 0.61 0.61 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 ! Upper Column 3 + 5 0.68 0.68 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 ! Base Column 1 + 6 0.68 0.68 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 ! Base Column 2 + 7 0.68 0.68 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 ! Base Column 3 + 23 0.68 0.68 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 ! Base column cap 1 + 24 0.68 0.68 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 ! Base column cap 2 + 25 0.68 0.68 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 ! Base column cap 3 + 8 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 ! Delta Pontoon, Upper 1 + 9 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 ! Delta Pontoon, Upper 2 + 10 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 ! Delta Pontoon, Upper 3 + 11 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 ! Delta Pontoon, Lower 1 + 12 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 ! Delta Pontoon, Lower 2 + 13 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 ! Delta Pontoon, Lower 3 + 14 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 ! Y Pontoon, Upper 1 + 15 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 ! Y Pontoon, Upper 2 + 16 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 ! Y Pontoon, Upper 3 + 17 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 ! Y Pontoon, Lower 1 + 18 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 ! Y Pontoon, Lower 2 + 19 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 ! Y Pontoon, Lower 3 + 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 -------------------- MEMBERS ------------------------------------------------- 25 NMembers - Number of members (-) - MemberID MJointID1 MJointID2 MPropSetID1 MPropSetID2 MDivSize MCoefMod 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) (flag) - 1 1 2 1 1 1.0000 3 TRUE ! Main Column - 2 3 4 2 2 1.0000 3 TRUE ! Upper Column 1 - 3 5 6 2 2 1.0000 3 TRUE ! Upper Column 2 - 4 7 8 2 2 1.0000 3 TRUE ! Upper Column 3 - 5 42 3 3 3 1.0000 3 TRUE ! Base Column 1 - 6 43 5 3 3 1.0000 3 TRUE ! Base Column 2 - 7 44 7 3 3 1.0000 3 TRUE ! Base Column 3 - 23 9 42 3 3 1.0000 3 TRUE ! Base column cap 1 - 24 10 43 3 3 1.0000 3 TRUE ! Base column cap 2 - 25 11 44 3 3 1.0000 3 TRUE ! Base column cap 3 - 8 12 13 4 4 1.0000 3 TRUE ! Delta Pontoon, Upper 1 - 9 14 15 4 4 1.0000 3 TRUE ! Delta Pontoon, Upper 2 - 10 16 17 4 4 1.0000 3 TRUE ! Delta Pontoon, Upper 3 - 11 18 19 4 4 1.0000 3 TRUE ! Delta Pontoon, Lower 1 - 12 20 21 4 4 1.0000 3 TRUE ! Delta Pontoon, Lower 2 - 13 22 23 4 4 1.0000 3 TRUE ! Delta Pontoon, Lower 3 - 14 24 25 4 4 1.0000 3 TRUE ! Y Pontoon, Upper 1 - 15 26 27 4 4 1.0000 3 TRUE ! Y Pontoon, Upper 2 - 16 28 29 4 4 1.0000 3 TRUE ! Y Pontoon, Upper 3 - 17 30 31 4 4 1.0000 3 TRUE ! Y Pontoon, Lower 1 - 18 32 33 4 4 1.0000 3 TRUE ! Y Pontoon, Lower 2 - 19 34 35 4 4 1.0000 3 TRUE ! Y Pontoon, Lower 3 - 20 36 37 4 4 1.0000 3 TRUE ! Cross Brace 1 - 21 38 39 4 4 1.0000 3 TRUE ! Cross Brace 2 - 22 40 41 4 4 1.0000 3 TRUE ! Cross Brace 3 + 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 ---------------------- FILLED MEMBERS ------------------------------------------ - 2 NFillGroups - Number of filled member groups (-) [If FillDens = DEFAULT, then FillDens = WtrDens; FillFSLoc is related to MSL2SWL] - FillNumM FillMList FillFSLoc FillDens - (-) (-) (m) (kg/m^3) - 3 2 3 4 -6.17 1025 - 3 5 6 7 -14.89 1025 + 2 NFillGroups - Number of filled member groups (-) [If FillDens = DEFAULT, then FillDens = WtrDens; FillFSLoc is related to MSL2SWL] + FillNumM FillMList FillFSLoc FillDens + (-) (-) (m) (kg/m^3) + 3 2 3 4 -6.17 1025 + 3 5 6 7 -14.89 1025 ---------------------- MARINE GROWTH ------------------------------------------- - 0 NMGDepths - Number of marine-growth depths specified (-) + 0 NMGDepths - Number of marine-growth depths specified (-) MGDpth MGThck MGDens (m) (m) (kg/m^3) ---------------------- MEMBER OUTPUT LIST -------------------------------------- - 0 NMOutputs - Number of member outputs (-) [must be < 10] + 0 NMOutputs - Number of member outputs (-) [must be < 10] MemberID NOutLoc NodeLocs [NOutLoc < 10; node locations are normalized distance from the start of the member, and must be >=0 and <= 1] [unused if NMOutputs=0] - (-) (-) (-) + (-) (-) (-) ---------------------- JOINT OUTPUT LIST --------------------------------------- - 0 NJOutputs - Number of joint outputs [Must be < 10] - 0 JOutLst - List of JointIDs which are to be output (-)[unused if NJOutputs=0] + 0 NJOutputs - Number of joint outputs [Must be < 10] + JOutLst - List of JointIDs which are to be output (-)[unused if NJOutputs=0] ---------------------- OUTPUT -------------------------------------------------- True HDSum - Output a summary file [flag] False OutAll - Output all user-specified member and joint loads (only at each member end, not interior locations) [flag] - 1 OutSwtch - Output requested channels to: [1=Hydrodyn.out, 2=GlueCode.out, 3=both files] - "ES11.4e2" OutFmt - Output format for numerical results (quoted string) [not checked for validity!] + 2 OutSwtch - Output requested channels to: [1=Hydrodyn.out, 2=GlueCode.out, 3=both files] + "E16.8e2" OutFmt - Output format for numerical results (quoted string) [not checked for validity!] "A11" OutSFmt - Output format for header strings (quoted string) [not checked for validity!] ---------------------- OUTPUT CHANNELS ----------------------------------------- - "Wave1Elev" - Wave elevation at the platform reference point (0, 0) + HydroFxi + HydroFyi + HydroFzi + HydroMxi + HydroMyi + HydroMzi END of output channels and end of file. (the word "END" must appear in the first 3 columns of this line) Appendix B: OC4 Semi-submersible Input File @@ -255,34 +227,29 @@ Appendix B: OC4 Semi-submersible Input File The following is a HydroDyn driver input file for OC4 semi-submersible structure:: - HydroDyn Driver file for OC4 Semi-submersible. - Compatible with HydroDyn v2.03.* - TRUE Echo - Echo the input file data (flag) + ------- HydroDyn Driver Input File -------------------------------------------- + HydroDyn Driver file for OC4 Semi-submersible. + FALSE Echo - Echo the input file data (flag) ---------------------- ENVIRONMENTAL CONDITIONS ------------------------------- - 9.80665 Gravity - Gravity (m/s^2) - 1025 WtrDens - Water density (kg/m^3) - 200 WtrDpth - Water depth (meters) - 0 MSL2SWL - Offset between still-water level and mean sea level (meters) [positive upward; unused when WaveMod = 6; must be zero if PotMod=1 or 2] + 9.80665 Gravity - Gravity (m/s^2) + 1025 WtrDens - Water density (kg/m^3) + 200 WtrDpth - Water depth (m) + 0 MSL2SWL - Offset between still-water level and mean sea level (m) [positive upward] ---------------------- HYDRODYN ----------------------------------------------- - "./OC4Semi.dat" HDInputFile - Primary HydroDyn input file name (quoted string) - "./OC4Semi" OutRootName - The name which prefixes all HydroDyn generated files (quoted string) - 1 NSteps - Number of time steps in the simulations (-) - 0.025 TimeInterval - TimeInterval for the simulation (sec) - ---------------------- WAMIT INPUTS ------------------------------------------- - 1 WAMITInputsMod - Inputs model {0: all inputs are zero for every timestep, 1: steadystate inputs, 2: read inputs from a file (InputsFile)} (switch) - "" WAMITInputsFile - Name of the inputs file if InputsMod = 2 (quoted string) - ---------------------- WAMIT STEADY STATE INPUTS ----------------------------- - 1.0 2.0 3.0 4.0 5.0 6.0 uWAMITInSteady - input displacements and rotations at the platform reference point (m, rads) - 7.0 8.0 9.0 10.0 11.0 12.0 uDotWAMITInSteady - input translational and rotational velocities at the platform reference point (m/s, rads/s) - 13.0 14.0 15.0 16.0 17.0 18.0 uDotDotWAMITInSteady - input translational and rotational acccelerations at the platform reference point (m/s^2, rads/s^2) - ---------------------- MORISON INPUTS ----------------------------------------- - 0 MorisonInputsMod - Inputs model {0: all inputs are zero for every timestep, 1: steadystate inputs, 2: read inputs from a file (InputsFile)} (switch) - " " MorisonInputsFile - Name of the inputs file if InputsMod = 2 (quoted string) - ---------------------- MORISON STEADY STATE INPUTS --------------------------- - 1.0 2.0 3.0 4.0 5.0 6.0 uMorisonInSteady - input displacements and rotations for the morison elements (m, rads) - 7.0 8.0 9.0 10.0 11.0 12.0 uDotMorisonInSteady - input translational and rotational velocities for the morison elements (m/s, rads/s) - 13.0 14.0 15.0 16.0 17.0 18.0 uDotDotMorisonInSteady - input translational and rotational acccelerations for the morison elements (m/s^2, rads/s^2) - END of driver input file + "./OC4Semi.dat" HDInputFile - Primary HydroDyn input file name (quoted string) + "./SeaState.dat" SeaStateInputFile - Primary SeaState input file name (quoted string) + "./OC4Semi" OutRootName - The name which prefixes all HydroDyn generated files (quoted string) + FALSE Linearize - Flag to enable linearization + 4801 NSteps - Number of time steps in the simulation (-) [60 seconds total] + 0.0125 TimeInterval - Time step for the simulation (sec) + ---------------------- PRP INPUTS (Platform Reference Point) ------------------ + 0 PRPInputsMod - Model for the PRP (platform reference point) inputs {0: all inputs are zero for every timestep, 1: steady-state inputs, 2: read inputs from a file (InputsFile)} (switch) + 0 PtfmRefzt - Vertical distance from the ground level to the platform reference point (m) + "not_used" PRPInputsFile - Filename for the PRP HydroDyn input InputsMod = 2 (quoted string) + ---------------------- PRP STEADY STATE INPUTS ------------------------------- + 0, 0, 0, 0, 0, 0 uPRPInSteady - PRP Steady-state (3) displacements and (3) rotations at the platform reference point (m, m, m, rad, rad, rad) + 0, 0, 0, 0, 0, 0 uDotPRPInSteady - PRP Steady-state (3) translational and (3) rotational velocities at the platform reference point (m/s, rads/s) + 0, 0, 0, 0, 0, 0 uDotDotPRPInSteady - PRP Steady-state (3) translational and (3) rotational accelerations at the platform reference point (m/s^2, rads/s^2) .. _hd-output-channels: @@ -308,14 +275,11 @@ global inertial-frame coordinate. Channel Name(s) Units Description ================================================================ ========================================================================================================== ======================================================================================== **Wave and Current Kinematics** -WaveαElev (m) Total (first- plus second-order) wave elevations (up to 9 designated locations) -WaveαElv1 (m) First-order wave elevations (up to 9 designated locations) -WaveαElv2 (m) Second-order wave elevations (up to 9 designated locations) MαNβVxi, MαNβVyi, MαNβVzi (m/s), (m/s), (m/s) Total (first- plus second-order) fluid particle velocities at MαNβ -MαNβAxi, MαNβAyi, MαNβAzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`) Total (first- plus second-order) fluid particle accelerations at MαNβ +MαNβAxi, MαNβAyi, MαNβAzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`) Total (first- plus second-order) fluid particle accelerations at MαNβ MαNβDynP (Pa) Total (first- plus second-order) fluid particle dynamic pressure at MαNβ JαVxi, JαVyi, JαVzi (m/s), (m/s), (m/s) Total (first- plus second-order) fluid particle velocities at Jα -JαAxi, JαAyi, JαAzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`) Total (first- plus second-order) fluid particle accelerations at Jα +JαAxi, JαAyi, JαAzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`) Total (first- plus second-order) fluid particle accelerations at Jα JαDynP (Pa) Total (first- plus second-order) fluid particle dynamic pressure at Jα **Total and Additional Loads** BαAddFxi, BαAddFyi, BαAddFzi, BαAddMxi, BαAddMyi, BαAddMzi (N), (N), (N), (N·m), (N·m), (N·m) Loads due to additional preload, stiffness, and damping at Bα @@ -327,13 +291,16 @@ BαWvsF2xi, BαWvsF2yi, BαWvsF2zi, BαWvsM2xi, BαWvsM2yi, BαWvsM2zi (N), (N), BαHdSFxi, BαHdSFyi, BαHdSFzi, BαHdSMxi, BαHdSMyi, BαHdSMzi (N), (N), (N), (N·m), (N·m), (N·m) Hydrostatic loads at Bα BαRdtFxi, BαRdtFyi, BαRdtFzi, BαRdtMxi, BαRdtMyi, BαRdtMzi (N), (N), (N), (N·m), (N·m), (N·m) Wave-radiation loads at Bα **Structural Motions** +PRPSurge, PRPSway, PRPHeave, PRPRoll, PRPPitch, PRPYaw (m), (m), (m), (rad), (rad), (rad) Displacements and rotations at platform reference point (PRP) +PRPTVxi, PRPTVyi, PRPTVzi, PRPRVxi, PRPRVyi, PRPRVzi (m/s), (m/s), (m/s), (rad/s), (rad/s), (rad/s) Translational and rotational velocities of the PRP +PRPTAxi, PRPTAyi, PRPTAzi, PRPRAxi, PRPRAyi, PRPRAzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`), (rad/s\ :sup:`2`), (rad/s\ :sup:`2`), (rad/s\ :sup:`2`) Translational and rotational accelerations of the PRP BαSurge, BαSway, BαHeave, BαRoll, BαPitch BαYaw (m), (m), (m), (rad), (rad), (rad) Displacements and rotations at Bα BαTVxi, BαTVyi, BαTVzi, BαRVxi, BαRVyi, BαRVzi (m/s), (m/s), (m/s), (rad/s), (rad/s), (rad/s) Translational and rotational velocities at Bα BαTAxi, BαTAyi, BαTAzi, BαRAxi, BαRAyi, BαRAzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`), (rad/s\ :sup:`2`), (rad/s\ :sup:`2`), (rad/s\ :sup:`2`) Translational and rotational accelerations at Bα MαNβSTVxi, MαNβSTVyi, MαNβSTVzi (m/s), (m/s), (m/s) Structural translational velocities at MαNβ -MαNβSTAxi, MαNβSTAyi, MαNβSTAzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`) Structural translational accelerations at MαNβ +MαNβSTAxi, MαNβSTAyi, MαNβSTAzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`) Structural translational accelerations at MαNβ JαSTVxi, JαSTVyi, JαSTVzi (m/s), (m/s), (m/s) Structural translational velocities at Jα -JαSTAxi, JαSTAyi, JαSTAzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`) Structural translational accelerations at Jα +JαSTAxi, JαSTAyi, JαSTAzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`) Structural translational accelerations at Jα **Distributed Loads (Per Unit Length) on Members** MαNβFDxi, MαNβFDyi, MαNβFDzi (N/m), (N/m), (N/m) Viscous-drag forces at MαNβ MαNβFIxi, MαNβFIyi, MαNβFIzi (N/m), (N/m), (N/m) Fluid-inertia forces at MαNβ diff --git a/docs/source/user/hydrodyn/input_files.rst b/docs/source/user/hydrodyn/input_files.rst index 08529c0d7f..df6d5fdc27 100644 --- a/docs/source/user/hydrodyn/input_files.rst +++ b/docs/source/user/hydrodyn/input_files.rst @@ -58,7 +58,7 @@ computed and printed to the calling terminal. **NSteps** specifies the number of simulation time steps, and **TimeInterval** specifies the time between steps. -Setting **PRPInputsMod** = 0 forces all principal reference point (PRP) +Setting **PRPInputsMod** = 0 forces all platform reference point (PRP) input motions to zero for all time. If you set **PRPInputsMod** = 1, then you must set the steady-state inputs in the PRP STEADY STATE INPUTS section of the file. Setting **PRPInputsMod** = 2 requires the diff --git a/docs/source/user/hydrodyn/output_files.rst b/docs/source/user/hydrodyn/output_files.rst index 0e692b3f1d..c3212f62c9 100644 --- a/docs/source/user/hydrodyn/output_files.rst +++ b/docs/source/user/hydrodyn/output_files.rst @@ -2,9 +2,9 @@ Output Files ============ -HydroDyn produces four types of output files: an echo file, a -wave-elevations file, a summary file, and a time-series results file. -The following sections detail the purpose and contents of these files. +HydroDyn produces three types of output files: an echo file, a summary +file, and a time-series file. The following sections detail the +purpose and contents of these files. Echo Files ~~~~~~~~~~ @@ -13,28 +13,12 @@ HydroDyn primary input file, the contents of those files will be echoed to a file with the naming conventions, **OutRootName**\ *.dvr.ech* for the driver input file and **OutRootName**\ *.HD.ech* for the HydroDyn primary input file. **OutRootName** is either specified in the HYDRODYN -section of the driver input file, or by the FAST program. The echo files +section of the driver input file, or by the OpenFAST program. The echo files are helpful for debugging your input files. The contents of an echo file will be truncated if HydroDyn encounters an error while parsing an input file. The error usually corresponds to the line after the last successfully echoed line. -Wave-Elevations File -~~~~~~~~~~~~~~~~~~~~ -Setting **WaveElevSeriesFlag** in the driver file to TRUE enables the -outputting of a grid of wave elevations to a text-based file with the -name ``OutRootName.WaveElev.out``. The grid consists of -**WaveElevNX** by **WaveElevNY** wave elevations (centered at *X* = 0, -*Y* = 0) with a **dX** and **dY** spacing in the global inertial-frame -coordinate system. These wave elevations are distinct and output -separately from the wave elevations determined by **NWaveElev** in the -HydroDyn primary input file, such that the total number of wave -elevation outputs is **NWaveElev** + ( **WaveElevNX** × **WaveElevNY** -). The wave-elevation output file ``OutRootName.WaveElev.out`` -contains the total wave elevation, which is the sum of the first- and -second-order terms (when the second-order wave kinematics are optionally -enabled). - .. _hd-summary-file: Summary File @@ -43,35 +27,35 @@ HydroDyn generates a summary file with the naming convention, **OutRootName**\ *.HD.sum* if the **HDSum** parameter is set to TRUE. This file summarizes key information about your hydrodynamics model, including buoyancy, substructure volumes, marine growth weight, the -simulation mesh and its properties, first-order wave frequency -components, and the radiation kernel. +simulation mesh and its properties, and the radiation kernel for +potential-flow bodies. When the text refers to an index, it is referring to a given row in a table. The indexing starts at 1 and increases consecutively down the rows. -WAMIT-model volume and buoyancy information +WAMIT-Model Volume and Buoyancy Information ------------------------------------------- -This section summarizes the buoyancy of the potential-flow-model -platform in its undisplaced configuration. For a hybrid -potential-flow/strip-theory model, these buoyancy values must be added -to any strip-theory member buoyancy reported in the subsequent sections -to obtain the total buoyancy of the platform. +This section summarizes the buoyancy of each potential-flow body in +its undisplaced position. For a hybrid potential-flow/strip-theory +model, these buoyancy values must be added to any strip-theory member +buoyancy reported in the subsequent sections to obtain the total +buoyancy of the platform. -Substructure Volume Calculations +Strip-Theory Volume Calculations -------------------------------- -This section contains a summary of the total substructure volume, the +This section contains a summary of the combined total volume, submerged volume, volume of any marine growth, and fluid-filled -(flooded/ballasted) volume for the substructure in its undisplaced -configuration. Except for the fluid-filled volume value, the reported +(flooded/ballasted) volume of all strip-theory members in their undisplaced +positions. Except for the fluid-filled volume value, the reported volumes are only for members that have the **PropPot** flag set to FALSE. The flooded/ballasted volume applies to any fluid-filled member, regardless of its **PropPot** flag. -Integrated Buoyancy Loads +Total Buoyancy Loads ------------------------- This section details the buoyancy loads of the undisplaced substructure -when summed about the WRP (0,0,0). The external buoyancy includes the +when summed about (0,0,0). The external buoyancy includes the effects of marine growth, and only applies to members whose **PropPot** flag is set to FALSE. The internal buoyancy is the negative effect on buoyancy due to flooding or ballasting and is independent of the @@ -80,64 +64,58 @@ buoyancy due to flooding or ballasting and is independent of the Integrated Marine Growth Weights -------------------------------- This section details the marine growth weight loads of the undisplaced -substructure when summed about the WRP (0,0,0). - -Simulation Node Table ---------------------- -This table details the undisplaced nodal information and properties for -all internal analysis nodes used by the HydroDyn model. The node index -is provided in the first column. The second column maps the node to the -input joint index (not to be confused with the **JointID**). If a value -of -1 is found in this column, the node is an interior node and results -from an input member being split somewhere along its length due to the -requirements of the **MDivSize** parameter in the primary input file -members table. -The third column indicates if this node is part of a Super -Member (**JointOvrlp** = 1). The next column tells you the corresponding -input member index (not to be confused with the **MemberID**). **Nxi**, -**Nyi**, and **Nzi**, provide the (*X*,\ *Y*,\ *Z*) coordinates in the -global inertial-frame coordinate system. **InpMbrDist** provides the -normalized distance to the node from the start of the input member. -**R** is the outer radius of the member at the node (excluding marine -growth), and **t** is the member wall thickness at the node. **dRdZ** is -the taper of the member at the node, **tMG** is the marine growth -thickness, and **MGDens** is the marine growth density. **PropPot** -indicates whether the element attached to this node is modeled using -potential-flow theory. If **FilledFlag** is TRUE, then **FillDens** -gives the filled fluid density and **FillFSLoc** indicates the -free-surface height (*Z*-coordinate). **Cd**, **Ca**, **Cp**, **AxCa**, -**AxCp**, **JAxCd**, **JAxCa**, and **JAxCp** are the viscous-drag, -added-mass, dynamic-pressure, axial added-mass, axial dynamic-pressure, -end-effect axial viscous-drag, end-effect axial added-mass, and -end-effect axial dynamic-pressure coefficients, respectively. **NConn** -gives the number of elements connected to node, and **Connection List** -is the list of element indexes attached to the node. +substructure when summed about (0,0,0). + +Strip-Theory Node Table +----------------------- +This table details the undisplaced strip-theory nodal information and properties for +all user defined joints and internal analysis nodes generated by HydroDyn. +The internal nodes are generated by splitting input members somewhere +along its length to meet the requirements of the **MDivSize** parameter in +the primary input file member table. The node index is provided in the +first column. The second column provides the input member index (not to be +confused with the **MemberID**) each internal node belongs to. +User-defined joints do not necessarily belong to a specific member, so no +information is provided on this column for these joints. **Nxi**, **Nyi**, and **Nzi** +provide the (*X*,\ *Y*,\ *Z*) coordinates in the global inertial-frame +coordinate system. **R** is the outer radius of the member at the node +(excluding marine growth), and **t** is the member wall thickness at the node. +**tMG** is the marine growth thickness, and **MGDens** is the marine growth +density. **PropPot** indicates whether the element attached to this node +is modeled using potential-flow theory. If **FilledFlag** is TRUE, then **FillMass** +gives the filled fluid mass assigned to the node. **Cd**, **Ca**, **Cp**, **Cb**, **AxCd**, **AxCa**, +**AxCp**, **JAxCd**, **JAxCa**, and **JAxCp** are the transverse drag, +transverse added-mass, transverse dynamic-pressure, buoyancy-scaling, axial drag, axial added-mass, +axial dynamic-pressure, endplate axial drag, endplate axial added-mass, and +endplate axial dynamic-pressure coefficients, respectively. Note that some of the columns +are only populated for user-defined joints, while other columns are only populated +for internal analysis nodes belonging to a single member. .. TODO 7.5.2 is the theory section which does not yet exist. .. See Section 7.5.2 for the member splitting rules used by HydroDyn. -Simulation Element Table ------------------------- -This section details the undisplaced simulation elements and their +Strip-Theory Member Table +------------------------- +This section details the undisplaced strip-theory members and their associated properties. A suffix of 1 or 2 in a column heading refers to -the element’s starting or ending node, respectively. The first column is -the element index. **node1** and **node2** refer to the node index found -in the node table of the previous section. Next are the element -**Length** and exterior **Volume**. This exterior volume calculation -includes any effects of marine growth. **MGVolume** provides the volume -contribution due to marine growth. The cross-sectional properties of -outer radius (excluding marine growth), marine growth thickness, and -wall thickness for each node are given by **R1**, **tMG1**, **t1**, -**R2**, **tMG2**, and **t2**, respectively. **MGDens1** and **MGDens2** -are the marine growth density at node 1 and 2. **PropPot** indicates if -the element is modeled using potential-flow theory. If the element is +the starting or ending node of the member, respectively. The first column is +the member index. **joint1** and **joint2** refer to the node index found +in the node table of the previous section. Next are the member +**Length**, the number of subdivided elements **NElem** to meet the +**MDivSize** requirement, and the exterior **Volume**. This exterior volume +calculation includes any marine growth volume on the member. **MGVolume** provides the volume +contribution due to marine growth. **Volume** and **MGVolume** will be zeros +for members modeled by potential flow, i.e., with **PropPot** = T for TRUE. +The cross-sectional properties of outer radius (including marine growth) and wall thickness for each +node are given by **R1**, **t1**, **R2**, and **t2**, respectively. **PropPot** indicates if +the member is modeled using potential-flow theory. If the element is fluid-filled (has flooding or ballasting), **FilledFlag** is set to -**T** for TRUE. **FillDensity** and **FillFSLoc** are the filled fluid -density and the free-surface location’s *Z*-coordinate in the global -inertial-frame coordinate system. **FillMass** is calculated by +T for TRUE. **FillDensity** and **FillFSLoc** are the filled fluid +density and the free-surface location (*Z*-coordinate in the global +inertial-frame coordinate system). **FillMass** is calculated by multiplying the **FillDensity** value by the element’s interior volume. -Finally, the element hydrodynamic coefficients are listed. These are the -same coefficients listed in the node table (above). +Finally, the hydrodynamic coefficients at the two end joints are listed. +These are the same coefficients listed in the node table (above). Summary of User-Requested Outputs --------------------------------- @@ -146,73 +124,57 @@ joint output channels. Member Outputs ++++++++++++++ -The first column lists the data channel’s string label, as entered in +The first column lists the string labels of the data channels, as entered in the OUTPUT CHANNELS section of the HydroDyn input file. **Xi**, **Yi**, -**Zi**, provide the output’s undisplaced spatial location in the global -inertial-frame coordinate system. The next column, **InpMbrIndx**, tells -you the corresponding input member index (not to be confused with the -**MemberID**). Next are the coordinates of the starting (**StartXi**, -**StartYi**, **StartZi**) and ending (**EndXi**, **EndYi**, **EndZi**) -nodes of the element containing this output location. **Loc** is the -normalized distance from the starting node of this element. +and **Zi** provide the coordinates of the output location in the global +inertial-frame system when the structure is not displaced. The next column, +**MemberID**, tells you the corresponding input member index. Next are +the coordinates of the starting (**StartXi**, **StartYi**, **StartZi**) +and ending (**EndXi**, **EndYi**, **EndZi**) nodes of the member containing +this output location. **Loc** is the normalized distance from the starting +node of this member. Joint Outputs +++++++++++++ -The first column lists the data channel’s string label, as entered in +The first column lists the string labels of the data channels, as entered in the OUTPUT CHANNELS section of the HydroDyn input file. **Xi**, **Yi**, -**Zi**, provide the output’s undisplaced spatial location in the global -inertial-frame coordinate system. **InpJointID** specifies the -**JointID** for the output as given in the MEMBER JOINTS table of the -HydroDyn input file. - -The Wave Number and Complex Values of the Wave Elevations as a Function of Frequency ------------------------------------------------------------------------------------- -This section provides the frequency-domain description (in terms of a -Discrete Fourier Transform or DFT) of the first-order wave elevation at -(0,0) on the free surface, but is not written when **WaveMod** = 0 or 6. -The first column, **m**, identifies the index of each wave frequency -component. The finite-depth wave number, frequency, and direction of the -wave component are given by **k**, **Omega**, and **Direction**, -respectively. The last two columns provide the real -(**REAL(DFT{WaveElev})**) and imaginary (**IMAG(DFT{WaveElev})**) -components of the DFT of the first-order wave elevation. The DFT -produces includes both the negative- and positive-frequency components. -The negative-frequency components are complex conjugates of the positive -frequency components because the time-domain wave elevation is -real-valued. The relationships between the negative- and -positive-frequency components of the DFT are given by -:math:`k\left( - \omega \right) = - k\left( \omega \right)` and -:math:`H\left( - \omega \right) = {H\left( \omega \right)}^{*}`, where -*H* is the DFT of the wave elevation and *\** denotes the complex -conjugate. +and **Zi** provide the coordinates of the output joint in the global +inertial-frame system when the structure is not displaced. **InpJointID** +specifies the **JointID** for the output as given in the MEMBER JOINTS table +of the HydroDyn input file. Radiation Memory Effect Convolution Kernel ------------------------------------------ - In the potential-flow solution based on frequency-to-time-domain transforms, HydroDyn computes the radiation kernel used by the convolution method for calculating the radiation memory effect through -the cosine transform of the 6x6 frequency-dependent hydrodynamic damping +the cosine transform of the frequency-dependent hydrodynamic damping matrix from the radiation problem. The resulting time-domain radiation -kernel (radiation impulse-response function)—which is a 6x6 -time-dependent matrix—is provided in this section. **n** and **t** give -the time-step index and time, which are followed by the elements +kernel (radiation impulse-response function), a time-dependent +matrix, is provided in this section. **n** and **t** give +the time-step index and time, which are followed by the entries of the matrix (**K11**, **K12**, etc.) of the radiation kernel associated with that time. Because the frequency-dependent hydrodynamic damping matrix is symmetric, so is the radiation kernel; thus, only the diagonal and upper-triangular portion of the matrix are provided. The radiation kernel should decay to zero after a short amount of time, which should -aid in selecting an appropriate value of **RdtnTMax**. +aid in selecting an appropriate value of **RdtnTMax**. The dimensions of the +radiation kernel matrix depend on the number of potential-flow bodies +present (**NBody**) and **NBodyMod** in the HydroDyn primary input file. If +**NBodyMod** = 1 (full hydrodynamic coupling), the summary file will contain +data for a single 6\ **NBody**-by-6\ **NBody** matrix. If **NBodyMod** > 1 +(no hydrodynamic coupling), the summary file will contain data for **NBody** +6-by-6 radiation kernal matrices. Results File ~~~~~~~~~~~~ The HydroDyn time-series results are written to a text-based file with the naming convention ``OutRootName.HD.out`` when **OutSwtch** is -set to either 1 or 3. If HydroDyn is coupled to FAST and **OutSwtch** is -set to 2 or 3, then FAST will generate a master results file that +set to either 1 or 3. If HydroDyn is coupled to OpenFAST and **OutSwtch** is +set to 2 or 3, then OpenFAST will generate a master results file that includes the HydroDyn results. The results are in table format, where -each column is a data channel (the first column always being the +each column is a data channel (the first column is always the simulation time), and each row corresponds to a simulation output time step. The data channels are specified in the OUTPUT CHANNELS section of the HydroDyn primary input file. The column format of the diff --git a/docs/source/user/seastate/appendix.rst b/docs/source/user/seastate/appendix.rst new file mode 100644 index 0000000000..27e93d3da1 --- /dev/null +++ b/docs/source/user/seastate/appendix.rst @@ -0,0 +1,140 @@ + +.. _ss-primary-input_example: + +Appendix A: Example SeaState primary input file +=============================================== + +The following is a SeaState primary input file generating irregular (JONSWAP) waves internally +structure:: + + ------- SeaState v1.00.* Input File -------------------------------------------- + Example SeaState primary input file + False Echo - Echo the input file data (flag) + ---------------------- ENVIRONMENTAL CONDITIONS -------------------------------- + "default" WtrDens - Water density (kg/m^3) + "default" WtrDpth - Water depth (meters) relative to MSL + "default" MSL2SWL - Offset between still-water level and mean sea level (meters) [positive upward; unused when WaveMod = 6; must be zero if PotMod=1 or 2] + ---------------------- SPATIAL DISCRETIZATION --------------------------------------------------- + 30.0 X_HalfWidth – Half-width of the domain in the X direction (m) [>0, NOTE: X[nX] = nX*dX, where nX = {-NX+1,-NX+2,…,NX-1} and dX = X_HalfWidth/(NX-1)] + 30.0 Y_HalfWidth – Half-width of the domain in the Y direction (m) [>0, NOTE: Y[nY] = nY*dY, where nY = {-NY+1,-NY+2,…,NY-1} and dY = Y_HalfWidth/(NY-1)] + 25.0 Z_Depth – Depth of the domain the Z direction (m) relative to SWL [0 < Z_Depth <= WtrDpth+MSL2SWL; "default": Z_Depth = WtrDpth+MSL2SWL; Z[nZ] = ( COS( nZ*dthetaZ ) – 1 )*Z_Depth, where nZ = {0,1,…NZ-1} and dthetaZ = pi/( 2*(NZ-1) )] + 10 NX – Number of nodes in half of the X-direction domain (-) [>=2] + 10 NY – Number of nodes in half of the Y-direction domain (-) [>=2] + 10 NZ – Number of nodes in the Z direction (-) [>=2] + ---------------------- WAVES --------------------------------------------------- + 2 WaveMod - Incident wave kinematics model {0: none=still water, 1: regular (periodic), 1P#: regular with user-specified phase, 2: JONSWAP/Pierson-Moskowitz spectrum (irregular), 3: White noise spectrum (irregular), 4: user-defined spectrum from routine UserWaveSpctrm (irregular), 5: Externally generated wave-elevation time series, 6: Externally generated full wave-kinematics time series [option 6 is invalid for PotMod/=0], 7: User-defined wave frequency components} (switch) + 1 WaveStMod - Model for stretching incident wave kinematics to instantaneous free surface {0: none=no stretching, 1: vertical stretching, 2: extrapolation stretching, 3: Wheeler stretching} (switch) [unused when WaveMod=0 or when PotMod/=0] + 600 WaveTMax - Analysis time for incident wave calculations (sec) [unused when WaveMod=0; determines WaveDOmega=2Pi/WaveTMax in the IFFT] + 0.2 WaveDT - Time step for incident wave calculations (sec) [unused when WaveMod=0 or 7; 0.1<=WaveDT<=1.0 recommended; determines WaveOmegaMax=Pi/WaveDT in the IFFT] + 2.0 WaveHs - Significant wave height of incident waves (meters) [used only when WaveMod=1, 2, or 3] + 10 WaveTp - Peak-spectral period of incident waves (sec) [used only when WaveMod=1 or 2] + "DEFAULT" WavePkShp - Peak-shape parameter of incident wave spectrum (-) or DEFAULT (string) [used only when WaveMod=2; use 1.0 for Pierson-Moskowitz] + 0.314159 WvLowCOff - Low cut-off frequency or lower frequency limit of the wave spectrum beyond which the wave spectrum is zeroed (rad/s) [unused when WaveMod=0, 1, or 6] + 1.570796 WvHiCOff - High cut-off frequency or upper frequency limit of the wave spectrum beyond which the wave spectrum is zeroed (rad/s) [unused when WaveMod=0, 1, or 6] + 0 WaveDir - Incident wave propagation heading direction (degrees) [unused when WaveMod=0 or 6] + 0 WaveDirMod - Directional spreading function {0: none, 1: COS2S} (-) [only used when WaveMod=2,3, or 4] + 1 WaveDirSpread - Wave direction spreading coefficient ( > 0 ) (-) [only used when WaveMod=2,3, or 4 and WaveDirMod=1] + 1 WaveNDir - Number of wave directions (-) [only used when WaveMod=2,3, or 4 and WaveDirMod=1; odd number only] + 0 WaveDirRange - Range of wave directions (full range: WaveDir +/- 1/2*WaveDirRange) (degrees) [only used when WaveMod=2,3,or 4 and WaveDirMod=1] + 123456789 WaveSeed(1) - First random seed of incident waves [-2147483648 to 2147483647] (-) [unused when WaveMod=0, 5, or 6] + RANLUX WaveSeed(2) - Second random seed of incident waves [-2147483648 to 2147483647] for intrinsic pRNG, or an alternative pRNG: "RanLux" (-) [unused when WaveMod=0, 5, or 6] + FALSE WaveNDAmp - Flag for normally distributed amplitudes (flag) [only used when WaveMod=2, 3, or 4] + "unused" WvKinFile - Root name of externally generated wave data file(s) (quoted string) [used only when WaveMod=5 or 6] + ---------------------- 2ND-ORDER WAVES ----------------------------------------- [unused with WaveMod=0 or 6] + FALSE WvDiffQTF - Full difference-frequency 2nd-order wave kinematics (flag) + FALSE WvSumQTF - Full summation-frequency 2nd-order wave kinematics (flag) + 0 WvLowCOffD - Low frequency cutoff used in the difference-frequencies (rad/s) [Only used with a difference-frequency method] + 1.256637 WvHiCOffD - High frequency cutoff used in the difference-frequencies (rad/s) [Only used with a difference-frequency method] + 0.618319 WvLowCOffS - Low frequency cutoff used in the summation-frequencies (rad/s) [Only used with a summation-frequency method] + 3.141593 WvHiCOffS - High frequency cutoff used in the summation-frequencies (rad/s) [Only used with a summation-frequency method] + ---------------------- CONSTRAINED WAVES --------------------------------------- + 0 ConstWaveMod - Constrained wave model: 0=none; 1=Constrained wave with specified crest elevation, alpha; 2=Constrained wave with guaranteed peak-to-trough crest height, HCrest (flag) + 3 CrestHmax - Crest height (2*alpha for ConstWaveMod=1 or HCrest for ConstWaveMod=2), must be larger than WaveHs (m) [unused when ConstWaveMod=0] + 60 CrestTime - Time at which the crest appears (s) [unused when ConstWaveMod=0] + 0 CrestXi - X-position of the crest (m) [unused when ConstWaveMod=0] + 0 CrestYi - Y-position of the crest (m) [unused when ConstWaveMod=0] + ---------------------- CURRENT ------------------------------------------------- [unused with WaveMod=6] + 0 CurrMod - Current profile model {0: none=no current, 1: standard, 2: user-defined from routine UserCurrent} (switch) + 0 CurrSSV0 - Sub-surface current velocity at still water level (m/s) [used only when CurrMod=1] + "DEFAULT" CurrSSDir - Sub-surface current heading direction (degrees) or DEFAULT (string) [used only when CurrMod=1] + 20 CurrNSRef - Near-surface current reference depth (meters) [used only when CurrMod=1] + 0 CurrNSV0 - Near-surface current velocity at still water level (m/s) [used only when CurrMod=1] + 0 CurrNSDir - Near-surface current heading direction (degrees) [used only when CurrMod=1] + 0 CurrDIV - Depth-independent current velocity (m/s) [used only when CurrMod=1] + 0 CurrDIDir - Depth-independent current heading direction (degrees) [used only when CurrMod=1] + ---------------------- MacCamy-Fuchs diffraction model ------------------------- + 0 MCFD - MacCamy-Fuchs member radius (ignored if radius <= 0) [must be 0 when WaveMod 0 or 6] + ---------------------- OUTPUT -------------------------------------------------- + False SeaStSum - Output a summary file [flag] + 3 OutSwtch - Output requested channels to: [1=SeaState.out, 2=GlueCode.out, 3=both files] + "E15.7e2" OutFmt - Output format for numerical results (quoted string) [not checked for validity!] + "A15" OutSFmt - Output format for header strings (quoted string) [not checked for validity!] + 2 NWaveElev - Number of points where the incident wave elevations can be computed (-) [maximum of 9 output locations] + 0.0, 5.0 WaveElevxi - List of xi-coordinates for points where the incident wave elevations can be output (meters) [NWaveElev points, separated by commas or white space; usused if NWaveElev = 0] + 0.0, 0.0 WaveElevyi - List of yi-coordinates for points where the incident wave elevations can be output (meters) [NWaveElev points, separated by commas or white space; usused if NWaveElev = 0] + 2 NWaveKin - Number of points where the wave kinematics can be output (-) [maximum of 9 output locations] + 0.0, 0.0 WaveKinxi - List of xi-coordinates for points where the wave kinematics can be output (meters) [NWaveKin points, separated by commas or white space; usused if NWaveKin = 0] + 0.0, 5.0 WaveKinyi - List of yi-coordinates for points where the wave kinematics can be output (meters) [NWaveKin points, separated by commas or white space; usused if NWaveKin = 0] + -14.0, -17.0 WaveKinzi - List of zi-coordinates for points where the wave kinematics can be output (meters) [NWaveKin points, separated by commas or white space; usused if NWaveKin = 0] + ---------------------- OUTPUT CHANNELS ----------------------------------------- + "Wave1Elev, Wave1Elv1, Wave1Elv2" - Wave elevation + "Wave2Elev, Wave2Elv1, Wave2Elv2" + "FVel1xi, FVel1yi, FVel1zi" - fluid velocity at location 1 + "FAcc1xi, FAcc1yi, FAcc1zi" - fluid accelerations at location 1 + "FDynP1" - fluid dynamic pressure at location 1 + "FVel2xi, FVel2yi, FVel2zi" - fluid velocity at location 2 + "FAcc2xi, FAcc2yi, FAcc2zi" - fluid accelerations at location 2 + "FDynP2" + END + +Appendix B: Example SeaState driver input file +============================================== +The following is a SeaState driver input file +structure:: + + Seastate driver file + Compatible with SeaState v1.00 + FALSE Echo - Echo the input file data (flag) + ---------------------- ENVIRONMENTAL CONDITIONS ------------------------------- + 9.80665 Gravity - Gravity (m/s^2) + 1025 WtrDens - Water density (kg/m^3) + 200 WtrDpth - Water depth (m) + 0 MSL2SWL - Offset between still-water level and mean sea level (m) [positive upward] + ---------------------- SEASTATE ----------------------------------------------- + "./seastate_input.dat" SeaStateInputFile - Primary SeaState input file name (quoted string) + "./seastate.SeaSt" OutRootName - The name which prefixes all SeaState generated files (quoted string) + 0 WrWvKinMod - Write wave kinematics? [0: Do not write any kinematics to file, 1: Write only the (0,0) wave elevations to file, 2: Write the complete wave kinematics to files, no files written if WaveMod=6] + 5001 NSteps - Number of time steps in the simulations (-) + 0.1 TimeInterval - Time step for the simulation (sec) + ---------------------- Waves multipoint elevation output ---------------------- + False WaveElevSeriesFlag - T/F flag to output the wave elevation field (for movies) + END of driver input file + +.. _sea-output-channels: + +Appendix C. List of Output Channels +=================================== + +This is a list of all possible output channels for the SeaState module. +The names are grouped by meaning, but can be ordered in the OUTPUT +CHANNELS section of the primary SeaState input file as you see fit. +α refers to the output position for either wave elevation or wave +kinematics specified in the OUTPUT section of the primary SeaState input +file, where α is a number in the range [1,NWaveElev] for wave elevation +outputs and in the range [1,NWaveKin] for wave kinematics outputs. +Setting α > NWaveElev or α > NWaveKin yields invalid output. All outputs +are in the global inertial-frame coordinate system. + +================================================================ ========================================================================================================== ========================================================================================== +Channel Name(s) Units Description +================================================================ ========================================================================================================== ========================================================================================== +**Wave Elevation** +WaveαElev (m) Total (first- plus second-order) wave elevations (up to 9 designated locations) +WaveαElv1 (m) First-order wave elevations (up to 9 designated locations) +WaveαElv2 (m) Second-order wave elevations (up to 9 designated locations) +**Wave and Current Kinematics** +FVelαxi, FVelαyi, FVelαzi (m/s), (m/s), (m/s) Total (first- plus second-order waves and current) fluid velocities at α +FAccαxi, FAccαyi, FAccαzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`) Total (first- plus second-order waves) fluid accelerations at α +FDynPα (Pa) Total (first- plus second-order waves) fluid dynamic pressure at α +FAccMCFαxi, FAccMCFαyi, FAccMCFαzi (m/s\ :sup:`2`), (m/s\ :sup:`2`), (m/s\ :sup:`2`) Scaled first-order-wave fluid accelerations for the MacCamy-Fuchs members in HydroDyn at α +================================================================ ========================================================================================================== ========================================================================================== diff --git a/docs/source/user/seastate/index.rst b/docs/source/user/seastate/index.rst index 098e8789ee..b0dd44c048 100644 --- a/docs/source/user/seastate/index.rst +++ b/docs/source/user/seastate/index.rst @@ -5,6 +5,8 @@ SeaState User Guide and Theory Manual :maxdepth: 1 input_files.rst + output_files.rst + appendix.rst SeaState generates wave field information used by HydroDyn. This module had once been part of HydroDyn, so see the HydroDyn documentation for information on diff --git a/docs/source/user/seastate/input_files.rst b/docs/source/user/seastate/input_files.rst index 1399be55e1..b7dcc5cf14 100644 --- a/docs/source/user/seastate/input_files.rst +++ b/docs/source/user/seastate/input_files.rst @@ -20,7 +20,7 @@ SeaState Driver Input File The driver input file is only needed for the standalone version of SeaState and contains inputs normally generated by OpenFAST. It is necessary to control the sea state conditions for uncoupled models. -A sample SeaState driver input file is given in Appendix B. +An example SeaState driver input file is given in Appendix B. Set the **Echo** flag in this file to TRUE if you wish to have ``SeaStateDriver`` echo the contents of the driver input file (useful @@ -64,7 +64,7 @@ explained below. SeaState Primary Input File ~~~~~~~~~~~~~~~~~~~~~~~~~~~ - +An example SeaState primary input file is given in Appendix A. Environmental Conditions ------------------------ @@ -139,8 +139,8 @@ are: spectrum * 4: Irregular (stochastic) waves based on a user-defined frequency - spectrum from routine *UserWaveSpctrm()*; see Appendix D for - compiling instructions + spectrum from routine *UserWaveSpctrm()*; need to recompile the SeaState + standalone program or OpenFAST. * 5: Externally generated wave-elevation time series diff --git a/docs/source/user/seastate/output_files.rst b/docs/source/user/seastate/output_files.rst new file mode 100644 index 0000000000..039e927c57 --- /dev/null +++ b/docs/source/user/seastate/output_files.rst @@ -0,0 +1,127 @@ +.. _sea-output: + +Output Files +============ +SeaState produces five types of output files: echo files, a wave-elevation +file, wave-kinematics files, a summary file, and a time-series file. +The following sections detail the purpose and contents of these files. + +Echo Files +~~~~~~~~~~ +If you set the **Echo** flag to TRUE in the SeaState driver file or the +SeaState primary input file, the contents of those files will be echoed +to a file with the naming conventions, **OutRootName**\ *.dvr.ech* for +the driver input file and **OutRootName**\ *.SeaSt.ech* for the SeaState +primary input file. **OutRootName** is either specified in the SEASTATE +section of the driver input file, or by the OpenFAST program. The echo files +are helpful for debugging your input files. The contents of an echo file +will be truncated if SeaState encounters an error while parsing an input +file. The error usually corresponds to the line after the last +successfully echoed line. + +Wave-Elevation File +~~~~~~~~~~~~~~~~~~~~ +Setting **WaveElevSeriesFlag** in the driver file to TRUE enables the +output of the wave elevation across the entire SeaState wave grid to +a text-based file with the name ``OutRootName.WaveElev.out``. +The output wave grid is controlled by the SPATIAL DISCRETIZATION +section of the primary SeaState input file. These wave elevations are +distinct and output separately from the wave elevations determined by +**NWaveElev** in the SeaState primary input file, which are instead +recorded in the time-series output file. The wave-elevation output file +``OutRootName.WaveElev.out`` contains the total wave elevation, which is +the sum of the first- and second-order terms (when the second-order wave +kinematics are optionally enabled). The wave-elevation file described +here is useful for visualization purposes. + +Wave-Kinematics Files +~~~~~~~~~~~~~~~~~~~~~ +**WrWvKinMod** controls the wave kinematics output from the SeaState driver. +The driver will output the wave-elevation time series at the global origin +(0,0) in a separate *.Elev* file if **WrWvKinMod** = 1. This file also serves +as a valid **WvKinFile** for **WaveMod** = 5 (externally generated wave-elevation +time series) in the primary SeaState input file. This is a separate wave- +elevation output independent from the wave-field output obtained with +**WaveElevSeriesFlag** = TRUE and the wave-elevation time series obtained with +**NWaveElev** in the SeaState primary input file. + +If **WrWvKinMod** = 2, SeaState will output the full wave kinematics (velocity, +acceleration, dynamic pressure, and wave elevation) at all wave grid points in +eight output files with the extensions *.Vxi*, *.Vyi*, *.Vzi*, *.Axi*, *.Ayi*, +*.Azi*, *.DynP*, and *.Elev*. The velocity and acceleration outputs are all in the +global earth-fixed coordinate system. These files are also valid as +**WvKinFile** for **WaveMod** = 6 (externally generated full wave-kinematics +time series) and can be used as templates if users would like to build +their own input files for **WaveMod** = 6. + +.. _sea-summary-file: + +Summary File +~~~~~~~~~~~~ +SeaState generates a summary file with the naming convention, +**OutRootName**\ *.SeaSt.sum* if the **SeaStSum** parameter is set +to TRUE. This file summarizes key information about your sea-state +model, including water density, water depth, still-water level, +the wave grid, first-order wave frequency components, and any +user-requested time-series outputs. + +Summary of User-Requested Outputs +--------------------------------- +The summary file includes information about all user-requested +wave-elevation and wave-kinematics time-series output channels. + +Wave-Kinematics Output Locations +++++++++++++++++++++++++++++++++ +The first column lists the index of the wave-kinematics output locations, +as entered in the OUTPUT CHANNELS section of the SeaState input file. +**Xi**, **Yi**, and **Zi** provide the spatial coordinates of the wave-kinematics +output locations in the global inertial-frame coordinate system. + +Wave-Elevation Output Locations ++++++++++++++++++++++++++++++++ +The first column lists the index of the wave-elevation output locations, +as entered in the OUTPUT CHANNELS section of the SeaState input file. +**Xi** and **Yi** provide the spatial coordinates of the wave-elevation +output locations in the global inertial-frame coordinate system. + +Requested Output Channels ++++++++++++++++++++++++++ +The string labels of all requested time-series output channels, as entered +in the OUTPUT CHANNELS section of the SeaState input file, are summarized here. + +Wave Frequency Components +------------------------- +This section provides the frequency-domain description (in terms of a +Discrete Fourier Transform or DFT) of the first-order wave elevation at +(0,0) on the free surface, but is not written when **WaveMod** = 0 or 6. +The first column, **index**, identifies the index of each wave frequency +component. The finite-depth wave number, angular frequency, and direction of the +wave components are given by **k**, **Omega**, and **Direction**, +respectively. The last two columns provide the real +(**REAL(DFT{WaveElev})**) and imaginary (**IMAG(DFT{WaveElev})**) +parts of the first-order DFT wave amplitudes. The DFT +produces both negative- and positive-frequency components. +The negative-frequency components are complex conjugates of the +positive-frequency components because the time-domain wave elevation is +real-valued. The relationships between the negative- and +positive-frequency components of the DFT are given by +:math:`k\left( - \omega \right) = - k\left( \omega \right)` and +:math:`H\left( - \omega \right) = {H\left( \omega \right)}^{*}`, where +*H* is the DFT of the wave elevation and *\** denotes the complex +conjugate. + + +Results File +~~~~~~~~~~~~ + +The SeaState time-series results are written to a text-based file with +the naming convention ``OutRootName.SeaSt.out`` when **OutSwtch** is +set to either 1 or 3. If SeaState is coupled to OpenFAST and **OutSwtch** is +set to 2 or 3, then OpenFAST will generate a master results file that +includes the SeaState results. The results are in table format, where +each column is a data channel (the first column is always the +simulation time), and each row corresponds to a simulation output time +step. The data channels are specified in the OUTPUT CHANNELS section of +the SeaState primary input file. The column format of the +SeaState-generated file is specified using the **OutFmt** and +**OutSFmt** parameter of the primary input file.