The KRC Planetary ORBit (PORB) System Users Guide

Hugh H. Kieffer   File=-/krc/PUG.tex 2013aug25


.
This file is a guide to using PORB and is intended for the general user who wants to apply KRC to someplace other than Mars. A separate document -/krc/porb.tex describes the design of the PORB system; it should not be needed by the general user.

1  Introduction

This document describes Version 2.2.2 and later; it applies to KRC Version 2.2.1 and later; 2.2.2 includes additional source files small.tab and exoplan.tab. The intention is to allow a user to create a geometry matrix, 7 ridgely formatted lines of numbers, for inclusion in a KRC input file that would apply to any planet, satellite, asteroid, comet or exoplanet the user may wish.
Version 2 of KRC uses dates relative to J200.0 = 2000Jan01 noon UTC. To change from version 1 dates, subtract 11545.0

2  Outline

Check PORBCM.mat to see if it already contains the matrix you want. If so, simply copy that into the KRC input file. Otherwise proceed....
The executable of porbmn and the elements data files must be in the same directory. Copy them all into a directory of your choice.
Determine if the elements files to be used need any edits for a new object. If so, do the edits.
Run PORBMN to create a geometry matrix, see § ; cut-and-paste it into your KRC input file. Then run KRC.

3  Files input to PORB

Files formatted for the PORB system cover four catagories, each file has its own format:
      Planets and satellites: one file for orbits and another for spin-axes
      Minor (or small) bodies: orbits and pole direction for each object. Two versions.
      Comets: Orbit size specified by perihelion distance.
      ExoPlanets: Orbit specified by semi-major axis, period and eccentricity; each commonly known. Relative orientation of the body spin axis specified by obliquity and Ls at periapsis, neither is commonly known.
All files contain adequate information in the header to easily add additional objects.
Reading of these files uses Fortran list-directed format, which uses white-space (blank or tab) to separate items and will terminate with a slash '/'. Thus, names and numbers must not have any internal space or /. On each line, anything after the number of items in the READ list is ignored, so comments may be entered. The first body in each file has a "/" just after the items read on each line to indicate how many items are read. All but the planets files contain a skeleton form for adding objects.

3.1  Planets

standish.tab
 Standish06=[] Keplerian elements and rates of change for 9 planets in mean ecliptic and equinox of J2000 valid for 1800 to 2050. This file is valid for 1800 to 2050; it should not need any edits
spinaxis.tab
 Archinal11=[] Planets: Direction of the pole and rates of change in ICRF, which differs from J2000 equatorial system by less than 0.1 arcsecond. The planets and a few satellites are included; more satellites can be added.

3.2  Minor planets / asteroids

3.2.1  Web sources

There are several sources on the web. Some I found did not have unambiguous definition of the coordinate systems used; these were established through email exchanges
PDS Small Bodies Node
 http://pdssbn.astro.umd.edu/
Primary source for spin axis. Values are in ecliptic coordinates of equinox 1950
 PDS Small Bodies Node http://pdssbn.astro.umd.edu/ 
DATA ARCHIVES> Archived at SBN > by target > Asteroids(all) 
  > Photometry and Lightcurves > EAR-A-5-DDR-DERIVED-LIGHTCURVE-V13.0 
Either download the set or:  > Browse > data >   lc_spinaxis.tab (230 kb)
      The explanation of this file is in  lc_spinaxis.lbl
Then scroll through. They are in numerical order with multiple entries per asteroid; 
the first line is 'summary' of the period (hours) and amplitude of the light curve.
 4th and 5th columns to the right of column containing 'summary' contains 
the 'best guess' of the longitude and latitude of the spin axis for each observer.
You get to choose your favorite! 

Minor Planet Center
 http://www.minorplanetcenter.net/iau/info/OrbElsExplanation.html
ArgPeri, Node and Inclin are in heliocentric ecliptic J2000.0
      Must specify date for elements that is within requested ephemeris range
JPL Small-Body Database Browser
 http://ssd.jpl.nasa.gov/sbdb.cgi
Orbit elements are in heliocentric ecliptic J2000. Rotation period in hours.  No spin-axis data.
Ted Bowells database
 ftp://ftp.lowell.edu/pub/elgb/astorb.html
Enormous; more than 1/2 million objects. Frequent updates.
ArgPeri, Node and Inclin are in J2000.0, must be ecliptic. No spin-axis data.

3.2.2  PORB input files

There are two PORB-system ASCII files that differ slightly in format. Both contain one element per line and include spin-axis.
minor.tab
Generally older entries.
small.tab
Format designed to allow cut-and-paste from the JPL Small-Body Database Browser. Rotation period in hours. Must get spin axis from other sources.
All entries were created 2013Aug 22 or later.
Look up object with JPL Small-Body Database Browser  
   http://ssd.jpl.nasa.gov/sbdb.cgi
Copy the number and name line. There must be no blanks or / within the name
    Append to this line the epoch
