HybridMotor Class#
- class rocketpy.HybridMotor[source]#
Class to specify characteristics and useful operations for Hybrid motors. This class inherits from the Motor class.
See also
- Variables:
HybridMotor.coordinate_system_orientation (
str
) – Orientation of the motor’s coordinate system. The coordinate system is defined by the motor’s axis of symmetry. The origin of the coordinate system may be placed anywhere along such axis, such as at the nozzle area, and must be kept the same for all other positions specified. Options are “nozzle_to_combustion_chamber” and “combustion_chamber_to_nozzle”.HybridMotor.nozzle_radius (
float
) – Radius of motor nozzle outlet in meters.HybridMotor.nozzle_position (
float
) – Motor’s nozzle outlet position in meters, specified in the motor’s coordinate system. See Positions and Coordinate Systems for more information.HybridMotor.throat_radius (
float
) – Radius of motor nozzle throat in meters.HybridMotor.solid (
SolidMotor
) – Solid motor object that composes the hybrid motor.HybridMotor.liquid (
LiquidMotor
) – Liquid motor object that composes the hybrid motor.HybridMotor.positioned_tanks (
list
) – List containing the motor’s added tanks and their respective positions.HybridMotor.grains_center_of_mass_position (
float
) – Position of the center of mass of the grains in meters, specified in the motor’s coordinate system. See Positions and Coordinate Systems for more information.HybridMotor.grain_number (
int
) – Number of solid grains.HybridMotor.grain_density (
float
) – Density of each grain in kg/meters cubed.HybridMotor.grain_outer_radius (
float
) – Outer radius of each grain in meters.HybridMotor.grain_initial_inner_radius (
float
) – Initial inner radius of each grain in meters.HybridMotor.grain_initial_height (
float
) – Initial height of each grain in meters.HybridMotor.grain_separation (
float
) – Distance between two grains in meters.HybridMotor.dry_mass (
float
) – Same as in Motor class. See theMotor
docs.HybridMotor.propellant_initial_mass (
float
) – Total propellant initial mass in kg. This is the sum of the initial mass of fluids in each tank and the initial mass of the solid grains.HybridMotor.total_mass (
Function
) – Total motor mass in kg as a function of time, defined as the sum of the dry mass (motor’s structure mass) and the propellant mass, which varies with time.HybridMotor.propellant_mass (
Function
) – Total propellant mass in kg as a function of time, this includes the mass of fluids in each tank and the mass of the solid grains.HybridMotor.total_mass_flow_rate (
Function
) – Time derivative of propellant total mass in kg/s as a function of time as obtained by the thrust source.HybridMotor.center_of_mass (
Function
) – Position of the motor center of mass in meters as a function of time. See Positions and Coordinate Systems for more information regarding the motor’s coordinate system.HybridMotor.center_of_propellant_mass (
Function
) – Position of the motor propellant center of mass in meters as a function of time. See Positions and Coordinate Systems for more information regarding the motor’s coordinate system.HybridMotor.I_11 (
Function
) – Component of the motor’s inertia tensor relative to the e_1 axis in kg*m^2, as a function of time. The e_1 axis is the direction perpendicular to the motor body axis of symmetry, centered at the instantaneous motor center of mass.HybridMotor.I_22 (
Function
) – Component of the motor’s inertia tensor relative to the e_2 axis in kg*m^2, as a function of time. The e_2 axis is the direction perpendicular to the motor body axis of symmetry, centered at the instantaneous motor center of mass. Numerically equivalent to I_11 due to symmetry.HybridMotor.I_33 (
Function
) – Component of the motor’s inertia tensor relative to the e_3 axis in kg*m^2, as a function of time. The e_3 axis is the direction of the motor body axis of symmetry, centered at the instantaneous motor center of mass.HybridMotor.I_12 (
Function
) – Component of the motor’s inertia tensor relative to the e_1 and e_2 axes in kg*m^2, as a function of time. See HybridMotor.I_11 and HybridMotor.I_22 for more information.HybridMotor.I_13 (
Function
) – Component of the motor’s inertia tensor relative to the e_1 and e_3 axes in kg*m^2, as a function of time. See HybridMotor.I_11 and HybridMotor.I_33 for more information.HybridMotor.I_23 (
Function
) – Component of the motor’s inertia tensor relative to the e_2 and e_3 axes in kg*m^2, as a function of time. See HybridMotor.I_22 and HybridMotor.I_33 for more information.HybridMotor.propellant_I_11 (
Function
) – Component of the propellant inertia tensor relative to the e_1 axis in kg*m^2, as a function of time. The e_1 axis is the direction perpendicular to the motor body axis of symmetry, centered at the instantaneous propellant center of mass.HybridMotor.propellant_I_22 (
Function
) – Component of the propellant inertia tensor relative to the e_2 axis in kg*m^2, as a function of time. The e_2 axis is the direction perpendicular to the motor body axis of symmetry, centered at the instantaneous propellant center of mass. Numerically equivalent to propellant_I_11 due to symmetry.HybridMotor.propellant_I_33 (
Function
) – Component of the propellant inertia tensor relative to the e_3 axis in kg*m^2, as a function of time. The e_3 axis is the direction of the motor body axis of symmetry, centered at the instantaneous propellant center of mass.HybridMotor.propellant_I_12 (
Function
) – Component of the propellant inertia tensor relative to the e_1 and e_2 axes in kg*m^2, as a function of time. See HybridMotor.propellant_I_11 and HybridMotor.propellant_I_22 for more information.HybridMotor.propellant_I_13 (
Function
) – Component of the propellant inertia tensor relative to the e_1 and e_3 axes in kg*m^2, as a function of time. See HybridMotor.propellant_I_11 and HybridMotor.propellant_I_33 for more information.HybridMotor.propellant_I_23 (
Function
) – Component of the propellant inertia tensor relative to the e_2 and e_3 axes in kg*m^2, as a function of time. See HybridMotor.propellant_I_22 and HybridMotor.propellant_I_33 for more information.HybridMotor.thrust (
Function
) – Motor thrust force, in Newtons, as a function of time.HybridMotor.total_impulse (
float
) – Total impulse of the thrust curve in N*s.HybridMotor.max_thrust (
float
) – Maximum thrust value of the given thrust curve, in N.HybridMotor.max_thrust_time (
float
) – Time, in seconds, in which the maximum thrust value is achieved.HybridMotor.average_thrust (
float
) – Average thrust of the motor, given in N.HybridMotor.burn_time (
tuple
offloat
) – Tuple containing the initial and final time of the motor’s burn time in seconds.HybridMotor.burn_start_time (
float
) – Motor burn start time, in seconds.HybridMotor.burn_out_time (
float
) – Motor burn out time, in seconds.HybridMotor.burn_duration (
float
) – Total motor burn duration, in seconds. It is the difference between theburn_out_time
and theburn_start_time
.HybridMotor.exhaust_velocity (
Function
) – Propulsion gases exhaust velocity, assumed constant, in m/s.HybridMotor.burn_area (
Function
) – Total burn area considering all grains, made out of inner cylindrical burn area and grain top and bottom faces. Expressed in meters squared as a function of time.HybridMotor.Kn (
Function
) – Motor Kn as a function of time. Defined as burn_area divided by nozzle throat cross sectional area. Has no units.HybridMotor.burn_rate (
Function
) – Propellant burn rate in meter/second as a function of time.HybridMotor.interpolate (
string
) – Method of interpolation used in case thrust curve is given by data set in .csv or .eng, or as an array. Options are ‘spline’ ‘akima’ and ‘linear’. Default is “linear”.
- __init__(thrust_source, dry_mass, dry_inertia, nozzle_radius, grain_number, grain_density, grain_outer_radius, grain_initial_inner_radius, grain_initial_height, grain_separation, grains_center_of_mass_position, center_of_dry_mass_position, nozzle_position=0, burn_time=None, throat_radius=0.01, reshape_thrust_curve=False, interpolation_method='linear', coordinate_system_orientation='nozzle_to_combustion_chamber')[source]#
Initialize Motor class, process thrust curve and geometrical parameters and store results.
- Parameters:
thrust_source (
int
,float
,callable
,string
,array
,Function
) –Motor’s thrust curve. Can be given as an int or float, in which case the thrust will be considered constant in time. It can also be given as a callable function, whose argument is time in seconds and returns the thrust supplied by the motor in the instant. If a string is given, it must point to a .csv or .eng file. The .csv file shall contain no headers and the first column must specify time in seconds, while the second column specifies thrust. Arrays may also be specified, following rules set by the class Function. Thrust units are Newtons.
See also
dry_mass (
int
,float
) – Same as in Motor class. See theMotor
docsdry_inertia (
tuple
,list
) – Tuple or list containing the motor’s dry mass inertia tensor components, in kg*m^2. This inertia is defined with respect to the the center_of_dry_mass_position position. Assuming e_3 is the rocket’s axis of symmetry, e_1 and e_2 are orthogonal and form a plane perpendicular to e_3, the dry mass inertia tensor components must be given in the following order: (I_11, I_22, I_33, I_12, I_13, I_23), where I_ij is the component of the inertia tensor in the direction of e_i x e_j. Alternatively, the inertia tensor can be given as (I_11, I_22, I_33), where I_12 = I_13 = I_23 = 0.nozzle_radius (
int
,float
) – Motor’s nozzle outlet radius in meters.grain_number (
int
) – Number of solid grainsgrain_density (
int
,float
) – Solid grain density in kg/m3.grain_outer_radius (
int
,float
) – Solid grain outer radius in meters.grain_initial_inner_radius (
int
,float
) – Solid grain initial inner radius in meters.grain_initial_height (
int
,float
) – Solid grain initial height in meters.grain_separation (
int
,float
) – Distance between grains, in meters.grains_center_of_mass_position (
float
) – Position of the center of mass of the grains in meters. More specifically, the coordinate of the center of mass specified in the motor’s coordinate system. See Positions and Coordinate Systems for more information.center_of_dry_mass_position (
int
,float
) – The position, in meters, of the motor’s center of mass with respect to the motor’s coordinate system when it is devoid of propellant. See Positions and Coordinate Systems.nozzle_position (
int
,float
, optional) – Motor’s nozzle outlet position in meters, in the motor’s coordinate system. See Positions and Coordinate Systems for details. Default is 0, in which case the origin of the coordinate system is placed at the motor’s nozzle outlet.burn_time (
float
,tuple
offloat
, optional) – Motor’s burn time. If a float is given, the burn time is assumed to be between 0 and the given float, in seconds. If a tuple of float is given, the burn time is assumed to be between the first and second elements of the tuple, in seconds. If not specified, automatically sourced as the range between the first and last-time step of the motor’s thrust curve. This can only be used if the motor’s thrust is defined by a list of points, such as a .csv file, a .eng file or a Function instance whose source is a list.throat_radius (
int
,float
, optional) – Motor’s nozzle throat radius in meters. Used to calculate Kn curve. Optional if the Kn curve is not interesting. Its value does not impact trajectory simulation.reshape_thrust_curve (
boolean
,tuple
, optional) – If False, the original thrust curve supplied is not altered. If a tuple is given, whose first parameter is a new burn out time and whose second parameter is a new total impulse in Ns, the thrust curve is reshaped to match the new specifications. May be useful for motors whose thrust curve shape is expected to remain similar in case the impulse and burn time varies slightly. Default is False.interpolation_method (
string
, optional) – Method of interpolation to be used in case thrust curve is given by data set in .csv or .eng, or as an array. Options are ‘spline’ ‘akima’ and ‘linear’. Default is “linear”.coordinate_system_orientation (
string
, optional) – Orientation of the motor’s coordinate system. The coordinate system is defined by the motor’s axis of symmetry. The origin of the coordinate system may be placed anywhere along such axis, such as at the nozzle area, and must be kept the same for all other positions specified. Options are “nozzle_to_combustion_chamber” and “combustion_chamber_to_nozzle”. Default is “nozzle_to_combustion_chamber”.
- Return type:
None
- exhaust_velocity#
Exhaust velocity by assuming it as a constant. The formula used is total impulse/propellant initial mass.
- Returns:
self.exhaust_velocity – Gas exhaust velocity of the motor.
- Return type:
- propellant_mass#
Evaluates the total propellant mass of the motor as the sum of fluids mass in each tank and the grains mass.
- Returns:
Total propellant mass of the motor as a function of time, in kg.
- Return type:
- property propellant_initial_mass#
Returns the initial propellant mass of the motor. See the docs of the HybridMotor.propellant_mass property for more information.
- Returns:
Initial propellant mass of the motor, in kg.
- Return type:
float
- mass_flow_rate#
Evaluates the mass flow rate of the motor as the sum of mass flow rates from all tanks and the solid grains mass flow rate.
- Returns:
Mass flow rate of the motor, in kg/s.
- Return type:
See also
Motor.total_mass_flow_rate
Calculates the total mass flow rate of the motor assuming constant exhaust velocity.
- center_of_propellant_mass#
Position of the propellant center of mass as a function of time. The position is specified as a scalar, relative to the motor’s coordinate system.
- Returns:
Position of the center of mass as a function of time.
- Return type:
- propellant_I_11#
Inertia tensor 11 component of the propellant, the inertia is relative to the e_1 axis, centered at the instantaneous propellant center of mass.
- Returns:
Propellant inertia tensor 11 component at time t.
- Return type:
Notes
The e_1 direction is assumed to be the direction perpendicular to the motor body axis.
References
- propellant_I_22#
Inertia tensor 22 component of the propellant, the inertia is relative to the e_2 axis, centered at the instantaneous propellant center of mass.
- Returns:
Propellant inertia tensor 22 component at time t.
- Return type:
Notes
The e_2 direction is assumed to be the direction perpendicular to the motor body axis, and perpendicular to e_1.
- propellant_I_33#
Inertia tensor 33 component of the propellant, the inertia is relative to the e_3 axis, centered at the instantaneous propellant center of mass.
- Returns:
Propellant inertia tensor 33 component at time t.
- Return type:
Notes
The e_3 direction is assumed to be the axial direction of the rocket motor.
- propellant_I_12#
Inertia tensor 12 component of the propellant, the inertia is relative to the e_1 and e_2 axes, centered at the instantaneous propellant center of mass.
- Returns:
Propellant inertia tensor 12 component at time t.
- Return type:
Notes
This is assumed to be zero due to axial symmetry of the motor. This could be improved in the future to account for the fact that the motor is not perfectly symmetric.
- propellant_I_13#
Inertia tensor 13 component of the propellant, the inertia is relative to the e_1 and e_3 axes, centered at the instantaneous propellant center of mass.
- Returns:
Propellant inertia tensor 13 component at time t.
- Return type:
Notes
This is assumed to be zero due to axial symmetry of the motor. This could be improved in the future to account for the fact that the motor is not perfectly symmetric.
- propellant_I_23#
Inertia tensor 23 component of the propellant, the inertia is relative to the e_2 and e_3 axes, centered at the instantaneous propellant center of mass.
- Returns:
Propellant inertia tensor 23 component at time t.
- Return type:
Notes
This is assumed to be zero due to axial symmetry of the motor. This could be improved in the future to account for the fact that the motor is not perfectly symmetric.
- add_tank(tank, position)[source]#
Adds a tank to the motor.
- Parameters:
tank (
Tank
) – Tank object to be added to the motor.position (
float
) – Position of the tank relative to the origin of the motor coordinate system. The tank reference point is its geometry zero reference point.
See also
:ref:’Adding Tanks`
- Return type:
None