SYNOPSIS

       yoda [options ...] FITS-file

DESCRIPTION

       YODA 1.2.5 2004-10-06

       YODA  (Yet  another Object Detection Application) is a software package
       performing object detection, photometry and star-galaxy  classification
       on astronomical images.

       --ap-transform <FLOATARRAY>
              [1,0,0,1]

              Linear transforamtion coefficients for apertures

       --bg-bins <INT>
              [25]

              Number of bins in background histograms

       -g, --bg-gridsize <INT>
              [128]

              Number of bins in background histograms

       --bg-iter <FLAG>
              [false]

              Iterate background and rms estimation

       -c, --class-output-cat <STRING>
              [<Image>.class]

              Name of classifier outpout file

       -C, --classify <FLAG>
              [false]

              Perform classification

       -M, --coords-cat <STRING>
              []

              File with aperture centers for photometry (none: use coordinates
              from master-cat)

       --coords-columns <FLOATARRAY>
              [2,3]

              Column numbers of x and y coordinates in coords-cat file

       -D, --detect <FLAG>
       --dump-detection <FLAG>
              [false]

              Dump detection mask to disk

       -A, --fixed-aper <FLOAT>
              [0.0]

              Fixed circular aperture diameter in pixels

       --gain <FLOAT>
              [0.0]

              CCD gain in e-/ADU (0.0 for GAIN FITS keyword)

       --gain-keyword <STRING>
              [GAIN    ]

              FITS header keyword for GAIN

       -h, --help <FLAG>
              [false]

              Print this help message and exit

       --iraf-transform <FLAG>
              [false]

              Aperture lin. Tranformation in iraf format: xmag,ymag,xrot,yrot

       -k, --kron-factor <FLOAT>
              [2.5]

              Size factor for Kron-like apertures

       -m, --master-cat <STRING>
              []

              File of yoda catalog of master image when performing  photometry
              (none: use objects from current detection pass; needed for aper-
              ture geometry), and file containing photometry  data  when  per-
              forming classification (needed for sky value)

       --maxsize <INT>
              [100]

              Maximum linear size of object

       --min-aperture <FLOAT>
              [2.0]

              Radius of smallest possible kron aperture in pixels
              Minimum  number of consecutive pixels above threshold for object
              detection

       -P, --photometry <FLAG>
              [false]

              Perform aperture photometry

       -p, --photometry-cat <STRING>
              [<Image>.p]

              Name of output photometry catalog

       -T, --psf <FLAG>
              [false]

              Generate PSF template image from objects in image

       -I, --psf-catalog <STRING>
              [psf.cat]

              Write catalog of automatically determined PSF objects to file

       --psf-corelum <FLOAT>
              [10.0]

              Min core luminosity above detection isophote for PSF objects

       -i, --psf-input-cat <STRING>
              []

              Read catalog of objects for PSF estimation from file

       --psf-input-file <STRING>
              []

              File containing PSF template (none for internally generated tem-
              plate)

       --psf-maxasym <FLOAT>
              [0.05]

              Maximum asymmetry for PSF objects

       --psf-minstars <INT>
              [11]

              Minimum number of objects to use in PSF estimation

       --psf-output-file <STRING>
              [<Image>.psf]


              Saturation value of image

       -s, --seeing <FLOAT>
              [2.0]

              FWHM of Gaussian convolution kernel in pixels

       --sky-annulus <FLOATARRAY>
              [5,3]

              Distance  from largest aperture and width of sky annulus. If 0,0
              then the sky at each object's position is estimated by  interpo-
              lating the background image at the object's center.

       --split-npixmin <INT>
              [4]

              Minimum number of pixels in splitted objects

       --split-range <FLOATARRAY>
              [0.01,0.8]

              Minimum  and maximum isophote in units of object maximum flux to
              split at

       --step-split <FLOAT>
              [0.02]

              Fractional increment in splitting isophote

       -t, --threshold <FLOAT>
              [3.0]

              Threshold for object detection above local noise

       -V, --version <FLAG>
              [false]

              Print version information and exit

       -z, --zeropoint <FLOAT>
              [23.5]

              Magnitude zero-point

EXAMPLES

       Detect objects in 'image.fits', write catalog to 'master.cat': yoda  -D
       -d master.cat -t 3.0 -n 7 -s 3.0 -z 23.43 image.fits

       Photometry  using  detected  objects,  output to image.phot: yoda -P -p
       image.phot -m master.cat -z 23.43 image.fits
       Report bugs to <drory@astro.as.utexas.edu>

COPYRIGHT

       Copyright  (C)  Niv  Drory YODA comes with ABSOLUTELY NO WARRANTY.  You
       may redistribute copies of YODA under the terms of the GNU General Pub-
       lic License. See the file named COPYING.

SEE ALSO

       The  full documentation for YODA is maintained as a Texinfo manual.  If
       the info and YODA programs are properly installed  at  your  site,  the
       command

              info YODA

       should give you access to the complete manual.



YODA 1.2.5 2004-10-06            October 2004                          YODA(1)