Fidelity_One

Rotor wake methods that are directly specified by analyses. More...

Functions
def	SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.compute_fidelity_one_inflow_velocities.compute_fidelity_one_inflow_velocities (wake, prop, WD)
def	SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.compute_wake_induced_velocity.compute_wake_induced_velocity (WD, VD, cpts, azi_start_idx=0, sigma=0.11, suppress_root=False)
def	SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.compute_wake_induced_velocity.vortex (X, Y, Z, X1, Y1, Z1, X2, Y2, Z2, sigma, GAMMA=1, bv=False, WD=None, use_regularization_kernal=True)
def	SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.compute_wake_induced_velocity.regularization_kernel (COEF_in, sigma)
def	SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.fidelity_one_wake_convergence.fidelity_one_wake_convergence (wake, rotor, wake_inputs)
def	SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.generate_fidelity_one_wake_shape.generate_fidelity_one_wake_shape (wake, rotor)
def	SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.generate_fidelity_one_wake_shape.initialize_distributions (Nr, Na, B, n_wts, m, VD)

Detailed Description

Rotor wake methods that are directly specified by analyses.

Function Documentation

compute_fidelity_one_inflow_velocities()

def SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.compute_fidelity_one_inflow_velocities.compute_fidelity_one_inflow_velocities	(		wake,
			prop,
			WD
	)

Assumptions:
    None

Source:
    N/A
Inputs:
    wake - rotor wake
    prop - rotor instance
    WD   - wake vortex distribution
Outputs:
    Va   - axial velocity, shape (ctrl_pts, Nr, Na); axis 2 in direction of rotation       [m/s]
    Vt   - tangential velocity, shape (ctrl_pts, Nr, Na); axis 2 in direction of rotation    [m/s]

compute_wake_induced_velocity()

def SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.compute_wake_induced_velocity.compute_wake_induced_velocity	(		WD,
			VD,
			cpts,
			azi_start_idx = 0,
			sigma = 0.11,
			suppress_root = False
	)

This computes the velocity induced by the Fidelity One semi-prescribed vortex wake (PVW)
on lifting surface control points

Assumptions:  

Source:   

Inputs: 
WD     - helical wake distribution points               [Unitless] 
VD     - vortex distribution points on lifting surfaces [Unitless] 
cpts   - control points in segment                      [Unitless] 

Properties Used:
N/A

fidelity_one_wake_convergence()

def SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.fidelity_one_wake_convergence.fidelity_one_wake_convergence	(		wake,
			rotor,
			wake_inputs
	)

This converges on the wake shape for the fidelity-one rotor wake.

Assumptions:
None

Source:
N/A

Inputs:
wake        - rotor wake
rotor       - rotor
wake_inputs - inputs passed from the BET rotor spin function

Outputs:
None

Properties Used:
None

generate_fidelity_one_wake_shape()

def SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.generate_fidelity_one_wake_shape.generate_fidelity_one_wake_shape	(		wake,
			rotor
	)

This generates the propeller wake control points and vortex distribution that make up the prescribed vortex wake. 
All (x,y,z) coordinates are in the vehicle frame of reference (X points nose to tail).

Assumptions:
   None

Source: 
   None

Inputs:
   rotor  -  A SUAVE rotor component for which the wake is generated

initialize_distributions()

def SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.generate_fidelity_one_wake_shape.initialize_distributions	(		Nr,
			Na,
			B,
			n_wts,
			m,
			VD
	)

Initializes the matrices for the wake vortex distributions.

Assumptions:
    None

Source:
    N/A
    
Inputs:
   Nr    - number of radial blade elemnts
   Na    - number of azimuthal start positions
   B     - number of rotor blades
   n_wts - total number of wake time steps in wake simulation
   m     - number of control points to evaluate
   VD    - vehicle vortex distribution
   
Outputs:
   VD  - Vortex distribution
   WD  - Wake vortex distribution

Properties:
   N/A

regularization_kernel()

def SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.compute_wake_induced_velocity.regularization_kernel	(		COEF_in,
			sigma
	)

Regularization kernel used to prevent singularities

Assumptions
Spreads the vortex core over the radius sigma

Source
   Winckelmans, "Topics in Vortex Methods for the Computation of Three-and Two-dimensional 
   Incompressible Unsteady Flows", 1989.

Inputs:
   COEF    Biot-Savart Kernel
   sigma   regularization radius

Outputs:
   KAPPA   Regularization Kernel
   
Properties Used:
N/A

vortex()

def SUAVE.Methods.Propulsion.Rotor_Wake.Fidelity_One.compute_wake_induced_velocity.vortex	(		X,
			Y,
			Z,
			X1,
			Y1,
			Z1,
			X2,
			Y2,
			Z2,
			sigma,
			GAMMA = 1,
			bv = False,
			WD = None,
			use_regularization_kernal = True
	)

This computes the velocity induced on a control point by a segment
of a horseshoe vortex that points from point 1 to point 2 for a filament with
positive vortex strength.

Assumptions:  
None 

Source: 
Low-Speed Aerodynamics, Second Edition by Joseph katz, Allen Plotkin
Pgs. 584(Literature), 579-586 (Fortran Code implementation)

Inputs:
GAMMA       - propeller/rotor circulation
[X,Y,Z]     - location of control point  
[X1,Y1,Z1]  - location of point 1 
[X2,Y2,Z2]  - location of point 2
Properties Used:
N/A