casa  5.7.0-16
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Types | Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | Static Private Attributes | List of all members
casa::ImagePrimaryBeamCorrector Class Reference

#include <ImagePrimaryBeamCorrector.h>

Inheritance diagram for casa::ImagePrimaryBeamCorrector:
casa::ImageTask< casacore::Float >

Public Types

enum  Mode {
  MULTIPLY,
  DIVIDE
}
 Top level interface for primary beam correction. More...
 
- Public Types inherited from casa::ImageTask< casacore::Float >
enum  Verbosity
 Virtual base class for image analysis tasks. More...
 

Public Member Functions

 ImagePrimaryBeamCorrector ()=delete
 
 ImagePrimaryBeamCorrector (const SPCIIF image, const SPCIIF pbImage, const casacore::Record *const &regionPtr, const casacore::String &region, const casacore::String &box, const casacore::String &chanInp, const casacore::String &stokes, const casacore::String &maskInp, const casacore::String &outname, const casacore::Bool overwrite, const casacore::Float cutoff, const casacore::Bool useCutoff, const Mode mode)
 if outname is empty, no image will be written if overwrite is true, if image already exists it will be removed if overwrite is false, if image already exists exception will be thrown Only one of regionPtr or region<src> should be specified. More...
 
 ImagePrimaryBeamCorrector (const SPCIIF image, const casacore::Array< casacore::Float > &pbArray, const casacore::Record *const &regionPtr, const casacore::String &region, const casacore::String &box, const casacore::String &chanInp, const casacore::String &stokes, const casacore::String &maskInp, const casacore::String &outname, const casacore::Bool overwrite, const casacore::Float cutoff, const casacore::Bool useCutoff, const Mode mode)
 
 ~ImagePrimaryBeamCorrector ()
 destructor More...
 
SPIIF correct (casacore::Bool wantReturn)
 perform the correction. More...
 
casacore::String getClass () const
 
- Public Member Functions inherited from casa::ImageTask< casacore::Float >
virtual ~ImageTask ()
 
void setStretch (const casacore::Bool stretch)
 
void setLogfile (const casacore::String &lf)
 tacitly does nothing if lf is the empty string. More...
 
void setLogfileAppend (const casacore::Bool a)
 
void setRegion (const casacore::Record &region)
 
void setMask (const casacore::String &mask)
 
void setVerbosity (Verbosity verbosity)
 
void addHistory (const std::vector< std::pair< casacore::String, casacore::String > > &msgs) const
 These messages will appear in the product image history upon the call to _prepareOutputImage(). More...
 
void addHistory (const casacore::LogOrigin &origin, const casacore::String &msg) const
 
void addHistory (const casacore::LogOrigin &origin, const std::vector< casacore::String > &msgs) const
 
void addHistory (const casacore::LogOrigin &origin, const casacore::String &taskname, const std::vector< casacore::String > &paramNames, const std::vector< casac::variant > &paramValues) const
 This adds standard history messages regarding the task that was run and input parameters used. More...
 
void suppressHistoryWriting (casacore::Bool b)
 suppress writing the history on _prepareOutputImage() call. More...
 
std::vector< std::pair
< casacore::String,
casacore::String > > 
getHistory ()
 get the history associated with the task. More...
 
void setDropDegen (casacore::Bool d)
 

Protected Member Functions

std::vector
< casacore::Coordinate::Type
_getNecessaryCoordinates () const
 Represents the minimum set of coordinates necessary for the task to function. More...
 
CasacRegionManager::StokesControl _getStokesControl () const
 
- Protected Member Functions inherited from casa::ImageTask< casacore::Float >
 ImageTask (const SPCIIT image, const casacore::String &region, const casacore::Record *const &regionPtr, const casacore::String &box, const casacore::String &chanInp, const casacore::String &stokes, const casacore::String &maskInp, const casacore::String &outname, casacore::Bool overwrite)
 if outname is empty, no image will be written if overwrite is True, if image already exists it will be removed if overwrite is False, if image already exists exception will be thrown More...
 
 ImageTask (const SPCIIT image, const casacore::Record *const &regionPtr, const casacore::String &mask, const casacore::String &outname, casacore::Bool overwrite)
 
