---
name: "purify"
section: "1"
platform: "linux"
package: "purify"
version: "4.2.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/purify"
---

# purify(1)

Reconstruct images from radio interferometers using PADMM

## 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/astro-informatics/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.