Modeling Options Inputs

The following inputs describe the options available in the modeling_options file.

WISDEM wind turbine modeling options schema

Scehma that describes the modeling options for WISDEM

WISDEM_model_options_schema_v00
type	object

General

type	object
properties
verbosity	Prints additional outputs to screen (and to a file log in the future)
	type	boolean
solver_maxiter	Number of iterations for the top-level coupling solver
	type	integer
	default	5

WISDEM

type	object
properties
n_dlc	Number of load cases
	type	integer
	minimum	0
	default	1
RotorSE	type	object
	properties
	flag	Whether or not to run this module
		type	boolean
	n_aoa	Number of angles of attack in a common grid to define polars
		type	integer
		default	200
	n_xy	Number of coordinate point used to define airfoils
		type	integer
		default	200
	n_span	Number of spanwise stations in a common grid used to define blade properties
		type	integer
		default	30
	n_pc	Number of wind speeds to compute the power curve
		type	integer
		default	20
	n_pc_spline	Number of wind speeds to spline the power curve
		type	integer
		default	200
	n_pitch_perf_surfaces	Number of pitch angles to determine the Cp-Ct-Cq-surfaces
		type	integer
		default	20
	min_pitch_perf_surfaces	Min pitch angle of the Cp-Ct-Cq-surfaces
		type	number
		default	-5
	max_pitch_perf_surfaces	Max pitch angle of the Cp-Ct-Cq-surfaces
		type	number
		default	30
	n_tsr_perf_surfaces	Number of tsr values to determine the Cp-Ct-Cq-surfaces
		type	integer
		default	20
	min_tsr_perf_surfaces	Min TSR of the Cp-Ct-Cq-surfaces
		type	number
		default	2
	max_tsr_perf_surfaces	Max TSR of the Cp-Ct-Cq-surfaces
		type	number
		default	12
	n_U_perf_surfaces	Number of wind speeds to determine the Cp-Ct-Cq-surfaces
		type	integer
		default	1
	regulation_reg_III	Flag to derive the regulation trajectory in region III in terms of pitch and TSR
		type	boolean
		default	True
	peak_thrust_shaving	If True, apply peak thrust shaving within RotorSE.
		type	boolean
	thrust_shaving_coeff	Scalar applied to the max torque within RotorSE for peak thrust shaving. Only used if peak_thrust_shaving is True.
		type	number
		default	1
	fix_pitch_regI12	If True, pitch is fixed in region I1/2, i.e. when min rpm is enforced.
		type	boolean
	spar_cap_ss	Composite layer modeling the spar cap on the suction side in the geometry yaml. This entry is used to compute ultimate strains.
		type	string
		default	none
	spar_cap_ps	Composite layer modeling the spar cap on the pressure side in the geometry yaml. This entry is used to compute ultimate strains.
		type	string
		default	none
	te_ss	Composite layer modeling the trailing edge reinforcement on the suction side in the geometry yaml. This entry is used to compute ultimate strains.
		type	string
		default	none
	te_ps	Composite layer modeling the trailing edge reinforcement on the pressure side in the geometry yaml. This entry is used to compute ultimate strains.
		type	string
		default	none
	gamma_freq	Partial safety factor on modal frequencies
		type	number
maximum		5
minimum		1
default		1.1
gust_std	Number of standard deviations for strength of gust
	type	number
	maximum	15
	minimum	0
	default	3
root_fastener_s_f	Safety factor for the max stress of blade root fasteners
	type	number
	maximum	100
	minimum	0.1
	default	2.5
hubloss	Include Prandtl hub loss model in CCBlade calls
	type	boolean
	default	True
tiploss	Include Prandtl tip loss model in CCBlade calls
	type	boolean
	default	True
wakerotation	Include effect of wake rotation (i.e., tangential induction factor is nonzero) in CCBlade calls
	type	boolean
	default	True
usecd	Use drag coefficient in computing induction factors in CCBlade calls
	type	boolean
	default	True
n_sector	Number of sectors to divide rotor face into in computing thrust and power.
	type	integer
	maximum	10
	minimum	1
	default	4
3d_af_correction	Flag switching on and off the 3d DU-Selig airfoil correction implemented in Polar.py
	type	boolean
	default	True
inn_af	Flag switching on and off the inverted neural network for airfoil design
	type	boolean
inn_af_max_rthick	Maximum airfoil thickness supported by the INN for airfoil design
	type	number
	maximum	1
	minimum	0
	default	0.4
