Lunar Numbat Orbit
==================

Introduction
------------

Orbit (or more precisely, Lunar Numbat Orbit) is a series of scripts
for producing orbital data (telemetry) for an object moving in the
Earth-Moon system.

It is a work-in-progress.

  Lunar Numbat Website: http://lunarnumbat.org
  Lunar Numbet Orbit:
    http://www.mawsonlakes.org/mediawiki/index.php/Lunar_Numbat_Orbit  


Getting Started (for the REALLY impatient)
---------------
Create a plot of the trajectory to the moon (with thanks to Roy Duncan).

  cd scripts
  ./gnuplot-orbit.sh
  evince orbit.ps


Getting Started (for the simply impatient)
---------------
Start running the orbital simulation in the background and capture the
data.

  orbit.pl > orbit.log &

Display the 'telemetry' stream

  tail -f orbit.log | orbit-display-stream.pl

Display the 'telemetry' in a full screen terminal mode (requires
libcurses-perl)

  tail -f orbit.log | orbit-display-curses.pl


Programs
--------

orbit.pl 

  This is the main script which simulates the motion of an object
  travelling in orbit in the Earth/Moon system.

  The 'stdout' of this program contains the 'telemetry' for the object
  in the form of:

  ----
  rtc:1234529684
  t:1
  x:6471
  y:22.372
  vx:0
  vy:11.186
            <---- blank line
  rtc:1234529685
  t:2
  x:6471
  y:33.558
  vx:0
  vy:11.186
  ----

orbit-display-stream.pl

  This script reads in the 'telemetry' data on stdin and displays it
  along a single line, in the form:

  ----
  t:1            x:6471.000     y:22.372       vx:0.000        vy:11.186       
  t:2            x:6471.000     y:33.558       vx:0.000        vy:11.186 
  ----

  This is suitable for monitoring the changes in raw data.

orbit-display-curses.pl

  Requires: libcurses-perl

  This script reads in the 'telemetry' data on stdin and displays it
  in a full screen curses display.


See the contrib directory for more orbit scripts and examples.