This directory contains the data, in binary format, of the USNO-A2.0 (Monet et al., 1998; see catalog I/252, or follow the "doc" link; see documentation at http://vizier.u-strasbg.fr/vizier/VizieR/pmm/usno2.htx see also the original documentation from http://www.usno.navy.mil/pmm/ ) The USNO-A2 data are stored in a compact binary format best suited for performant search by position -- but note that the total required space is 3.6Gbytes! The data are stored in subdirectories Nxxxx and Sxxxx, where xxx takes the values 0000, 0730, 1500 ... 8230 corresponding to 7.5 degree zones in declination. Within each of these subdirectories, the data are stored in files grouping stars in 30min (7.5degrees) slices in right ascension. The same data files can be used by the various existing computer architectures (ix86, sparc, compaq, etc) The directory src contains the source programs which work on these binary files; the Makefile may need some changes to define peculiar compilers and/or compilation options, but it should be straightforward for the Unix users: a 'make', followed by a 'make install' would install the required programs in the proper subdirectories; a 'make clean' removes the unnecessary stuff. The program, named "pmm.exe", is stored in one of the the bin-xxx subdirectories, where xxx stands for an architecture (here bin-solaris for Sun Solaris 2.x, bin-dos for MS-DOS). When executed without any argument, the program lists the following basic help: Usage: pmm [-HELP] [-r[s] [min,]radius] [-b[s] x[,y] [-c center] [-e edit_opt] [-f input_file] [-id zone-USNO_id] [-m max_records] [-l! min,max] [-s !] [-whole] -HELP: display column explanations -b: target box in arcmin ; -bs = target box in arcsec -r: target radius in arcmin ; -rs = target radius in arcsec -c: target center in decimal or sexagesimal (defaut in stdin) -e: s=edit RA/DE in Sexa; i=edit USNO-ID, e=edit ObsDate, x=edit x,y -f: specifies an input file (default stdin) -id: choice of a zone and USNO-A2.0 instead of target position -m: max number of stars to retrieve -l!: Set the limits (range) on one of the parameters (below) -s!: Sort the result by the parameter ! (list below) -whole: search on the whole sky ====The abbreviations of the parameters (symbolized !)are: a=Alpha B=Bmag c=Color(B-R) d=Delta i=USNO-ID o=obsDate p=Plate r=distance R=Rmag x=proj.E y=proj.N z=Zone For actual searches, the program requires the knowledge of a special environment variable named PMMroot which tells the location of the data files. When executed in the present directory, a search around the position 123.45 -12.45 (in degrees) will work with: $ PMMroot=.; export PMMroot $ bin/pmm.exe -c 123.45-12.45 The various options can be used to sort the result, change the limits or the output format; for instance $ bin/pmm.exe -c 123.45-12.45 -sr -rs 90 -esie edits the output ordered by increasing distance from the specified target position (-sr), up to 90arcsec (-rs 90) for that target position, and editing options (-e) wsking for RA and Dec in sexagesimal (s), the USNO-identifier (i), and epoch of the observation (e). The result should be the following: #Center: 123.45-12.45 #USNO-A2.0 RA (ICRS) Dec A* Bmag Rmag Epoch ; r(") 0750-05933215 08:13:46.112-12:27:16.43 18.7 19.1 1955.881 ; 32.16 0750-05934187 08:13:48.971-12:27:34.12 19.2 17.9 1955.881 ; 36.96 0750-05934709 08:13:50.534-12:26:54.48 19.0 18.9 1955.881 ; 37.52 0750-05933895 08:13:48.102-12:26:20.05 18.9 18.9 1955.881 ; 39.97 0750-05933138 08:13:45.882-12:26:12.92 19.0 18.4 1955.881 ; 56.38 0750-05933328 08:13:46.461-12:26:08.08 18.1 17.7 1955.881 ; 56.60 0750-05934226 08:13:49.091-12:27:54.34 19.5 17.7 1955.881 ; 56.63 0750-05934008 08:13:48.380-12:27:58.05 14.9 15.0 1955.881 ; 58.31 0750-05933828 08:13:47.931-12:26:00.28 15.3 13.7 1955.881 ; 59.72 0750-05934618 08:13:50.250-12:27:50.80 17.2 16.9 1955.881 ; 60.55 0750-05934623 08:13:50.257-12:27:52.29 17.1 16.5 1955.881 ; 61.86 0750-05932471 08:13:44.015-12:26:32.75 19.3 18.4 1955.881 ; 64.42 0750-05935029 08:13:51.475-12:26:19.75 16.2 15.3 1955.881 ; 64.88 0750-05932317 08:13:43.530-12:26:54.76 19.7 18.6 1955.881 ; 65.69 0750-05933074 08:13:45.688-12:25:59.24 19.3 18.4 1955.881 ; 69.56 0750-05934655 08:13:50.340-12:25:59.14 19.3 18.7 1955.881 ; 69.84 0750-05935185 08:13:51.932-12:27:41.21 19.1 17.6 1955.881 ; 70.81 0750-05932215 08:13:43.228-12:27:14.11 18.7 16.7 1955.881 ; 71.30 0750-05935055 08:13:51.550-12:27:56.95 18.7 17.9 1955.881 ; 77.10 0750-05935442 08:13:52.704-12:27:38.00 19.2 18.3 1955.881 ; 78.67 0750-05934134 08:13:48.799-12:28:24.69 15.4 14.8 1955.881 ; 85.49 0750-05933170 08:13:45.959-12:25:39.04 18.6 18.1 1955.881 ; 86.30 0750-05932989 08:13:45.454-12:25:41.29 19.6 17.5 1955.881 ; 87.10 0750-05935415 08:13:52.630-12:27:56.13 18.0 18.1 1955.881 ; 88.03 0750-05935841 08:13:53.871-12:27:23.79 16.5 15.3 1955.881 ; 89.21 #--- 25 matches (4351 tested) The USNO-identifier may also be used as an argument, e.g. $ bin/pmm.exe -id 0750-05930487 -esie and the result should be the following: #PMM 0750-05930487 #USNO-A2.0 RA (ICRS) Dec A* Bmag Rmag Epoch ; r(") 0750-05930487 08:13:38.212-12:26:58.44 14.9 14.2 1955.881 #--- 1 matches (1 tested) A whole 7.5degree zone may be edited by $ bin/pmm.exe -id 0750- -esie -m 100000000 the -m argument asking an edition of up to 100 million records. NOTE: a client-server program "findpmm2" included in the package ftp://cdsarc.u-strasbg.fr/pub/cats/cdsclient.tar.gz can query the USNO-A2 from any remote site connected to Internet (it interacts directly with the ucac1 program running in daemon mode at CDS). It you use this cdsclient package, there is no need of copying all this stuff... Note also that the USNO-A2 can be queried via HTTP in a number of locations, especially the various VizieR mirror services, from: http://vizier.u-strasbg.fr/viz-bin/VizieR?-source=USNO2 http://adc.gsfc.nasa.gov/viz-bin/VizieR?-source=USNO2 http://vizier.nao.ac.jp/viz-bin/VizieR?-source=USNO2 http://urania.iucaa.ernet.in/viz-bin/VizieR?-source=USNO2 http://vizier.hia.nrc.ca/viz-bin/VizieR?-source=USNO2 http://archive.ast.cam.ac.uk/viz-bin/VizieR?-source=USNO2 http://www.inasan.rssi.ru/viz-bin/VizieR?-source=USNO2 http://data.bao.ac.cn/viz-bin/VizieR?-source=USNO2 where the results are available in various popular formats (e.g. XML VOTable) ================================================================================ Questions, problems, etc... question@astro.u-strasbg.fr Francois Ochsenbein 31 July 2002 ================================================================================