Getting Started with RocketPy in MATLAB®
In this Live Script, you will learn how to run RocketPy using the MATLAB® environment.
First things first: clone/download RocketPy's repository and set it as your MATLAB® working directory so that you can run this live script without any issues.
Finally, all the prerequisites are complete and you can comeback to MATLAB®! We just need to set the execution mode as out of process and start working. MATLAB® can run Python scripts and functions in a separate process. Running Python in a separate process enables you to:
- Use some third-party libraries in the Python code that are not compatible with MATLAB®.
- Isolate the MATLAB® process from crashes in the Python code.
pyenv('ExecutionMode','OutOfProcess');
Note: if MATLAB® is not able to find Python automatically, you may have to run the command line above including a path to the Python exectuable installed on your computer:
% pyenv('ExecutionMode','OutOfProcess', 'Version', '/path/to/python/executable');
Now, we will go through a simplified rocket trajectory simulation to get you started. Let's start by importing the rocketpy module and its classes.
rocketpy = py.importlib.import_module('rocketpy');
Environment = rocketpy.environment.Environment;
SolidMotor = rocketpy.motors.solid_motor.SolidMotor;
Rocket = rocketpy.rocket.Rocket;
Flight = rocketpy.simulation.flight.Flight;
Setting Up a Simulation
Creating an Environment for Spaceport America
% rocketpy.Environment(latitude, longitude, elevation);
env = Environment(pyargs(...
'latitude', 32.990254, ...
'longitude',-106.974998, ...
To get weather data from the GFS forecast, available online, we run the following lines.
First, we set tomorrow's date.
Tomorrow = datetime('tomorrow');
env.set_date({int32(Tomorrow.Year), int32(Tomorrow.Month), int32(Tomorrow.Day), int32(12)}) % Hour given in UTC time (noon UTC)
Now, we tell our Environment object to retrieve a weather forecast for our specified location and date using GFS:
env.set_atmospheric_model(pyargs( ...
We can see what the weather will look like by calling the info method!
Plots will open in a separate window, so be sure to run this last cell to see them!
Creating a Motor
A solid rocket motor is used in this case. To create a motor, the SolidMotor class is used and the required arguments are given.
The SolidMotor class requires the user to have a thrust curve ready. This can come either from a .eng file for a commercial motor, such as below, or a .csv file from a static test measurement.
Besides the thrust curve, other parameters such as grain properties and nozzle dimensions must also be given.
Pro75M1670 = SolidMotor(pyargs( ...
'thrust_source', "../../data/motors/Cesaroni_M1670.eng", ...
'dry_inertia', py.tuple({0.125, 0.125, 0.002}), ...
'nozzle_radius', 33 / 1000, ...
'grain_number', int32(5), ...
'grain_density', 1815, ...
'grain_outer_radius', 33 / 1000, ...
'grain_initial_inner_radius', 15 / 1000, ...
'grain_initial_height', 120 / 1000, ...
'grain_separation', 5 / 1000, ...
'grains_center_of_mass_position', -0.85704, ...
'center_of_dry_mass_position', 0.317, ...
'nozzle_position', 0, ...
'throat_radius', 11 / 1000, ...
'interpolation_method', "linear", ...
'coordinate_system_orientation', "nozzle_to_combustion_chamber" ...
To see what our thrust curve looks like, along with other import properties, we invoke the info method yet again. You may try the all_info method if you want more information all at once!
Plots will open in a separate window, so be sure to run this last cell to see them!
Creating a Rocket
A rocket is composed of several components. Namely, we must have a motor (good thing we have the Pro75M1670 ready), a couple of aerodynamic surfaces (nose cone, fins and tail) and parachutes (if we are not launching a missile).
Let's start by initializing our rocket, named calisto, supplying it with the Pro75M1670 engine, entering its inertia properties, some dimensions and also its drag curves.
calisto = Rocket(pyargs( ...
'radius', 127 / 2000, ...
'inertia', py.tuple({6.321, 6.321, 0.0334}), ...
'power_off_drag', "../../data/calisto/powerOffDragCurve.csv", ...
'power_on_drag', "../../data/calisto/powerOnDragCurve.csv", ...
'center_of_mass_without_motor', 0, ...
'coordinate_system_orientation', "tail_to_nose" ...
Rocket.set_rail_buttons(pyargs( ...
'upper_button_position', 0.0818, ...
'lower_button_position', -0.618, ...
'angular_position', 45 ...
Rocket.add_motor(pyargs( ...
% Adding Aerodynamic Surfaces
% Now we define the aerodynamic surfaces. They are really straight forward.
nosecone = Rocket.add_nose(pyargs( ...
'kind', "von karman", ...
fin_set = Rocket.add_trapezoidal_fins(pyargs( ...
tail = Rocket.add_tail(pyargs( ...
'top_radius', 0.0635, ...
'bottom_radius', 0.0435, ...
'position', -1.194656 ...
% Finally, we have parachutes! calisto will have two parachutes, Drogue and
% Both parachutes are activated by some special algorithm, which is usually
% really complex and a trade secret. Most algorithms are based on pressure sampling
% only, while some also use acceleration info.
% RocketPy allows you to define a trigger function which will decide when to
% activate the ejection event for each parachute. This trigger function is supplied
% with pressure measurement at a predefined sampling rate. This pressure signal
% is usually noisy, so artificial noise parameters can be given. Call
% py.help(Rocket.add_parachute)
for more details. Furthermore, the trigger function also receives the complete state vector of the rocket, allowing us to use velocity, acceleration or even attitude to decide when the parachute event should be triggered.
Here, we define our trigger functions rather simply using Python. Unfortunately, defining these with MATLAB® code is not yet possible.
% Drogue parachute is triggered when vertical velocity is negative, i.e. rocket is falling past apogee
drogue_trigger = py.eval("lambda p, y: y[5] < 0", py.dict);
% Main parachute is triggered when vertical velocity is negative and altitude is below 800 AGL
main_trigger = py.eval("lambda p, y: (y[5] < 0) and (y[2] < 800 + 1400)", py.dict);
Now we add both the drogue and the main parachute to our rocket.
Main = Rocket.add_parachute(pyargs( ...
'trigger', main_trigger, ...
'sampling_rate', 105, ...
'noise', py.tuple({0, 8.3, 0.5}) ...
Drogue = Rocket.add_parachute(pyargs( ...
'trigger', drogue_trigger, ...
'sampling_rate', 105, ...
'noise', py.tuple({0, 8.3, 0.5}) ...
Just be careful if you run this last cell multiple times! If you do so, your rocket will end up with lots of parachutes which activate together, which may cause problems during the flight simulation. We advise you to re-run all cells which define our rocket before running this, preventing unwanted old parachutes. Alternatively, you can run the following lines to remove parachutes.
% calisto.parachutes.remove(Drogue)
% calisto.parachutes.remove(Main)
Simulating a Flight
Simulating a flight trajectory is as simple as initializing a Flight class object givin the rocket and environnement set up above as inputs. The launch rail inclination and heading are also given here.
test_flight = Flight(pyargs(...
Analyzing the Results
RocketPy gives you many plots, thats for sure! They are divided into sections to keep them organized. Alternatively, see the Flight class documentation to see how to get plots for specific variables only, instead of all of them at once.
Plots will open in a separate window, so be sure to run this last cell to see them!
Working with Data Generated by RocketPy in MATLAB®
You can access the entire trajectory solution matrix with the following line of code. The returned matrix contain the following columns: time t (s), x (m), y (m), z (m), (m/s), (m/s), (m/s), , , , , (rad/s), (rad/s), (rad/s). solution_matrix = double(py.numpy.array(test_flight.solution))
Support for accessing secondary values calculated during post processing, such as energy, mach number, and angle of attack, is also available for all versions of RocketPy greater than or equal to version 0.11.0.
To showcase this, let's get the angle of attack of the rocket and plot it using MATLAB®:
angle_of_attack = double(test_flight.angle_of_attack.source)
plot(angle_of_attack(:,1), angle_of_attack(:,2)) % First column is time (s), second is the angle of attack
ylabel('Angle of Attack (Deg)')
xlim([test_flight.out_of_rail_time, 10])
You can also convert data from other objects besides the Flight class, such as from the Environment. For example, let's say you want to get the wind velocity, both the x and y component:
wind_velocity_x = double(env.wind_velocity_x.source) % First column is altitude (ASL m), while the second one is the speed (m/s)
wind_velocity_y = double(env.wind_velocity_y.source) % First column is altitude (ASL m), while the second one is the speed (m/s)
Time to Fly!
This is all you need to get started using RocketPy in MATLAB®! Now it is time to play around and create amazing rockets. Have a great launch!
+.S9 { margin: 20px 10px 5px 4px; padding: 0px; line-height: 20px; min-height: 0px; white-space: pre-wrap; color: rgb(33, 33, 33); font-family: Helvetica, Arial, sans-serif; font-style: normal; font-size: 20px; font-weight: 700; text-align: left; }
Getting Started with RocketPy in MATLAB®
In this Live Script, you will learn how to run RocketPy using the MATLAB® environment.
First things first: clone/download RocketPy's repository and set it as your MATLAB® working directory so that you can run this live script without any issues.
Finally, all the prerequisites are complete and you can comeback to MATLAB®! We just need to set the execution mode as out of process and start working. MATLAB® can run Python scripts and functions in a separate process. Running Python in a separate process enables you to:
- Use some third-party libraries in the Python code that are not compatible with MATLAB®.
- Isolate the MATLAB® process from crashes in the Python code.
pyenv('ExecutionMode','OutOfProcess');
Note: if MATLAB® is not able to find Python automatically, you may have to run the command line above including a path to the Python exectuable installed on your computer:
% pyenv('ExecutionMode','OutOfProcess', 'Version', '/path/to/python/executable');
Now, we will go through a simplified rocket trajectory simulation to get you started. Let's start by importing the rocketpy module and its classes.
rocketpy = py.importlib.import_module('rocketpy');
Environment = rocketpy.environment.Environment;
SolidMotor = rocketpy.motors.solid_motor.SolidMotor;
Rocket = rocketpy.rocket.Rocket;
Flight = rocketpy.simulation.flight.Flight;
Setting Up a Simulation
Creating an Environment for Spaceport America
% rocketpy.Environment(latitude, longitude, elevation);
env = Environment(pyargs(...
'latitude', 32.990254, ...
'longitude',-106.974998, ...
To get weather data from the GFS forecast, available online, we run the following lines.
First, we set tomorrow's date.
Tomorrow = datetime('tomorrow');
env.set_date({int32(Tomorrow.Year), int32(Tomorrow.Month), int32(Tomorrow.Day), int32(12)}) % Hour given in UTC time (noon UTC)
Now, we tell our Environment object to retrieve a weather forecast for our specified location and date using GFS:
env.set_atmospheric_model(pyargs( ...
We can see what the weather will look like by calling the info method!
Plots will open in a separate window, so be sure to run this last cell to see them!
Creating a Motor
A solid rocket motor is used in this case. To create a motor, the SolidMotor class is used and the required arguments are given.
The SolidMotor class requires the user to have a thrust curve ready. This can come either from a .eng file for a commercial motor, such as below, or a .csv file from a static test measurement.
Besides the thrust curve, other parameters such as grain properties and nozzle dimensions must also be given.
Pro75M1670 = SolidMotor(pyargs( ...
'thrust_source', "../../data/motors/cesaroni/Cesaroni_M1670.eng", ...
'dry_inertia', py.tuple({0.125, 0.125, 0.002}), ...
'nozzle_radius', 33 / 1000, ...
'grain_number', int32(5), ...
'grain_density', 1815, ...
'grain_outer_radius', 33 / 1000, ...
'grain_initial_inner_radius', 15 / 1000, ...
'grain_initial_height', 120 / 1000, ...
'grain_separation', 5 / 1000, ...
'grains_center_of_mass_position', -0.85704, ...
'center_of_dry_mass_position', 0.317, ...
'nozzle_position', 0, ...
'throat_radius', 11 / 1000, ...
'interpolation_method', "linear", ...
'coordinate_system_orientation', "nozzle_to_combustion_chamber" ...
To see what our thrust curve looks like, along with other import properties, we invoke the info method yet again. You may try the all_info method if you want more information all at once!
Plots will open in a separate window, so be sure to run this last cell to see them!
Creating a Rocket
A rocket is composed of several components. Namely, we must have a motor (good thing we have the Pro75M1670 ready), a couple of aerodynamic surfaces (nose cone, fins and tail) and parachutes (if we are not launching a missile).
Let's start by initializing our rocket, named calisto, supplying it with the Pro75M1670 engine, entering its inertia properties, some dimensions and also its drag curves.
calisto = Rocket(pyargs( ...
'radius', 127 / 2000, ...
'inertia', py.tuple({6.321, 6.321, 0.0334}), ...
'power_off_drag', "../../data/rockets/calisto/powerOffDragCurve.csv", ...
'power_on_drag', "../../data/rockets/calisto/powerOnDragCurve.csv", ...
'center_of_mass_without_motor', 0, ...
'coordinate_system_orientation', "tail_to_nose" ...
Rocket.set_rail_buttons(pyargs( ...
'upper_button_position', 0.0818, ...
'lower_button_position', -0.618, ...
'angular_position', 45 ...
Rocket.add_motor(pyargs( ...
% Adding Aerodynamic Surfaces
% Now we define the aerodynamic surfaces. They are really straight forward.
nosecone = Rocket.add_nose(pyargs( ...
'kind', "von karman", ...
fin_set = Rocket.add_trapezoidal_fins(pyargs( ...
tail = Rocket.add_tail(pyargs( ...
'top_radius', 0.0635, ...
'bottom_radius', 0.0435, ...
'position', -1.194656 ...
% Finally, we have parachutes! calisto will have two parachutes, Drogue and
% Both parachutes are activated by some special algorithm, which is usually
% really complex and a trade secret. Most algorithms are based on pressure sampling
% only, while some also use acceleration info.
% RocketPy allows you to define a trigger function which will decide when to
% activate the ejection event for each parachute. This trigger function is supplied
% with pressure measurement at a predefined sampling rate. This pressure signal
% is usually noisy, so artificial noise parameters can be given. Call
% py.help(Rocket.add_parachute)
for more details. Furthermore, the trigger function also receives the complete state vector of the rocket, allowing us to use velocity, acceleration or even attitude to decide when the parachute event should be triggered.
Here, we define our trigger functions rather simply using Python. Unfortunately, defining these with MATLAB® code is not yet possible.
% Drogue parachute is triggered when vertical velocity is negative, i.e. rocket is falling past apogee
drogue_trigger = py.eval("lambda p, y: y[5] < 0", py.dict);
% Main parachute is triggered when vertical velocity is negative and altitude is below 800 AGL
main_trigger = py.eval("lambda p, y: (y[5] < 0) and (y[2] < 800 + 1400)", py.dict);
Now we add both the drogue and the main parachute to our rocket.
Main = Rocket.add_parachute(pyargs( ...
'trigger', main_trigger, ...
'sampling_rate', 105, ...
'noise', py.tuple({0, 8.3, 0.5}) ...
Drogue = Rocket.add_parachute(pyargs( ...
'trigger', drogue_trigger, ...
'sampling_rate', 105, ...
'noise', py.tuple({0, 8.3, 0.5}) ...
Just be careful if you run this last cell multiple times! If you do so, your rocket will end up with lots of parachutes which activate together, which may cause problems during the flight simulation. We advise you to re-run all cells which define our rocket before running this, preventing unwanted old parachutes. Alternatively, you can run the following lines to remove parachutes.
% calisto.parachutes.remove(Drogue)
% calisto.parachutes.remove(Main)
Simulating a Flight
Simulating a flight trajectory is as simple as initializing a Flight class object givin the rocket and environnement set up above as inputs. The launch rail inclination and heading are also given here.
test_flight = Flight(pyargs(...
Analyzing the Results
RocketPy gives you many plots, thats for sure! They are divided into sections to keep them organized. Alternatively, see the Flight class documentation to see how to get plots for specific variables only, instead of all of them at once.
Plots will open in a separate window, so be sure to run this last cell to see them!
Working with Data Generated by RocketPy in MATLAB®
You can access the entire trajectory solution matrix with the following line of code. The returned matrix contain the following columns: time t (s), x (m), y (m), z (m), (m/s), (m/s), (m/s), , , , , (rad/s), (rad/s), (rad/s). solution_matrix = double(py.numpy.array(test_flight.solution))
Support for accessing secondary values calculated during post processing, such as energy, mach number, and angle of attack, is also available for all versions of RocketPy greater than or equal to version 0.11.0.
To showcase this, let's get the angle of attack of the rocket and plot it using MATLAB®:
angle_of_attack = double(test_flight.angle_of_attack.source)
plot(angle_of_attack(:,1), angle_of_attack(:,2)) % First column is time (s), second is the angle of attack
ylabel('Angle of Attack (Deg)')
xlim([test_flight.out_of_rail_time, 10])
You can also convert data from other objects besides the Flight class, such as from the Environment. For example, let's say you want to get the wind velocity, both the x and y component:
wind_velocity_x = double(env.wind_velocity_x.source) % First column is altitude (ASL m), while the second one is the speed (m/s)
wind_velocity_y = double(env.wind_velocity_y.source) % First column is altitude (ASL m), while the second one is the speed (m/s)
Time to Fly!
This is all you need to get started using RocketPy in MATLAB®! Now it is time to play around and create amazing rockets. Have a great launch!
-
diff --git a/docs/matlab/Getting_Started.m b/docs/matlab/Getting_Started.m
index 360a19c37..2983d59b6 100644
--- a/docs/matlab/Getting_Started.m
+++ b/docs/matlab/Getting_Started.m
@@ -1,36 +1,36 @@
%% Getting Started with RocketPy in MATLAB®
-% In this Live Script, you will learn how to run RocketPy using the MATLAB®
+% In this Live Script, you will learn how to run RocketPy using the MATLAB®
% environment.
-%
-% First things first: clone/download RocketPy's repository and set it as your
+%
+% First things first: clone/download RocketPy's repository and set it as your
% MATLAB® working directory so that you can run this live script without any issues.
-%
-% After that, we start by configuring our Python environment. You can do so
-% by following the guidelines presented in the MATLAB® documentation:
.
-%
-% Once the Python environment is configured, RocketPy needs to installed using
-% |pip| as outlined in RocketPy's documentation: .
-%
-% Finally, all the prerequisites are complete and you can comeback to MATLAB®!
-% We just need to set the execution mode as out of process and start working.
-% MATLAB® can run Python scripts and functions in a separate process. Running
+%
+% Finally, all the prerequisites are complete and you can comeback to MATLAB®!
+% We just need to set the execution mode as out of process and start working.
+% MATLAB® can run Python scripts and functions in a separate process. Running
% Python in a separate process enables you to:
-%%
-% * Use some third-party libraries in the Python code that are not compatible
+%%
+% * Use some third-party libraries in the Python code that are not compatible
% with MATLAB®.
% * Isolate the MATLAB® process from crashes in the Python code.
pyenv('ExecutionMode','OutOfProcess');
%%
-% Note: if MATLAB® is not able to find Python automatically, you may have to
-% run the command line above including a path to the Python exectuable installed
+% Note: if MATLAB® is not able to find Python automatically, you may have to
+% run the command line above including a path to the Python exectuable installed
% on your computer:
% pyenv('ExecutionMode','OutOfProcess', 'Version', '/path/to/python/executable');
-%%
-% Now, we will go through a simplified rocket trajectory simulation to get you
+%%
+% Now, we will go through a simplified rocket trajectory simulation to get you
% started. Let's start by importing the rocketpy module and its classes.
rocketpy = py.importlib.import_module('rocketpy');
@@ -47,42 +47,42 @@
'longitude',-106.974998, ...
'elevation', 1400 ...
));
-%%
-% To get weather data from the GFS forecast, available online, we run the following
+%%
+% To get weather data from the GFS forecast, available online, we run the following
% lines.
-%
+%
% First, we set tomorrow's date.
Tomorrow = datetime('tomorrow');
env.set_date({int32(Tomorrow.Year), int32(Tomorrow.Month), int32(Tomorrow.Day), int32(12)}) % Hour given in UTC time (noon UTC)
-%%
-% Now, we tell our Environment object to retrieve a weather forecast for our
+%%
+% Now, we tell our Environment object to retrieve a weather forecast for our
% specified location and date using GFS:
env.set_atmospheric_model(pyargs( ...
'type', "Forecast", ...
'file', "GFS" ...
))
-%%
+%%
% We can see what the weather will look like by calling the info method!
env.info()
-%%
-% Plots will open in a separate window, so be sure to run this last cell to
+%%
+% Plots will open in a separate window, so be sure to run this last cell to
% see them!
%% Creating a Motor
-% A solid rocket motor is used in this case. To create a motor, the SolidMotor
+% A solid rocket motor is used in this case. To create a motor, the SolidMotor
% class is used and the required arguments are given.
-%
-% The SolidMotor class requires the user to have a thrust curve ready. This
-% can come either from a .eng file for a commercial motor, such as below, or a
+%
+% The SolidMotor class requires the user to have a thrust curve ready. This
+% can come either from a .eng file for a commercial motor, such as below, or a
% .csv file from a static test measurement.
-%
-% Besides the thrust curve, other parameters such as grain properties and nozzle
+%
+% Besides the thrust curve, other parameters such as grain properties and nozzle
% dimensions must also be given.
Pro75M1670 = SolidMotor(pyargs( ...
- 'thrust_source', "../../data/motors/Cesaroni_M1670.eng", ...
+ 'thrust_source', "../../data/motors/cesaroni/Cesaroni_M1670.eng", ...
'dry_mass', 1.815, ...
'dry_inertia', py.tuple({0.125, 0.125, 0.002}), ...
'nozzle_radius', 33 / 1000, ...
@@ -100,30 +100,30 @@
'interpolation_method', "linear", ...
'coordinate_system_orientation', "nozzle_to_combustion_chamber" ...
));
-%%
-% To see what our thrust curve looks like, along with other import properties,
-% we invoke the info method yet again. You may try the all_info method if you want
+%%
+% To see what our thrust curve looks like, along with other import properties,
+% we invoke the info method yet again. You may try the all_info method if you want
% more information all at once!
Pro75M1670.info()
-%%
-% Plots will open in a separate window, so be sure to run this last cell to
+%%
+% Plots will open in a separate window, so be sure to run this last cell to
% see them!
%% Creating a Rocket
-% A rocket is composed of several components. Namely, we must have a motor (good
-% thing we have the Pro75M1670 ready), a couple of aerodynamic surfaces (nose
+% A rocket is composed of several components. Namely, we must have a motor (good
+% thing we have the Pro75M1670 ready), a couple of aerodynamic surfaces (nose
% cone, fins and tail) and parachutes (if we are not launching a missile).
-%
-% Let's start by initializing our rocket, named calisto, supplying it with the
-% Pro75M1670 engine, entering its inertia properties, some dimensions and also
+%
+% Let's start by initializing our rocket, named calisto, supplying it with the
+% Pro75M1670 engine, entering its inertia properties, some dimensions and also
% its drag curves.
calisto = Rocket(pyargs( ...
'radius', 127 / 2000, ...
'mass', 14.426, ...
'inertia', py.tuple({6.321, 6.321, 0.0334}), ...
- 'power_off_drag', "../../data/calisto/powerOffDragCurve.csv", ...
- 'power_on_drag', "../../data/calisto/powerOnDragCurve.csv", ...
+ 'power_off_drag', "../../data/rockets/calisto/powerOffDragCurve.csv", ...
+ 'power_on_drag', "../../data/rockets/calisto/powerOnDragCurve.csv", ...
'center_of_mass_without_motor', 0, ...
'coordinate_system_orientation', "tail_to_nose" ...
));
@@ -166,33 +166,33 @@
'position', -1.194656 ...
));
% Adding Parachutes
-% Finally, we have parachutes! calisto will have two parachutes, Drogue and
+% Finally, we have parachutes! calisto will have two parachutes, Drogue and
% Main.
-%
-% Both parachutes are activated by some special algorithm, which is usually
-% really complex and a trade secret. Most algorithms are based on pressure sampling
+%
+% Both parachutes are activated by some special algorithm, which is usually
+% really complex and a trade secret. Most algorithms are based on pressure sampling
% only, while some also use acceleration info.
-%
-% RocketPy allows you to define a trigger function which will decide when to
-% activate the ejection event for each parachute. This trigger function is supplied
-% with pressure measurement at a predefined sampling rate. This pressure signal
-% is usually noisy, so artificial noise parameters can be given. Call
+%
+% RocketPy allows you to define a trigger function which will decide when to
+% activate the ejection event for each parachute. This trigger function is supplied
+% with pressure measurement at a predefined sampling rate. This pressure signal
+% is usually noisy, so artificial noise parameters can be given. Call
% py.help(Rocket.add_parachute)
-%%
-% for more details. Furthermore, the trigger function also receives the complete
-% state vector of the rocket, allowing us to use velocity, acceleration or even
+%%
+% for more details. Furthermore, the trigger function also receives the complete
+% state vector of the rocket, allowing us to use velocity, acceleration or even
% attitude to decide when the parachute event should be triggered.
-%
-% Here, we define our trigger functions rather simply using Python. Unfortunately,
+%
+% Here, we define our trigger functions rather simply using Python. Unfortunately,
% defining these with MATLAB® code is not yet possible.
% Drogue parachute is triggered when vertical velocity is negative, i.e. rocket is falling past apogee
drogue_trigger = py.eval("lambda p, y: y[5] < 0", py.dict);
-% Main parachute is triggered when vertical velocity is negative and altitude is below 800 AGL
-main_trigger = py.eval("lambda p, y: (y[5] < 0) and (y[2] < 800 + 1400)", py.dict);
-%%
+% Main parachute is triggered when vertical velocity is negative and altitude is below 800 AGL
+main_trigger = py.eval("lambda p, y: (y[5] < 0) and (y[2] < 800 + 1400)", py.dict);
+%%
% Now we add both the drogue and the main parachute to our rocket.
Main = Rocket.add_parachute(pyargs( ...
@@ -214,18 +214,18 @@
'lag', 1.5, ...
'noise', py.tuple({0, 8.3, 0.5}) ...
));
-%%
-% |Just be careful if you run this last cell multiple times! If you do so, your
-% rocket will end up with lots of parachutes which activate together, which may
-% cause problems during the flight simulation. We advise you to re-run all cells
-% which define our rocket before running this, preventing unwanted old parachutes.
+%%
+% |Just be careful if you run this last cell multiple times! If you do so, your
+% rocket will end up with lots of parachutes which activate together, which may
+% cause problems during the flight simulation. We advise you to re-run all cells
+% which define our rocket before running this, preventing unwanted old parachutes.
% Alternatively, you can run the following lines to remove parachutes.|
% calisto.parachutes.remove(Drogue)
% calisto.parachutes.remove(Main)
%% |Simulating a Flight|
-% |Simulating a flight trajectory is as simple as initializing a Flight class
-% object givin the rocket and environnement set up above as inputs. The launch
+% |Simulating a flight trajectory is as simple as initializing a Flight class
+% object givin the rocket and environnement set up above as inputs. The launch
% rail inclination and heading are also given here.|
test_flight = Flight(pyargs(...
@@ -236,28 +236,28 @@
'heading', 0 ...
));
%% |Analyzing the Results|
-% |RocketPy gives you many plots, thats for sure! They are divided into sections
-% to keep them organized. Alternatively, see the Flight class documentation to
-% see how to get plots for specific variables only, instead of all of them at
+% |RocketPy gives you many plots, thats for sure! They are divided into sections
+% to keep them organized. Alternatively, see the Flight class documentation to
+% see how to get plots for specific variables only, instead of all of them at
% once.|
test_flight.all_info()
-%%
-% Plots will open in a separate window, so be sure to run this last cell to
+%%
+% Plots will open in a separate window, so be sure to run this last cell to
% see them!
%% Working with Data Generated by RocketPy in MATLAB®
-% You can access the entire trajectory solution matrix with the following line
-% of code. The returned matrix contain the following columns: time $t$ (s), $x$
-% (m), $y$ (m), $z$ (m), $v_x$ (m/s), $v_y$ (m/s), $v_z$ (m/s), $q_0$, $q_1$,
+% You can access the entire trajectory solution matrix with the following line
+% of code. The returned matrix contain the following columns: time $t$ (s), $x$
+% (m), $y$ (m), $z$ (m), $v_x$ (m/s), $v_y$ (m/s), $v_z$ (m/s), $q_0$, $q_1$,
% $q_2$, $q_3$, $\omega_1$ (rad/s), $\omega_2$ (rad/s), $\omega_3$ (rad/s).
solution_matrix = double(py.numpy.array(test_flight.solution))
-%%
-% Support for accessing secondary values calculated during post processing,
-% such as energy, mach number, and angle of attack, is also available for all
+%%
+% Support for accessing secondary values calculated during post processing,
+% such as energy, mach number, and angle of attack, is also available for all
% versions of RocketPy greater than or equal to version 0.11.0.
-%
-% To showcase this, let's get the angle of attack of the rocket and plot it
+%
+% To showcase this, let's get the angle of attack of the rocket and plot it
% using MATLAB®:
angle_of_attack = double(test_flight.angle_of_attack.source)
@@ -265,13 +265,13 @@
ylabel('Angle of Attack (Deg)')
xlabel('Time(s)')
xlim([test_flight.out_of_rail_time, 10])
-%%
-% You can also convert data from other objects besides the Flight class, such
-% as from the Environment. For example, let's say you want to get the wind velocity,
+%%
+% You can also convert data from other objects besides the Flight class, such
+% as from the Environment. For example, let's say you want to get the wind velocity,
% both the x and y component:
wind_velocity_x = double(env.wind_velocity_x.source) % First column is altitude (ASL m), while the second one is the speed (m/s)
wind_velocity_y = double(env.wind_velocity_y.source) % First column is altitude (ASL m), while the second one is the speed (m/s)
%% Time to Fly!
-% This is all you need to get started using RocketPy in MATLAB®! Now it is time
+% This is all you need to get started using RocketPy in MATLAB®! Now it is time
% to play around and create amazing rockets. Have a great launch!
\ No newline at end of file
diff --git a/docs/notebooks/getting_started.ipynb b/docs/notebooks/getting_started.ipynb
index 307042755..cabc26407 100644
--- a/docs/notebooks/getting_started.ipynb
+++ b/docs/notebooks/getting_started.ipynb
@@ -32,7 +32,7 @@
},
{
"cell_type": "code",
- "execution_count": null,
+ "execution_count": 1,
"metadata": {},
"outputs": [],
"source": [
@@ -42,7 +42,7 @@
},
{
"cell_type": "code",
- "execution_count": null,
+ "execution_count": 2,
"metadata": {
"colab": {},
"colab_type": "code",
@@ -105,7 +105,7 @@
},
{
"cell_type": "code",
- "execution_count": null,
+ "execution_count": 4,
"metadata": {
"colab": {},
"colab_type": "code",
@@ -131,7 +131,7 @@
},
{
"cell_type": "code",
- "execution_count": null,
+ "execution_count": 5,
"metadata": {
"colab": {},
"colab_type": "code",
@@ -163,7 +163,7 @@
},
{
"cell_type": "code",
- "execution_count": null,
+ "execution_count": 6,
"metadata": {
"colab": {},
"colab_type": "code",
@@ -187,13 +187,78 @@
},
{
"cell_type": "code",
- "execution_count": null,
+ "execution_count": 7,
"metadata": {
"colab": {},
"colab_type": "code",
"id": "H_AMjVTjNVFT"
},
- "outputs": [],
+ "outputs": [
+ {
+ "name": "stdout",
+ "output_type": "stream",
+ "text": [
+ "\n",
+ "Gravity Details\n",
+ "\n",
+ "Acceleration of gravity at surface level: 9.7911 m/s²\n",
+ "Acceleration of gravity at 5.000 km (ASL): 9.7802 m/s²\n",
+ "\n",
+ "\n",
+ "Launch Site Details\n",
+ "\n",
+ "Launch Date: 2024-11-03 12:00:00 UTC\n",
+ "Launch Site Latitude: 32.99025°\n",
+ "Launch Site Longitude: -106.97500°\n",
+ "Reference Datum: SIRGAS2000\n",
+ "Launch Site UTM coordinates: 315468.64 W 3651938.65 N\n",
+ "Launch Site UTM zone: 13S\n",
+ "Launch Site Surface Elevation: 1471.5 m\n",
+ "\n",
+ "\n",
+ "Atmospheric Model Details\n",
+ "\n",
+ "Atmospheric Model Type: Forecast\n",
+ "Forecast Maximum Height: 5.000 km\n",
+ "Forecast Time Period: from 2024-11-02 06:00:00 to 2024-11-18 06:00:00 utc\n",
+ "Forecast Hour Interval: 3 hrs\n",
+ "Forecast Latitude Range: From -90.0° to 90.0°\n",
+ "Forecast Longitude Range: From 0.0° to 359.75°\n",
+ "\n",
+ "Surface Atmospheric Conditions\n",
+ "\n",
+ "Surface Wind Speed: 201.65 m/s\n",
+ "Surface Wind Direction: 21.65°\n",
+ "Surface Wind Heading: 4.31°\n",
+ "Surface Pressure: 845.29 hPa\n",
+ "Surface Temperature: 283.30 K\n",
+ "Surface Air Density: 1.039 kg/m³\n",
+ "Surface Speed of Sound: 337.42 m/s\n",
+ "\n",
+ "\n",
+ "Earth Model Details\n",
+ "\n",
+ "Earth Radius at Launch site: 6371.83 km\n",
+ "Semi-major Axis: 6378.14 km\n",
+ "Semi-minor Axis: 6356.75 km\n",
+ "Flattening: 0.0034\n",
+ "\n",
+ "\n",
+ "Atmospheric Model Plots\n",
+ "\n"
+ ]
+ },
+ {
+ "data": {
+ "image/png": "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",
+ "text/plain": [
+ "