sgsc Examples

Example 1. Search with results to standard output

Find the 10 brightest HST Guide Stars in a 1-degree square box centered on 10:00:00 +30:00:00 J2000 and sort them by right ascension.
sgsc -s r -hn 10 -r -1800 10:00:00 +30:00:00 J2000
produces the following:
sgsc WCSTools 3.6.9, 5 July 2007, Doug Mink SAO
      GSC 10:00:00.000 +30:00:00.00 J2000 +- +00:34:38.5 +00:30:00.0 at epoch 2000.0000
10 / 234 HST Guide Stars (Mag brighter than 10.04)
GSC_number  RA2000       Dec2000      Mag  Class Band N  Arcsec
1967.0300 09:58:19.183 +29:55:34.64   9.19    0    1  1  1336.74
1967.1296 09:58:29.813 +29:32:03.91   7.91    0    1  1  2046.52
2502.0814 09:59:07.171 +30:25:19.13   8.05    0    1  1  1666.34
2502.0896 09:59:15.326 +30:15:24.37  10.04    0    1  1  1091.04
1967.0363 09:59:15.794 +29:52:46.96   9.04    0    1  1   719.50
2502.0999 09:59:19.949 +30:00:27.65   9.75    0    1  1   520.99
1967.1429 09:59:36.209 +29:38:42.68   5.69    0    4  1  1314.30
1967.0408 10:00:51.336 +29:41:03.37   9.48    3    1  1  1318.35
2503.1384 10:00:52.450 +30:12:16.81   9.57    0    1  1  1003.07
2503.1460 10:01:49.226 +30:00:35.14   9.94    0    1  1  1419.2

Example 2. Search with results to a file

Find all HST Guide Stars within 5 arcminutes of M51 and write results to a file
sgsc -wtr 300 -o m51 13:27:48.311 +47:27:28.98 B1950
produces the following in the file m51.gsc:
catalog GSC
ra      13:27:48.311
dec     +47:27:28.98
radecsys        fk4
equinox 1950.0000
epoch   1950.0000
radsec  300.00
catsort mag 
program sgsc WCSTools 3.6.9, 5 July 2007, Doug Mink SAO
gsc_id          ra1950          dec1950         mag     class   band    N      arcsec
---------       ------------    ------------    -----   -----   ----    -      ------
3460.0280       13:27:40.922    +47:29:05.33    10.89   3       1       1      122.05
3463.0173       13:27:55.505    +47:28:26.19    11.76   3       1       1      92.71
3463.0591       13:28:08.664    +47:25:54.63    13.38   0       1       1      227.00
3460.0534       13:27:32.285    +47:29:04.27    14.98   0       1       1      188.37
3460.0156       13:27:42.139    +47:23:10.30    15.00   0       1       1      266.16
3460.0831       13:27:23.243    +47:27:32.43    15.06   0       1       1      254.26
3460.0444       13:27:30.911    +47:24:37.26    15.15   0       1       1      246.29
3460.0588       13:27:49.031    +47:25:32.74    15.40   0       1       1      116.47

Example 3. Find closest star

Find the closest HST Guide Star to 10:00:00 +10:00:00 J2000.
Set a large search radius because the default is 15 arcseconds.
sgsc -ahr 1800 10:00:00 +10:00:00 J2000
produces the following:
sgsc WCSTools 3.6.9, 5 July 2007, Doug Mink SAO  Find closest star
      GSC 10:00:00.000 +10:00:00.00 J2000 r= +00:30:00.0 at epoch 2000.0000
GSC_number  RA2000       Dec2000      Mag  Class Band N  Arcsec
0829.0269 10:00:03.989 +09:59:01.25  14.29    0    1  1    83.21

Example 4. List selected stars from catalog

List HST Guide Stars 1000.0001 through 1000.0010
sgsc -s n -h 1000.0001-1000.0010x0.0001
produces the following:
sgsc WCSTools 3.6.9, 5 July 2007, Doug Mink SAO
GSC_number  RA2000       Dec2000      Mag  Class Band N
1000.0001 17:30:55.206 +11:55:53.68  14.29    0    1  2
1000.0002 17:30:41.471 +11:34:39.70  14.03    0    1  2
1000.0003 17:37:01.085 +12:22:28.45  12.80    0    1  1
1000.0004 17:34:25.990 +11:27:46.37  14.04    0    1  1
1000.0005 17:35:57.660 +11:54:13.25  13.80    0    1  1
1000.0006 17:30:20.213 +11:19:21.47  12.83    0    1  2
1000.0007 17:35:35.738 +12:00:55.94  14.51    0    1  1
1000.0008 17:35:55.471 +11:24:46.22  12.77    0    1  1
1000.0009 17:34:01.051 +12:30:45.29   6.72    0    1  1
1000.0010 17:33:39.060 +11:16:06.35  14.60    0    1  1

Example 5. Match stars in input catalog

Match the stars in the input catalog test.tab to the HST Guide Star Catalog and list them one match per line.
sgsc -jl @test.tab
produces the following:
8240020 22:15:54.555 -11:36:56.13  9.80  __  5806.0696 22:15:54.533 -11:36:56.05 10.70 53   -0.33    0.08    0.34
267313 17:47:51.210 -22:58:17.35  9.10  A0  6828.0353 17:47:51.200 -22:58:16.61  8.87 58   -0.14    0.74    0.75
196784 13:42:07.204 -09:06:40.06  8.60  K0  5546.1408 13:42:07.181 -09:06:39.06  8.96 37   -0.34    1.00    1.06
127373 10:24:43.528 +11:21:21.15 10.20  K0  0841.1205 10:24:43.534 +11:21:21.31  8.87 42    0.08    0.16    0.18
095438 06:07:46.792 +23:28:44.76 10.30  K0  1864.0762 06:07:46.858 +23:28:45.52  9.06 118    0.90    0.76    1.18
where the columns are input catalog star name, RA, Dec, magnitude, spectral type, Guide Star region.number, RA, Dec, magnitude, number of stars in the 900-arcsec-radius default search radius, and catalog-search dRA, dDec, and dr (in arcseconds).

