TwoMassCnvrt
RichardJ.Mathar
Fitsheaderkeywordbatcheditor
|
TwoMassCnvrt extracts star positions and magnitudes from the 2MASS catalogue (on the user's file system) and generates an ASCII format of the stars distributed over the pixels in the field of view in the catalogue style of skymaker. More...
Functions | |
void | usage (char *argv0) |
Emit a short usage reminder. | |
int | main (int argc, char *argv[]) |
The C++ program TwoMassCnvrt converts portions of the 2MASS catalog to a Skymaker's list file. | |
TwoMassCnvrt extracts star positions and magnitudes from the 2MASS catalogue (on the user's file system) and generates an ASCII format of the stars distributed over the pixels in the field of view in the catalogue style of skymaker.
For interactive infrequent access to basically the same features see the 2MASS Image Service.
void usage | ( | char * | argv0 | ) |
Emit a short usage reminder.
[in] | argv0 | The name of the executable. |
int main | ( | int | argc, |
char * | argv[] | ||
) |
The C++ program TwoMassCnvrt converts portions of the 2MASS catalog to a Skymaker's list file.
The prerequisites of running the program are the regions of interest of the 2MASS catalog in the standard layout in the file system, which are files named ../???/t*.cat, where the three question marks are the three digits of the quantized declination (measured from 0 of the southern pole up to 179).
This means the program will scan these directories, and if some of the files or their lines are missing, the stars that are not found will not be produced by the program either.
The standard output contains lines in the Skymaker format, a 100 followed by the two FITS pixel locations and a magnitude. The standard error contains a snapshot that would be added to the FITS file header of what will be produced by Skymaker to have a useful WCS system across the FITS image. See the Makefile
for an example of chaining the operations.
[in] | argc | |
[in] | argv | The command line options are: |
-D
is followed by the location of the directory of the 2MASS catalog. This is without the ???/t*.cat
portion of the file names.
-r
is followed by the right ascension (in hours from 0 to 24) of the pointing in the center of the FITS plate. Instead of a floating point number in hours, the RA may also be provided by the standard two-colon hex-format, HH:MM:SS.ss.
-d
is followed by the declination (in degrees from -90 to 90) of the pointing in the center of the FITS plate. Instead of a floating point number in hours, the DEC may also be provided by the standard two-colon hex-format, +-DD:MM:SS.ss.
-p
defines the number of the pixels along x and along y. (We are only dealing with quadratic detector areas.) The product of this with the pixel scale is the two-sided field of view in which stars of the 2MASS catalogue must reside to be copied to the output. Warning: this must be the same as the IMAGE_SIZE in the sky.conf file .
-s
is the pixel scale in units of arcseconds per pixel. Warning: this must be the same as the PIXEL_SIZE in the sky.conf file .
-m
clips the magnitude (in the infrared band, not refering to the visible) of the star list that is put to the output. A number of 8.5, for example, means that only objects brighter than 8.5 (numerically smaller than 8.5) are copied over.
-b
is followed by a single capital letter, one out of three J, H or K as expected.
-q
is followed by a number between 0 and 1, which scales the magnitude of the star in the output according to that quantum efficiency.
-G
generates a start catalogue as used with the display of the GEIRS detector software of the MPIA. If that selection of theoutput format is made, the value of the -q-option is ignored.
The syntax in overview:
TwoMassConv [-D 2massdir] [-r RA/h] [-d DEC/deg] [-p px] [-s arcs] [-m mag] [-b {J,H,K}] > sky.list 2> sky.hdr