NAME

       MakeCatalog - Make a catalog from labeled input images

SYNOPSIS

       astmkcatalog [OPTION...] ASTRdata

DESCRIPTION

       MakeCatalog  is  part  of  GNU Astronomy Utilities 0.5.  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 image extension name or number.

       -C, --clumpsfile=STR
              Image containing clump labels.

       -E, --skysubtracted
              Input is already sky subtracted (for S/N).

       -h, --hdu=STR/INT
              Extension name or number of input data.

       --objectshdu=STR
              Object image extension name or number.

       -O, --objectsfile=STR
              Image containing object/detection labels.

       -R, --threshold=FLT
              Use pixels more than this multiple of STD.

       -s, --skyfile=STR
              Image containing sky values.

       --skyhdu=STR
              Sky image extension name or number.

       --stdhdu=STR
              Sky image extension name or number.

       -t, --stdfile=STR
              Image containing sky STD values.

       --zeropoint=FLT
              Zeropoint magnitude of input dataset.

              Output:

       -D, --dontdelete
              Don't delete output if it exists.

       -K, --keepinputdir
              Keep input directory for automatic output.

       -o, --output=STR
              Output name.

       --sfmagarea=FLT
              Surface brightness area (in arcseconds^2).

       --sfmagnsigma=FLT
              Surface brightness multiple of Sky STD.

       --tableformat=STR
              Table format: `fits-ascii', `fits-binary'.

              Upper limit magnitude settings:

       -e, --envseed
              Use GSL_RNG_SEED environment variable for seed.

       --upmaskfile=STR
              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.

              Identifier columns

       -i, --ids
              All IDs of objects and clumps.

       --idinhostobj
              ID of clump in host object.

       -j, --hostobjid
              ID of object hosting this clump.

       --objid
              Object label/ID.

              Positional columns (pixel)

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

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

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

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

       --geox Geometric center in first FITS axis.

       --geoy Geometric center in second FITS axis.

       -x, --x
              Flux weighted center in first FITS axis.

       -y, --y
              Flux weighted center in second FITS axis.

              Positional columns (WCS)

       --clumpsgeow1
              Geometric center of all clumps in 1st WCS.

       --clumpsgeow2
              Geometric center of all clumps in 2nd WCS.

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

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

       -d, --dec
              Flux weighted center declination.

       --geow1
              Geometric center in first WCS axis.

       --geow2
              Geometric center in second 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.

              Brightness/magnitude related columns

       -b, --brightness
              Brightness (sum of pixel values).

       --clumpbrightness
              Brightness of clumps in an object.

       --clumpsmagnitude
              Magnitude of all clumps in object.

       -G, --magnitudeerr
              Magnitude error of objects or clumps.

       -m, --magnitude
              Total magnitude of objects or clumps.

       --noriverbrightness
              Sky (not river) subtracted clump brightness.

       -n, --sn
              Signal to noise ratio of objects or clumps.

       --riverave
              Average river value surrounding a clump.

       --rivernum
              Number of river pixels around a clump.

       --sky  Average Sky value under this clump or object.

       --std  Average Sky standard deviation.

       --upperlimit
              Upper-limit value, use other options to config.

       -u, --upperlimitmag
              Upper-limit mag. use other options to config.

              Morphology/shape related columns

       -a, --area
              Number of pixels in clump or object.

       -A, --semimajor
              Flux weighted semi-major axis.

       -B, --semiminor
              Flux weighted semi-minor axis.

       -c, --numclumps
              Number of clumps in this object.

       --clumpsarea
              Sum of all clump areas in an object.

       --geoaxisratio
              Geometric axis ratio.

       --geopositionangle
              Geometric position angle.

       --geosemimajor
              Geometric semi-major axis.

       --geosemiminor
              Geometric semi-minor axis.

       -p, --positionangle
              Flux weighted position angle.

       -Q, --axisratio
              Flux weighted axis ratio.

       --weightarea
              Area used for flux weighted positions.

              Operating modes:

       -?, --help
              give this help list

       --cite BibTeX citation for this program.

       --config=STR
              Read configuration file STR immediately.

       --lastconfig
              Do not parse any more configuration files.

       --minmapsize=INT
              Minimum bytes in array to not use ram RAM.

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

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

GNU Astronomy Utilities 0.5                       December 2017                                   MAKECATALOG(1)