man/ephemd

From FITSH
Revision as of 09:18, 18 October 2016 by Apal (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Synopsis

ephemd <perturbers> <objects> <observers> [options] [command]

Description

This is a simple, small and lightweight command-line driven ephemerides service for retrieving astrometrical information of small Solar System objects (SSOs).

Options:

General options:

-h, --help
Gives general summary about the command line options.
--long-help, --help-long
Gives a detailed list of command line options.
--wiki-help, --help-wiki, --mediawiki-help, --help-mediawiki
Gives a detailed list of command line options in Mediawiki format.
--version
Gives some version information about the program.
--verbose
Be more verbose during startup of ephemd.
--quiet
Be more quiet during startup of ephemd.
-i, --stdio
Instead of running in server mode, ephemd reads commands from and writes output to standard input and output, respectively.
-p, --port <port>
TCP/IP port in which ephemd listens for incoming connections. Default port is 9137.
-c, --command <command> ...
Executes the command <command> ... immediately after launching and loading ephemd data. Note that the <command> ... lasts up to the end of the command line, so one has to ensure that this option is the last which is passed to ephemd.

Parameters and regarding to orbital mechanics:

-f, --planet-file, --planet-files <ephem_file> [<...>]
List of input ephemerides of planets that acts as a perturber in the Solar System. The list of files lasts up to the next command line argument (starting with a dash or double dash) or up to the end of the command line. Hence, one may safely use wildcard patterns in order to specify multiple perturbes simultaneously.
-b, --observer-file, --observer-files <ephem_file> [<...>]
List of input ephemerides of observers. The list of files lasts up to the next command line argument (starting with a dash or double dash) or up to the end of the command line. Hence, one may safely use wildcard patterns in order to specify multiple observers simultaneously.
-j, --object-file <file>
Pre-formatted orbital elements of small Solar System objects. See also README and the script ./scripts/prep-2-dat2in.sh in the ephemd source package for more details about the format.

Available commands:

quit, exit, close
Terminates the connection (server/client mode) or the program itself (in stdio mode).
status
A brief summary about `ephemd` status.
list observers
Lists the available observers.
set observer <name>
Sets the observer to <name>.
get observer
Prints the name of the currently set observer.
ephem <name> <time>
Generates ephemerides for the object with <name> for the instance or interval defined by <time>. The <name> is taken from the input object file and by default (see `make prepare`) these are either the MPC designation numbers or the MPC temporal names. Official MPC names are not supported now. For instance, use `ephem 1234 ...` instead of `ephem Elyna ...`. The <time> is either a Julian Day instance or can have the format of <JD_start>:<step>:<JD_end> to generate a series of ephemerides. <JD_start>:<JD_end> is equivalent to <JD_start>:1.000:<JD_end>.
Personal tools