State vectors
Use this page to set the position and velocity of the vessel relative to a celestial body.
First, select the desired celestial body (sun, planet or moon) in the Orbit reference box. All position and velocity parameters will be interpreted relatively to the centre of this body.
Next, you should select the reference coordinate frame in which the state vectors are expressed. The Frame box provides three choices:
- ecliptic: The ecliptic frame is defined by the plane of Earth's orbit around the sun. The x-axis is defined by the vernal equinox, the y-axis is the ecliptic north pole, and the z-axis is in the plane of the ecliptic, perpendicular to x and y, and oriented so as to result in a left-handed coordinate system.
- ref. equator (fixed): The coordinate system is defined by the equatorial plane of the reference body, with x and z in the equatorial plane, and y pointing to the north pole. The frame is non-rotating, i.e. fixed with respect to the celestial sphere.
- ref. equator (rotating): As in the fixed case, this system is defined by the equator of the reference body, but it rotates with the planet, and the x-axis points to longitude 0°.
Finally, select the coordinates to use. You can select between cartesian coordinates (x,y,z and dx/dt,dy/dt,dz/dt), and spherical polar coordinates (r,φ,θ and dr/dt,dφ/dt,dθ/dt). Generally, polar coordinates will be more intuitive to use.
You are now ready to edit your position and velocity. Since a vessel's state vectors are constantly changing during the simulation, it is probably best to pause now by pressing the P button. Then press Refresh to update the dialog data. Now you can enter new data for position and velocity, and press Apply to pass them to the simulation. Or use the spin controls next to the input boxes for direct manipulation.
Usage tips
Editing the state vectors is probably most useful when your vessel is close to a planetary surface, for example during atmospheric flight. At orbital altitudes, it is easier to control the vessel state via its orbital elements. Defining a stable orbit via position and velocity data is much more difficult.
When editing a vessel close to the surface, the rotating equatorial frame is a good choice. In conjunction with polar coordinates, the position values translate directly to planetary longitude, latitude and radius data, and the velocity data are equivalent to ground speed in longitudinal, latitudinal and radial direction.
By editing its state vectors, a vessel is set to flight mode. Make sure the parameters you enter define a position above the surface. If you want to place a vessel on the ground, use the Surface location page instead.