Main Page | Class List | Directories | File List | Class Members | File Members

ObitTableCCUtil.c File Reference

ObitTableCC class utility function definitions. More...

#include "glib/gqsort.h"
#include "ObitTableCCUtil.h"
#include "ObitMem.h"

Functions

ObitIOCode ObitTableCCUtilGrid (ObitTableCC *in, glong OverSample, glong *first, glong *last, gboolean noNeg, gfloat factor, gfloat minFlux, gfloat maxFlux, ObitImageDesc *desc, ObitFArray **grid, gfloat gparm[3], glong *ncomp, ObitErr *err)
 Public: grid components onto a grid.
ObitFArrayObitTableCCUtilCrossList (ObitTableCC *inCC, ObitImageDesc *inDesc, ObitImageDesc *outDesc, gfloat gparm[3], glong *ncomps, ObitErr *err)
 Public: return list of CC from one image overlapping another.
ObitIOCode ObitTableCCUtilMerge (ObitTableCC *in, ObitTableCC *out, ObitErr *err)
 Merge elements of an ObitTableCC.
ObitFArrayObitTableCCUtilMergeSel (ObitTableCC *in, gint startComp, gint endComp, gfloat *parms, ObitErr *err)
 Merge elements of an ObitTableCC with selection.
ObitTableCCObitTableCCUtilMergeSel2Tab (ObitImage *image, glong inCCver, glong *outCCver, gint startComp, gint endComp, gfloat range[2], ObitErr *err)
 Merge selected elements of an ObitTableCC to a new table.
void ObitTableCCUtilScale (ObitTableCC *in, gint startComp, gint endComp, gfloat scale, ObitErr *err)
 Scale the flux densities of entries in a CC table.
void ObitTableCCUtilAppend (ObitTableCC *inCC, ObitTableCC *outCC, gint startComp, gint endComp, ObitErr *err)
 Append CLEAN components from one table to another.
gboolean ObitTableCCUtilFiltCC (ObitTableCC *CCTab, gfloat radius, gfloat minFlux, ObitErr *err)
 Filter weak, isolated components.


Detailed Description

ObitTableCC class utility function definitions.


Function Documentation

void ObitTableCCUtilAppend ObitTableCC inCC,
ObitTableCC outCC,
gint  startComp,
gint  endComp,
ObitErr err
 

Append CLEAN components from one table to another.

Parameters:
inCC Table to copy from
outCC Table to copy to
startComp First component to select , 0=>1
endComp Last component to select, 0=> all
err ObitErr error stack.

ObitFArray* ObitTableCCUtilCrossList ObitTableCC inCC,
ObitImageDesc inDesc,
ObitImageDesc outDesc,
gfloat  gparm[3],
glong *  ncomps,
ObitErr err
 

Public: return list of CC from one image overlapping another.

Returned array has component values on the first axis and one row per overlapping component. (X cell (0-rel), Y cell (0-rel), flux). CCs on cells within 0.5 pixels of outDesc are included. Components in the same cell are combined. If the components are Gaussians, their parameters are returned in gaus.

Parameters:
in Table of CCs
inDesc Descriptor for image from which components derived
outDesc Descriptor for output image
grid [out] filled in array, created, resized if necessary
gparm [out] Gaussian parameters (major, minor, PA (all deg)) if the components in in are Gaussians, else, -1. These are the values from the first CC.
ncomp [out] number of components in output list (generally less than size of FArray).
err ObitErr error stack.
Returns:
pointer to list of components, may be NULL on failure, MUST be Unreffed.

gboolean ObitTableCCUtilFiltCC ObitTableCC CCTab,
gfloat  radius,
gfloat  minFlux,
ObitErr err
 

Filter weak, isolated components.

Parameters:
CCTab CC table object to filter.
radius Radius within which to consider components. (deg)
minFlux Minimum acceptable summed flux
err Error/message stack
Returns:
True if any components zeroed

ObitIOCode ObitTableCCUtilGrid ObitTableCC in,
glong  OverSample,
glong *  first,
glong *  last,
gboolean  noNeg,
gfloat  factor,
gfloat  minFlux,
gfloat  maxFlux,
ObitImageDesc desc,
ObitFArray **  grid,
gfloat  gparm[3],
glong *  ncomp,
ObitErr err
 

Public: grid components onto a grid.

The image from which the components is derived is described in desc. The output grid is padded by a factor OverSample. If the components are Gaussians, their parameters are returned in gaus.

Parameters:
in Table to grid
OverSample Expansion factor for output image
first First component (1-rel) to include, 0=>1, filled in if changed
last Last component (1-rel) to include, 0=>all, filled in if changed
noNeg Ignore first negative flux component and after
factor factor to multiply timec fluxes
minFlux Minimum abs. value flux density to include (before factor)
maxFlux Maximum abs. value flux density to include (before factor)
desc Descriptor for image from which components derived
grid [out] filled in array, created, resized if necessary
gparm [out] Gaussian parameters (major, minor, PA all in deg) if the components in in are Gaussians, else, -1.
ncomp [out] number of components gridded.
err ObitErr error stack.
Returns:
I/O Code OBIT_IO_OK = OK.

ObitIOCode ObitTableCCUtilMerge ObitTableCC in,
ObitTableCC out,
ObitErr err
 

Merge elements of an ObitTableCC.

First sorts table, collapses, sorts to desc. flux

Parameters:
in Table to sort
out Table to write output to
err ObitErr error stack.
Returns:
I/O Code OBIT_IO_OK = OK.

ObitFArray* ObitTableCCUtilMergeSel ObitTableCC in,
gint  startComp,
gint  endComp,
gfloat *  parms,
ObitErr err
 

Merge elements of an ObitTableCC with selection.

with selection by row number. First sorts table, collapses, sorts to desc. flux

Parameters:
in Table to sort
startComp First component to select
endComp Last component to select, 0=> all
parms [out] Non-point parameters (MUST all be the same ) dimen. at least 4. parms[3] = type 0 => point, no parameters 1 = Sky Gaussian, [0:3]=maj, min, PA 2 = Convolved Gaussian, [0:3]=maj axis, min axis, PA (all deg) 3 = Uniform Sphere [0] = radius (deg)
err ObitErr error stack.
Returns:
FArray containing merged CC table contents; MUST be Unreffed.
  • Flux
  • Delta X
  • Delta Y

ObitTableCC* ObitTableCCUtilMergeSel2Tab ObitImage image,
glong  inCCver,
glong *  outCCver,
gint  startComp,
gint  endComp,
gfloat  range[2],
ObitErr err
 

Merge selected elements of an ObitTableCC to a new table.

Parameters:
image input image with input CC table
inCCver input CC table
outCCver Desired output CC table on image, if 0 then new value used returned.
startComp First component to select
endComp Last component to select, 0=> all
range Max and min abs value of flux densities to accept
err ObitErr error stack.

void ObitTableCCUtilScale ObitTableCC in,
gint  startComp,
gint  endComp,
gfloat  scale,
ObitErr err
 

Scale the flux densities of entries in a CC table.

Parameters:
in Table to scale
startComp First component to select
endComp Last component to select, 0=> all
scale Factor to multiply times flux densities
err ObitErr error stack.


Generated on Fri Aug 31 22:13:07 2007 for Obit by  doxygen 1.3.9.1