sgsca Examples

Find the 10 brightest GSC-ACT Stars in a 1-degree square box centered on 10:00:00 +30:00:00 J2000 and sort them by right ascension.: sgsca -s r -hn 10 -r -1800 10:00:00 +30:00:00 J2000
produces the following: sgsca WCSTools 3.6.9, 5 July 2007, Doug Mink SAO GSC-ACT 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/ACT (Mag brighter than 10.04) GSC_number RA2000 Dec2000 Mag Class Band N Arcsec 1967.0300 09:58:19.171 +29:55:34.97 9.19 0 1 1 1336.82 1967.1296 09:58:29.801 +29:32:04.16 7.91 0 1 1 2046.40 2502.0814 09:59:07.154 +30:25:19.52 8.05 0 1 1 1666.79 2502.0896 09:59:15.312 +30:15:24.77 10.04 0 1 1 1091.48 1967.0363 09:59:15.782 +29:52:47.28 9.04 0 1 1 719.43 2502.0999 09:59:19.934 +30:00:27.97 9.75 0 1 1 521.20 1967.1429 09:59:36.209 +29:38:42.68 5.69 0 4 1 1314.30 1967.0408 10:00:51.324 +29:41:03.66 9.48 3 1 1 1318.03 2503.1384 10:00:52.435 +30:12:17.17 9.57 0 1 1 1003.21 2503.1460 10:01:49.214 +30:00:35.46 9.94 0 1 1 1419.11

Find all GSC-ACT Stars within 5 arcminutes of M51 and write results to a file: sgsca -wtr 300 -o m51 -b 13:27:48.311 +47:27:28.98
produces the following in the file m51.gscact: catalog GSC-ACT ra 13:25:41.574 dec +47:43:00.03 equinox 1950.0 epoch 1950.0 radsec 300.00 catsort mag1 program sgsca 3.3.1, 10 March 2003, Doug Mink SAO gsc_id ra1950 dec1950 mag class band N arcsec --------- ------------ ------------ ----- ----- ---- - ------ 3460.0655 13:25:50.021 +47:47:25.41 11.91 0 1 1 278.72 3460.0079 13:25:26.986 +47:45:48.00 12.72 0 1 1 223.31 3460.0171 13:25:17.051 +47:43:57.24 14.12 0 1 1 253.97 3460.0928 13:25:25.839 +47:44:30.88 15.09 0 1 1 182.91

Find the closest GSC-ACT star to 10:00:00 +10:00:00 J2000.
Set a large search radius because the default is 15 arcseconds.: sgsca -ahr 1800 10:00:00 +10:00:00 J2000
produces the following: sgsca WCSTools 3.6.9, 5 July 2007, Doug Mink SAO Find closest star GSC-ACT 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.991 +09:59:00.96 14.29 0 1 1 83.44

List GSC-ACT stars 1000.0001 through 1000.0010: sgsca -h 1000.0001-1000.0010x0.0001
produces the following: sgsca WCSTools 3.6.9, 5 July 2007, Doug Mink SAO GSC_number RA2000 Dec2000 Mag Class Band N 1000.0001 17:30:55.239 +11:55:53.64 14.29 0 1 2 1000.0002 17:30:41.505 +11:34:39.76 14.03 0 1 2 1000.0003 17:37:01.085 +12:22:28.60 12.80 0 1 1 1000.0004 17:34:26.006 +11:27:46.37 14.04 0 1 1 1000.0005 17:35:57.670 +11:54:13.32 13.80 0 1 1 1000.0006 17:30:20.237 +11:19:21.58 12.83 0 1 2 1000.0007 17:35:35.748 +12:00:56.05 14.51 0 1 1 1000.0008 17:35:55.481 +11:24:46.19 12.77 0 1 1 1000.0009 17:34:01.058 +12:30:45.50 6.72 0 1 1 1000.0010 17:33:39.077 +11:16:06.31 14.60 0 1 1

Match the stars in the input catalog test.cat to the GSC-ACT Star Catalog and list them one match per line.: sgsca -jl @test.cat
produces the following: 240020 22:15:54.522 -11:36:54.93 9.80 1950.0420 __ 5806.0696 22:15:54.547 -11:36:55.84 10.70 53 0.37 -0.90 0.97 267313 17:47:51.203 -22:58:16.83 9.10 1960.0209 A0 6828.0353 17:47:51.186 -22:58:17.02 8.87 58 -0.24 -0.20 0.31 196784 13:42:07.184 -09:06:39.56 8.60 1970.0605 K0 5546.1408 13:42:07.181 -09:06:39.96 8.96 37 -0.05 -0.40 0.40 127373 10:24:43.535 +11:21:21.55 10.20 1980.0309 K0 0841.1205 10:24:43.512 +11:21:21.60 8.87 42 -0.34 0.05 0.34 095438 06:07:46.800 +23:28:44.80 10.30 1990.0319 K0 1864.0762 06:07:46.858 +23:28:45.41 9.06 118 0.79 0.61 0.99
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).