NAME

airmass - Computing airmass coefficient

SYNOPSIS

airmass [options] source_file ... - batch mode
airmass [options] - terminal mode

DESCRIPTION

The Airmass program computes value of the airmass coefficient (X) from given julian date, object's coordinates and observer's coordinates. It works either in batch mode, where the table stored in file is converted and saved to another file, or in terminal mode, where the user enters simple commands and queries by keyboard.

When running the batch mode, the program reads the source file line by line, and expects the JD value in the first column, which must be divided at least one of common used dividers (semicolon, comma, space, tab char, ...). The JD value can be in full (2453xxx.x) or short (53xxx.x) form. Decimal places must be separated by point, not comma. The lines, which doesn't consist of valid julian date, are copied into output without any change. In other cases the heliocentric correction is computed, its value is added to or subtracted from read julian date and the old JD value is replaced by the new one in the same form (full or short form, number of decimal places). The rest of the line is unchanged.

In terminal mode, the opening informations is displayed and the program prompts the user to enter object's coordinates. First, specify right ascension (R.A.) a confirm by the Enter key. By the same way, the declination (DEC.) is set up. The value is printed out as response to the command. Then, by the same way again, the observer's geographical longitude (LON.) and latitude (LAT.) is entered. Use positive values of latitude to the north of equator. Positive values of longitude means, that the location is to the east of zero meridian. After setting up coordinates, entering of a julian date is expected (JD). The user enters the julian date and the program computes and prints out the values of azimuth, altitude and value of airmass coefficient. All commands are descibed below. Entering the q command exits the program.

OPTIONS

The list of input files is usualy entered directly on the command line. If you are going to process a large set of files, you can use the question marks (for a single chars) or the asterisk (for a strings of chars).

The alternate way, how to process a large set of files, is the batch mode. In this mode, the list of input files is read from a given file or from the standard input. The directory file, for example named dirfile, must have the text format and the names of the input files are written on the separate lines. If the files are placed not in the current working directory, you have to specify the proper path in full or shortened form.

The mask parameters allows to set the naming of output files. The mask consists of letters, numbers and other characters allowed in the file name by the operating system. The special meaning has the question mark or the sequence of it. They will be replaced by the ordinal number of the output file, the number is always indented by leading zeros to the same number of decimal places as the number of the question marks. For example, when the mask amass????.fts is given, the output files named amass0001.fts, amass0002.fts, amass0003.fts will be generated.

@dirfile
The program will read the list of source files from specified file.
@
The program will read the list of source files from stdin.
mask=mask, -omark
Mask of the output file(s). Default is amass????.dat.
-cx
Initial counter value. Default is 1.
ra=hhmmss
Object's right ascension.
dec=+dddmmss
Object's declination.
lon=+dddmmss
Observers's geographical longitude.
lat=+dddmmss
Observer's geographical latitude.
--help
Prints short help.
--license
Prints the license.
--version
Prints the program name and its version.
--quiet
Quiet mode -- inhibits the screen printouts.
--debug
Debug mode -- extends the screen printouts.

EXAMPLES

The program adds values of airmass coefficient to the table stored in data.dat file and the resulting table stores in helioc.dat file. The object's coordinates are R.A. = 18h 29m 32s, DEC. = +22d 34m 24s, the observer's coordinates are LON. = 16d 40m = 16.6667 deg. to the east of the zero meridian and LAT. = 49d 13m = 49.2167 deg. to the north of the equator.

airmass lon=16.6667 lat=49.2167 ra=182932 dec=223424 data.dat

EXIT STATUS

airmass returns a zero exist status if it succeeds to convert all specified file. Otherwise, it will stop immediately when the error occurs and returns nonzero code.

DIRECTORIES

~/.cmunipack /usr/local/share/cmunipack

AUTHORS

The project manager David Motl is also the author of the most part of the source codes. Some algorithms originates from Munipack package, coded by Filip Hroch. Algorithms for aperture photometry originates from Daophot software by P. B. Stetson. Munifind algorithm originates from Varfind tool written by Rudolf Novak and Lukas Kral.

The package uses the FITSIO library (Dr. William Pence, NASA), the FreeImage library maintained by Herve Drolon and the James Clark's EXPAT library.

The english version of the documentation was written by David Motl with great help of Petr Lutcha and Jitka Kudrnacova.

BUG REPORTS

David Motl (dmotl [at] volny.cz)

COPYING

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

SEE ALSO

airmass(1), autoflat(1), cmunipack(1), darkbat(1), flatbat(1), helcor(1), kombine(1), konve(1), meandark(1), munifind(1), munilist(1), munimatch(1), muniphot(1), timebat(1)