NAME

dist - calculates the angular distance of stars

SYNOPSIS

dist cstring [arcseconds] [altaz] [iso=] [thresh=] [ignore] [file=] [append]
dist [dra=] [ddec=]

DESCRIPTION

dist takes coordinate strings from the standard input and computes the angular distance to the coordinate string on the command line.
total=29.50 dx=29.34 ddec=3.00 arcseconds:
Where dx is the arc distance in RA.

There is a second mode which goes into effect when dra= or ddec= are on the command line. When this occurs, the offsets in decimal degrees are added the the coordinates that arrive in stdin and are printed out.

OPTIONS

append - appends the total line to input line.

arcseconds - changes the output distances in arc-seconds rather than decimal degrees.

altaz - prints out difference in altitude and azimuth rather than ra and dec. Note when this mode is used, the site information must be available and the epoch matters.

iso= sets the epoch of the observation. This is only needed when the altaz option is specified.

thresh= sets a threshold value (in degrees or arcseconds depending on command line) and if the total distance exceeds this value, the program will exit with a non-zero code.

ignore - ignores if there is a difference between the modes of the two types of coordinate. It also does NOT precess.

file= specifies a file to read the other coordinates.


Program index