gnuastro (0.22)

(root)/
share/
man/
man1/
astscript-psf-select-stars.1
ASTSCRIPT-PSF-SELECT-STARS(1) User Commands ASTSCRIPT-PSF-SELECT-STARS(1)

NAME
astscript-psf-select-stars - Select good stars for constructing the PSF

SYNOPSIS
astscript-psf-select-stars [OPTIONS] image.fits

DESCRIPTION
Build a catalogue of "good stars" that will be considered for constructing an extended and non parametric PSF.
Here, "good stars" means that they don't have close objects that affect it sourrondings and consequently they are
not contaminated. The script will construct a catalog of stars from reference datasets (Gaia) if the user does
not provide another one. In addition to this, other parameters like the axis ratio are considered to filter the
sample and select only proper stars.

astscript-psf-select-stars options:
Input:

-h, --hdu=STR/INT
HDU/Extension name of number of the input file.

-S, --segmented=STR
Segmentation file obtained by Segment (astsegment).

-D, --dataset=STR
Query dataset ("gaia --dataset=edr3", etc.).

-r, --racolumn=STR
Right Ascension (R.A.) column name.

-d, --deccolumn=STR
Declination (Dec) column name.

-f, --field=STR
Magnitude column name ("phot_rp_mean_mag", for Gaia).

-p, --parallaxanderrorcolumn=STR,STR The name of the parallax column.

-m, --magnituderange=FLT,FLT The range of magnitude.

-Q, --minaxisratio=FLT
Minimum axis ratio to be accepted (default to 0.9).

-M, --mindistdeg=FLT
Minimum distance to more bright neighbour stars. to be accepted, in degrees.

-c, --catalog=STR
Catalog of stars containing: ra, dec, magnitude, parrallax, parrallax_error.

-a, --matchaperturedeg=FLT Aperture, in pixels, to match catalogue ra and
dec coordinates with clumps' ra and dec.

-F, --faintmagdiff
The difference from the faintest star which the user will be determined the faintest star in '--magnitud‐
erange' option.

-b, --brightmag
The limit for selecting wider range of bright stars.

Output:

-o, --output
Output table with the object coordinates.

-t, --tmpdir
Directory to keep temporary files.

-k, --keeptmp
Keep temporal/auxiliar files.

Operating mode:

-h, --help
Print this help.

--cite BibTeX citation for this program.

-q, --quiet
Don't print any extra information in stdout.

-V, --version
Print program version.

Mandatory or optional arguments to long options are also mandatory or optional for any corresponfing short op‐
tions.

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

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

COPYRIGHT
Copyright © 2020-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 Sepideh Eskandarlou.

SEE ALSO
The full documentation for astscript-psf-select-stars is maintained as a Texinfo manual. If the info and ast‐
script-psf-select-stars programs are properly installed at your site, the command

info astscript-psf-select-stars

should give you access to the complete manual.

GNU Astronomy Utilities 0.22 February 2024 ASTSCRIPT-PSF-SELECT-STARS(1)