Difference between revisions of "Sextant MFD"

From OrbiterWiki
Jump to navigation Jump to search
(Added category.)
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[Image:Lgplv3-147x51.png|right|thumb|[http://www.gnu.org/licenses/lgpl-3.0-standalone.html Licensed under LGPL v3]]]
 
[[Image:Lgplv3-147x51.png|right|thumb|[http://www.gnu.org/licenses/lgpl-3.0-standalone.html Licensed under LGPL v3]]]
[[Image:SextantMFD_20090804.png|right|thumb|300px|Sextant MFD in action]]
+
[[Image:SextantMFD_20090819.png|right|thumb|300px|Sextant MFD in action]]
  
 
{{Addon|
 
{{Addon|
Line 7: Line 7:
 
}}
 
}}
  
Sextant MFD is a yet-to-be-released MFD that simulates a sextant and rendezvous radar for use in semi-optical orbital rendezvous. For more information on the technique refer to this thread on the Orbiter-Forum: http://www.orbiter-forum.com/showthread.php?t=9065.
+
Sextant MFD is an [[MFD]] that simulates a sextant and rendezvous radar for use in semi-optical orbital rendezvous. The intent is to simulate the environment presented to the pilots of Gemini-era spacecraft in the event of a flight computer failure. For more information on the technique refer to the [http://www.orbiter-forum.com/showthread.php?t=9065 thread on the Orbiter-Forum] and [http://www.orbithangar.com/searchid.php?ID=4127 Sam Enkidu's tutorial on Orbit-Hangar].
 +
 
 +
A beta version of the MFD is [http://bitbucket.org/tblaxland/sextant-mfd/downloads/ available on BitBucket].
  
 
== Operation ==
 
== Operation ==
Line 21: Line 23:
 
==== Reference ====
 
==== Reference ====
  
The upper section of the display shows reference information including the MFD title, the current reference body (used for determining the local horizon) and the current target.
+
The upper section of the display shows reference information including the MFD title, the current reference body (used for determining the local horizon), the current target and a stopwatch.
  
 
==== Sextant ====
 
==== Sextant ====
Line 57: Line 59:
  
 
Switch between metric and imperial units.
 
Switch between metric and imperial units.
 +
 +
==== S/S ====
 +
 +
Start/stop the stopwatch.
 +
 +
==== RST ====
 +
 +
Stop and reset the stopwatch.
  
 
==== MRK ====
 
==== MRK ====
Line 72: Line 82:
 
== Configuration ==
 
== Configuration ==
  
A configuration file (SextantMFD.cfg) in located in OrbiterDirectory\Config\SextantMFD and contains the settings for the MFD. The following items can be configured.
+
The configuration files are located in OrbiterDirectory\Config\SextantMFD and contain the settings for the MFD. The configuration file name shall be in the format "SextantMFD.''vesselClassName''.cfg", where ''vesselClassName'' is the class name of the vessels that will use that configuration file. The special name "SextantMFD.''default''.cfg" sets the default configuration for the MFD for the case where no class specific configuration file is found.
 +
 
 +
The following items can be configured.
  
 
=== Colours ===
 
=== Colours ===
Line 87: Line 99:
  
 
UNITS - the default units. See the config file for valid values.
 
UNITS - the default units. See the config file for valid values.
 +
 +
=== Limits ===
 +
 +
SEXTANT_MAX_ANGLE - the maximum angular measurement range of the sextant, in degrees.
 +
 +
RADAR_MAX_RANGE - the maximum range of the radar, in metres.
 +
 +
RADAR_MAX_ANGLE - the maximum angular range of the radar, in degrees.
  
 
== Credits ==
 
== Credits ==
  
This MFD uses the built-in Orbiter pop-up menus for selecting the reference body. Thanks to CJ Plooy for his work in making this functionality available.
+
This MFD uses 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.
 
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.
Line 102: Line 122:
 
Sextant MFD 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.
 
Sextant MFD 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/>.
+
You should have received a copy of the GNU Lesser General Public License along with Sextant MFD. If not, see <http://www.gnu.org/licenses/>.
 +
 
 +
[[Category: Articles]]
 +
[[Category:MFD]]
 +
[[Category: MFD add-ons]]

Latest revision as of 11:15, 1 October 2023

Sextant MFD in action

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


Sextant MFD is an MFD that simulates a sextant and rendezvous radar for use in semi-optical orbital rendezvous. The intent is to simulate the environment presented to the pilots of Gemini-era spacecraft in the event of a flight computer failure. For more information on the technique refer to the thread on the Orbiter-Forum and Sam Enkidu's tutorial on Orbit-Hangar.

A beta version of the MFD is available on BitBucket.

Operation[edit]

Loading[edit]

Load the MFD by pressing the MFD "SEL" button and selecting "Sextant".

Information Displayed[edit]

The display is broken into three distinct parts.

Reference[edit]

The upper section of the display shows reference information including the MFD title, the current reference body (used for determining the local horizon), the current target and a stopwatch.

Sextant[edit]

The middle section displays information about the target based on measurements from a virtual sextant.

  • Timer - the time starts when the the MRK button is pressed and stops when it is pressed again. The units are minutes and seconds.
  • Local hor. angle - the angle between the target and the local horizontal plane.
  • In-plane angle - the amount of angular motion of the target in the orbital plane, relative to an inertial frame, since the timer was started.
  • Off-plane angle - the amount of angular motion of the target perpendicular to the orbital plane, relative to an inertial frame, since the timer was started.

The units for all angles are decimal degrees.

Rendezvous Radar[edit]

The lower section displays information about the target based on measurements from a virtual rendezvous radar.

  • Range - Range to the target. Units are metres (m) or feet (').
  • Range Rate - Rate of change of the range. A negative value indicates that the range is decreasing. Units are metres/second or feet/second (fps).
  • Pitch and Yaw - Position of target relative to the local vessel frame.

Buttons[edit]

The function of each of the buttons is described below.

REF[edit]

Changes the reference body used for determing the local vertical. The reference body defaults to the major gravitational influence on the vessel when the scenario is started. Pressing this button opens a dialog box allowing the reference body to be selected.

TGT[edit]

Changes the target vessel. Pressing this button opens a dialog box allowing the target vessel's name to be entered.

UNT[edit]

Switch between metric and imperial units.

S/S[edit]

Start/stop the stopwatch.

RST[edit]

Stop and reset the stopwatch.

MRK[edit]

Take a mark on the target, reset the timer to zero and start it counting. Press again to take another mark and halt the timer.

Changing Vessel Focus[edit]

When you change vessel focus, the MFD will remember the settings for each vessel and MFD position. This includes sextant mark information, so that a mark may be started, focus switched, and the mark completed after switching back.

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 Sextant MFD in the scenario even though those vessels do not have the focus at the time of scenario being saved.

Configuration[edit]

The configuration files are located in OrbiterDirectory\Config\SextantMFD and contain the settings for the MFD. The configuration file name shall be in the format "SextantMFD.vesselClassName.cfg", where vesselClassName is the class name of the vessels that will use that configuration file. The special name "SextantMFD.default.cfg" sets the default configuration for the MFD for the case where no class specific configuration file is found.

The following items can be configured.

Colours[edit]

TEXT_COLOUR - colour for general text items.

POS_COLOUR - colour for positive measurement values.

NEG_COLOUR - colour for negative measurement values.

See the config file for valid colour values.

Defaults[edit]

UNITS - the default units. See the config file for valid values.

Limits[edit]

SEXTANT_MAX_ANGLE - the maximum angular measurement range of the sextant, in degrees.

RADAR_MAX_RANGE - the maximum range of the radar, in metres.

RADAR_MAX_ANGLE - the maximum angular range of the radar, in degrees.

Credits[edit]

This MFD uses 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]

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

Sextant MFD 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.

Sextant MFD 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 Sextant MFD. If not, see <http://www.gnu.org/licenses/>.