Uses the off-pulse noise statistics to scale the polarization. More...

#include <OffPulseCalibrator.h>

Inheritance diagram for Pulsar::OffPulseCalibrator:

Public Member Functions
	OffPulseCalibrator (const Archive *archive)
	Construct from an single PolnCal Pulsar::Archive.
	~OffPulseCalibrator ()
	Destructor.
void	calibrate (Archive *archive)
	Calibrate the polarization of the given archive.
Public Member Functions inherited from Pulsar::SingleAxisCalibrator
	SingleAxisCalibrator (const Archive *archive)
	Construct from an single PolnCal Pulsar::Archive.
	SingleAxisCalibrator (const SingleAxisCalibrator &)
	Copy constructor.
SingleAxisCalibrator *	clone () const
	Clone operator.
	~SingleAxisCalibrator ()
	Destructor.
Calibrator::Info *	get_Info () const
	Return the SingleAxisCalibrator information.
Public Member Functions inherited from Pulsar::ReferenceCalibrator
	ReferenceCalibrator (const Archive *archive)
	Construct from an single PolnCal Pulsar::Archive.
	ReferenceCalibrator (const ReferenceCalibrator &)
	Copy constructor.
	~ReferenceCalibrator ()
	Destructor.
void	set_reference_source (const Stokes< Estimate< double > > &stokes)
	Set the Stokes parameters of the reference source.
Stokes< Estimate< double > >	get_reference_source () const
	Get the Stokes parameters of the reference source.
void	set_outlier_threshold (float f)
	Set the threshold used to reject outliers when computing levels.
float	get_outlier_threshold () const
	Get the threshold used to reject outliers when computing levels.
void	get_levels (unsigned nchan, std::vector< std::vector< Estimate< double > > > &hi, std::vector< std::vector< Estimate< double > > > &lo) const
	Return the mean levels of the calibrator hi and lo states.
virtual void	set_nchan (unsigned nchan)
	Set the number of frequency channels in the response array.
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_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.
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	extra (unsigned ichan, const std::vector< Estimate< double > > &source, const std::vector< Estimate< double > > &sky)
	Disable the differential gain correction.
Protected Member Functions inherited from Pulsar::SingleAxisCalibrator
MEAL::Complex2 *	solve (const std::vector< Estimate< double > > &hi, const std::vector< Estimate< double > > &lo)
	Return a new Calibration::SingleAxis instance.
Protected Member Functions inherited from Pulsar::ReferenceCalibrator
void	set_calibrator (const Archive *archive)
	Filter access to the calibrator.
void	calculate_transformation ()
	Solve using the observation of the reference source.
void	calculate (std::vector< std::vector< Estimate< double > > > &hi, std::vector< std::vector< Estimate< double > > > &lo)
	Does the calculation of the above.
Protected Member Functions inherited from Pulsar::PolnCalibrator
void	setup_transformation () const
	Set up to call calculate_transformation.
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

Additional Inherited Members
Static Public Member Functions inherited from Pulsar::ReferenceCalibrator
static ReferenceCalibrator *	factory (const Calibrator::Type , const Archive )
	Factory creates instances of derived types.
static void	get_levels (const Archive *archive, Index subint, unsigned nchan, std::vector< std::vector< Estimate< double > > > &hi, std::vector< std::vector< Estimate< double > > > &lo, double outlier_threshold)
	Return the mean levels of the calibrator hi and lo states.
static void	get_levels (const Integration *integration, unsigned nchan, std::vector< std::vector< Estimate< double > > > &hi, std::vector< std::vector< Estimate< double > > > &lo, double outlier_threshold)
	Return the mean levels of the calibrator hi and lo states.
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::ReferenceCalibrator
static Option< bool >	smooth_bandpass
	If true, then a median filter is run on the calibrator bandpass.
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.
Protected Attributes inherited from Pulsar::SingleAxisCalibrator
Reference::To< Calibration::SingleAxisSolver >	solver
	Optimization for SingleAxis solve.
Protected Attributes inherited from Pulsar::ReferenceCalibrator
std::vector< Estimate< double > >	baseline
	Intensity of off-pulse (system + sky), in CAL flux units.
Stokes< Estimate< double > >	reference_source
	The Stokes parameters of the reference source.
bool	source_set
	Flag raised when the reference_source attribute is set.
unsigned	requested_nchan
	Requested number of frequency channels.
double	outlier_threshold
	Threshold used to reject outliers when computing levels.
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.

Detailed Description

Uses the off-pulse noise statistics to scale the polarization.

This calibrator should probably never be used. It was developed to deal with Wideband Correlator data observed during a period of heavy testing and development (P236). It was observed that the system does not remain stable between calibrator and pulsar observations, nor from sub-integration to sub-integration. Therefore, this calibrator attempts to correct the gains using the statistics of the off-pulse baseline. The error in the assumption that this baseline is unpolarized is the least of our concerns at this point.

Member Function Documentation

◆ calibrate()

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

virtual

Calibrate the polarization of the given archive.

The required transformation cannot be represented by a Jones matrix

Reimplemented from Pulsar::PolnCalibrator.

References Pulsar::Integration::baseline_stats(), Pulsar::Calibrator::calibrate(), Pulsar::PolnCalibrator::calibration_setup(), Signal::Coherence, Pulsar::Integration::get_Profile(), and Estimate< typename T, typename U >::val.

◆ extra()

void Pulsar::OffPulseCalibrator::extra	(	unsigned	ichan,
		const std::vector< Estimate< double > > &	source,
		const std::vector< Estimate< double > > &	sky )

protectedvirtual

Disable the differential gain correction.

Reimplemented from Pulsar::ReferenceCalibrator.

References Pulsar::PolnCalibrator::get_transformation(), Pulsar::PolnCalibrator::get_transformation_valid(), and Calibration::SingleAxis::set_diff_gain().

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

OffPulseCalibrator.h
OffPulseCalibrator.C

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ calibrate()

◆ extra()