inn_af_min_rthick	Minimum airfoil thickness supported by the INN for airfoil design
	type	number
	maximum	1
	minimum	0
	default	0.15
rail_transport	Flag switching on and off the rail transport module of RotorSE
	type	boolean
DriveSE	type	object
	properties
	flag	Whether or not to run this module
		type	boolean
	model_generator	Whether or not to do detailed generator modeling using tools formerly in GeneratorSE
		type	boolean
	gamma_f	Partial safety factor on loads
		type	number
		maximum	5
		minimum	1
		default	1.35
	gamma_m	Partial safety factor for materials
		type	number
		maximum	5
		minimum	1
		default	1.3
	gamma_n	Partial safety factor for consequence of failure
		type	number
		maximum	5
		minimum	1
		default	1
	use_gb_torque_density	Flag switching between running to gearbox sizing of DrivetrainSE (False) or the simple sizing given a value of torque density expressed in Nm/kg
		type	boolean
		default	True
	hub	type	object
		properties
		hub_gamma	Partial safety factor for hub sizing
			type	number
			maximum	7
			minimum	1
			default	2
		spinner_gamma	Partial safety factor for spinner sizing
			type	number
			maximum	5
			minimum	1
			default	1.5
TowerSE	type	object
	properties
	flag	Whether or not to run this module
		type	boolean
	wind	Wind scaling relationship with height
		type	string
		enum	PowerWind, LogisticWind
		default	PowerWind
	gamma_f	Partial safety factor on loads
		type	number
		maximum	5
		minimum	1
		default	1.35
	gamma_m	Partial safety factor for materials
		type	number
		maximum	5
		minimum	1
		default	1.3
	gamma_n	Partial safety factor for consequence of failure
		type	number
		maximum	5
		minimum	1
		default	1
	gamma_b	Partial safety factor for buckling
		type	number
		maximum	5
		minimum	1
		default	1.1
	gamma_freq	Partial safety factor on modal frequencies
		type	number
		maximum	5
		minimum	1
		default	1.1
	gamma_fatigue	Partial safety factor for fatigue failure
		type	number
		maximum	5
		minimum	1
		default	1
	buckling_method	Buckling utilization calculation method- Eurocode 1994 or DNVGL RP-C202
		type	string
		enum	Eurocode, Euro-code, eurocode, euro-code, DNVGL, dnvgl, DNV-GL, dnv-gl
		default	dnvgl
	buckling_length	Buckling length factor in Eurocode safety check
		type	number
		maximum	100
		minimum	1
		default	10
	frame3dd	Set of Frame3DD options used for tower analysis
		type	object
		properties
		shear	Inclusion of shear area for symmetric sections
			type	boolean
			default	True
		geom	Inclusion of shear stiffening through axial loading
			type	boolean
			default	True
		modal_method	Eigenvalue solver 1=Subspace-Jacobi iteration, 2=Stodola (matrix iteration)
			type	number
			enum	1, 2
			default	1
		tol	Convergence tolerance for modal eigenvalue solution
			type	number
			maximum	0.1
			minimum	1e-12
default			1e-09
n_refine	Number of Frame3DD element refinements for every specified section along tower/member
	type	integer
	default	3
FixedBottomSE	type	object
	properties
	type	Can be monopile or jacket.
		type	string
		default	monopile
	flag	Whether or not to run this module
		type	boolean
	wind	Wind scaling relationship with height
		type	string
		enum	PowerWind, LogisticWind
		default	PowerWind
	gamma_f	Partial safety factor on loads
		type	number
		maximum	5
		minimum	1
		default	1.35
	gamma_m	Partial safety factor for materials
		type	number
		maximum	5
		minimum	1
		default	1.3
	gamma_n	Partial safety factor for consequence of failure
		type	number
		maximum	5
		minimum	1
		default	1
	gamma_b	Partial safety factor for buckling
		type	number
		maximum	5
		minimum	1
		default	1.1
	gamma_freq	Partial safety factor on modal frequencies
		type	number
		maximum	5
		minimum	1
		default	1.1
	gamma_fatigue	Partial safety factor for fatigue failure
		type	number
		maximum	5
		minimum	1
		default	1
	buckling_method	Buckling utilization calculation method- Eurocode 1994 or DNVGL RP-C202
		type	string
		enum	Eurocode, Euro-code, eurocode, euro-code, DNVGL, dnvgl, DNV-GL, dnv-gl
		default	dnvgl
	buckling_length	Buckling length factor in Eurocode safety check
		type	number
		maximum	100
		minimum	1
		default	10
	frame3dd	Set of Frame3DD options used for tower analysis
		type	object
		properties
		shear	Inclusion of shear area for symmetric sections
			type	boolean
			default	True
		geom	Inclusion of shear stiffening through axial loading
			type	boolean
			default	True
		modal_method	Eigenvalue solver 1=Subspace-Jacobi iteration, 2=Stodola (matrix iteration)
			type	number
			enum	1, 2
			default	1
		tol	Convergence tolerance for modal eigenvalue solution
