NAME¶

SYNOPSIS¶

DESCRIPTION¶

For more information, please run any of the following commands. They will respectively show you the `Invoking MakeCatalog' subsection, the complete `MakeCatalog' section, or the full GNU Astronomy Utilities manual. In particular the first contains a very complete explanation of each option.

info astmkcatalog

info MakeCatalog

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:

-c, --clumplabs=STR

Image specifying clump labels.

--clumphdu=STR

Clumps image header name or number.

-E, --skysubtracted

Input is already sky subtracted (for S/N).

-h, --hdu=STR

Extension name or number of input data.

-H, --mhdu=STR

Mask image header name or number.

-M, --mask=STR

Mask image file name.

--objhdu=STR

Object image header name or number.

-O, --objlabs=STR

Image specifying object labels.

-s, --skyfilename=STR

Sky value image.

--skyhdu=STR

Sky image header name or number.

--stdhdu=STR

Sky STD image header name or number.

-t, --stdfilename=STR

Sky standard deviation image.

-T, --threshold=FLT

Only values larger than this multiple of STD.

-z, --zeropoint=FLT

Image zeropoint magnitude.

Output:

--accuprecision=INT

Precision of more accurate floating pnt. cols.

--accuwidth=INT

Width of more accurate floating point columns.

-D, --dontdelete

Don't delete output if it exists.

--floatprecision=INT

Precision of floating point columns.

--floatwidth=INT

Width of floating point columns.

--intwidth=INT

Width of integer columns.

-K, --keepinputdir

Do not remove input's dir info for output.

--nsigmag=FLT

Multiple of Sky STD to report magnitude of.

-o, --output=STR

Output file or directory name.

Upper limit magnitude:

--envseed

Random number generator info from environment.

--upmask=STR

Mask image file name only for upper limit.

--upmaskhdu=STR

Upper limit mask image header name or number.

--upnsigma=FLT

Multiple of final sigma to use.

--upnum=INT

Number of randomly positioned samples.

--upsclipaccu=FLT

Acceptable relative diff to stop clipping.

--upsclipmultip=FLT

Sigma clipping multiple of std.

Catalog columns:

-a, --area

Number of pixels.

-A, --semimajor

Flux weighted Semi-major axis.

-b, --brightness

Brightness (sum of pixel values).

-B, --semiminor

Flux weighted Semi-minor axis.

--clumpbrightness

Brightness in clumps of an object.

--clumpsarea

Area of clumps in an object.

--clumpsdec

Clumps flux weighted center declination.

--clumpsgeodec

Clumps geometric center declination.

--clumpsgeora

Clumps geometric center right ascension.

--clumpsgeox

Clumps geometric center (first FITS axis).

--clumpsgeoy

Clumps geometric center (second FITS axis).

--clumpsmagnitude

Total magnitude of clumps in this object.

--clumpsra

Clumps flux weighted center right ascension.

--clumpsx

Clumps flux weighted center (first FITS axis).

--clumpsy

Clumps flux weighted center (second FITS axis).

-C, --numclumps

Number of clumps in this object.

-d, --dec

All object flux weighted center declination.

-e, --magnitudeerr

Total magnitude error.

--geodec

All object geometric center declination.

--geopositionangle

Flux weighted Position angle.

--geora

All object geometric center right ascension.

--geosemimajor

Flux weighted Semi-major axis.

--geosemiminor

Flux weighted Semi-minor axis.

--geox

All obj. geometric center (first FITS axis).

--geoy

All obj. geometric center (second FITS axis).

-i, --id

Overall ID of this object or clump.

-I, --idinhostobj

ID of clump in host object.

-j, --hostobjid

ID of object hosting this clump.

-m, --magnitude

Total magnitude.

--noriverbrightness

Sky (not river) subtracted clump brightness.

-n, --sn

Signal to noise ratio column.

-p, --positionangle

Flux weighted Position angle.

-r, --ra

All object flux weighted center right ascension.

--riverave

Average river value surrounding this clump.

--rivernum

Number of river pixels surrounding this clump.

--sky

Sky value.

--std

Sky standard deviation.

--upperlimitmag

Upper limit magnitude for each clump or object.

-x, --x

All obj. flux weighted center (first FITS axis).

-y, --y

All obj. flux weighted center (second FITS axis).

Operating modes:

-?, --help

give this help list

--cite

BibTeX citation for MakeCatalog.

--nolog

No log file for programs which make one.

-N, --numthreads=INT

Number of CPU threads to use.

--onlydirconf

Only read current directory configuration file.

--onlyversion=STR

Only run if the program version is this.

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

AUTHOR¶

REPORTING BUGS¶

COPYRIGHT¶

SEE ALSO¶

info MakeCatalog

should give you access to the complete manual.