1SOLVE-FIELD(1) astrometry.net SOLVE-FIELD(1)
2
6 solve-field - Main high-level command-line user interface.
7
9 solve-field [options] [image-file-1 image-file-2 ...] [xyls-file-1
10 xyls-file-2 ...]
11
13 Main high-level command-line user interface for astrometry.net
14 You can specify http:// or ftp:// URLs instead of filenames. The
16 "wget" or "curl" program will be used to retrieve the URL.
17 The astrometry engine will take any image and return the astrometry
19 world coordinate system (WCS), ie a standards-based description of the
20 (usually nonlinear) transformation between image coordinates and sky
21 coordinates with absolutely no “false positives” (but maybe some “no
22 answers”). It will do its best, even when the input image has no or to‐
23 tally incorrect meta data.
24
26 -h, --help
27 Print the help message
28 -v, --verbose
30 Be more chatty. Repeat for even more verboseness
31 -D, --dir directory
33 Place all output files in the specified directory
34 -o, --out file
36 Name the output files with this base name
37 -b, --backend-config file
39 Use this config file for the "astrometry-engine" program
40 --config file
42 Use this config file for the "astrometry-engine" program
43 --batch
45 Run astrometry-engine once, rather than once per input file
46 -f, --files-on-stdin
48 Read filenames to solve on stdin, one per line
49 -p, --no-plots
51 Don't create any plots of the results
52 --plot-scale scale
54 Scale the plots by this factor (eg, 0.25)
55 --plot-bg file
57 Set the background image to use for plots (JPEG)
58 -G, --use-wget
60 Use wget instead of curl
61 -O, --overwrite
63 Overwrite output files if they already exist
64 -K, --continue
66 Don't overwrite output files if they already exist; continue a
67 previous run
68 -J, --skip-solved
70 Skip input files for which the 'solved' output file already ex‐
71 ists; NOTE: this assumes single-field input files
72 --fits-image
74 assume the input files are FITS images
75 -N, --new-fits file
77 Output filename of the new FITS file containing the WCS header;
78 "none" to not create this file
79 -Z, --kmz file
81 Create KMZ file for Google Sky. (requires wcs2kml)
82 -i, --scamp file
84 Create image object catalog for SCAMP
85 -n, --scamp-config file
87 Create SCAMP config file snippet
88 -U, --index-xyls file
90 Output filename for xylist containing the image coordinate of
91 stars from the index
92 --just-augment
94 Just write the augmented xylist files; don't run astrometry-en‐
95 gine.
96 --axy file
98 Output filename for augment xy list (axy)
99 --temp-axy
101 Write 'augmented xy list' (axy) file to a temp file
102 --timestamp
104 Add timestamps to log messages
105 -7, --no-delete-temp
107 Don't delete temp files (for debugging)
108 -L, --scale-low scale
110 Lower bound of image scale estimate
111 -H, --scale-high scale
113 Upper bound of image scale estimate
114 -u, --scale-units units
116 In what units are the lower and upper bounds? Choices:
117 "degwidth", "degw", "dw"
119 width of the image, in degrees (default)
120 "arcminwidth", "amw", "aw"
122 width of the image, in arcminutes
123 "arcsecperpix", "app"
125 arcseconds per pixel
126 "focalmm"
128 35-mm (width-based) equivalent focal length
129 -8, --parity pos/neg
131 Only check for matches with positive/negative parity (default:
132 try both)
133 -c, --code-tolerance distance
135 Matching distance for quads (default: 0.01)
136 -E, --pixel-error pixels
138 For verification, size of pixel positional error (default: 1)
139 -q, --quad-size-min fraction
141 Minimum size of quads to try, as a fraction of the smaller image
142 dimension, default: 0.1
143 -Q, --quad-size-max fraction
145 Maximum size of quads to try, as a fraction of the image hy‐
146 potenuse, default 1.0
147 --odds-to-tune-up odds
149 Odds ratio at which to try tuning up a match that isn't good
150 enough to solve (default: 1e6)
151 --odds-to-solve odds
153 Odds ratio at which to consider a field solved (default: 1e9)
154 --odds-to-reject odds
156 Odds ratio at which to reject a hypothesis (default: 1e-100)
157 --odds-to-stop-looking odds
159 Odds ratio at which to stop adding stars when evaluating a hy‐
160 pothesis (default: HUGE_VAL)
161 --use-source-extractor
163 Use Source Extractor rather than built-in image2xy to find
164 sources
165 --source-extractor-config file
167 Use the given Source Extractor config file. Note that CATA‐
168 LOG_NAME and CATALOG_TYPE values will be over-ridden by com‐
169 mand-line values. This option implies --use-source-extractor.
170 --source-extractor-path file
172 Use the given path to the Source Extractor executable. Default:
173 just 'source-extractor', assumed to be in your PATH. Note that
174 you can give command line args here too (but put them in
175 quotes), eg:
176 --source-extractor-path 'source-extractor -DETECT_TYPE CCD'.
178 This option implies --use-source-extractor.
180 -3 RA, --ra RA
182 RA of field center for search, format: degrees or hh:mm:ss
183 -4 DEC, --dec DEC
185 DEC of field center for search, format: degrees or hh:mm:ss
186 -5 degrees, --radius degrees
188 Only search in indexes within 'radius' of the field center given
189 by --ra and --dec
190 -d, --depth number or range
192 Number of field objects to look at, or range of numbers; 1 is
193 the brightest star, so "-d 10" or "-d 1-10" mean look at the top
194 ten brightest stars only.
195 --objs int
197 Cut the source list to have this many items (after sorting, if
198 applicable).
199 -l, --cpulimit seconds
201 Give up solving after the specified number of seconds of CPU
202 time
203 -r, --resort
205 Sort the star brightnesses by background-subtracted flux; the
206 default is to sort using acompromise between background-sub‐
207 tracted and non-background-subtracted flux
208 -6, --extension int
210 FITS extension to read image from.
211 --invert
213 Invert the image (for black-on-white images)
214 -z, --downsample int
216 Downsample the image by factor int before running source extrac‐
217 tion
218 --no-background-subtraction
220 Don't try to estimate a smoothly-varying sky background during
221 source extraction.
222 --sigma float
224 Set the noise level in the image
225 -9, --no-remove-lines
227 Don't remove horizontal and vertical overdensities of sources.
228 --uniformize int
230 Select sources uniformly using roughly this many boxes (0=dis‐
231 able; default 10)
232 --no-verify-uniformize
234 Don't uniformize the field stars during verification
235 --no-verify-dedup
237 Don't deduplicate the field stars during verification
238 -0, --no-fix-sdss
240 Don't try to fix SDSS idR files.
241 -C, --cancel file
243 Filename whose creation signals the process to stop
244 -S, --solved file
246 Output file to mark that the solver succeeded
247 -I, --solved-in file
249 Input filename for solved file
250 -M, --match file
252 Output filename for match file
253 -R, --rdls file
255 Output filename for RDLS file
256 --sort-rdls column
258 Sort the RDLS file by this column; default is ascending; use
259 "-column" to sort "column" in descending order instead.
260 --tag column
262 Grab tag-along column from index into RDLS file
263 --tag-all
265 Grab all tag-along columns from index into RDLS file
266 -j, --scamp-ref file
268 Output filename for SCAMP reference catalog
269 -B, --corr file
271 Output filename for correspondences
272 -W, --wcs file
274 Output filename for WCS file
275 -P, --pnm file
277 Save the PNM file as file
278 -k, --keep-xylist file
280 Save the (unaugmented) xylist to file
281 -A, --dont-augment
283 Quit after writing the unaugmented xylist
284 -V, --verify file
286 Try to verify an existing WCS file
287 --verify-ext extension
289 HDU from which to read WCS to verify; set this BEFORE --verify
290 -y, --no-verify
292 Ignore existing WCS headers in FITS input images
293 -g, --guess-scale
295 Try to guess the image scale from the FITS headers
296 --crpix-center
298 Set the WCS reference point to the image center
299 --crpix-x pix
301 Set the WCS reference point to the given position
302 --crpix-y pix
304 Set the WCS reference point to the given position
305 -T, --no-tweak
307 Don't fine-tune WCS by computing a SIP polynomial
308 -t, --tweak-order int
310 Polynomial order of SIP WCS corrections
311 -m, --temp-dir dir
313 Where to put temp files, default /tmp
314 The following options are valid for xylist inputs only:
316 -F, --fields number or range
317 The FITS extension(s) to solve, inclusive
318 -w, --width pixels
320 Specify the field width
321 -e, --height pixels
323 Specify the field height
324 -X, --x-column column-name
326 The FITS column containing the X coordinate of the sources
327 -Y, --y-column column-name
329 The FITS column containing the Y coordinate of the sources
330 -s, --sort-column column-name
332 The FITS column that should be used to sort the sources
333 -a, --sort-ascending
335 Sort in ascending order (smallest first); default is descending
336 order
337 Note that most output files can be disabled by setting the filename to
339 "none". (If you have a sick sense of humour and you really want to
340 name your output file "none", you can use "./none" instead.)
341
343 The Astrometry.net team. Principal investigators are David W. Hogg
344 (NYU) and Dustin Lang (CMU).
345
347 http://astrometry.net
3480.56 July 2015 SOLVE-FIELD(1)