Latest revision as of 05:33, 1 February 2009

State Vector MFD[edit]

StateVectorMFD in action

Project home: StateVectorMFD at Orbit Hangar Author: Tim 'tblaxland' Blaxland Current version: Unknown Compatibility: Unknown

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. Kepler's Laws are then solved numerically to obtain the state vectors for the future time.

Operation[edit]

Loading the MFD[edit]

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 Configuration for the default settings that are used when the MFD is first loaded.

Changing T+[edit]

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[edit]

Press the REF button and select a new reference body.

Changing the Numerical Notation[edit]

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

Non-spherical Gravity Effects[edit]

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[edit]

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

Saving/Loading Scenarios[edit]

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[edit]

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[edit]

A configuration file (StateVector.cfg) in located in OrbiterDirectory\Config contains the settings for the MFD. The following items can be configured.

Colours[edit]

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[edit]

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[edit]

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

NOTATION - the default numerical notation.

Credits[edit]

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 FreeOrbitMFD by CJ Plooy were used for formatting the SI prefixes. See source code for details.

Copyright Notice[edit]

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/>.

@@ Line 1: / Line 1: @@
-= ZTC Tether-Sling Transportation System =
+= State Vector MFD =
-[[Image:Put some image here|right|thumb|300px|This is the image caption]]
+[[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|
-=[http://www.orbiter-forum.com/showthread.php?t=684 ZTC Tether-Sling at Orbiter-Forum]|
+=[http://www.orbithangar.com/some_location StateVectorMFD at Orbit Hangar]|
-=[http://www.orbiter-forum.com/member.php?u=86 Tim 'tblaxland' Blaxland]; [http://www.orbiter-forum.com/member.php?u=163 n0mad23]
+=[http://www.orbiter-forum.com/member.php?u=86 Tim 'tblaxland' Blaxland]
 }}
-The ZTC Tether-Sling Transportation System project uses momentum exchange tethers for nearly propellant free transfers of payloads between solar system bodies.
+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.
-It is expected that some propellant will be used by fine-tuning of transfer trajectories. Testing has shown that for lunar transfers corrections of less than 25m/s are typically required.
+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.
-== Principle ==
+== Operation ==
-The basic principle of a momentum exchange tether is to take momentum from the tether's orbit and transfer it into the payload's orbit. The momentum of an Earth based tether can then be recharged over time using solar powered electrodynamic propulsion to allow it to prepare to transfer further payloads.
+=== Loading the MFD ===
-== Research ==
+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.
-Both NASA and Tethers Unlimited have done significant research into momentum exchange tethers over the years. NASA's most recent Technology Assessment Group report confirmed that the principle behind the project is sound however significant but feasible advances in materials would be required for the project to become a reality.
+See [[#Configuration|Configuration]] for the default settings that are used when the MFD is first loaded.
-== Electro-Dynamic Propulsion ==
+=== Changing T+ ===
-Electro-dynamic propulsion uses the interaction between an electric current in the tether with the Earth's magnetic field. The thrust generated is a result of the Lorentz force on the electrons flowing in the tether. The Earth's ionosphere is used as a distributed return path for the tether current by way of anodes and cathodes on each end of the tether.
+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.
-A simplified model of the Earth's magnetic field will be used for the purpose of simulating the electro-dynamic propulsion.
+=== Changing the Reference Body ===
-== Tether Locations ==
+Press the REF button and select a new reference body.
-Tethers are planned for Earth (Ananke for lunar transfers and Ananke-MX for Mars transfers), Moon (Khronos) and Mars. Development work is progressing on Ananke at present.
+=== Changing the Numerical Notation ===
-=== Earth ===
+Press the NOT button to toggle the numerical notation between SI prefixes and exponential form.
-==== Ananke ====
+=== Non-spherical Gravity Effects ===
-Ananke is a 120km long tether for lunar transfers that orbits the Earth in an elliptical (eccentricity approx 0.45) equatorial orbit. An equatorial orbit is used so the regression of the ascending nodes does not over complicate the planning of lunar transfer trajectories. The periapsis of the tether is approximately 340km altitude and this places the catcher mechanism at 250km altitude for rendezvous with the payload.
+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.
-The tether rotates at approximately 1 degree per second. The resulting centripetal force on the payload is approximately 2.8gees.
+=== Changing Vessel Focus ===
-The design payload mass is 20-25 metric tonnes.
+When you change vessel focus, the MFD will remember the settings for each vessel and MFD position.
-One of the key challenges of the system is affecting a successful rendezvous between the payload and the catcher on the end of the tether. The rendezvous is more challenging than a typical space rendezvous due to the rapidly rotating tether forcing the capture window to be very small in both space and time. Specialised guidance tools for the rendezvous of the payload with the catcher mechanism are being developed.
+=== Saving/Loading Scenarios ===
-==== Ananke-MX ====
+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.
-Ananke-MX is a stretched version of Ananke for transferring payloads to Mars. MX is short for Mars eXpress.
+== Coordinate Systems ==
-=== Moon ===
+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.
-==== Khronos ====
+== Configuration ==
-Khronos is a rotovator type tether design to be able place and pickup payloads directly from the surface of the moon. Khronos will most likely be placed in a near polar orbit to maximise rendezvous opportunities with payloads coming in from Earth.
+A configuration file (StateVector.cfg) in located in OrbiterDirectory\Config contains the settings for the MFD. The following items can be configured.
-=== Mars ===
+=== Colours ===
-== Vessels ==
+NOW_COLOUR - colour for the current state vectors in the left-hand column.
-=== Tortoise Class Lunar Transfer Vessel ===
+T_PLUS_COLOUR - colour for the predicted state vectors in the right-hand column.
-The Tortoise Class Lunar Transfer Vessel is designed to be transferred from low Earth orbit to the lunar surface and back again. Capture and landing at the moon is by way of the Khronos tether. Capture at Earth is by way of aerobraking.
+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.
+== 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/>.

Difference between revisions of "User talk:Tblaxland"