logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

solve-field - Main high-level command-line user interface.

Author

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

Description

       Main high-level command-line user interface for astrometry.net

       You  can  specify http:// or ftp:// URLs instead of filenames.  The "wget" or "curl" program will be used
       to retrieve the URL.

       The astrometry engine will take any image and return the astrometry world coordinate system (WCS),  ie  a
       standards-based  description  of the (usually nonlinear) transformation between image coordinates and sky
       coordinates with absolutely no “false positives” (but maybe some “no answers”). It will do its best, even
       when the input image has no or totally incorrect meta data.

Name

       solve-field - Main high-level command-line user interface.

Options

-h, --help
              Print the help message

       -v, --verbose
              Be more chatty. Repeat for even more verboseness

       -D, --dirdirectory
              Place all output files in the specified directory

       -o, --outfile
              Name the output files with this base name

       -b, --backend-configfile
              Use this config file for the "astrometry-engine" program

       --configfile
              Use this config file for the "astrometry-engine" program

       --batch
              Run astrometry-engine once, rather than once per input file

       -f, --files-on-stdin
              Read filenames to solve on stdin, one per line

       -p, --no-plots
              Don't create any plots of the results

       --plot-scalescale
              Scale the plots by this factor (eg, 0.25)

       --plot-bgfile
              Set the background image to use for plots (JPEG)

       -G, --use-wget
              Use wget instead of curl

       -O, --overwrite
              Overwrite output files if they already exist

       -K, --continue
              Don't overwrite output files if they already exist; continue a previous run

       -J, --skip-solved
              Skip input files for which the 'solved' output file already exists;  NOTE:  this  assumes  single-
              field input files

       --fits-image
              assume the input files are FITS images

       -N, --new-fitsfile
              Output filename of the new FITS file containing the WCS header; "none" to not create this file

       -Z, --kmzfile
              Create KMZ file for Google Sky. (requires wcs2kml)

       -i, --scampfile
              Create image object catalog for SCAMP

       -n, --scamp-configfile
              Create SCAMP config file snippet

       -U, --index-xylsfile
              Output filename for xylist containing the image coordinate of stars from the index

       --just-augment
              Just write the augmented xylist files; don't run astrometry-engine.

       --axyfile
              Output filename for augment xy list (axy)

       --temp-axy
              Write 'augmented xy list' (axy) file to a temp file

       --timestamp
              Add timestamps to log messages

       -7, --no-delete-temp
              Don't delete temp files (for debugging)

       -L, --scale-lowscale
              Lower bound of image scale estimate

       -H, --scale-highscale
              Upper bound of image scale estimate

       -u, --scale-unitsunits
              In what units are the lower and upper bounds? Choices:

              "degwidth", "degw", "dw"
                     width of the image, in degrees (default)

              "arcminwidth", "amw", "aw"
                     width of the image, in arcminutes

              "arcsecperpix", "app"
                     arcseconds per pixel

              "focalmm"
                     35-mm (width-based) equivalent focal length

       -8, --paritypos/neg
              Only check for matches with positive/negative parity (default: try both)

       -c, --code-tolerancedistance
              Matching distance for quads (default: 0.01)

       -E, --pixel-errorpixels
              For verification, size of pixel positional error (default: 1)

       -q, --quad-size-minfraction
              Minimum size of quads to try, as a fraction of the smaller image dimension, default: 0.1

       -Q, --quad-size-maxfraction
              Maximum size of quads to try, as a fraction of the image hypotenuse, default 1.0

       --odds-to-tune-upodds
              Odds ratio at which to try tuning up a match that isn't good enough to solve (default: 1e6)

       --odds-to-solveodds
              Odds ratio at which to consider a field solved (default: 1e9)

       --odds-to-rejectodds
              Odds ratio at which to reject a hypothesis (default: 1e-100)

       --odds-to-stop-lookingodds
              Odds ratio at which to stop adding stars when evaluating a hypothesis (default: HUGE_VAL)

       --use-source-extractor
              Use Source Extractor rather than built-in image2xy to find sources

       --source-extractor-configfile
              Use the given Source Extractor config file. Note that CATALOG_NAME and CATALOG_TYPE values will be
              over-ridden by command-line values.  This option implies --use-source-extractor.

       --source-extractor-pathfile
              Use  the  given path to the Source Extractor executable. Default: just 'source-extractor', assumed
              to be in your PATH. Note that you can give command line args here too (but put  them  in  quotes),
              eg:

              --source-extractor-path 'source-extractor -DETECT_TYPE CCD'.

              This option implies --use-source-extractor.

       -3RA, --raRA
              RA of field center for search, format: degrees or hh:mm:ss

       -4DEC, --decDEC
              DEC of field center for search, format: degrees or hh:mm:ss

       -5degrees, --radiusdegrees
              Only search in indexes within 'radius' of the field center given by --ra and --dec-d, --depthnumber or range
              Number  of  field  objects to look at, or range of numbers; 1 is the brightest star, so "-d 10" or
              "-d 1-10" mean look at the top ten brightest stars only.

       --objsint
              Cut the source list to have this many items (after sorting, if applicable).

       -l, --cpulimitseconds
              Give up solving after the specified number of seconds of CPU time

       -r, --resort
              Sort the star brightnesses by background-subtracted flux; the default is to sort using acompromise
              between background-subtracted and non-background-subtracted flux

       -6, --extensionint
              FITS extension to read image from.

       --invert
              Invert the image (for black-on-white images)

       -z, --downsampleint
              Downsample the image by factor int before running source extraction

       --no-background-subtraction
              Don't try to estimate a smoothly-varying sky background during source extraction.

       --sigmafloat
              Set the noise level in the image

       -9, --no-remove-lines
              Don't remove horizontal and vertical overdensities of sources.

       --uniformizeint
              Select sources uniformly using roughly this many boxes (0=disable; default 10)

       --no-verify-uniformize
              Don't uniformize the field stars during verification

       --no-verify-dedup
              Don't deduplicate the field stars during verification

       -0, --no-fix-sdss
              Don't try to fix SDSS idR files.

       -C, --cancelfile
              Filename whose creation signals the process to stop

       -S, --solvedfile
              Output file to mark that the solver succeeded

       -I, --solved-infile
              Input filename for solved file

       -M, --matchfile
              Output filename for match file

       -R, --rdlsfile
              Output filename for RDLS file

       --sort-rdlscolumn
              Sort the RDLS file by this column; default  is  ascending;  use  "-column"  to  sort  "column"  in
              descending order instead.

       --tagcolumn
              Grab tag-along column from index into RDLS file

       --tag-all
              Grab all tag-along columns from index into RDLS file

       -j, --scamp-reffile
              Output filename for SCAMP reference catalog

       -B, --corrfile
              Output filename for correspondences

       -W, --wcsfile
              Output filename for WCS file

       -P, --pnmfile
              Save the PNM file as file-k, --keep-xylistfile
              Save the (unaugmented) xylist to file-A, --dont-augment
              Quit after writing the unaugmented xylist

       -V, --verifyfile
              Try to verify an existing WCS file

       --verify-extextension
              HDU from which to read WCS to verify; set this BEFORE --verify-y, --no-verify
              Ignore existing WCS headers in FITS input images

       -g, --guess-scale
              Try to guess the image scale from the FITS headers

       --crpix-center
              Set the WCS reference point to the image center

       --crpix-xpix
              Set the WCS reference point to the given position

       --crpix-ypix
              Set the WCS reference point to the given position

       -T, --no-tweak
              Don't fine-tune WCS by computing a SIP polynomial

       -t, --tweak-orderint
              Polynomial order of SIP WCS corrections

       -m, --temp-dirdir
              Where to put temp files, default /tmpThefollowingoptionsarevalidforxylistinputsonly:-F, --fieldsnumberorrange
              The FITS extension(s) to solve, inclusive

       -w, --widthpixels
              Specify the field width

       -e, --heightpixels
              Specify the field height

       -X, --x-columncolumn-name
              The FITS column containing the X coordinate of the sources

       -Y, --y-columncolumn-name
              The FITS column containing the Y coordinate of the sources

       -s, --sort-columncolumn-name
              The FITS column that should be used to sort the sources

       -a, --sort-ascending
              Sort in ascending order (smallest first); default is descending order

       Note that most output files can be disabled by setting the filename to "none".  (If you have a sick sense
       of humour and you really want to name your output file "none", you can use "./none" instead.)

See Also

http://astrometry.net

0.56                                                July 2015                                     SOLVE-FIELD(1)

Synopsis

solve-field [options] [image-file-1image-file-2 ...]  [xyls-file-1xyls-file-2 ...]

See Also