Tutorials

File Menu

Objects Menu

View Menu

Preferences

Time

Autopilot

Extra



File Menu

New
Choosing New from the File menu creates a new simulation with one object. The object has the name object. It has 1 solar mass. Using the Object > Edit Object menu, you may edit the object's name, diameter, mass and color. Using the Objects > Create Objects menu you may add new objects to your simulations. Choosing New sets Gravity Simulator's date and time to 00/00/00 00:00:00. You may use Set Time... from the Time menu to set the simulation time to anything you want.

Open
Choosing Open from the File menu allows you to open an existing Gravity Simulator file stored on your computer. You may also open files by clicking on one of the most recently accesss files at the bottom of the File menu.

Save
Choosing Save from the File menu causes your current file to be saved under its current name.

Save As...
Choosing Save As... from the File menu opens a dialog box where you can browse to a specific folder of your choice, and give your simulation a name. Pressing OK saves your file with a *.gsim extension.

Auto Save...

Choosing Auto Save from the File opens the Auto Save dialog box. You can choose to have Gravity Simulator automatically save your simulation at automatic intervals. It will save your files in the same directory as the simulation you are running. The files will be given the same name as the simulation you are running plus the simulation date appended to the end.

To use Auto Save, you must check the box that says Auto Save Enabled and specify how often you would like your simulation saved as well as the maximum number of times Auto Save will create file.

You may also choose to save a Data File by checking the box that says Create Data File You must have Auto Save Enabled checked for this feature to work. A data file will be created with the same name as your simulation plus an extention of .txt. Data will be appended to this file each time Gravity Simulator performs an Auto Save. The data file contains state vectors and orbital elements for every object in your Gravity Simulator simulation. You may open this file in a spreadsheet program to create graphs. For example, the following shows the planet Mercury's inclination over a 10,000 year period. It was created by using Auto Save's Create Data File feature, and choosing every 10 years. The maximum number of saves is set to 1000. It is recommended that you create a new directory and save your initial simulation in that directory. This way, all auto saved simulations will be grouped together with the original simulation in one directory.

You can open data.txt in a spreadsheet program such as Excel. Choose a comma delimited data type. Exit
Choosing Exit from the File has the same effect as pressing the X button in the top right corner of the window. Gravity Simulator saves your current simulation under the name resume.gsim in the same directory as the gravitysimulator.exe file. The next time you start Gravity Simulator, it will open this file.

Most Recently Accessed Simulations
Gravity Simulator stores your 4 most recently opened or saved simulations at the bottom of the File menu. Clicking on one causes the simulation to open.




Objects Menu

Edit Object...
The Edit Object dialog box allows you to change the parameters of an existing object.

Under Object choose the object you would like to edit.
The object's current properties are displayed.

The Reference Object is the object that the selected object's distances and velocities are relative to.

Color allows you to change the color of the selected object.

Mass is the mass of the selected object. You may specify your units as Earth masses, Sun masses, Jupiter masses, or kilograms.

Size is the selected objects Diameter. You may specify your units to be Earth diameters, Jupiter Diameters, Sun diameters, or kilometers.

Location is the distance between the selected object and its reference object. It is divided into its X, y, and Z components. You may choose units of Meters, Kilometers, Astronomical Units, or Light Years.

Velocity is the velocity between the selected object and its reference object. It is divided into its X, Y, and Z components as defined by the ecliptic plane. You may choose units of Meters / Second, or Kilometers / Second. Pressing Apply saves any changes you make.

Pressing OK saves any changes you make and closes the Edit Object window.

Pressing Cancel closes the Edit Object window without saving your changes.

Pressing Delete Object deletes the selected object.


Create Objects...
The Create Objects dialog box allows you to create objects.

You may create objects one at a time, or you may create multiple objects. The speed of your computer's processor will limit how many objects you can simulate at once and still have your simulation run at an acceptable rate.

To create a single object, leave Number of Objects set to 1.

Choose a Reference Object. The default is your simulation's current Focus Object

Choose a size (Diameter) in kilometers for your object. The +/- box will cause the program to choose a random value for you in the specified range. For example, if you enter 1000 kilometers +/- 50%, the program will choose a random value for you in the range of 500 - 1500 kilometers. This is useful when creating multiple objects.

Choose a Semi-major axis. This is your object's average distance from its reference object. You may choose units of Meters, Kilometers, Astronomical Units, or Light Years. The +/- box will cause the program to choose a random value for you in the specified range. For example, if you enter 10 Astronomical Units +/- 50%, the program will choose a random value for you in the range of 5 - 15 Astronomical Units. This is useful when creating multiple objects.

