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
[WCSTools] [WCSTools programs] [scat] [sgsc] [sgsca] [sgsca examples]

sgsc Examples

Example 1. Search with results to standard output

Example 2. Search with results to a file

Example 3. Find closest star

Example 4. List selected stars from catalog

Example 5. Match stars in input catalog

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

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

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