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.

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.

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.

is_explicit()

Return True if this is an explicit component.

load_model_options()

Load the relevant model options from Problem._metadata['model_options'].

set_constraint_options(name[, ref, ref0, ...])

Set options for objectives 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.

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.

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.

is_explicit()

Return True if this is an explicit component.

load_model_options()

Load the relevant model options from Problem._metadata['model_options'].

set_constraint_options(name[, ref, ref0, ...])

Set options for objectives 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.

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.

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.

is_explicit()

Return True if this is an explicit component.

load_model_options()

Load the relevant model options from Problem._metadata['model_options'].

set_constraint_options(name[, ref, ref0, ...])

Set options for objectives 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.

all_connected_nodes(graph, start[, local])

Yield all downstream nodes starting at the given node.

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.

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_relevant_vars(desvars, responses, mode)

Find all relevant vars between desvars and responses.

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.

is_explicit()

Return True if this is an explicit component.

load_model_options()

Load the relevant model options from Problem._metadata['model_options'].

set_constraint_options(name[, ref, ref0, ...])

Set options for objectives 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.