Man page - astmkcatalog(1)

Packages contains this manual

Package:  gnuastro
apt-get install gnuastro

Manuals in package:
• astscript-ds9-region(1)
• astmkcatalog(1)
• astcrop(1)
• astscript-zeropoint(1)
• astarithmetic(1)
• astwarp(1)
• astscript-pointing-simulate(1)
• astscript-psf-select-stars(1)
• astquery(1)
• astsegment(1)
• astnoisechisel(1)
• astfits(1)
• astscript-radial-profile(1)
• astconvolve(1)
• astscript-psf-unite(1)
• astcosmiccal(1)
• astmkprof(1)
• astscript-sort-by-night(1)
• astconvertt(1)
• astscript-psf-stamp(1)
• astscript-psf-scale-factor(1)
• astmatch(1)
• astscript-psf-subtract(1)
• astscript-fits-view(1)
• asttable(1)
• aststatistics(1)
Documentations in package:
• gnuastro

Manual

MAKECATALOG

NAME
SYNOPSIS
DESCRIPTION
REPORTING BUGS
COPYRIGHT
SEE ALSO

---

NAME

MakeCatalog - Make a catalog from labeled input images

SYNOPSIS

astmkcatalog [ OPTION ...] ASTRdata

DESCRIPTION

MakeCatalog is part of GNU Astronomy Utilities 0.23. MakeCatalog will create a catalog from an input, labeled, and noise images.

For more information, please run any of the following commands. In particular the second contains a very comprehensive explanation of MakeCatalog’s invocation: expected input(s), output(s), and a full description of all the options.
All options and their values:

$ astmkcatalog -P

Inputs/Outputs and options:

$ info astmkcatalog

Full section in manual/book:

$ info MakeCatalog

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

MakeCatalog options:

Input:

--clumpshdu = STR

Clump labels extension name or number.

--forcereadstd

Read STD even if no columns need it.

-h , --hdu = STR /INT

Extension name or number of input data.

-l , --clumpsfile = FITS

Dataset containing clump labels.

--sigmaclip = FLT ,FLT

Sigma-clip column multiple and tolerance.

--skyhdu = STR

Sky image extension name or number.

--stdhdu = STR

Sky STD extension name or number.

--subtractsky

Subtract the Sky dataset from the values.

-s , --insky = FITS /FLT

Input Sky value or file.

-t , --instd = STR /FLT

Sky standard deviation value or dataset.

--valueshdu = STR

Name or number of extension containing values.

--variance

STD input dataset is actually variance.

-v , --valuesfile = FITS

Values/brightness dataset.

--zeropoint = FLT

Zeropoint magnitude of input dataset.

Tessellation (tile grid):

--checktiles

Tile IDs in an image, the size of input.

-F , --remainderfrac = FLT

Fraction of remainder to split last tile.

--interpmetric = STR

Interpolation metric (radial, manhattan).

-M , --numchannels = INT[ ,..] No. of channels in dim.s (FITS order).

--oneelempertile

Display 1 element/tile, not full input res.

-Z , --tilesize = INT[ ,INT]

Regular tile size on dim.s (FITS order).

Output:

-C , --clumpscat

Make a clumps catalog also.

-D , --dontdelete

Don’t delete output if it exists.

--inbetweenints

Keep rows (integer ids) with no labels.

-K , --keepinputdir

Keep input directory for automatic output.

--noclumpsort

Don’t sort the clumps catalog by ID.

--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.

--sfmagarea = FLT

Surface brightness area (in arcsecondsˆ2).

--sfmagnsigma = FLT

Surface brightness multiple of Sky STD.

--tableformat = STR

Table fmt: ’fits-ascii’, ’fits-binary’, ’txt’.

--wcslinearmatrix = STR

WCS linear matrix of output (’pc’ or ’cd’).

Upper limit magnitude settings:

--checkuplim = INT[ ,INT] Check random distribution for one label.

-e , --envseed

Use GSL_RNG_SEED environment variable for seed.

--upmaskfile = FITS

Mask image file name only for upper limit.

--upmaskhdu = STR

Mask image HDU only for upper limit.

--upnsigma = FLT

