ObitDConCleanVis.c File Reference

ObitDConCleanVis class function definitions. More...

#include "ObitDConCleanVis.h"
#include "ObitMem.h"
#include "ObitFFT.h"
#include "ObitTableUtil.h"
#include "ObitTableCCUtil.h"
#include "ObitSkyGeom.h"

Functions
void	ObitDConCleanVisInit (gpointer in)
	Private: Initialize newly instantiated object.
void	ObitDConCleanVisClear (gpointer in)
	Private: Deallocate members.
ObitDConCleanVis *	newObitDConCleanVis (gchar *name)
	Public: Default Constructor.
gconstpointer	ObitDConCleanVisGetClass (void)
	Public: ClassInfo pointer.
ObitDConCleanVis *	ObitDConCleanVisCopy (ObitDConCleanVis *in, ObitDConCleanVis *out, ObitErr *err)
	Public: Copy (deep) constructor.
void	ObitDConCleanVisClone (ObitDConCleanVis *in, ObitDConCleanVis *out, ObitErr *err)
	Public: Copy structure.
ObitDConCleanVis *	ObitDConCleanVisCreate (gchar *name, ObitUV *uvdata, ObitErr *err)
	Public: Create/initialize ObitDConCleanVis structures.
ObitDConCleanVis *	ObitDConCleanVisCreate2 (gchar *name, ObitUV *uvdata, ObitUVImager *imager, ObitSkyModel *skyModel, ObitErr *err)
	Public: Create/initialize ObitDConCleanVis structures from optional components.
void	ObitDConCleanVisDeconvolve (ObitDCon *inn, ObitErr *err)
	Public: Do deconvolution.
void	ObitDConCleanVisGetParms (ObitDCon *inn, ObitErr *err)
	Public: Get parameters.
void	ObitDConCleanVisDefWindow (ObitDConClean *inn, ObitErr *err)
	Public: Set Default CLEAN windows.
void	ObitDConCleanVisSub (ObitDConCleanVis *in, ObitErr *err)
	Public: Subtract components and generate new residual image(s).
gboolean	ObitDConCleanVisPickNext (ObitDConCleanVis *in, ObitErr *err)
	Public: Pick next field(s) and get Residual image(s).
gfloat	ObitDConCleanVisQuality (ObitDConCleanVis *in, glong field, ObitErr *err)
	Public: Determine quality measure for field.
gboolean	ObitDConCleanVisReimage (ObitDConCleanVis *in, ObitUV *uvdata, ObitErr *err)
	Public: Reimaging needed to center strong source on pixel?
void	ObitDConCleanVisAddField (ObitDConCleanVis *in, ObitUV *uvdata, ObitErr *err)
	Public: Resize to add a new field.
gboolean	ObitDConCleanVisRecenter (ObitDConCleanVis *in, ObitUV *uvdata, ObitErr *err)
	Public: Recenter autoCenter images.
gboolean	ObitDConCleanVisFilter (ObitDConCleanVis *in, gfloat filter[2], ObitErr *err)
	Public: Filter weak, isolated components.
void	ObitDConCleanVisClassInit (void)
	Public: Class initializer.

---

Detailed Description

ObitDConCleanVis class function definitions.

Image based CLEAN class. This class is derived from the ObitDCon class.

---

Function Documentation

ObitDConCleanVis* newObitDConCleanVis (  gchar *  name  )

Public: Default Constructor. Initializes class if needed on first call. Parameters: name  An optional name for the object. Returns: the new object.

void ObitDConCleanVisAddField (  ObitDConCleanVis *  in, ObitUV *  uvdata, ObitErr *  err )

Public: Resize to add a new field. Parameters: in  DConCleanVis to expand uvdata  UV data being imaged. err  Error/message stack

void ObitDConCleanVisClassInit (  void   )

Public: Class initializer.

void ObitDConCleanVisClear (  gpointer  inn  )

Private: Deallocate members. Does (recursive) deallocation of parent class members. Parameters: inn  Pointer to the object to deallocate. Actually it should be an ObitDConCleanVis* cast to an Obit*.

void ObitDConCleanVisClone (  ObitDConCleanVis *  in, ObitDConCleanVis *  out, ObitErr *  err )

Public: Copy structure. Parameters: in  The object to copy out  An existing object pointer for output, must be defined. err  Obit error stack object.

ObitDConCleanVis* ObitDConCleanVisCopy (  ObitDConCleanVis *  in, ObitDConCleanVis *  out, ObitErr *  err )

Public: Copy (deep) constructor. Parameters: in  The object to copy out  An existing object pointer for output or NULL if none exists. err  Obit error stack object. Returns: pointer to the new object.

ObitDConCleanVis* ObitDConCleanVisCreate (  gchar *  name, ObitUV *  uvdata, ObitErr *  err )

Public: Create/initialize ObitDConCleanVis structures. Parameters: name  An optional name for the object. uvdata  from which to create object, should have all control information defined on info member. err  Obit error stack object. Returns: the new object.

ObitDConCleanVis* ObitDConCleanVisCreate2 (  gchar *  name, ObitUV *  uvdata, ObitUVImager *  imager, ObitSkyModel *  skyModel, ObitErr *  err )

Public: Create/initialize ObitDConCleanVis structures from optional components. Parameters: name  An optional name for the object. uvdata  from which to create object, should have all control information defined on info member. imager  Optional ObitUVImager to use, if NULL use default Reference "stolen" (i.e. no need to Unref after call) skyModel  Optional ObitSkyModel to use, if NULL use default Reference "stolen" (i.e. no need to Unref after call) err  Obit error stack object. Returns: the new object.

