Manages a table of Jones matrix elements as a function of time and frequency. More...

#include <ManualPolnCalibrator.h>

Inheritance diagram for Pulsar::ManualPolnCalibrator:

Classes
class	FrequencyResponse
	The frequency response for a given epoch. More...
class	Response
	The response at a single radio frequency. More...

Public Member Functions
	ManualPolnCalibrator (const std::string &filename)
	Default Constructor loads content from specified file name.
virtual void	load (const std::string &filename)
	Loads content from specified file name.
void	calibrate (Archive *archive)
	Calibrate the polarization of the given observation.
void	transform (Archive *)
	Subject an observation to the transformation (inverse of calibration)
void	add (const MJD &epoch, const Response &)
	Add a new Response at the given epoch.
const FrequencyResponse &	match (const MJD &epoch) const
	Return the best-matching frequency response, given the epoch.
const Jones< float > &	get_response (const MJD &epoch, double MHz) const
	Return the Jones matrix for the given the epoch and frequency in MHz.
Public Member Functions inherited from Pulsar::PolnCalibrator
	PolnCalibrator (const Archive *archive=0)
	Construct with optional processed calibrator Archive.
	PolnCalibrator (const PolnCalibrator &calibrator)
	Copy constructor.
virtual	~PolnCalibrator ()
	Destructor.
void	set_calibrator (const Archive *archive)
	Set the calibrator archive used to define basic attributes.
void	set_subint (const Index &isub)
	Set the sub-integration index.
virtual void	set_response_nchan (unsigned nchan)
	Set the number of frequency channels in the response array.
virtual unsigned	get_response_nchan () const
	Get the number of frequency channels in the response array.
virtual Jones< float >	get_response (unsigned ichan) const
	Return the system response for the specified channel.
bool	has_Receiver () const
	Return true if the Receiver is set.
const Receiver *	get_Receiver () const
	Return the Receiver.
void	set_Receiver (const Archive *)
	Set the Receiver extension to that of the input Archive.
std::string	get_receiver_basis_filename () const
void	transformation_resize (unsigned nchan)
bool	get_transformation_valid (unsigned ch) const
	Return true if the transformation for the specified channel is valid.
void	set_transformation_invalid (unsigned ch, const std::string &reason)
	Set the transformation invalid flag for the specified channel.
const std::string &	get_transformation_invalid_reason (unsigned ichan) const
	Get the reason that the transformation in the specified channel is invalid.
const MEAL::Complex2 *	get_transformation (unsigned ichan) const
	Return the transformation for the specified channel.
MEAL::Complex2 *	get_transformation (unsigned ichan)
	Return the transformation for the specified channel.
void	set_transformation (unsigned ichan, MEAL::Complex2 *)
	Set the transformation for the secified channel.
bool	has_covariance () const
	Return true if parameter covariances are stored.
void	get_covariance (unsigned ichan, std::vector< double > &) const
	Return the covariance matrix vector for the specified channel.
virtual bool	has_solver () const
	Return true if least squares minimization solvers are available.
virtual const MEAL::LeastSquares *	get_solver (unsigned ichan) const
	Return the transformation for the specified channel.
MEAL::LeastSquares *	get_solver (unsigned ichan)
void	set_backend_correction (bool f)
	Perform backend corrections before inverting response.
virtual const Type *	get_type () const
	Return the Calibrator::Type of derived class.
virtual unsigned	get_nchan () const
	Get the number of frequency channels in the calibrator.
unsigned	get_nchan (bool build_if_needed) const
	Get the number of frequency channels in the calibrator.
CalibratorExtension *	new_Extension () const
	Return a new PolnCalibratorExtension.
Calibrator::Info *	get_Info () const
	Return plotting information.
void	calibration_setup (const Archive *arch)
	Set up done before calibrating an archive.
Public Member Functions inherited from Pulsar::Calibrator
	Calibrator ()
	Default constructor.
virtual	~Calibrator ()
	Destructor.
Archive *	new_solution (const std::string &archive_class) const
	Return a new processed calibrator Archive with a CalibratorExtension.
virtual MJD	get_epoch () const
	Return the reference epoch of the calibration experiment.
virtual std::string	get_filenames () const
	Return a string containing the file information.
const Archive *	get_Archive () const
	Return a const reference to the calibrator archive.
bool	has_Archive () const
	Return true if the calibrator is constructed from an Archive.
template<class T>
bool	is_a () const
Public Member Functions inherited from Reference::Able
	Able (const Able &)
