= 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-Files ==
 * none