Multiple of sigma to define upperlimit.

--upnum = INT

Number of randomly positioned samples

--uprange = INT ,INT

Range of random positions (pix) around target.

--upsigmaclip = FLT ,FLT

Sigma multiple and, tolerance or number.

Settings for other columns:

--frac-max = FLT[ ,FLT]

Fraction(s) in --frac-max * options.

--spatialresolution = FLT

Spatial resolution (for surf. brightness err).

Identifier columns

--id-in-host-obj

ID of clump in host object.

-i , --ids

All IDs of objects and clumps.

-j , --host-obj-id

ID of object hosting this clump.

--obj-id

Object label/ID.

Positional (pixel/image) measurements

--area-max-val

Number of pixels used in ’--max-val-*’.

--area-min-val

Number of pixels used in ’--min-val-*’.

--clumps-geo-x

Geometric center of all clumps in obj. (X).

--clumps-geo-y

Geometric center of all clumps in obj. (Y).

--clumps-geo-z

Geometric center of all clumps in obj. (Z).

--clumps-x

Flux.wht center of all clumps in obj. (X).

--clumps-y

Flux.wht center of all clumps in obj. (Y).

--clumps-z

Flux.wht center of all clumps in obj. (Z).

--geo-x

Geometric center in first FITS axis.

--geo-y

Geometric center in second FITS axis.

--geo-z

Geometric center in third FITS axis.

--max-val-x

Maximum value’s X axis position.

--max-val-y

Maximum value’s Y axis position.

--max-val-z

Maximum value’s Z axis position

--max-x

Maximum X axis position.

--max-y

Maximum Y axis position.

--max-z

Maximum Z axis position.

--min-val-x

Minimum value’s X axis position.

--min-val-y

Minimum value’s Y axis position.

--min-val-z

Minimum value’s Z axis position.

--min-x

Minimum X axis position.

--min-y

Minimum Y axis position.

--min-z

Minimum Z axis position

-x , --x

Flux weighted center in first FITS axis.

-y , --y

Flux weighted center in second FITS axis.

-z , --z

Flux weighted center in third FITS axis.

Positional (WCS) measurements

--clumps-geo-w1

Geometric center of all clumps in 1st WCS.

--clumps-geo-w2

Geometric center of all clumps in 2nd WCS.

--clumps-geo-w3

Geometric center of all clumps in 3rd WCS.

--clumps-w1

Flux.wht center of all clumps in 1st WCS.

--clumps-w2

Flux.wht center of all clumps in 2nd WCS.

--clumps-w3

Flux.wht center of all clumps in 3rd WCS.

-d , --dec

Flux weighted center declination.

--geo-w1

Geometric center in first WCS axis.

--geo-w2

Geometric center in second WCS axis.

--geo-w3

Geometric center in third WCS axis.

-r , --ra

Flux weighted center right ascension.

	--w1		Flux weighted center in first WCS axis.
	--w2		Flux weighted center in second WCS axis.
	--w3		Flux weighted center in third WCS axis.

Brightness/magnitude (only using pixel value/error) measurements

--clumps-magnitude

Magnitude of all clumps in object.

--clumps-sum

Brightness of clumps in an object.

--magnitude-error

Magnitude error of objects or clumps.

--maximum

Maximum value (mean of top three pixels)

--mean

Mean of values in object/clump.

--median

Median of values in object/clump.

-m , --magnitude

Total magnitude of objects or clumps.

--river-max

Maximum river value around clump.

--river-mean

Mean river value surrounding a clump.

--river-min

Minimum river value around clump.

--river-num

Number of river pixels around a clump.

--sigclip-mean

Mean after Sigma-clipping

--sigclip-median

Median after Sigma-clipping

--sigclip-number

Number of pixels in Sigma-clipped measurement.

--sigclip-std

Standard deviation after Sigma-clipping

--sky

Sky value (per pixel).

--sky-std

Sky standard deviation (per pixel).

	--sn		Signal to noise ratio of objects or clumps.
	--std		Standard dev. of values in object/clump.
	--sum		Sum of pixel values in each label.

--sum-error

Error (1-sigma) in measuring sum.

--sum-no-river

