NAME

       purify - Reconstruct images from radio interferometers using PADMM

SYNOPSIS

       purify --measurement_set path --name path [options]

DESCRIPTION

       PURIFY  is  a  tool  for  radio  interferometric imaging including file handling (for both
       visibilities and fits files), implementation of the measurement operator and set-up of the
       different optimization problems used for image deconvolution.

       The  code  is  given  for  educational  purpose.  The  code  is  in  beta  and still under
       development.

OPTIONS

       --measurement_set
              Path of measurement set. (required)

       --name Path of file output. (required)

       --noise
              Path of measurement_set with  Stokes  V  noise  estimate.   (Assumes  Stokes  V  of
              measurement set).

       --niters
              Number of iterations.

       --stokes
              Choice of stokes I, Q, U, or V (I is default).

       --cellsize
              Size of a pixel in arcseconds.

       --size Image size in pixels.

       --width
              Image width in pixels.

       --height
              Image height in pixels.

       --beta Values used to set the stepsize of PADMM

       --noadapt
              Choose not to update the stepsize.

       --diagnostic
              Save diagnostic information to log file.

       --l2_bound
              Factor to multiply the l2 bound by.

       --relative_variation
              Convergence criteria on relative variation (default is 1e-3).

       --residual_convergence
              Factor to multiply the l2 bound by for convergence. (default is 1)

       --relative_gamma_adapt
              Relative difference criteria for adapting the stepsize gamma (default 0.01).

       --power_iterations
              Maximum iterations for the power method.

       --primary_beam
              Choice of primary beam model. (none is the only option).

       --fft_grid_correction
              Choose calculate the gridding correction using an FFT rather than analytic formula.

       --kernel
              Type of gridding kernel to use, kb, gauss, pswf, box. (kb is default)

       --kernel_support
              Support of kernel in grid cells. (4 is the default)

       --logging_level
              Determines the output logging level for sopt and purify. ("debug" is the default)

       --help Print usage information.

AUTHORS

       PURIFY  was  initially  created  by Rafael Carrillo, Jason McEwen and Yves Wiaux but major
       contributions have since been made by a number of others. The full list of contributors is
       as  follows:  Rafael  E.  Carrillo,  Jason D. McEwen, Yves Wiaux, Luke Pratley, and Mayeul
       d'Avezac.

BUGS

       If you have any questions or comments, feel free  to  contact  Rafael  Carrillo  or  Jason
       McEwen, or add an issue in the issue tracker https://github.com/basp-group/purify/issues

LICENSE

       PURIFY Copyright (C) 2013 Rafael Carrillo, Jason McEwen, Yves Wiaux

       This program is free software; you can redistribute it and/or modify it under the terms of
       the GNU General Public License as  published  by  the  Free  Software  Foundation;  either
       version 2 of the License, or (at your option) any later version.

       This  program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PURPOSE.
       See the GNU General Public License for more details.