Difference between revisions of "Getting Started"

From OpenRocket wiki
Jump to navigation Jump to search
Line 335: Line 335:
 
<br />
 
<br />
  
That completes the airframe exterior, which can be viewed in either 2D (as above) or three 3D views. The most commonly used of which are ''3D Unfinished'' and ''3D Finished''.
+
----
  
<br />
+
[[#Rocket Configuration| &larr; Go to ''Rocket Configuration'']]
  
That completes the airframe exterior, which can be viewed in either 2D (as above) or three 3D views. The most commonly used of which are ''3D Unfinished'' and ''3D Finished''.
+
----
  
 
<br />
 
<br />
 +
 +
== Adding Internal Components ==
  
 
<table class="left">
 
<table class="left">
 
   <tr>
 
   <tr>
     <th>''3D Unfinished'' View</th>
+
     <th>''Launch Lug'' Specifications</th>
     <td>'''[[File:11.06.01.Rocket_Build.3D_Unfinished.png|left|frameless|1028 px|center]]'''</td>
+
     <td>'''[[File:11.06.02.Rocket_Build.Launch_Lug.png|left|frameless|512 px|center]]'''</td>
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <th>''3D Finished'' View</th>
+
     <th>''Launch Lug'' Added</th>
     <td>'''[[File:11.06.02.Rocket_Build.3D_Finished.png|left|frameless|1028 px|center]]'''</td>
+
     <td>'''[[File:11.06.03.Rocket_Build.Launch_Lug.png|left|frameless|1028 px|center]]'''</td>
 
   </tr>
 
   </tr>
 
</table>
 
</table>
  
 
<br />
 
<br />
 +
 +
That completes the airframe exterior, which can be viewed in either 2D (as above) or three 3D views. The most commonly used of which are ''3D Unfinished'' and ''3D Finished''.
  
 
----
 
----
  
[[#Rocket Configuration| &larr; Go to ''Rocket Configuration'']]
+
[[#Adding External Components| &larr; Go to ''Adding External Components'']]
  
 
----
 
----
Line 364: Line 368:
 
<br />
 
<br />
  
== Adding Internal Components ==
+
== Viewing Your Design ==
  
 
<br />
 
<br />
 +
 +
<table class="left">
 +
  <tr>
 +
    <th>''3D Unfinished'' View</th>
 +
    <td>'''[[File:11.06.01.Rocket_Build.3D_Unfinished.png|left|frameless|1028 px|center]]'''</td>
 +
  </tr>
 +
  <tr>
 +
    <th>''3D Finished'' View</th>
 +
    <td>'''[[File:11.06.02.Rocket_Build.3D_Finished.png|left|frameless|1028 px|center]]'''</td>
 +
  </tr>
 +
</table>
  
 
----
 
----
  
[[#Adding External Components| &larr; Go to ''Adding External Components'']]
+
[[#Adding Internal Components| &larr; Go to ''Adding InternalComponents'']]
  
 
----
 
----

Revision as of 10:37, 3 April 2022

↑ Back to Contents

The current User's Guide is very much a work in progress, any help would be greatly appreciated!
If you'd like to contribute something, just hit the 'Edit' tab at the top.



In this section we have a look at how OpenRocket is organized, by analyzing in detail the structure of the user interface. We will also briefly mention the Example projects that are accessible from the File menu. After reading this section you will have a thorough understanding of how OpenRocket is structured, and will be ready to start designing a rocket of your own. If you already know how this program is organized, feel free to jump to Basic Rocket Design, the next section.


The User interface

The OpenRocket user interface is divided horizontally into four sections, the Main Menu (green); the Task Tabs (black); the Rocket Design, Motors & Configuration, and Flight Simulation Pane (red), and the Rocket Views Pane (blue).

UI of OpenRocket divided into four

Main Menu

Menu Item Description
File
OR.Guide.User Interface.04.01.File.png
The File Menu is divided into five divisions by function, (1) file opening options; (2) file saving options; (3) import and export options; and (4) closing and (5) quiting options.
- New allows you to start a new project, without closing the project that is currently open.
- Open... allows you to open an *.ork file that you have previously saved on your computer.
- Open Recent opens a pull-down menu of recently opened filed from which you may choose one to reopen.
- Open Example allows you to select from and open an example project included with OpenRocket.
- Save saves the changes you have made to a project that you have previously saved.
- Save as... allows you to save the project you are working on to a new *.ork file.
- Import allows you to import a previously saved Rocksim 10 *.rkt file.
- Export allows you to export the project you are working on to a Rocksim 10 *.rkt file.
- Export Decal allows you to export a decal *.jpg file (currently only the first decal).
- Print/Export PDF allows you to select elements to print or export to a *.pdf" file from a drop-down menu; such as the technical details of your rocket's components, templates for your rocket's fin sets, or even the design of your rocket.
- Close exits the current project (you will be asked whether to save unsaved changes); close also exits OpenRocket if there are no other open projects.
- Quit exits OpenRocket, checking that you have saved all open projects.
Edit
OR.Guide.User Interface.04.02.File.png
The Edit Menu is divided into three types of operations, (1) undoing and redoing an action; (2) cutting, copying, pasting, and deleting components and text; and scaling the rocket and system preference.
Tools
OR.Guide.User Interface.04.03.File.png
The Tools Menu provides design tools which allow the user to analyze the effect of specific components, optimize particular rocket characteristics, create custom expressions for specialized to analysis, and a photo studio which displays the rocket in 3D with a variety of backgrounds and effects.
Help
OR.Guide.User Interface.04.04.File.png
The Help Menu is divided into three sections, (1) guided tours demonstrating the use of OpenRocket; (2) bug reporting and debugging tools to assist users provide feedback to the developers; and (3) licensing and version and other general information about OpenRocket.

← Go to The User interface



Task Tabs

The windows shown below utilize the A simple model rocket example included with OpenRocket.

Rocket Design
01.02.Rocket Design.Tab.png
The Rocket Design tab is divided into three sections, the component tree, component arrangement buttons, and component selection buttons. The components available in OpenRocket are divided into four classes based upon component function. These classes are assembly components, body components and fin sets (external components), internal components, and mass components (which include electronics and recovery components). Components are greyed out until it would be appropriate to add that component type. As components are added, you will see the component tree (on the left side of the window, grow with each component added. For a detailed description of each component, see Component Details.

Motors & Configuration
02.02.Motor-Configuration.Tab.png
The Motors & Configurations tab is where you select motors, recovery events, and stage timing. Motor configuration options include creating new configurations, renaming existing configurations, removing (deleting) configurations, and copying configurations. With a specific configuration selected, you may select (or select a different) motor, remove the motor, or select and reset the motor ignition timing. For more motors and configuration utilization details, see Motors & Configuration Details.

Flight Simulations
03.02.Flight simulations.Tab.png
The Flight Simulations tab is where you manage and flight simulations and flight simulation plots. From here, you can add new simulations, or edit, run, or delete existing simulations. Select a single simulation, and you can even plot and export the simulation results. For more details on ow to use these functions, see Flight Simulations Details.


← Go to Main Menu



Rocket Views

The windows shown below utilize the A simple model rocket example included with OpenRocket.

The Side View and Back View are line drawings, similar to a blueprint that shows all of the rocket components and the placement of those components. Almost all of your design work will take place in the side and back views.
Side/Back View
05.01.01.Rocket Display.Side.png
05.02.01.Rocket Display.Back.png

The 3D Figure and 3D Unfinished view allow you to look through the rockets exterior to view many of the interior components. These views can help you more clearly see the relationship between the placement of different components inside the airframe.
3D Figure/3D Unfinished
05.03.01.Rocket Display.3D Figure.png
05.04.01.Rocket Display.3D Unfinished.png

The 3D Finished view shows you what the rocket will look like when finished. OpenRocket allows you to select component colors, inside and outside of outer tubes, right side or left side of fins, and even creating transparent components, all with or without decals (transparent or opaque).
3D Finished
05.05.01.Rocket Display.3D Finished.png

← Go to Task Tabs



Become Familiar with OpenRocket

For new users of OpenRocket, before attempting to create your own custom rocket design, it is strongly recommended that you become familiar with the OpenRocket user interface and generally accepted rocket design principles by opening and looking at how an example is assembled, making changes to the example, and understanding how to simulate flights. The example designs are found here:

File → Example... →
01.04.02.Open Example.png

← Go to Rocket Views



Starting a New Design

Rocket Configuration

To build your first rocket, start OpenRocket, then double click the Rocket label at the top of the component tree to open the Rocket configuration pop-up window. OpenRocket allows you to name your design, identify the designer, make comments, and create a revision history.

The default design name is Rocket, but that name can be changed, and a design name change also changes the name of the rocket shown on the component tree. So, rename your design and enter the designer, comments, and revision history information you desire.

Double-Click Rocket
04.01.02.Rocket Configuration.png
Rename Rocket
04.01.05.Rocket Configuration.Rename.png

← Go to Become Familiar with OpenRocket



Adding External Components

Now it's time to start putting together components to build the rocket design. The generally accepted way of putting together a rocket design is from top to bottom, from nose to tail. So, we'll add the nose cone first.

Selecting a Nose Cone

With the Stage selected, click on the Nose Cone button and the Nose Cone configuration window will pop up. Then, select From database... to open the Choose component present window. From here, you can select from the pre-loaded parts database. Select the nose cone shown below, and click the Close button, then close the Nose Cone configuration window.

Selecting a Nose Cone
11.01.03.Rocket Build.Nose Cone.png
11.01.10.Rocket Build.Nose Cone.png
Nose Cone Added
11.01.11.Rocket Build.Nose Cone.png

Congratulations, you've just added your first component.


Adding a Payload Bay

So that a few "appearance" can be demonstrated later, a payload bay will be added after the nose cone. To do this, with either the Stageor Nose Cone selected, click on the Body Tube button and the Body Tube configuration window will pop up. Then, select From database... to open the Choose component present window. From here, you can select from the pre-loaded parts database. Select the body tube shown below, and click the Close button, then close the Body Tube configuration window.

Add a Body Tube
11.02.01.Rocket Build.Payload Bay.png
11.02.05.Rocket Build.Payload Bay.png
Payload Bay Added
11.02.06.Rocket Build.Payload Bay.png


Adding a Transition

Transitions are most often used to connect body tubes with different diameters. But, a transition can also be used to connect two body tubes of the same diameter, as will be done here.

To do this, with either the Stage or Payload Bay selected, click on the Transition button and the Transition configuration window will pop up. The default Transition Configuration tab is the General tab. On this tab, change your entries in the circled areas below to match the entries shown. Then, click the Shoulder tab, and change your entries in the circled areas below to match the entries shown. Then, click the Close button.

Add a Transition
11.03.01.Rocket Build.Transition.png
Change Specifications
11.03.06.Rocket Build.Transition.png
Transition Added
11.03.07.Rocket Build.Transition.png


Adding a Body Tube

Now, do what you did to add the Payload Bay, above, but select this body tube from the parts database:

Add a Body Tube
11.04.01.Rocket Build.Body Tube.png
Body Tube Added
11.04.02.Rocket Build.Body Tube.png


Adding Fins

The bottom component are the fins. OpenRocket offers four types of fins, Trapezoidal, Elliptical, Free Form, and Tube Fins. For this design, Trapezoidal fins will be used.

With the Body Tube selected, click on the Trapezoidal fins button and the Trapezoidal Fin Set configuration window will pop up. On your default General tab, change your entries match the entries shown. Then, click click the Close button.

Select Fin Type
11.05.01.Rocket Build.Fins.png
Select Fin Type
11.05.02.Rocket Build.Fins.png


Fins attach to another component, in this case the Body Tube. As circled below, the fins are shown underneath the Body Tube on the component tree.

Fins Added
11.05.03.Rocket Build.Fins.png


Adding a Launch Guide

OpenRocket includes two styles of launch guides, Rail Buttons and a Launch Lug. Because of the diameter of the body tube, a Launch Lug will be used for this design. As with fins, launch guides attach to another component, in this case the body tube.

You should now be able to open the Launch Lug configuration window without assistance. So, open your Launch Lug configuration window, and change the specifications to match those shown below.

Launch Lug Specifications
11.06.02.Rocket Build.Launch Lug.png
Launch Lug Added
11.06.03.Rocket Build.Launch Lug.png



← Go to Rocket Configuration



Adding Internal Components

Launch Lug Specifications
11.06.02.Rocket Build.Launch Lug.png
Launch Lug Added
11.06.03.Rocket Build.Launch Lug.png


That completes the airframe exterior, which can be viewed in either 2D (as above) or three 3D views. The most commonly used of which are 3D Unfinished and 3D Finished.


← Go to Adding External Components



Viewing Your Design


3D Unfinished View
11.06.01.Rocket Build.3D Unfinished.png
3D Finished View
11.06.02.Rocket Build.3D Finished.png

← Go to Adding InternalComponents



OpenRocket's main window

You now have access to the OpenRocket main window.


The OpenRocket main window.


Notice there are three tabs in the top of the window. These tabs allow you to switch between the Rocket design, Motors and Configuration, and Flight simulations windows.


The Rocket design window

Template:Anchor For the moment, let's focus on the Rocket design window. This window is organized in the following way:
- in the bottom half of the window there is a large white space. This is where a 2D image of the rocket you are designing will appear.
- in the top-left part of the window, the rocket's stages and components are shown. When you start a new project, the rocket contains only one stage (i.e.; the sustainer) but no components.
- in the top-right part of the window, all the body components and fin sets, inner components, and mass objects that you can add to the rocket are shown. Notice that it's not possible to add all of these objects to the rocket at any particular stage of the rocket design. Exactly which components can be added when will be explained later in this guide.

Now let's have a closer look at the bottom half of the Rocket design window. When you add a component to your rocket, it will be immediately displayed, as shown below:


Bottom half of the Rocket design window after adding a nose cone.


Notice the rulers around the borders. These give you an idea of the dimensions of your rocket.

As you can see, in addition to the appearance of your rocket, the Rocket design window also shows some other useful information as well. This includes the rocket's dimensions, mass, apogee, max. velocity, max. acceleration, stability, center of gravity (CG), and center of pressure (CP).

In the top left-hand corner of the previous image there are two buttons: Side view and Back view. These allow you to visualize the rocket from two different positions. Next to these buttons you can find the zoom-regulation commands and then one Stage i button for each Stage in your rocket. Selecting/deselecting each of these allows you to include or exclude each stage from the picture. On the left of the previous image, you can also see a scroll bar that allows you to rotate the rocket up to 360°.

Finally, notice the drop-down list in the top right-hand corner of the previous image. This allows you to choose which of your motor configurations to apply to the rocket you have designed (more on this later). The image below shows how the bottom half of the Rocket design window appears after the rocket design has been completed.


Bottom half of the Rocket design window after completing the rocket's design (taken from the A simple model rocket example design).


In this image, the rocket's body components and fin sets are represented with a continuous blue line; the rocket's inner components are represented with a continuous red line (the inner tube is also filled in with a grey background); and the mass objects are represented with either black or red dotted lines. It is also possible to customize the colour in which each part is represented, as will be shown later on. The image below shows how the top left-hand portion of the Rocket design window looks after the rocket design has been completed.


Top left-hand portion of the Rocket design window after completing the rocket's design (taken from the A simple model rocket example design).


As you can see, the rocket's components have a tree-like structure:
- the Rocket, called A simple model rocket, has only one stage: the Sustainer.
- the Sustainer contains two body components: a Nose cone and a Body tube.
- the Body tube contains a fin set (in particular a Trapezoidal fin set), a Launch lug, three inner components (an Inner Tube and two Centering rings), and three mass objects (a Shock cord, a Parachute, and a Wadding).
- the Inner tube contains an Engine block.
This tree-like structure will be discussed further later in this guide.

The buttons visible on the left in the previous image have pretty straightforward functions. By selecting one of the rocket's components you can change its position in the list of components (but not its position in the rocket) by using the Move up and Move down buttons. You can also edit its characteristics (e.g., dimensions, material, mass, color used to represent it within the rocket) by using the Edit button--or you can delete it from the rocket completely using the Delete button. Notice that none of these buttons is active in the above image, since no component has been selected.

You can also add an extra stage to your rocket by clicking the New stage button.

The Flight simulations window

Now we have a look at the Flight simulations window, which you can access by selecting the Flight simulations tab in the top left-hand corner of the OpenRocket main window. Before designing your rocket or running any flight simulation, the Flight simulations window looks like this:


The Flight simulations window before designing the rocket and running any simulation.


Notice that the bottom part of the window does not change when switching from the Rocket Design window to the Flight simulations window. Hence we only need to analyze the top part of the window. Here, most of the space is occupied by a currently blank space, where the technical details about your simulations will appear. Above this space there are five buttons, which allow you to program a new simulation (New simulation), edit a selected simulation (Edit simulation), for example by changing motor configuration or some atmospheric condition, run all the simulations you have programmed (Run simulations), remove the selected simulations (Remove simulations), or either plot or export some of the results of a selected simulation(Plot/export). (More on exporting simulation results in Rocket Analysis.)

The image below shows how the top part of the Rocket Design window looks after you have designed your rocket, programmed some simulations, and run them.


The top half of the Flight simulations window after having programmed and run some simulations (taken from the A simple model rocket example design).


Notice that five of the six simulations that have been run have a green tick on the left: this means that the simulation has been completed without any warnings. Conversely, if the simulation has generated some warning while being run, a red exclamation mark is shown (as for the third simulation in the image above). To find out more about the warning, mouse-over the simulation (without clicking) as shown in the image below.


More information about warnings in the Flight simulations window.


It is possible to change the position of the columns containing the various technical simulation data by simply dragging any column left or right, as shown below:


Moving columns in the Flight simulations window.


The main window's menus

We now analyze the four main window's menus, briefly explaining the function of each of the menus' options.


The File menu

The image below shows the options offered by the File menu, located in the top left-hand corner of OpenRocket's main window.


The File menu.


The function of each option in the File menu is pretty straightforward to understand:
- New allows you to start a new project, without closing the project that is currently open.
- Open... allows you to open a *.ork file that you have saved on your computer.
- Open example... allows you to open one of the example projects (more on these later).
- Save saves the changes you have made to a previously-saved project.
- Save as... allows you to save the project you are working on to a new *.ork file.
- Print/Export PDF opens a window like the one shown below (if you have already completed your rocket's design). From here you can select what to include in your print/PDF file; such as technical details of your rocket's components, templates of your rocket's fin sets, or even the design of your rocket. We suggest you try this option with one of the example projects to understand how each of these is represented when printing/exporting to PDF. More on printing and exporting to PDF in Rocket Analysis.
- Close closes the current project (after asking for confirmation if there are unsaved changes). This will also exit the application if there was only one project open.
- Quit exits the application, checking that you have saved all open projects.


The window that opens when Print/Export PDF is selected.


The Edit menu

The image below shows the options offered by the Edit menu.


The Edit menu.


These options are mostly the classic editing options: undo/redo some action (Undo/Redo) and cut/copy/paste/delete some element (Cut/Copy/Paste/Delete). We also have the following options:
- Scale... opens the window shown below. Here you can choose to scale your rocket's size by some percentage (you can select from a range of 25% to 400%), starting from a specified dimension that can either be the one the rocket currently has or one you specify. By checking or unchecking the Update explicit mass values box, you can also decide whether or not the rocket's mass should be updated when scaling its volume.


The Scale window.


- Preferences opens the Preferences window, as shown below. At the top of this window there are seven tabs which allow you to switch between various preference panes.

From the General pane, you can change the Interface Language to one of 13 translations. You'll need to restart OpenRocket to make the change take effect.

You can also load User-defined thrust curves, for motors not yet represented in OpenRocket's library.

From this pane, you can also check for an Update, or set your preferences for Update checking.


At this writing (December 2020), OpenRocket 15.03 tries to contact an out-of-date update source, and will not find future updates.
You should un-check this box, and periodically check OpenRocket.info for information on the latest version.


The General pane of the Preferences window.


The Design tab brings up a preference pane where you can tell OpenRocket where to Position new body components, the default Size of text, the Default Mach number for Center of Pressure estimation, and OpenRocket's behavior in the Design window.


The Design pane of the Preferences window.


The Simulation tab brings up a preference pane where you can control OpenRocket's behavior when working with simulations, and the options it uses for calculation in the Flight simulations window.


The Simulation pane of the Preferences window.


The Launch tab brings up a preference pane where you can fix OpenRocket's default Wind,Atmospheric conditions, Launch site, and Launch rod, as used in the Flight simulations window.


The Launch pane of the Preferences window.


The Units tab brings up a preference pane where you can set your preferred units for every parameter, and completely reset metric or imperial units as used in all OpenRocket inputs.


The Units pane of the Preferences window.


The picture below shows the Materials pane of the Preferences window. Here you can manage all of the available materials for the rocket component, by either editing the characteristics of the materials (i.e., their name and density) through the Edit button, or you can delete a material through the Delete button. You can also add new materials if you wish, by clicking the New button and setting the material's name, type and density.


The Materials pane of the Preferences window.


The Graphics tab brings up a preference pane where you can choose your preferred Graphics Editor (for example, Photoshop, MS-Paint, GIMP, Affinity Photo, etc.), and enable and set parameters for 3D Graphics in the Rocket design window.


The Graphics pane of the Preferences window.

The Tools menu

The image below shows the options offered by the Tools menu.


The Tools menu.


- The Component analysis option opens a window like the one shown below. Here, technical information for the rocket's external components and fin sets is displayed. Using the scroll bars in the top half of the window you can also change some parameters, such as wind direction, angle of attachment, mach number and roll rate. More on the component analysis window in Rocket Analysis.


The Component analysis window, opened from the A simple model rocket example design.


- The Rocket optimization option opens a window like the one shown below. From here you can optimize the performance of your rocket by selecting exactly which performance to optimize from the Optimized drop-down list. More on the rocket optimization window in Rocket Analysis.


The Optimization window, opened from the A simple model rocket example design.


- The Custom expressions option opens a window for adding and editing custom expressions, as shown below. In OpenRocket, you're not limited to using the built-in simulation variables in your plots and analysis. With the custom expression feature, you can write expressions to calculate other values of interest during the simulation. These can then be plotted or exported just like the built-in variables. More on the Custom Expression window in Custom Expressions.


The Custom Expressions window.


- OpenRocket's Photo Studio (seen below) lets you visualize your rocket in flight, over a variety of backgrounds, in a variety of attitudes and lighting. Effects let you customize its engine exhaust and the way it's depicted. You can adjust parameters with the dialog panel, and adjust the view with the mouse. The best way to learn about the Photo Studio is to start playing with it - it's pretty fun, and if you've given your rocket color and assigned realistic materials, it can look very good!


The Photo Studio window.


The Help menu

The image below shows the options offered by the Help menu.


The Help menu.


The functions of the options in the Help menu are as follow:

- Guided tours opens a window containing guided tours of some of OpenRocket's functionality. These tours are works in progress, and not exhaustive.


The Guided Tour panel, with a tour open.


- Bug report opens a bug report form that you can complete and email to the developers.


At this writing (December 2020), OpenRocket 15.03 tries to contact an out-of-date bug-submission page, and will not submit the bug. You may see an error dialog with an email address. Do not submit to this email - it's not monitored.
Instead, fill out the report with steps to trigger, description, etc., then copy the text from this window and file your bug report as an issue at OpenRocket's Issue List on Github.


The Bug Report panel


- Debug log opens the OpenRocket debug log. The debug log is mostly of interest to developers. The log window lets you filter to see all kinds of information about what OpenRocket is doing.


The Debug Log panel.


- License opens a window containing OpenRocket's license.
- About opens a window containing summary information about this project.