Choose an Eccentricity. This describes the shape of your orbit. Values should be in the range of 0-1. An orbit with an eccentricity of 0 is perfectly round. An object with an eccentricity of 0.9999 is highly elliptical. The +/- box will cause the program to choose a random value for you in the specified range. For example, if you enter .5 +/- 50%, the program will choose a random value for you in the range of 0.25 - 0.75. This is useful when creating multiple objects.

Choose an Inclination. This determines the plane of your orbit with respect to the ecliptic. Values should be between 0-360 degrees or 0 to 2pi radians. An orbit whose inclination is 0 orbits in the ecliptic. An object with an inclination of 90 degrees is in a polar orbit. An object with an inclination of 180 degrees orbits in the ecliptic, but in a retrograde (backwards) direction. The +/- box will cause the program to choose a random value for you in the specified range. For example, if you enter 10 degrees +/- 50%, the program will choose a random value for you in the range of 5 - 15 degrees. This is useful when creating multiple objects.

Choose a Mass. You may specify units of Sun masses, Jupiter Masses, Earth Masses, or Kilograms. The +/- box will cause the program to choose a random value for you in the specified range. For example, if you enter 1 Earth mass +/- 50%, the program will choose a random value for you in the range of 0.5 - 1.5 Earth masses. This is useful when creating multiple objects.

Choose a Longitude of ascending node. Values should be in the range of 0 - 360 degrees or 0-2pi radians. If you entered a value other than 0 for inclination, this determines the point where your orbit crosses the ecliptic from South to North. The +/- box will cause the program to choose a random value for you in the specified range. For example, if you enter 10 degrees +/- 50%, the program will choose a random value for you in the range of 5 - 15 degrees. This is useful when creating multiple objects.

Choose an Argument of perifocus. Values should be in the range of 0 - 360 degrees or 0 - 2pi radians. If you entered a value other than 0 for eccentricity, this determines where in your orbit your object will make its closest pass to its reference object. The +/- box will cause the program to choose a random value for you in the specified range. For example, if you enter 10 degrees +/- 50%, the program will choose a random value for you in the range of 5 - 15 degrees. This is useful when creating multiple objects.

Choose a Mean anomoly. This determines where in the orbit the object will be when it is created. Values should be in the range of 0 - 360 degrees or 0 - 2pi radians. The +/- box will cause the program to choose a random value for you in the specified range. For example, if you enter 10 degrees +/- 50%, the program will choose a random value for you in the range of 5 - 15 degrees. This is useful when creating multiple objects.

Give your object a Name. If you choose a Number of Objects greater than 1, then the program will add a number to the end of the name you specify.

Specify whether you used Degrees or Radians.

Press Create to create the object or objects.

Press Cancel to close the Create Objects box without creating any objects.



View Menu

Zoom in, Zoom out

This causes your view to be zoomed in or out. The Screen Scale window tells you your current screen width.

Add Distance and Velocity Box

This opens a new Distance and velocity box.

By moving the mouse over the Distance and Velocity Box, dropdown lists appear that allow you to specify the objects whose distance and velocities are given. Tangental and Radial velocities are also given.

Add Orbital Elements Box

This opens a new Orbital Elements Box.

Specify the object whose elements you want. Specify a reference object. The box should choose the objects reference object by default. This box displays an objects orbital elements as well as its state vectors.

Add Thrust Box

This opens a new Thrust Box to allow you alter any object's velocity.

The button on the top of the window contains the name of the selected object. Pressing this button allows you to specify a different object, as well as a reference object. The object's current reference object is the default.

There are four different directions you may apply thrust, Prograde, Retrograde, Towards, and Away. You may also specify a custom direction by pressing the "Edit..." button.

To thrust an object, press the desired button. For example, if you want to thrust the Mercury Messenger spacecraft into a higher orbit, choose one of the Prograde buttons. These will cause a change in velocity in the direction of travel with respect to the selected reference object of either 1 m/s, 10 m/s, 100 m/s or 1 km/s.

A retrograde boost applies the thrust in a direction opposite to the direction of travel with respect to the selected reference object.

A towards boost causes the selected object to accelerate towards the selected reference object.

An away boost causes the selected object to accelerate away from the selected reference object.

Press the "Edit..." button to specify an altitude and azimuth in the ecliptic plane from the vernal equinox. Then use the 1, 10, 100, 1K buttons under "Custom Boost" to apply a boost in your custom direction.

Dashboard Elements

Dashboard Elements are a group of user controls that you may display or hide. You can move them to any part of the screen you like. By choosing View > Dashboard Elements > Show All > Align Vertically or Align Horizontally, you can display them all at once. You may also press F8 on your keyboard to display them in a vertical pattern, or F9 to display them in a horizontal pattern. Choosing "Hide All" hides them.