virtual std::vector
< OutputDestinationChecker::OutputStruct
_getOutputStruct ()
 
virtual void _construct (casacore::Bool verbose=true)
 does the lion's share of constructing the object, ie checks validity of inputs, etc. More...
 
const SPCIIT _getImage () const
 
const casacore::String_getMask () const
 
const casacore::Record_getRegion () const
 
void _setStokes (const casacore::String &stokes)
 
const casacore::String_getStokes () const
 
const casacore::String_getChans () const
 
const casacore::String_getOutname () const
 
casacore::Bool _isPVImage () const
 Is the attached image a position-velocity (PV) image? More...
 
void _removeExistingOutfileIfNecessary () const
 
void _removeExistingFileIfNecessary (const casacore::String &filename, const casacore::Bool overwrite, casacore::Bool warnOnly=false) const
 if warnOnly is true, log a warning message if file exists and overwrite is true, else throw an exception. More...
 
casacore::String _summaryHeader () const
 
const std::shared_ptr
< casacore::LogIO
_getLog () const
 
virtual casacore::Bool _hasLogfileSupport () const
 by default, derived classes are configured to have no log file support. More...
 
casacore::Bool _getStretch () const
 
Bool _getSuppressHistory () const
 
const std::shared_ptr< LogFile_getLogFile () const
 
casacore::Bool _writeLogfile (const casacore::String &output, const casacore::Bool open=true, const casacore::Bool close=true)
 
casacore::Bool _openLogfile ()
 
void _closeLogfile () const
 
virtual casacore::Bool _supportsMultipleRegions () const
 
virtual casacore::Bool _supportsMultipleBeams () const
 does this task support images with multiple beams? false means it never does. More...
 
SPIIT _prepareOutputImage (const casacore::ImageInterface< casacore::Float > &image, const casacore::Array< casacore::Float > *const values, const casacore::ArrayLattice< casacore::Bool > *const mask=nullptr, const casacore::IPosition *const outShape=nullptr, const casacore::CoordinateSystem *const coordsys=nullptr, const casacore::String *const outname=nullptr, casacore::Bool overwrite=false, casacore::Bool dropDegen=false) const
 If outname != NULL, use the value supplied. More...
 
SPIIT _prepareOutputImage (const casacore::ImageInterface< casacore::Float > &image, casacore::Bool dropDegen=false) const
 
SPIIT _prepareOutputImage (const casacore::ImageInterface< casacore::Float > &image, const casacore::String &outname, casacore::Bool overwrite, casacore::Bool warnOnly) const
 if warnOnly is true, only log a warning message if the file exists and overwrite is true, else throw an excepction More...
 
SPIIT _prepareOutputImage (const casacore::ImageInterface< casacore::Float > &image, const casacore::Lattice< casacore::Float > &data) const
 data are copied to the output image from the data lattice. More...
 
Verbosity _getVerbosity () const
 
casacore::Bool _getOverwrite () const
 
virtual casacore::Bool _mustHaveSquareDirectionPixels () const
 
casacore::Bool _getDropDegen () const
 
void _doHistory (std::shared_ptr< casacore::ImageInterface< U >> &image) const
 
void _reportOldNewImageShapes (const ImageInterface< casacore::Float > &out) const
 
void _reportOldNewImageShapes (const IPosition &outShape) const
 

Private Member Functions

void _checkPBSanity ()
 

Private Attributes

SPIIF _pbImage
 
casacore::Float _cutoff
 
Mode _mode
 
casacore::Bool _useCutoff
 
casacore::Bool _concatHistories
 

Static Private Attributes

static const casacore::String _class
 

Additional Inherited Members

