Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
QUERY(1)			  User Commands 			QUERY(1)

NAME
     query - query remote data servers and download

SYNOPSIS
     astquery [OPTION...] DATABASE

DESCRIPTION
     query  is	part  of  GNU  Astronomy  Utilities 0.24.  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 pro-
     grams.

     For more information, please run any of the following commands. In particu-
     lar the second contains a very comprehensive explanation of query's invoca-
     tion: expected input(s), output(s), and a full description of all	the  op-
     tions.

     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 op-
     tional 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 (C) 2015-2025 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.24	  November 2025 			QUERY(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=astquery&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help