Sky (not river) subtracted clump sum.

--upperlimit

Upper-limit value, use other options to config.

--upperlimit-mag

Upper-limit mag. use other options to config.

--upperlimit-onesigma

Upper-limit one sigma value.

--upperlimit-quantile

Quantile in random distribution (max 1).

--upperlimit-sigma

Place in random distribution (sigma multiple).

--upperlimit-skew

(Mean-Median)/STD of random distribution.

Surface brightness measurements (all: mag/arcsecˆ2)

--half-max-sb

Surface brightness within half the maximum.

--half-sum-sb

Surface brightness within --halfsumarea .

--sb

Surface brightness.

--sb-error

Surface brightness error from STD/VAR image.

--sigclip-mean-sb

Surface brightness of sigclip-mean (1 pix area).

--sigclip-mean-sb-delta

sigclip-mean-sb delta from sigclip’d STD.

--sigclip-std-sb

Surface brightness of sigclip-std (1 pix area).

--upperlimit-sb

Upper-limit surface brightness.

Morphology/shape (non-parametric) measurements

--area

Number of non-blank valued pixels.

--area-arcsec2

Area of labeled region in arcsecˆ2.

--area-xy

Projected area in first two dimensions.

--clumps-area

Non-blank area covered by clumps.

--frac-max1-area

Area containing 1st fraction of maximum.

--frac-max1-radius

Radius calculated from --fracmaxarea1 .

--frac-max1-sum

Sum of pixels brighter than 1st frac. of max.

--frac-max2-area

Area containing 2nd fraction of maximum.

--frac-max2-radius

Radius calculated from --fracmaxarea2 .

--frac-max2-sum

Sum of pixels brighter than 2nd frac. of max.

--fwhm

Full width at half max (non-parametric).

--geo-area

Area labled region (irrespective of value).

--geo-area-xy

Projected geo-area in first two dimensions.

--half-max-area

No. pixels valued above half the max.

--half-max-radius

Radius at half the maximum (non-parametric).

--half-max-sum

Sum of pixels above half the maximum.

--half-sum-area

Area containing half of --brightness .

--half-sum-radius

Radius calculated from --halfsumarea .

--num-clumps

Number of clumps in this object.

--weight-area

Area used for value weighted positions.

Morphology/shape (elliptical) measurements

--axis-ratio

Flux weighted axis ratio.

--geo-axis-ratio

Geometric (ignoring values, only lab) axis ratio.

--geo-position-angle

Geometric (ignoring values, only lab) pos. angle.

--geo-semi-major

Geometric RMS along major axis (ignoring value).

--geo-semi-minor

Geometric RMS along minor axis (ignoring value).

--position-angle

Flux weighted position angle.

--semi-major

RMS along major axis (in pixels).

--semi-minor

RMS along minor axis (in pixels).

Vector (multi-valued) measurements

--area-in-slice

[3D input] Number of labeled in each slice.

--area-other-in-slice

[3D input] Area of other lab. in projected area.

--area-proj-in-slice

[3D input] Num. voxels in ’--sum-proj-in-slice’.

--sum-err-in-slice

[3D input] Error in ’--sum-in-slice’.

--sum-in-slice

[3D input] Sum of values in each slice.

--sum-other-err-in-slice

[3D input] Area in ’--sum-other-in-slice’.

--sum-other-in-slice

[3D input] Sum of other lab. in projected area.

--sum-proj-err-in-slice

[3D input] Error of ’--sum-proj-in-slice’.

--sum-proj-in-slice

[3D input] Sum of projected area in each slice.

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.

--minmapsize = INT

Min. bytes to avoid RAM automatically.

-N , --numthreads = INT

Number of CPU threads to use.

--onlyversion = STR

Only run if the program version is STR.

-P , --printparams

Print parameter values to be used and abort.

--quietmmap

Don’t print mmap’d file’s name and size.

-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/

REPORTING BUGS

Report bugs to bug-gnuastro@gnu.org.

COPYRIGHT

Copyright © 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 MakeCatalog is maintained as a Texinfo manual. If the info and MakeCatalog programs are properly installed at your site, the command

info MakeCatalog

should give you access to the complete manual.

---