- Static Protected Member Functions inherited from casa::ImageTask< casacore::Float >
static void _copyMask (casacore::Lattice< casacore::Bool > &mask, const casacore::ImageInterface< casacore::Float > &image)
 
static void _copyData (casacore::Lattice< casacore::Float > &data, const casacore::Lattice< casacore::Float > &image)
 

Detailed Description

Definition at line 38 of file ImagePrimaryBeamCorrector.h.

Member Enumeration Documentation

Top level interface for primary beam correction.

Etymology

Collapses image.

Synopsis

High level interface for primary beam correction.

Example

corrector.correct();
Enumerator
MULTIPLY 
DIVIDE 

Definition at line 66 of file ImagePrimaryBeamCorrector.h.

Constructor & Destructor Documentation

casa::ImagePrimaryBeamCorrector::ImagePrimaryBeamCorrector ( )
delete
casa::ImagePrimaryBeamCorrector::ImagePrimaryBeamCorrector ( const SPCIIF  image,
const SPCIIF  pbImage,
const casacore::Record *const &  regionPtr,
const casacore::String region,
const casacore::String box,
const casacore::String chanInp,
const casacore::String stokes,
const casacore::String maskInp,
const casacore::String outname,
const casacore::Bool  overwrite,
const casacore::Float  cutoff,
const casacore::Bool  useCutoff,
const Mode  mode 
)

if outname is empty, no image will be written if overwrite is true, if image already exists it will be removed if overwrite is false, if image already exists exception will be thrown Only one of regionPtr or region<src> should be specified.

casa::ImagePrimaryBeamCorrector::ImagePrimaryBeamCorrector ( const SPCIIF  image,
const casacore::Array< casacore::Float > &  pbArray,
const casacore::Record *const &  regionPtr,
const casacore::String region,
const casacore::String box,
const casacore::String chanInp,
const casacore::String stokes,
const casacore::String maskInp,
const casacore::String outname,
const casacore::Bool  overwrite,
const casacore::Float  cutoff,
const casacore::Bool  useCutoff,
const Mode  mode 
)
casa::ImagePrimaryBeamCorrector::~ImagePrimaryBeamCorrector ( )

destructor

Member Function Documentation

void casa::ImagePrimaryBeamCorrector::_checkPBSanity ( )
private
std::vector<casacore::Coordinate::Type> casa::ImagePrimaryBeamCorrector::_getNecessaryCoordinates ( ) const
protectedvirtual

Represents the minimum set of coordinates necessary for the task to function.

Implements casa::ImageTask< casacore::Float >.

CasacRegionManager::StokesControl casa::ImagePrimaryBeamCorrector::_getStokesControl ( ) const
protectedvirtual
SPIIF casa::ImagePrimaryBeamCorrector::correct ( casacore::Bool  wantReturn)

perform the correction.

If <src>wantReturn is true, return a pointer to the collapsed image.

casacore::String casa::ImagePrimaryBeamCorrector::getClass ( ) const
virtual

Member Data Documentation

const casacore::String casa::ImagePrimaryBeamCorrector::_class
staticprivate

Definition at line 124 of file ImagePrimaryBeamCorrector.h.

casacore::Bool casa::ImagePrimaryBeamCorrector::_concatHistories
private

Definition at line 123 of file ImagePrimaryBeamCorrector.h.

casacore::Float casa::ImagePrimaryBeamCorrector::_cutoff
private

Definition at line 121 of file ImagePrimaryBeamCorrector.h.

Mode casa::ImagePrimaryBeamCorrector::_mode
private

Definition at line 122 of file ImagePrimaryBeamCorrector.h.

SPIIF casa::ImagePrimaryBeamCorrector::_pbImage
private

Definition at line 119 of file ImagePrimaryBeamCorrector.h.

casacore::Bool casa::ImagePrimaryBeamCorrector::_useCutoff
private

Definition at line 123 of file ImagePrimaryBeamCorrector.h.


The documentation for this class was generated from the following file: