astquery1

Usage

Overview

query is part of GNU Astronomy Utilities 0.23. 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.

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/