= pole =

== Description ==

The program pole solves pole right ascension, declination, and rotation rate for a body in principal axis rotation. The rotation rate is calculated in degrees/day while right ascension and declination are in degrees.

For pole to run, POLE.TXT and [[LMRKLIST.TXT]] are required in the working directory. [[LMRKLIST.TXT]] is just a file containing a list of landmarks and POLE.TXT is a single row file that contains the predicted pole RA (deg), DEC (deg), PM (deg), and OMEGA (deg/day). These values are given in the .tpc kernel file for the object.

== POLE.TXT Example ==
{{{
       86         -65      89.00000000    2010.48945
}}}

== Input-Files ==
 * POLE.TXT - simple text file containing nominal pole RA (deg), DEC (deg), PM (deg), OMEGA (deg/day)
 * [[LMRKLIST.TXT]] - list of landmarks

== Input stdin ==
 * A time in UTC (make sure it is within the span supported by the kernels)
{{{
2018 NOV 16 13:09:54.824
}}}

 * Determine whether you want the rotation rate fixed ( y for yes, n for no)

 * 0 if you want to iterate, 1 if you want to keep result (updates POLE.TXT), 2 if you want previous result (nominal if on 1st iteration)

== Output ==
 * {{{
    86.60062   -65.00002    90.42707  2009.99979311
     0.05176     0.02171                 0.00000001
}}}

 * First row is all the new pole parameters for POLE.TXT while the second row is the change.