Able &	operator= (const Able &)
unsigned	get_reference_count () const
Public Member Functions inherited from Reference::HeapTracked
	HeapTracked (const HeapTracked &)
HeapTracked &	operator= (const HeapTracked &)
bool	__is_on_heap () const

Protected Member Functions
void	transform_work (Archive *arch, const std::string &name, bool invert)
	Performs the work for calibrate and transform.
Protected Member Functions inherited from Pulsar::PolnCalibrator
void	setup_transformation () const
	Set up to call calculate_transformation.
virtual void	calculate_transformation ()
	Derived classes can create and fill the transformation array.
virtual bool	get_valid (unsigned ichan) const
	Derived classes can add conditions for channel validity.
float	get_weight (unsigned ichan) const
	Return the weight (0 or 1) of the specified channel.
virtual unsigned	get_maximum_nchan () const
	Derived classes may be able to shrink the transformation array.
Protected Member Functions inherited from Pulsar::Calibrator
void	copy_variation (Calibrator *)
void	set_variation (Variation *var)
const Archive *	get_calibrator () const
	Provide derived classes with access to the calibrator.
Archive *	get_calibrator ()
	Provide derived classes with mutable access to the calibrator.
bool	has_calibrator () const
	Return true if the calibrator attribute has been set.
Protected Member Functions inherited from Reference::Able
Handle *	__reference (bool active) const
void	__dereference (bool auto_delete=true) const

Protected Attributes
std::vector< FrequencyResponse >	response
	The frequency response as a function of epoch.
unsigned	current_response = 0
	Index of the current frequency response.
std::string	ascii_model_filename
	Name of the file from which the entries were loaded.
Protected Attributes inherited from Pulsar::PolnCalibrator
std::vector< std::vector< double > >	covariance
	The array of covariance matrix vectors.
std::vector< Jones< float > >	response
	The array of Jones matrices derived from the transformation array.
Reference::To< const PolnCalibratorExtension >	poln_extension
	The PolnCalibratorExtension of the Archive passed during construction.
Reference::To< const FeedExtension >	feed
	The FeedExtension of the Archive passed during construction.
bool	built
	Flag set when response has been built.
unsigned	observation_nchan
	The number of frequency channels in the observation to be calibrated.
bool	do_backend_correction
	Perform backend corrections before inverting.
Index	subint
	The sub-integration from which to construct a solution.
Protected Attributes inherited from Pulsar::Calibrator
Reference::To< Type >	type
	The type of the Calibrator.
Reference::To< Variation >	variation
	Updates model parameters.
Reference::To< const CalibratorExtension >	extension
	The CalibratorExtension of the Archive passed during construction.
std::vector< std::string >	filenames
	Filenames of Pulsar::Archives from which instance was created.

Additional Inherited Members
Static Public Member Functions inherited from Pulsar::Calibrator
static unsigned	get_instance_count ()
	Returns the number of Calibrator instances currently in existence.
Static Public Member Functions inherited from Reference::Able
static size_t	get_instance_count ()
Static Public Member Functions inherited from Reference::HeapTracked
static void *	operator new (size_t size, void *ptr=0)
static void	operator delete (void location, void ptr)
static void	operator delete (void *location)
static size_t	get_heap_queue_size ()
Static Public Attributes inherited from Pulsar::PolnCalibrator
static Option< double >	minimum_determinant
	Minimum allowable determinant of Jones matrices.
Static Public Attributes inherited from Pulsar::Calibrator
static unsigned	verbose = 0
	Verbosity level.
static Pulsar::Option< float >	median_smoothing
	Fractional bandwidth of the window used in median filter.
static Pulsar::Option< float >	interpolating
	Fractional bandwidth over which interpolation will be performed.
static Pulsar::Option< float >	det_threshold
	Tolerance to non-physical values of the coherency matrix.

Detailed Description

Manages a table of Jones matrix elements as a function of time and frequency.

Member Function Documentation

◆ calibrate()

void Pulsar::ManualPolnCalibrator::calibrate ( Archive * archive )

virtual

Calibrate the polarization of the given observation.

Reimplemented from Pulsar::PolnCalibrator.

References transform_work().

◆ get_response()

const Jones< float > & Pulsar::ManualPolnCalibrator::get_response	(	const MJD &	epoch,
		double	MHz ) const

Return the Jones matrix for the given the epoch and frequency in MHz.

Returns the best match, given the epoch and frequency.

References match().

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

ManualPolnCalibrator.h
ManualPolnCalibrator.C

Classes

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ calibrate()

◆ get_response()