Editing User talk:Tblaxland

= State Vector MFD =

[[Image:Lgplv3-147x51.png|right|thumb|[http://www.gnu.org/licenses/lgpl-3.0-standalone.html Licensed under LGPL v3]]]
[[Image:StateVectorMFD.png|right|thumb|300px|StateVectorMFD in action]]

{{Addon|
1=[http://www.orbithangar.com/some_location StateVectorMFD at Orbit Hangar]|
2=[http://www.orbiter-forum.com/member.php?u=86 Tim 'tblaxland' Blaxland]
}}

StateVectorMFD is basic MFD for displaying a vessel's state vectors at the current time and at a some other time relative to the present time.

The MFD uses the [[Kepler Orbital Simulation Toolkit]] (KOST) to convert the current state vectors to orbital elements and then perform time propagation along those elements. [http://en.wikipedia.org/wiki/Kepler%27s_laws_of_planetary_motion Kepler's Laws] are then solved numerically to obtain the state vectors for the future time.

== Operation ==

=== Loading the MFD ===

Load the MFD by pressing the MFD "SEL" button and select "State Vector". The MFD will show the current state vectors in a column on the left hand side and the state vectors for a future time in a column on the right hand side.

See below for the default settings that are used when the MFD is first loaded.

=== Changing T+ ===

To change the time used for predicting the future state vectors, press the T+ button and enter a time (in seconds) in the dialog box. This dialog box also takes SI prefixes in the input, eg, 5100 seconds could be entered as 5.1k. T+ may also be negative. Default value: 0 seconds.

=== Changing the Reference Body ===

Press the REF button and select a new reference body. Default value: current major gravitational influence.

=== Changing the Numerical Notation ===

Press the NOT button to toggle the numerical notation between SI prefixes and exponential form. Default value: SI prefixes.

=== Non-spherical Gravity Effects ===

Estimated corrections to the future state vectors are added automatically if non-spherical gravity sources are enabled and they are presently acting on the vessel.

=== Changing Vessel Focus ===

When you change vessel focus, the MFD will remember the settings for each vessel and MFD position.

=== Saving/Loading Scenarios ===

This MFD saves its state to the scenario file so all settings will be restored when restarting the scenario. Also included is saving/restoring the settings for any other vessels that have been used with StateVectorMFD in the scenario even though those vessels do not have the focus at the time of scenario being saved.

== Coordinate Systems ==

The state vectors are displayed in the Orbiter left-hand ecliptic coordinate system (+X - sun direction at vernal equinox, +Y - ecliptic north). Support for other systems may be added in the future.

== Configuration ==

A configuration file (StateVector.cfg) in located in OrbiterDirectory\Config contains the settings for the MFD.

=== Colours ===

NOW_COLOUR - colour for the current state vectors in the left-hand column.

T_PLUS_COLOUR - colour for the predicted state vectors in the right-hand column.

See the config file for valid colour values.

=== Numerical Solver ===

MAX_RELATIVE_ERROR - the maximum relative error in the mean anomaly when solving Kepler's equation. Smaller number = more accurate.

MAX_ITERATIONS - the maximum number of iterations used when solving Kepler's equation. Larger number = more accurate.

=== Defaults ===

T_PLUS_TIME - the default T+ value (in seconds).

NOTATION - the default numerical notation.

== Known Issues ==

Predicted state vectors in the right-hand column may become inaccurate after periods of time acceleration with non-spherical gravity enabled. Workaround: reset T+ to 0s and wait until the numbers in the right-hand column equal those in the left-hand column.

== Credits ==

This MFD uses the [[Kepler Orbital Simulation Toolkit]] (KOST) by CJ Plooy and Tim Blaxland. A copy of KOST is included with the source code.

It also use the built-in Orbiter pop-up menus for selecting the reference body. Thanks to CJ Plooy for his work in making this functionality available.

Two functions from [http://www.orbithangar.com/searchid.php?ID=3609 FreeOrbitMFD by CJ Plooy] were used for formatting the SI prefixes. See source code for details.

== Copyright Notice ==

Copyright 2009 by Tim Blaxland (tblaxland@gmail.com)

StateVectorMFD is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

StateVectorMFD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with StateVectorMFD. If not, see <http://www.gnu.org/licenses/>.