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.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 par-
       ticular 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/gnuas-
       tro/

REPORTING BUGS
       Report bugs to bug-gnuastro@gnu.org.

COPYRIGHT
       Copyright (C) 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.23	   July	2024			      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.0>

home | help