void ObitDConCleanVisDeconvolve (  ObitDCon *  inn, ObitErr *  err )

Public: Do deconvolution. CLEAN control parameters are in the ObitInfoList member: "Niter" OBIT_int scalar = Maximum number of CLEAN iterations "maxPixel" OBIT_int scalar = Maximum number of residuals [def 20000] "minPatch" OBIT_int scalar = Minimum beam patch in pixels [def 50] "BMAJ" OBIT_float scalar = Restoring beam major axis (deg) "BMIN" OBIT_float scalar = Restoring beam minor axis (deg) "BPA" OBIT_float scalar = Restoring beam position angle (deg) "Beam" OBIT_float array[3]= (BMAJ, BMIN, BPA) alternate form "CCVer" OBIT_int array = CLEAN table version for all fields "Gain" OBIT_float array = CLEAN loop gain per field "minFlux" OBIT_float array = Minimun flux density (Jy) per field "Factor" OBIT_float array = CLEAN depth factor per field "autoCen" OBIT_float scalar = Threshold leven for autocenter If peak exceeds this value the minFlux reset to 0.1*autoCen "Plane" OBIT_int array = Plane being processed, 1-rel indices of axes 3-? Parameters: in  The object to deconvolve err  Obit error stack object.

void ObitDConCleanVisDefWindow (  ObitDConClean *  inn, ObitErr *  err )

Public: Set Default CLEAN windows. If CLEANBox defined in in->info then its contents are used for field 1. Assumes all images in mosaic have descriptors defined. Uses base class function. Parameters: in  The CLEAN object err  Obit error stack object.

gboolean ObitDConCleanVisFilter (  ObitDConCleanVis *  in, gfloat  filter[2], ObitErr *  err )

Public: Filter weak, isolated components. Parameters: in  DConCleanVis to check Values on info member: "CCVer" OBIT_int scalar = CC table version to use, default 1 filter,filtering  parameters: [0] = radius Radius within which to consider components. (deg) if this is 0.0 nothing is done [1] = minFlux Minimum acceptable summed flux (Jy) err  Error/message stack return TRUE if any components were removed, i.e. reimaging needed

gconstpointer ObitDConCleanVisGetClass (  void   )

Public: ClassInfo pointer. Returns: pointer to the class structure.

void ObitDConCleanVisGetParms (  ObitDCon *  inn, ObitErr *  err )

Public: Get parameters. "autoCen" OBIT_float scalar = Threshold leven for autocenter If peak exceeds this value the minFlux reset to 0.1*autoCen "dispURL" OBIT_string scalar = URL of display server Parameters: in  The CLEAN object as base class err  Obit error stack object.

void ObitDConCleanVisInit (  gpointer  inn  )

Private: Initialize newly instantiated object. Parent classes portions are (recursively) initialized first Parameters: inn  Pointer to the object to initialize.

gboolean ObitDConCleanVisPickNext (  ObitDConCleanVis *  in, ObitErr *  err )

Public: Pick next field(s) and get Residual image(s). Adopted from the AIPSish CLBSTF (QOOP:QCLEAN.FOR) Parameters: in  The object to deconvolve err  Obit error stack object. Returns: TRUE iff reached minimum flux density or max. number comp.

gfloat ObitDConCleanVisQuality (  ObitDConCleanVis *  in, glong  field, ObitErr *  err )

Public: Determine quality measure for field. Parameters: in  The object to deconvolve field  field number (1-rel) to test err  Obit error stack object. Returns: quality measure, higher is more desirable

gboolean ObitDConCleanVisRecenter (  ObitDConCleanVis *  in, ObitUV *  uvdata, ObitErr *  err )

Public: Recenter autoCenter images. The centroid of the CLEAN components of autoCenter fields are determined. If they are not at the reference pixel to within toler, the position is adjusted. Fields in the mosaic member of in are considered autoCenter fields if the image info member contains a boolean entry "autoCenField" with value True. Any images recentered will have the CLEAN components cleared Images should be remade if any positions are modified. Parameters: in  DConCleanVis to check Values on info member: "CCVer" OBIT_int scalar = CC table version to use, default 1 "toler" OBIT_float scalar = Tolerance to accept as on a pixel (cells) def 0.001 uvdata  UV data err  Error/message stack return TRUE if a position was modified

gboolean ObitDConCleanVisReimage (  ObitDConCleanVis *  in, ObitUV *  uvdata, ObitErr *  err )

Public: Reimaging needed to center strong source on pixel? A new (96x96) field is added centered on the offending source and a negative clean window added to the position of the source in its original window. Avoid duplicates of the same source and ensure that all occurances of this source in any exant field has a negative clean window added. Multiple centering sources per facet are allowed A boolean entry "autoCenField" with value True is added to the info member of any image members added to the mosaic member. Routine originally translated from the AIPSish VLAUTIL.FOR/VLCCIN Parameters: in  DConCleanVis to check Values on info member: "restartFlux" OBIT_float scalar = Minimum brightness flux for CLEAN restart, def infinite "CCVer" OBIT_int scalar = CC table version to use, default 1 "toler" OBIT_float scalar = Tolerance to accept as on a pixel (cells) def 0.01 uvdata  UV data being imaged. err  Error/message stack Returns: TRUE if image needs to be remade, generally meaning something exceeded threshold.

void ObitDConCleanVisSub (  ObitDConCleanVis *  in, ObitErr *  err )

Public: Subtract components and generate new residual image(s). Parameters: in  The object to deconvolve err  Obit error stack object.

---