type			number
maximum			0.1
minimum			1e-12
default			1e-09
soil_springs	If False, then a monopile is modeled with a perfectly clamped foundation. If True, then spring-stiffness equivalents are computed from soil properties for all DOF.
	type	boolean
gravity_foundation	Model the monopile base as a gravity-based foundation with no pile embedment
	type	boolean
n_refine	Number of Frame3DD element refinements for every specified section along tower/member
	type	integer
	default	3
n_legs	Number of legs for the jacket. Only used if type`==`jacket.
	type	integer
	default	4
n_bays	Number of bays for the jacket, or x-joints per tower leg pair. Only used if type`==`jacket.
	type	integer
	default	3
mud_brace	If true, add a mud brace at the bottom of each jacket leg. Only used if type`==`jacket.
	type	boolean
	default	True
save_truss_figures	If true, save .pngs of the jacket truss during analysis or optimization. Jacket only.
	type	boolean
BOS	type	object
	properties
	flag	Whether or not to run this module
		type	boolean
FloatingSE	type	object
	properties
	flag	Whether or not to run this module
		type	boolean
	n_refine	Number of Frame3DD element refinements for every specified section along tower/member
		type	integer
		default	1
	frame3dd	Set of Frame3DD options used for floating tower analysis
		type	object
		properties
		shear	Inclusion of shear area for symmetric sections
			type	boolean
		geom	Inclusion of shear stiffening through axial loading
			type	boolean
		modal_method	Eigenvalue solver 1=Subspace-Jacobi iteration, 2=Stodola (matrix iteration)
			type	number
			enum	1, 2
			default	2
		shift	Numerical matrix diagonal adder for eigenvalue solve of unrestrained structure
			type	number
			default	10
		tol	Convergence tolerance for modal eigenvalue solution
			type	number
			maximum	0.1
			minimum	1e-12
			default	1e-08
	gamma_f	Partial safety factor on loads
		type	number
		maximum	5
		minimum	1
		default	1.35
	gamma_m	Partial safety factor for materials
		type	number
		maximum	5
		minimum	1
		default	1.3
	gamma_n	Partial safety factor for consequence of failure
		type	number
		maximum	5
		minimum	1
		default	1
	gamma_b	Partial safety factor for buckling
		type	number
		maximum	5
		minimum	1
		default	1.1
	gamma_freq	Partial safety factor on modal frequencies
		type	number
		maximum	5
		minimum	1
		default	1.1
	gamma_fatigue	Partial safety factor for fatigue failure
		type	number
		maximum	5
		minimum	1
		default	1
	symmetric_moorings	Whether or not to assume a symmetric mooring system
		type	boolean
		default	True
	rank_and_file	Use the rank-and-file method of identifying mode shapes that guarantees modeshape numbers in all directions, but will reuse the same modeshape for multiple directions
		type	boolean
Loading	This is only used if not running the full WISDEM turbine Group and you need to input the mass properties, forces, and moments for a tower-only or nacelle-only analysis
	type	object
	properties
	mass	Mass at external boundary of the system. For the tower, this would be the RNA mass.
		type	number
	center_of_mass	Distance from system boundary to center of mass of the applied load. For the tower, this would be the RNA center of mass in tower-top coordinates.
		type	array
		default	0
			0
			0
		items	type	number
	moment_of_inertia	Moment of inertia of external mass in coordinate system at the system boundary. For the tower, this would be the RNA MoI in tower-top coordinates.
		type	array
		default	0
			0
			0
			0
			0
			0
		items	type	number
	loads	The loading scenarios associated with the applied mass. For the tower, this would be operating, parked, etc.
		type	array
		items	type	object
			properties
			force	Force vector applied at system boundary
				type	array
				default	0
					0
					0
				items	type	number
			moment	Force vector applied at system boundary
				type	array
				default	0
					0
					0
				items	type	number
			velocity	Applied wind reference velocity, if necessary
				type	number