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.