copy elements lines  e through M
Click on: Physical Parameters and copy 3 columns for the rotation period. E.g.,
  rot_per 	7.210 	h
Append 3 lines for: [data not in the JPL database]
0. / Right Ascension of Pole, J2000 [deg]   
0. / Declination of Pole, J2000 [deg]
0. / Prime meridian at epoch [deg]
   Then replace the zeros if you have real values.

3.3  Comets

comet.tab
 Some comets: orbit and spin.
WARNING: Consistency of source orientation systems uncertain
      Specify perihelion and eccentricity.
Includes orbit and pole. Mostly compiled in 1980:1992
Current values are available at:
      http://www.minorplanetcenter.net/iau/Ephemerides/Comets/Soft00Cmt.txt
             Saved 2013 Jun 19 in MPC format as: -/krc/porb/MPcomets.tab
   Columns   F77            Use
    1 -   4  i4     Periodic comet number
    5        a1     Orbit type (generally `C', `P' or `D')
    6 -  12  a7     Provisional designation (in packed form)
   15 -  18  i4     Year of perihelion passage
   20 -  21  i2     Month of perihelion passage
   23 -  29  f7.4   Day of perihelion passage (TT)
   31 -  39  f9.6   Perihelion distance (AU)
   42 -  49  f8.6   Orbital eccentricity
   52 -  59  f8.4   Argument of perihelion, J2000.0 (degrees)
   62 -  69  f8.4   Longitude of the ascending node, J2000.0
                      (degrees)
   72 -  79  f8.4   Inclination in degrees, J2000.0 (degrees)
   82 -  85  i4     Year of epoch for perturbed solutions
   86 -  87  i2     Month of epoch for perturbed solutions
   88 -  89  i2     Day of epoch for perturbed solutions
   92 -  95  f4.1   Absolute magnitude
   97 - 100  f5.1   Slope parameter
  103 -      a      Name

J2000.0 was confirmed to be heliocentric ecliptic.

3.4  exoPlanets

exoplan.tab
 Major differences from solar system objects are:
      Need both semi-major axis and orbital period.
      Direction of spin axis is specified by planet obliquity and LS of periapses
                    Both these are rarely known, variations are illustrative.
porbmn run will print an estimated factor for the "solar constant" . This value times the normal SOLCON in KRC input should replace SOLCON.
The length of the synodic day (assuming prograde motion) is also printed; it should be used as PERIOD in the KRC input.
 
http://en.wikipedia.org/wiki/List_of_exoplanetary_host_stars 
12 extracts at the bottom of the file.

4  PORBEL: get elements

Will read elements and spin-vector data for one object from a (or two) data file, move several values into common and return others.
For planets, reads first the orbital elements and adjusts to the requested epoch.
Standish tables list the following with respect to the J2000 ecliptic system, in order, at J2000.0 and their derivative in time:
      1   a: semi-major axis [au, au/century]
      2   e: eccentricity [radians, radians/century]
      3   I : inclination [degrees, degrees/century]
      4   L : mean longitude [degrees, degrees/century]
             L=Ω+ω+ M is a compound angle measured in two planes:
                    From VE to node in plane of reference
                    then to periapsis and on to mean anomaly in orbital plane
      5   ϖ : longitude of perihelion [degrees, degrees/century] (ϖ = Ω+ ω )
             ϖ is a compound angle measured in two planes:
                    ω, the argument of periapsis, measured in the plane of orbit
      6   Ω: longitude of the ascending node [degrees, degrees/century]
             measured in the reference plane.

A  Cookbook

        A Cookbook to running the  KRC Plantary ORBit system: PORB

cd into the directory containing the probmn executable and the *.tab files

> porbmn    To start the main program

Will be asked where to send output; normally enter:  T <CR>

Will be asked which of 5 options:
 Enter: 1

Will be asked which source data.
 Normally enter : 1 (planets) or 4 for asteroids or 6 for exoplanets

Will be asked which item in the file. Should have looked at the chosen elements
file to know this
 Enter the proper number.   E.g., 4 is Mars

Only if doing planets, will be asked for the epoch in centuries after 2000. 
E.g., for 2012,  enter 0.12
 
At this point, the calculations are done and a brief report will be appear
If and only if doing Planets, will be asked for which pole position
   a  /  will use the planet pole, else, enter a satellite name
      If that is not in the spinaxis table, will use the planets pole.

If doing exoPlanets, then note the solar power factor and the synodic day.

Will be asked which of 5 options:
  4  will print the values in vector format and come back to this same prompt
  2  Will begin the required output process: Then
   Will be asked to read or save.   Enter: 2
   Will be asked output format.   Enter: 2
   Will be asked for an output file name: 
     A single "/" with no leading spaces will use the default "PORBCM.mat" and
       append the latest set to whatever is already in that file.
     Else enter a new file name and <CR>

Will be asked which of same 5 options:
 Enter: 0 to quit  OR to another object.

You then copy the 7 lines in the output file into a KRC input file.




File translated from TEX by TTH, version 4.03.
On 3 Mar 2014, 10:53.