WCSTools programs

sucac4 Examples

Example 1. Search with results to standard output

Find the 10 brightest UCAC4 stars in a 1-degree square box centered on 10:00:00 +10:00:00 J2000 and sort them by right ascension.
sucac4 -shn 10 -r -1800 10:00:00 +10:00:00 J2000
produces the following:

Example 2. Search with results to a file

Find all UCAC4 stars within 3 arcminutes of M51 and write RA-sorted results to a file
sucac4 -tswr 180 -o test 10:27:48.311 +47:27:28.98 B1950
produces file test.ucac3. Note inclusion of errors in position in arcseconds and proper motion in mas/year. 






Example 3.  Find closest star




Find the closest UCAC4 star to 10:00:00 +10:00:00 J2000

sucac4 -ha 10:00:00 +10:00:00 J2000

produces the following:







Example 4.  List selected stars from catalog




List UCAC4 Catalog stars 180.000001 through 180.000010

sucac4 -h 180.000001-180.000010x0.000001

produces the following:









Example Example 5.  Match stars in input catalog




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

sucac4 -tl @test.tab 

produces the following:





where the columns are input catalog star name, RA, Dec, magnitude, spectral type,
UCAC region.number, RA, Dec, RA and Dec errors in arcseconds, Supercosmos B, R, and I magnitudes,
2MASS J, H, and Ks magnitudes, UCAC ifit model and aperture magnitudes, RA and Dec proper motion
in milliarcseconds per year, RA and Dec proper motion errors in mas/year, number of images used,
number of catalogs used, 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 UCAC4 stars in a 3-arcminute circle centered on
10:00:00 +30:00:00 J2000
and sort them by right ascension.

setenv UCAC4_PATH http://xxx/cgi-bin/scat


sucac4 -s p -vn 10 -r 360 10:00:00 +30:00:00 J2000

produces the following:




With a local catalog,

sucac4 -hs p -vn 10 -r 360 10:00:00 +30:00:00 J2000


Called locally, scat returns the same result, with occasional roundoff
differences in the last digit:













Telescope Data Center


Last updated 16 September 2013 by
Jessica Mink



[WCSTools]
[WCSTools programs]
[scat]
[sucac3]
[sucac2]
[sucac1]
[sucac2 examples]
[sucac1 examples]