.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH QUERY "1" "February 2024" "GNU Astronomy Utilities 0.22" "User Commands"
.SH NAME
query \- query remote data servers and download
.SH SYNOPSIS
.B astquery
[\fI\,OPTION\/\fR...] \fI\,DATABASE\/\fR
.SH 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.
.PP
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.
.TP
All options and their values:
$ astquery \fB\-P\fR
.TP
Inputs/Outputs and options:
$ info astquery
.TP
Full section in manual/book:
$ info query
.TP
Full Gnuastro manual/book:
$ info gnuastro
.PP
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:
.IP
\f(CW$ info help-gnuastro\fR
.PP
query options:
.IP
Input:
.TP
\fB\-\-ccol\fR=\fI\,STR\/\fR,STR
Coordinate (RA, Dec) column names in dataset.
.TP
\fB\-h\fR, \fB\-\-hdu\fR=\fI\,STR\/\fR/INT
Extension name or number of input data.
.TP
\fB\-L\fR, \fB\-\-limitinfo\fR=\fI\,STR\/\fR
Only retrieve dataset info. with this string.
.TP
\fB\-Q\fR, \fB\-\-query\fR=\fI\,STR\/\fR
The raw query as a simple string.
.TP
\fB\-v\fR, \fB\-\-overlapwith\fR=\fI\,FITS\/\fR
Set query region to overlap with this image.
.IP
Output:
.TP
\fB\-\-dry\-run\fR
Only print the download command, don't run it.
.TP
\fB\-D\fR, \fB\-\-dontdelete\fR
Don't delete output if it exists.
.TP
\fB\-i\fR, \fB\-\-information\fR
Print database or dataset information.
.TP
\fB\-k\fR, \fB\-\-keeprawdownload\fR
Don't delete raw downloaded file.
.TP
\fB\-K\fR, \fB\-\-keepinputdir\fR
Keep input directory for automatic output.
.TP
\fB\-\-outfitsnocommit\fR
No Git commit in 0\-th HDU of output FITS.
.TP
\fB\-\-outfitsnoconfig\fR
No metadata in 0\-th HDU of output FITS.
.TP
\fB\-\-outfitsnodate\fR
No 'DATE' in 0\-th HDU of output FITS.
.TP
\fB\-\-outfitsnoversions\fR
No versions in 0\-th HDU of output FITS.
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,STR\/\fR
Output file name.
.TP
\fB\-\-tableformat\fR=\fI\,STR\/\fR
Table fmt: 'fits\-ascii', 'fits\-binary', 'txt'.
.TP
\fB\-\-wcslinearmatrix\fR=\fI\,STR\/\fR
WCS linear matrix of output ('pc' or 'cd').
.IP
Generate query internally (not compatible with '\-\-query'):
.TP
\fB\-b\fR, \fB\-\-noblank\fR=\fI\,STR[\/\fR,STR]
No rows with blank value in given column(s).
.TP
\fB\-c\fR, \fB\-\-column\fR=\fI\,STR\/\fR
Column names to download from catalog.
.TP
\fB\-C\fR, \fB\-\-center\fR=\fI\,FLT\/\fR,FLT
Center coords. to select by region in sky.
.TP
\fB\-g\fR, \fB\-\-range\fR=\fI\,STR\/\fR,FLT:FLT
Range of selected targets in given column.
.TP
\fB\-H\fR, \fB\-\-head\fR=\fI\,INT\/\fR
Only download given number of top rows.
.TP
\fB\-r\fR, \fB\-\-radius\fR=\fI\,FLT\/\fR
Radius around \fB\-\-center\fR to select targets.
.TP
\fB\-\-sort\fR=\fI\,STR[\/\fR,STR]
Sort based on values of given columns.
.TP
\fB\-s\fR, \fB\-\-dataset\fR=\fI\,STR\/\fR
Name of dataset in database.
.TP
\fB\-w\fR, \fB\-\-width\fR=\fI\,FLT[\/\fR,FLT]
Width of box around \fB\-\-center\fR to select targets.
.IP
Operating modes:
.TP
\-?, \fB\-\-help\fR
give this help list
.TP
\fB\-\-checkconfig\fR
List all config files and variables read.
.TP
\fB\-\-cite\fR
BibTeX citation for this program.
.TP
\fB\-\-config\fR=\fI\,STR\/\fR
Read configuration file STR immediately.
.TP
\fB\-\-config\-prefix\fR=\fI\,STR\/\fR
Custom prefix of option names config files.
.TP
\fB\-\-lastconfig\fR
Do not parse any more configuration files.
.TP
\fB\-\-onlyversion\fR=\fI\,STR\/\fR
Only run if the program version is STR.
.TP
\fB\-P\fR, \fB\-\-printparams\fR
Print parameter values to be used and abort.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Only report errors, remain quiet about steps.
.TP
\fB\-S\fR, \fB\-\-setdirconf\fR
Set default values for this directory and abort.
.TP
\fB\-\-usage\fR
give a short usage message
.TP
\fB\-U\fR, \fB\-\-setusrconf\fR
Set default values for this user and abort.
.TP
\fB\-V\fR, \fB\-\-version\fR
print program version
.PP
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
.PP
GNU Astronomy Utilities home page: http://www.gnu.org/software/gnuastro/
.SH "REPORTING BUGS"
Report bugs to bug\-gnuastro@gnu.org.
.SH COPYRIGHT
Copyright \(co 2015\-2024 Free Software Foundation, Inc.
License GPLv3+: GNU General public license version 3 or later.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.PP
Written/developed by Mohammad Akhlaghi
.SH "SEE ALSO"
The full documentation for
.B query
is maintained as a Texinfo manual.  If the
.B info
and
.B query
programs are properly installed at your site, the command
.IP
.B info query
.PP
should give you access to the complete manual.