NAME

       query - query remote data servers and download

SYNOPSIS

       astquery [OPTION...] DATABASE

DESCRIPTION

       query  is  part  of  GNU Astronomy Utilities 0.22.  query is just a place holder used as a minimal set of
       files and functions necessary for a program in Gnuastro. It can be used for learning or as a template  to
       build new programs.

       For  more information, please run any of the following commands. In particular the second contains a very
       comprehensive explanation of query's invocation: expected input(s), output(s), and a full description  of
       all the options.

       All options and their values:
              $ astquery -P

       Inputs/Outputs and options:
              $ info astquery

       Full section in manual/book:
              $ info query

       Full Gnuastro manual/book:
              $ info gnuastro

       If  you  couldn't find your answer in the manual, you can get direct help from experienced Gnuastro users
       and developers. For more information, please run:

              $ info help-gnuastro

       query options:

              Input:

       --ccol=STR,STR
              Coordinate (RA, Dec) column names in dataset.

       -h, --hdu=STR/INT
              Extension name or number of input data.

       -L, --limitinfo=STR
              Only retrieve dataset info. with this string.

       -Q, --query=STR
              The raw query as a simple string.

       -v, --overlapwith=FITS
              Set query region to overlap with this image.

              Output:

       --dry-run
              Only print the download command, don't run it.

       -D, --dontdelete
              Don't delete output if it exists.

       -i, --information
              Print database or dataset information.

       -k, --keeprawdownload
              Don't delete raw downloaded file.

       -K, --keepinputdir
              Keep input directory for automatic output.

       --outfitsnocommit
              No Git commit in 0-th HDU of output FITS.

       --outfitsnoconfig
              No metadata in 0-th HDU of output FITS.

       --outfitsnodate
              No 'DATE' in 0-th HDU of output FITS.

       --outfitsnoversions
              No versions in 0-th HDU of output FITS.

       -o, --output=STR
              Output file name.

       --tableformat=STR
              Table fmt: 'fits-ascii', 'fits-binary', 'txt'.

       --wcslinearmatrix=STR
              WCS linear matrix of output ('pc' or 'cd').

              Generate query internally (not compatible with '--query'):

       -b, --noblank=STR[,STR]
              No rows with blank value in given column(s).

       -c, --column=STR
              Column names to download from catalog.

       -C, --center=FLT,FLT
              Center coords. to select by region in sky.

       -g, --range=STR,FLT:FLT
              Range of selected targets in given column.

       -H, --head=INT
              Only download given number of top rows.

       -r, --radius=FLT
              Radius around --center to select targets.

       --sort=STR[,STR]
              Sort based on values of given columns.

       -s, --dataset=STR
              Name of dataset in database.

       -w, --width=FLT[,FLT]
              Width of box around --center to select targets.

              Operating modes:

       -?, --help
              give this help list

       --checkconfig
              List all config files and variables read.

       --cite BibTeX citation for this program.

       --config=STR
              Read configuration file STR immediately.

       --config-prefix=STR
              Custom prefix of option names config files.

       --lastconfig
              Do not parse any more configuration files.

       --onlyversion=STR
              Only run if the program version is STR.

       -P, --printparams
              Print parameter values to be used and abort.

       -q, --quiet
              Only report errors, remain quiet about steps.

       -S, --setdirconf
              Set default values for this directory and abort.

       --usage
              give a short usage message

       -U, --setusrconf
              Set default values for this user and abort.

       -V, --version
              print program version

       Mandatory or optional arguments to long options are also mandatory  or  optional  for  any  corresponding
       short options.

       GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/

REPORTING BUGS

       Report bugs to bug-gnuastro@gnu.org.

COPYRIGHT

       Copyright  © 2015-2024 Free Software Foundation, Inc.  License GPLv3+: GNU General public license version
       3 or later.
       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to  the  extent
       permitted by law.

       Written/developed by Mohammad Akhlaghi

SEE ALSO

       The  full  documentation for query is maintained as a Texinfo manual.  If the info and query programs are
       properly installed at your site, the command

              info query

       should give you access to the complete manual.

GNU Astronomy Utilities 0.22                      February 2024                                         QUERY(1)