Example 6. Search over the web with results to standard output

Find the 10 brightest HST Guide Stars in a 1-degree square box centered on 10:00:00 +30:00:00 J2000 and sort them by right ascension.
setenv GSC_NORTH http://archive.eso.org/skycat/servers/gsc-server
sgsc -v -s r -hn 10 -r -1800 10:00:00 +10:00:00 J2000
produces the following:
sgsc WCSTools 3.6.9, 5 July 2007, Doug Mink SAO
Center:  10:00:00.000   +10:00:00.00 J2000
Area:    +00:30:27.77 x +00:30:00.00
      GSC 10:00:00.000 +10:00:00.00 J2000 +- +00:30:27.8 +00:30:00.0 at epoch 2000.0000
http://archive.eso.org/skycat/servers/gsc-server?10.0000000+10.0000000&r=0,42.755&nout=100000&f=8
SearchLim: RA: 09:57:58.149 - 10:02:01.851  Dec: +09:30:00.00 - +10:30:00.00
RefLim: RA: 09:57:57.956 - 10:02:02.044  Dec: +09:30:00.00 - +10:30:00.00
TABREAD: Catalog http://archive.eso.org/skycat/servers/gsc-server : 242 / 383 / 382 found
TABREAD: 242 stars found; only 10 returned
10 / 242 HST Guide Stars (Mag brighter than 9.95)
GSC_number  RA2000       Dec2000      Mag  Class Band N  Arcsec
0829.0023 09:58:00.576 +09:41:40.96   8.94    0    0  0  2079.18
0832.0872 09:58:07.949 +10:01:53.87   9.64    0    0  0  1659.06
0832.1065 09:58:28.150 +10:02:51.25   9.78    0    0  0  1367.49
0832.0981 09:58:28.716 +10:25:28.34   9.19    0    0  0  2037.59
0832.0632 09:58:45.667 +10:27:30.74   7.06    0    0  0  1982.16
0832.0632 09:58:45.679 +10:27:31.21   7.09    0    0  0  1982.45
0832.0905 09:59:17.026 +10:10:03.58   9.78    0    0  0   875.84
0829.0042 10:00:05.035 +09:38:23.96   9.95    0    0  0  1298.17
0829.0193 10:01:42.744 +09:36:40.90   9.85    0    0  0  2064.89
0832.1200 10:01:46.783 +10:12:58.32   9.14    0    0  0  1758.51
Note that the same search when scat reads the catalog directly returns a slightly different result because only one position is returned for star 0832.0632, so the fainter 0832.0641 is added to the list:
unsetenv GSC_NORTH
sgsc -v -s r -hn 10 -r -1800 10:00:00 +10:00:00 J2000
which produces the following:
sgsc WCSTools 3.6.9, 5 July 2007, Doug Mink SAO
Center:  10:00:00.000   +10:00:00.00 J2000
Area:    +00:30:27.77 x +00:30:00.00
      GSC 10:00:00.000 +10:00:00.00 J2000 +- +00:30:27.8 +00:30:00.0 at epoch 2000.0000
SearchLim: RA: 09:57:58.149 - 10:02:01.851  Dec: +09:30:00.00 - +10:30:00.00
RefLim: RA: 09:57:57.956 - 10:02:02.044  Dec: +09:30:00.00 - +10:30:00.00
GSCREG: searching 584 regions: 594 - 1177
GSCREG: RA: 149.49148 - 150.50852, Dec: 9.50000 - 10.50000
GSCREG: Region 829 added to search
GSCREG: Region 832 added to search
GSCREAD:    1 /    2:   118 /  2287  /  2286 sources from region  829    
GSCREAD:    2 /    2:   128 /  2001  /  2000 sources from region  832    
GSCREAD: 2 regions: 246 / 4288 found
GSCREAD: 246 stars found; only 10 returned
10 / 246 HST Guide Stars (Mag brighter than 10.41)
GSC_number  RA2000       Dec2000      Mag  Class Band N  Arcsec
0829.0023 09:58:00.576 +09:41:40.96   8.94    0    1  1  2079.18
0832.0641 09:58:06.919 +10:21:35.35  10.41    3    1  1  2113.10
0832.0872 09:58:07.949 +10:01:53.87   9.64    3    1  1  1659.06
0832.1065 09:58:28.150 +10:02:51.25   9.78    0    1  1  1367.49
0832.0981 09:58:28.716 +10:25:28.34   9.19    0    1  1  2037.59
0832.0632 09:58:45.678 +10:27:31.17   7.09    0    1  2  1982.42
0832.0905 09:59:17.026 +10:10:03.58   9.78    0    1  1   875.84
0829.0042 10:00:05.035 +09:38:23.96   9.95    0    1  1  1298.17
0829.0193 10:01:42.744 +09:36:40.90   9.85    0    1  1  2064.89
0832.1200 10:01:46.783 +10:12:58.32   9.14    0    1  1  1758.51

Last updated 6 July 2007 by Doug Mink
Telescope Data Center [WCSTools] [WCSTools programs] [scat] [sgsc] [sgsca] [sgsca examples]