sua2 Examples

Example 1. Search with results to standard output

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

sua2 -s r -hn 10 -r -1800 10:00:00 +30:00:00 J2000

produces the following:

sua2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
    USNO-A2.0 10:00:00.000 +30:00:00.00 J2000 +- +00:34:38.5 +00:30:00.0 at epoch 2000.0000
10 / 1938 USNO A-2.0 Sources (MagB brighter than 11.40)
USNO_A2_number  RA2000       Dec2000     MagB  MagR  Plate  Arcsec
1125.06018647 09:58:19.136 +29:55:35.38  10.4   8.8   316  1337.19
1200.06429238 09:59:15.359 +30:15:25.70  10.9   9.8   316  1091.94
1125.06021862 09:59:15.835 +29:52:47.49  10.7   8.7   316   718.76
1200.06429494 09:59:20.013 +30:00:28.34  10.5   9.4   316   520.19
1125.06022940 09:59:36.218 +29:38:42.84   0.0   5.9     0  1314.12
1200.06432908 10:00:24.351 +30:25:51.28  11.4   9.6   316  1583.06
1125.06027006 10:00:51.451 +29:41:08.46  10.4   9.7   316  1314.73
1200.06434324 10:00:52.723 +30:12:18.28  10.8   9.5   316  1006.56
1125.06028687 10:01:22.157 +29:35:05.13  11.1   9.7   316  1838.05
1200.06437345 10:01:49.213 +30:00:35.48  11.1   9.8   316  1419.10

Example 2. Search with results to a file

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

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

produces file m51.ua2:

catalog USNO-A2.0
ra      13:27:48.311
dec     +47:27:28.98
radecsys        fk4
equinox 1950.0000
epoch   1950.0000
radsec  180.00
catsort ra
program sua2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
usnoa2_id       ra1950          dec1950         magb    magr    plate   arcsec
-------------   ------------    ------------    -----   -----   -----   ------
1350.08286551   13:27:33.353    +47:26:01.02    18.5    18.7    174     175.39
1350.08286597   13:27:34.436    +47:28:29.14    18.4    17.8    174     153.02
1350.08286639   13:27:35.233    +47:27:19.58    17.5    17.0    174     132.97
1350.08286936   13:27:43.054    +47:24:50.81    12.7    18.3    174     166.93
1350.08287068   13:27:46.639    +47:28:52.35    17.7    18.9    174     85.07
1350.08287110   13:27:47.540    +47:29:02.75    12.9    19.1    174     94.10
1350.08287169   13:27:49.067    +47:25:33.26    12.3    17.2    174     115.97
1350.08287199   13:27:49.929    +47:30:21.03    18.6    18.1    174     172.83
1350.08287222   13:27:50.615    +47:24:47.85    19.8    19.0    174     162.82
1350.08287282   13:27:52.304    +47:24:41.38    16.8    15.8    174     172.43
1350.08287371   13:27:54.614    +47:24:56.96    19.6    17.8    174     164.93
1350.08287429   13:27:56.110    +47:29:33.86    17.8    16.3    174     147.80
1350.08287632   13:28:00.729    +47:27:02.61    17.3    16.2    174     128.68
1350.08287657   13:28:01.306    +47:26:47.96    17.7    17.2    174     138.04
1350.08287688   13:28:02.103    +47:28:19.06    18.0    17.4    174     148.56
1350.08287729   13:28:03.074    +47:25:57.22    18.9    19.3    174     175.63

Example 3. Find closest star

Find the closest USNO A-1.0 star to 10:00:00 +50:00:00 J2000

sua2 -a 10:00:00 +50:00:00 J2000

produces the following:

1350.07694839 10:00:01.648 +49:59:55.48  19.1  19.1  167     16.52

Example 4. List selected stars from catalog

List USNO-A2.0 Catalog stars 1350.00000001 through 1350.00000010

sua2 -s n -h 1350.00000001-1350.00000010x0.00000001

produces the following:

sua2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
USNO_A2_number  RA2000       Dec2000     MagB  MagR  Plate
1350.00000001 00:00:00.001 +50:16:36.55  18.0  16.9  150 
1350.00000002 00:00:00.003 +50:16:52.15  18.2  16.9  150 
1350.00000003 00:00:00.004 +45:28:38.99  14.3  12.7  193 
1350.00000004 00:00:00.004 +48:26:37.47  19.4  17.2  150 
1350.00000005 00:00:00.007 +48:51:54.31  18.0  17.6  150 
1350.00000006 00:00:00.009 +46:26:07.21  15.9  15.3  150 
1350.00000007 00:00:00.009 +52:11:55.80  18.1  17.4  112 
1350.00000008 00:00:00.013 +48:06:47.69  19.9  18.6  192 
1350.00000009 00:00:00.019 +49:05:21.67  19.6  19.0  150 
1350.00000010 00:00:00.019 +50:18:32.84  19.0  18.0  150

Example Example 5. Match stars in input catalog

Match the stars in the input catalog test.tab to the USNO-A2.0 Catalog and list them one match per line.

sua2 -tl @test.tab

produces the following:

