Documentation
Referenced Tower Modules
- class wisdem.towerse.tower.PreDiscretization(**kwargs)[source]
Process some of the tower YAML inputs.
- Parameters:
hub_height (float, [m]) – Scalar of the rotor apex height computed along the z axis.
tower_height (float, [m]) – Scalar of the tower height computed along the z axis.
foundation_height (float, [m]) – starting height of tower
- Returns:
height_constraint (float, [m]) – mismatch between tower height and desired hub_height
transition_piece_height (float, [m]) – Point mass height of transition piece above water line
joint1 (numpy array[3], [m]) – Global dimensional coordinates (x-y-z) for bottom node of member
joint2 (numpy array[3], [m]) – Global dimensional coordinates (x-y-z) for top node of member
- Attributes:
checking
Return True if check_partials or check_totals is executing.
linear_solver
Get the linear solver for this system.
msginfo
Our instance pathname, if available, or our class name.
nonlinear_solver
Get the nonlinear solver for this system.
under_approx
Return True if under complex step or finite difference.
Methods
abs_name_iter
(iotype[, local, cont, discrete])Iterate over absolute variable names for this System.
comm_info_iter
()Yield comm size for this system and all subsystems.
convert_from_units
(name, val, units)Convert the given value from the specified units to those of the named variable.
convert_units
(name, val, units_from, units_to)Wrap the utility convert_units and give a good error message.
dist_size_iter
(io, top_comm)Yield names and distributed ranges of all local and remote variables in this system.
get_coloring_fname
()Return the full pathname to a coloring file.
get_io_metadata
([iotypes, metadata_keys, ...])Retrieve metadata for a filtered list of variables.
get_promotions
([inprom, outprom])Return all promotions for the given promoted variable(s).
get_reports_dir
()Get the path to the directory where the report files should go.
get_source
(name)Return the source variable connected to the given named variable.
get_val
(name[, units, indices, get_remote, ...])Get an output/input/residual variable.
get_var_dup_info
(name, io)Return information about how the given variable is duplicated across MPI processes.
get_var_sizes
(name, io)Return the sizes of the given variable on all procs.
is_explicit
()Return True if this is an explicit component.
load_case
(case)Pull all input and output variables from a Case into this System.
load_model_options
()Load the relevant model options from Problem._metadata['model_options'].
local_range_iter
(io)Yield names and local ranges of all local variables in this system.
set_constraint_options
(name[, ref, ref0, ...])Set options for constraints in the model.
set_design_var_options
(name[, lower, upper, ...])Set options for design vars in the model.
set_objective_options
(name[, ref, ref0, ...])Set options for objectives in the model.
set_output_solver_options
(name[, lower, ...])Set solver output options.
set_val
(name, val[, units, indices])Set an input or output variable.
setup_partials
()Declare partials.
- class wisdem.towerse.tower.TurbineMass(**kwargs)[source]
Compute the turbine mass, center of mass, and mass moment of inertia.
- Parameters:
hub_height (float, [m]) – Hub-height
rna_mass (float, [kg]) – Total tower mass
rna_I (numpy array[6], [kg*m**2]) – Mass moment of inertia of RNA about tower top [xx yy zz xy xz yz]
rna_cg (numpy array[3], [m]) – xyz-location of RNA cg relative to tower top
tower_mass (float, [kg]) – Total tower mass
tower_center_of_mass (float, [m]) – z-position of center of mass of tower
tower_I_base (numpy array[6], [kg*m**2]) – Mass moment of inertia of tower about base [xx yy zz xy xz yz]
- Returns:
turbine_mass (float, [kg]) – Total mass of tower+rna
turbine_center_of_mass (numpy array[3], [m]) – xyz-position of tower+rna center of mass
turbine_I_base (numpy array[6], [kg*m**2]) – mass moment of inertia of tower about base [xx yy zz xy xz yz]
- Attributes:
checking
Return True if check_partials or check_totals is executing.
linear_solver
Get the linear solver for this system.
msginfo
Our instance pathname, if available, or our class name.
nonlinear_solver
Get the nonlinear solver for this system.
under_approx
Return True if under complex step or finite difference.
Methods
abs_name_iter
(iotype[, local, cont, discrete])Iterate over absolute variable names for this System.
comm_info_iter
()Yield comm size for this system and all subsystems.
convert_from_units
(name, val, units)Convert the given value from the specified units to those of the named variable.
convert_units
(name, val, units_from, units_to)Wrap the utility convert_units and give a good error message.
dist_size_iter
(io, top_comm)Yield names and distributed ranges of all local and remote variables in this system.
get_coloring_fname
()Return the full pathname to a coloring file.
get_io_metadata
([iotypes, metadata_keys, ...])Retrieve metadata for a filtered list of variables.
get_promotions
([inprom, outprom])Return all promotions for the given promoted variable(s).
get_reports_dir
()Get the path to the directory where the report files should go.
get_source
(name)Return the source variable connected to the given named variable.
get_val
(name[, units, indices, get_remote, ...])Get an output/input/residual variable.
get_var_dup_info
(name, io)Return information about how the given variable is duplicated across MPI processes.
get_var_sizes
(name, io)Return the sizes of the given variable on all procs.
is_explicit
()Return True if this is an explicit component.
load_case
(case)Pull all input and output variables from a Case into this System.
load_model_options
()Load the relevant model options from Problem._metadata['model_options'].
local_range_iter
(io)Yield names and local ranges of all local variables in this system.
set_constraint_options
(name[, ref, ref0, ...])Set options for constraints in the model.
set_design_var_options
(name[, lower, upper, ...])Set options for design vars in the model.
set_objective_options
(name[, ref, ref0, ...])Set options for objectives in the model.
set_output_solver_options
(name[, lower, ...])Set solver output options.
set_val
(name, val[, units, indices])Set an input or output variable.
setup_partials
()Declare partials.
- class wisdem.towerse.tower.TowerFrame(**kwargs)[source]
Run Frame3DD on the tower
- Parameters:
z_full (numpy array[npts], [m]) – location along cylinder. start at bottom and go to top
d_full (numpy array[npts], [m]) – effective cylinder diameter for section
t_full (numpy array[npts-1], [m]) – effective shell thickness for section
E_full (numpy array[npts-1], [N/m**2]) – modulus of elasticity
G_full (numpy array[npts-1], [N/m**2]) – shear modulus
rho_full (numpy array[npts-1], [kg/m**3]) – material density
rna_mass (float, [kg]) – Total tower mass
rna_I (numpy array[6], [kg*m**2]) – Mass moment of inertia of RNA about tower top [xx yy zz xy xz yz]
rna_cg (numpy array[3], [m]) – xyz-location of RNA cg relative to tower top
rna_F (numpy array[3], [N]) – rna force at tower top from drivetrain analysis
rna_M (numpy array[3], [N*m]) – rna moment at tower top from drivetrain analysis
Px (numpy array[n_full], [N/m]) – force per unit length in x-direction
Py (numpy array[n_full], [N/m]) – force per unit length in y-direction
Pz (numpy array[n_full], [N/m]) – force per unit length in z-direction
- Returns:
f1 (float, [Hz]) – First natural frequency
f2 (float, [Hz]) – Second natural frequency
structural_frequencies (numpy array[NFREQ], [Hz]) – First and second natural frequency
fore_aft_freqs (numpy array[NFREQ2]) – Frequencies associated with mode shapes in the tower fore-aft direction
side_side_freqs (numpy array[NFREQ2]) – Frequencies associated with mode shapes in the tower side-side direction
torsion_freqs (numpy array[NFREQ2]) – Frequencies associated with mode shapes in the tower torsion direction
fore_aft_modes (numpy array[NFREQ2, 5]) – 6-degree polynomial coefficients of mode shapes in the tower fore-aft direction (without constant term)
side_side_modes (numpy array[NFREQ2, 5]) – 6-degree polynomial coefficients of mode shapes in the tower side-side direction (without constant term)
torsion_modes (numpy array[NFREQ2, 5]) – 6-degree polynomial coefficients of mode shapes in the tower torsion direction (without constant term)
tower_deflection (numpy array[n_full], [m]) – Deflection of tower nodes in yaw-aligned +x direction
top_deflection (float, [m]) – Deflection of tower top in yaw-aligned +x direction
tower_Fz (numpy array[n_full-1], [N]) – Axial foce in vertical z-direction in cylinder structure.
tower_Vx (numpy array[n_full-1], [N]) – Shear force in x-direction in cylinder structure.
tower_Vy (numpy array[n_full-1], [N]) – Shear force in y-direction in cylinder structure.
tower_Mxx (numpy array[n_full-1], [N*m]) – Moment about x-axis in cylinder structure.
tower_Myy (numpy array[n_full-1], [N*m]) – Moment about y-axis in cylinder structure.
tower_Mzz (numpy array[n_full-1], [N*m]) – Moment about z-axis in cylinder structure.
base_F (numpy array[3], [N]) – Total force on cylinder
base_M (numpy array[3], [N*m]) – Total moment on cylinder measured at base
- Attributes:
checking
Return True if check_partials or check_totals is executing.
linear_solver
Get the linear solver for this system.
msginfo
Our instance pathname, if available, or our class name.
nonlinear_solver
Get the nonlinear solver for this system.
under_approx
Return True if under complex step or finite difference.
Methods
abs_name_iter
(iotype[, local, cont, discrete])Iterate over absolute variable names for this System.
comm_info_iter
()Yield comm size for this system and all subsystems.
convert_from_units
(name, val, units)Convert the given value from the specified units to those of the named variable.
convert_units
(name, val, units_from, units_to)Wrap the utility convert_units and give a good error message.
dist_size_iter
(io, top_comm)Yield names and distributed ranges of all local and remote variables in this system.
get_coloring_fname
()Return the full pathname to a coloring file.
get_io_metadata
([iotypes, metadata_keys, ...])Retrieve metadata for a filtered list of variables.
get_promotions
([inprom, outprom])Return all promotions for the given promoted variable(s).
get_reports_dir
()Get the path to the directory where the report files should go.
get_source
(name)Return the source variable connected to the given named variable.
get_val
(name[, units, indices, get_remote, ...])Get an output/input/residual variable.
get_var_dup_info
(name, io)Return information about how the given variable is duplicated across MPI processes.
get_var_sizes
(name, io)Return the sizes of the given variable on all procs.
is_explicit
()Return True if this is an explicit component.
load_case
(case)Pull all input and output variables from a Case into this System.
load_model_options
()Load the relevant model options from Problem._metadata['model_options'].
local_range_iter
(io)Yield names and local ranges of all local variables in this system.
set_constraint_options
(name[, ref, ref0, ...])Set options for constraints in the model.
set_design_var_options
(name[, lower, upper, ...])Set options for design vars in the model.
set_objective_options
(name[, ref, ref0, ...])Set options for objectives in the model.
set_output_solver_options
(name[, lower, ...])Set solver output options.
set_val
(name, val[, units, indices])Set an input or output variable.
setup_partials
()Declare partials.
- class wisdem.towerse.tower.TowerSE(**kwargs)[source]
This is the main TowerSE group that performs analysis of the tower.
- Attributes:
linear_solver
Get the linear solver for this system.
model_options
Get the model options from self._problem_meta.
msginfo
Our instance pathname, if available, or our class name.
nonlinear_solver
Get the nonlinear solver for this system.
under_approx
Return True if under complex step or finite difference.
Methods
abs_name_iter
(iotype[, local, cont, discrete])Iterate over absolute variable names for this System.
comm_info_iter
()Yield comm size for this system and all subsystems.
convert_from_units
(name, val, units)Convert the given value from the specified units to those of the named variable.
convert_units
(name, val, units_from, units_to)Wrap the utility convert_units and give a good error message.
dist_size_iter
(io, top_comm)Yield names and distributed ranges of all local and remote variables in this system.
get_coloring_fname
()Return the full pathname to a coloring file.
get_io_metadata
([iotypes, metadata_keys, ...])Retrieve metadata for a filtered list of variables.
get_promotions
([inprom, outprom])Return all promotions for the given promoted variable(s).
get_reports_dir
()Get the path to the directory where the report files should go.
get_source
(name)Return the source variable connected to the given named variable.
get_val
(name[, units, indices, get_remote, ...])Get an output/input/residual variable.
get_var_dup_info
(name, io)Return information about how the given variable is duplicated across MPI processes.
get_var_sizes
(name, io)Return the sizes of the given variable on all procs.
is_explicit
()Return True if this is an explicit component.
load_case
(case)Pull all input and output variables from a Case into this System.
load_model_options
()Load the relevant model options from Problem._metadata['model_options'].
local_range_iter
(io)Yield names and local ranges of all local variables in this system.
set_constraint_options
(name[, ref, ref0, ...])Set options for constraints in the model.
set_design_var_options
(name[, lower, upper, ...])Set options for design vars in the model.
set_input_defaults
(name[, val, units, src_shape])Specify metadata to be assumed when multiple inputs are promoted to the same name.
set_objective_options
(name[, ref, ref0, ...])Set options for objectives in the model.
set_output_solver_options
(name[, lower, ...])Set solver output options.
set_val
(name, val[, units, indices])Set an input or output variable.