1BUILD-ASTROMETRY-INDEX(1)       astrometry.net       BUILD-ASTROMETRY-INDEX(1)
2
3
4

NAME

6       build-astrometry-index - Create astrometry.net index files
7

SYNOPSIS

9       build-astrometry-index [options] -i catalog -o file -P scale
10

DESCRIPTION

12       build-astrometry-index  takes  a FITS catalog table containing at least
13       RA, DEC, and magnitude columns and converts it into an index file  that
14       can be used by the astrometry.net programs like solve-index (1).
15

OPTIONS

17       -i catalog
18              Input FITS catalog: source RA,DEC, etc.
19
20       -e extension
21              FITS extension to read when -i is specified.
22
23       -1 index
24              Share another index's stars (alternatively to -i/-e).
25
26       -o file
27              Output filename for index
28
29       -N nside
30              Healpix Nside for quad-building
31
32       -l size
33              Minimum quad size (arcminutes)
34
35       -u size
36              Maximum quad size (arcminutes)
37
38       -P number
39              Use  'preset' values for -N, -l, and -u. The scale-number is the
40              last two  digits  of  the  pre-cooked  index  filename  --  eg.,
41              index-205 is -P 5.
42
43              -P  0  should  be  good for images about 6 arcmin in size and it
44              goes in steps of sqrt(2), so:
45
46              -P 2 should work for images about 12 arcmin across
47
48              -P 4 should work for images about 24 arcmin across
49
50              -P 6 should work for images about 1 degree across
51
52              -P 8 should work for images about 2 degree across
53
54              -P 10 should work for images about 4 degree across etc... up  to
55              -P 19
56
57       -S column
58              Sort column (default: assume the input file is already sorted)
59
60       -f     Sort  in descending order (eg, for FLUX); default ascending (eg,
61              for MAG)
62
63       -A column
64              Specify the RA  column name in the  input  FITS  table  (default
65              "RA")
66
67       -D column
68              Specify  the  Dec  column  name in the input FITS table (default
69              "Dec")
70
71       -B val Cut any object whose sort-column value is  less  than  val;  for
72              mags this is a bright limit
73
74       -U     Healpix Nside for uniformization (default: same as -n)
75
76       -H big healpix
77              Big healpix; default is all-sky
78
79       -s Nside
80              Big healpix Nside; default is 1
81
82       -m margin
83              Add a margin of margin healpixels; default 0
84
85       -n sweeps
86              Sweeps (ie, number of stars per fine healpix grid cell); default
87              10
88
89       -r radius
90              Deduplication radius in arcseconds; default no deduplication
91
92       -j jitter
93              Positional error of stars in the reference catalog  (in  arcsec;
94              default 1)
95
96       -d dimquads
97              Number of stars in a "quad" (default 4).
98
99       -p passes
100              Number  of  rounds  of  quad-building  (ie,  number of quads per
101              healpix cell, default 16)
102
103       -R reuse
104              Number of times a star can be used (default: 8)
105
106       -L max-reuses
107              Make extra passes through the healpixes, increasing the -r reuse
108              limit each time, up to max-reuses.
109
110       -E     Scan through the catalog, checking which healpixes are occupied.
111
112       -I id  Set the unique ID of this index
113
114       -M     In-memory (don't use temp files)
115
116       -T     Don't delete temp files
117
118       -t dir Use this temp directory (default: /tmp)
119
120       -v     Add verbosity.
121

AUTHOR

123       The  Astrometry.net  team.  Principal  investigators  are David W. Hogg
124       (NYU) and Dustin Lang (CMU).
125

SEE ALSO

127       hpsplit (1), solve-field (1)
128       For a tutorial, see http://astrometry.net/doc/build-index.html
129
130
131
1320.56                               July 2015         BUILD-ASTROMETRY-INDEX(1)
Impressum