catalog USNO-A2.0
search  test.tab
radecsys        fk5
equinox 2000.0000
epoch   2000.0000
radsec  120.00
program sua2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
ppm_id 	srch_ra     	srch_dec    	s_mag	sspt	usnoa2_id    	ra              dec         	mag1 	mag2 	n 	dra     ddec    drad   
-------	------------	------------	-----	----	-------------	------------    ------------	-----	-----	--	-------	-------	-------
240020	22:15:54.555	-11:36:56.13	 9.80	__	0750.21153376	22:15:54.521	-11:36:54.60	11.60   10.40	11	-0.49	1.53	1.61
267313	17:47:51.210	-22:58:17.35	 9.10	A0	0600.28787484	17:47:51.194	-22:58:17.27	 0.00    8.90	370	-0.22	0.08	0.24
196784	13:42:07.204	-09:06:40.06	 8.60	K0	0750.08217430	13:42:07.153	-09:06:39.43	 9.40    8.10	16	-0.76	0.63	0.99
127373	10:24:43.528	+11:21:21.15	10.20	K0	0975.06486656	10:24:43.519	+11:21:21.53	10.70    8.80	6	-0.13	0.38	0.40
095438	06:07:46.792	+23:28:44.76	10.30	K0	1125.03426401	06:07:46.859	+23:28:45.44	11.40    9.10	91	0.92	0.68	1.14

where the columns are input catalog star name, RA, Dec, magnitude, spectral type, A2.0 region.number, RA, Dec, B magnitude, R magnitude, number of stars in the 120-arcsecond radius default search region, and catalog - search dra, ddec, and dr (in arcseconds).

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

Find the 10 closest USNO A-2.0 stars in a 3-arcminute circle centered on 10:00:00 +30:00:00 J2000 and sort them by right ascension.

setenv UA2_PATH http://archive.eso.org/skycat/servers/usnoa-server
sua2 -s p -vn 10 -r 180 10:00:00 +30:00:00 J2000

produces the following:

sua2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
Center:  10:00:00.000   +30:00:00.00 J2000
Radius: +00:03:00.00
    USNO-A2.0 10:00:00.000 +30:00:00.00 J2000 r= +00:03:00.0 at epoch 2000.0000
http://archive.eso.org/skycat/servers/usnoa-server?150.0000000+30.0000000&radius=0,3.000&format=8&sort=m&n=40
SearchLim: RA: 09:59:46.144 - 10:00:13.856  Dec: +29:57:00.00 - +30:03:00.00
RefLim: RA: 09:59:46.137 - 10:00:13.863  Dec: +29:57:00.00 - +30:03:00.00
TABREAD: Catalog http://archive.eso.org/skycat/servers/usnoa-server : 12 / 13 / 12 found
TABREAD: 12 stars found; only 10 returned
Closest 10 / 12 USNO A-2.0 Sources (closer than 127.29 arcsec)
USNO_A2_number  RA2000       Dec2000     MagB  MagR  Plate  Arcsec
0125.06024092 09:59:57.826 +29:59:41.89  18.6  18.9   316   33.55
0200.06431758 10:00:03.022 +30:00:07.60  19.7  19.3   316   39.98
0125.06024448 10:00:04.080 +29:58:52.32  19.8  18.3   316   85.97
0125.06024249 10:00:00.811 +29:58:29.46  17.1  16.0   316   91.15
0200.06431222 09:59:52.843 +30:00:11.48  18.9  17.9   316   93.67
0200.06432027 10:00:07.766 +30:00:05.62  13.0  11.8   316  101.04
0125.06024245 10:00:00.742 +29:58:11.17  18.5  17.5   316  109.25
0200.06431535 09:59:58.373 +30:01:47.96  20.4  19.8   316  110.01
0125.06024645 10:00:06.986 +29:58:44.18  19.4  19.5   316  118.26
0200.06432076 10:00:08.810 +30:00:55.73  18.9  18.7   316  127.29

With a local catalog,

sua2 -s p -vhn 10 -r 180 10:00:00 +30:00:00 J2000

gets the same stars with the declination zones correct:

sua2 WCSTools 3.6.9, 6 July 2007, Doug Mink SAO
Center:  10:00:00.000   +30:00:00.00 J2000
Radius: +00:03:00.00
    USNO-A2.0 10:00:00.000 +30:00:00.00 J2000 r= +00:03:00.0 at epoch 2000.0000
SearchLim: RA: 09:59:46.144 - 10:00:13.856  Dec: +29:57:00.00 - +30:03:00.00
RefLim: RA: 09:59:46.137 - 10:00:13.863  Dec: +29:57:00.00 - +30:03:00.00
UACZONES:  2 zones: 1125 - 1200
UACZONES: RA: 149.94224 - 150.05776, Dec: 29.95000 - 30.05000
UACREAD: zone 1125 ( 1 /  2)        7 /     1568 / 20024396 sources      
UACREAD: zone 1200 ( 2 /  2)        5 /     1491 / 20143080 sources      
UACREAD: 2 zones: 12 / 3059 found
UACREAD: 12 stars found; only 10 returned
Closest 10 / 12 USNO A-2.0 Sources (closer than 127.29 arcsec)
USNO_A2_number  RA2000       Dec2000     MagB  MagR  Plate  Arcsec
1125.06024092 09:59:57.825 +29:59:41.89  18.6  18.9   316   33.56
1200.06431758 10:00:03.022 +30:00:07.60  19.7  19.3   316   39.99
1125.06024448 10:00:04.080 +29:58:52.33  19.8  18.3   316   85.96
1125.06024249 10:00:00.812 +29:58:29.46  17.1  16.0   316   91.15
1200.06431222 09:59:52.843 +30:00:11.49  18.9  17.9   316   93.67
1200.06432027 10:00:07.765 +30:00:05.60  13.0  11.8   316  101.03
1125.06024245 10:00:00.743 +29:58:11.19  18.5  17.5   316  109.24
1200.06431535 09:59:58.373 +30:01:47.96  20.4  19.8   316  110.01
1125.06024645 10:00:06.986 +29:58:44.17  19.4  19.5   316  118.27
1200.06432076 10:00:08.810 +30:00:55.74  18.9  18.7   316  127.29

---

Last updated 8 July 2007 by Doug Mink [WCSTools] [WCSTools programs] [scat] [sua2] [sua1] [sua1 examples]