sgsc2 Examples

Example 1. Search with results to standard output

Find the 10 brightest GSC II stars in V in a 1-degree square box centered on 10:00:00 +30:00:00 J2000 and sort them by right ascension.

sgsc2 -s mv -hn 10 -r -1800 10:00:00 +30:00:00 J2000

produces the following:

sgsc2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
      GSC 2.3 10:00:00.000 +30:00:00.00 J2000 +- +00:34:38.5 +00:30:00.0 at epoch 2000.0000
10 / 8149 GSC 2.3 Sources (MagV brighter than 99.90)
GSC2_id      RA2000       Dec2000     MagF  MagJ  MagN  MagB  MagV Class  Arcsec
N9AF005890 09:59:36.215 +29:38:42.84 99.90 99.90 99.90  6.80  5.80  0    1314.13
N9AF016861 09:59:36.215 +29:38:42.84 99.90 99.90 99.90  6.80  5.80  0    1314.13
N9AF018336 09:59:36.215 +29:38:42.84 99.90 99.90 99.90  6.80  5.80  0    1314.13
N9AF014118 09:59:36.215 +29:38:42.84 99.90 99.90 99.90  6.80  5.80  0    1314.13
N9AF020075 09:59:36.215 +29:38:42.84 99.90 99.90 99.90  6.80  5.80  0    1314.13
N9AF000109 09:59:36.215 +29:38:42.84 99.90 99.90 99.90  7.10  5.90  0    1314.13
N9AF016727 09:58:29.832 +29:32:03.97 99.90 99.90 99.90  9.00  8.00  0    2046.33
N9AF017888 09:58:29.832 +29:32:03.97 99.90 99.90 99.90  9.00  8.00  0    2046.33
N9AF012862 09:58:29.832 +29:32:03.97 99.90 99.90 99.90  9.00  8.00  0    2046.33
N9AF000148 09:58:29.832 +29:32:03.96 99.90 99.90 99.90  9.30  8.10  0    2046.34

Example 2. Search with results to a file

Find all GSC II stars within 3 arcminutes of M51 and write RA-sorted results to a file

sgsc2 -ts r -wr 180 -o m51 13:27:48.311 +47:27:28.98 B1950

produces file m51.gsc2:

catalog GSC 2.3
ra      13:27:48.311
dec     +47:27:28.98
radecsys        fk4
equinox 1950.0000
epoch   1950.0000
radsec  180.00
catsort ra
program sgsc2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
gsc2_id         ra1950          dec1950         magf    magj    magn    magb    magv    class   arcsec
-------------   ------------    ------------    -----   -----   -----   -----   -----   -----   ------
N5PB018958      13:27:32.180    +47:28:24.56    99.90   99.90   18.70   99.90   99.90   3       172.76
N5PB011727      13:27:32.910    +47:28:57.29    99.90   21.60   99.90   99.90   99.90   3       179.40
N5PB018353      13:27:33.210    +47:28:37.69    99.90   99.90   18.80   99.90   99.90   3       167.83
N5PB011731      13:27:33.917    +47:29:07.66    99.90   22.30   99.90   99.90   99.90   0       176.17
N5PB011736      13:27:34.026    +47:29:13.95    99.90   21.90   99.90   99.90   99.90   3       178.88
 . . .

N5PB018334      13:28:04.014    +47:26:40.96    99.90   99.90   18.70   99.90   99.90   3       166.36
N5PB018952      13:28:04.459    +47:27:48.84    99.90   99.90   17.50   99.90   99.90   3       164.96
N5PB018347      13:28:05.193    +47:27:42.53    99.90   99.90   17.40   99.90   99.90   3       171.75
N5PB006272      13:28:05.254    +47:27:21.84    20.00   99.90   19.00   99.90   99.90   3       171.99
N5PB011686      13:28:05.271    +47:27:16.62    99.90   21.80   99.90   99.90   99.90   3       172.46

Example 3. Find closest star

Find the closest GSC II star to 10:00:00 +50:00:00 J2000

sgsc2 -ah 10:00:00 +50:00:00 J2000

produces the following:

sgsc2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO  Find closest star
      GSC 2.3 10:00:00.000 +50:00:00.00 J2000 r= +00:02:00.0 at epoch 2000.0000
GSC2_id      RA2000       Dec2000     MagF  MagJ  MagN  MagB  MagV Class  Arcsec
N96M007367 09:59:59.960 +49:59:47.76 19.80 99.90 99.90 99.90 99.90  0     12.24

Example 4. List selected stars from catalog

List GSC II Catalog stars

sgsc2 -h list of numbers

doesn't work yet.

Example 5. Match stars in input catalog

Match the stars in the input catalog test.tab to the GSC II Catalog and list them one match per line.

sgsc2 -lt @test.tab

produces the following:

catalog GSC 2.3
search  test.tab
radecsys        fk5
equinox 2000.0000
epoch   2000.0000
radsec  120.00
program sgsc2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
ppm_id  srch_ra         srch_dec        s_mag   s_TYPE  gsc2_id         ra              dec             magf    magj    magn    magb    magv    class   n       dra     ddec    drad   
------- ------------    ------------    -----   ----    -------------   ------------    ------------    -----   -----   -----   -----   -----   --      ---     ------- ------- -------
240020  22:15:54.555    -11:36:56.13     9.80   __      SBER000261      22:15:54.558    -11:36:56.22    99.90   99.90   99.90   11.00 10.20     0       35         0.05   -0.09    0.10
267313  17:47:51.210    -22:58:17.35     9.10   A0      S8CH000038      17:47:51.196    -22:58:17.30    99.90   99.90   99.90    9.30  8.90     0       496       -0.19    0.05    0.20
196784  13:42:07.204    -09:06:40.06     8.60   K0      S6S1009599      13:42:07.203    -09:06:40.06    99.90   99.90   99.90    9.40  8.50     0       55        -0.01   -0.00    0.01
127373  10:24:43.528    +11:21:21.15    10.20   K0      N6ZK000194      10:24:43.506    +11:21:21.50    99.90   99.90   99.90   10.80  9.50     0       44        -0.33    0.35    0.48
095438  06:07:46.792    +23:28:44.76    10.30   K0      N8CH000121      06:07:46.837    +23:28:44.94    99.90   99.90   99.90   10.40  9.40     0       151        0.61    0.18    0.64

where the columns are input catalog star name, RA, Dec, magnitude, spectral type, GSC II number, RA, Dec, F, J, N, B, and V magnitudes, number of stars in the 120-arcsec-radius default search radius, and catalog-search dra, ddec, and dr (in arcseconds).

Last updated 9 July 2007 by Doug Mink [WCSTools] [WCSTools programs] [scat] [sgsc2]