dsp::CPSRTwoBitCorrection Class Reference

Converts CPSR data from 2-bit digitized to floating point values. More...

#include <CPSRTwoBitCorrection.h>

Inheritance diagram for dsp::CPSRTwoBitCorrection:

Public Member Functions
	CPSRTwoBitCorrection ()
	Constructor initializes base class atributes. More...
virtual bool	matches (const Observation *observation)
	Return true if CPSRTwoBitCorrection can convert the Observation.
virtual unsigned	get_ndig_per_byte () const
	Over-ride the TwoBitCorrection default. More...
virtual unsigned	get_output_offset (unsigned idig) const
	Over-ride the TwoBitCorrection default. More...
virtual unsigned	get_output_ipol (unsigned idig) const
	Over-ride the TwoBitCorrection default. More...
virtual unsigned	get_output_incr () const
	Over-ride the TwoBitCorrection default. More...
virtual unsigned	get_shift (unsigned idig, unsigned isamp) const
	Over-ride the SubByteTwoBitCorrection default. More...
Public Member Functions inherited from dsp::SubByteTwoBitCorrection
	SubByteTwoBitCorrection (const char *name="SubByteTwoBitCorrection")
	Default constructor.
	~SubByteTwoBitCorrection ()
	Destructor.
virtual unsigned	get_input_offset (unsigned idig) const
	Return the offset (number of bytes) into input for the given digitizer. More...
virtual unsigned	get_input_incr () const
	Return the offset to the next byte of input data. More...
unsigned	get_output_ichan (unsigned idig) const
	Get the output frequency channel for the given digitizer;. More...
Public Member Functions inherited from dsp::TwoBitCorrection
	TwoBitCorrection (const char *name="TwoBitCorrection")
	Null constructor.
virtual	~TwoBitCorrection ()
	Virtual destructor.
void	set_dynamic_output_level_setting (bool flag=true)
	Enable or disable dynamic output level setting.
virtual double	get_optimal_variance ()
	Get the optimal value of the time series variance.
void	set_threshold (float threshold)
	Set the sampling threshold as a fraction of the noise power. More...
float	get_threshold () const
	Get the sampling threshold as a fraction of the noise power.
void	set_table (TwoBitTable *table)
	Set the digitization convention.
const TwoBitTable *	get_table () const
	Get the digitization convention.
Public Member Functions inherited from dsp::ExcisionUnpacker
	ExcisionUnpacker (const char *name="ExcisionUnpacker")
	Null constructor.
void	reserve ()
	Initialize the WeightedTimeSeries dimensions. More...
void	set_output (TimeSeries *)
	Overload Transformation::set_output to also set weighted_output.
void	match_resolution (Input *)
	Match the ndat_per_weight to the resolution of the Input. More...
unsigned	get_resolution () const
	Return ndat_per_weight.
virtual void	set_ndat_per_weight (unsigned ndat_per_weight)
	Set the number of samples per weight in WeightTimeSeries output. More...
unsigned	get_ndat_per_weight () const
	Get the number of samples per weight in WeightTimeSeries output.
virtual void	set_nstate (unsigned nstate)
	Set the number of states in the histogram.
virtual void	set_cutoff_sigma (float cutoff_sigma)
	Set the cut off power for impulsive interference excision.
virtual float	get_cutoff_sigma () const
	Get the cut off power for impulsive interference excision.
float	get_fraction_low () const
	Get the fraction of samples in the low state.
unsigned	get_nlow_min () const
	Get the minumum number of ones in ndat_per_weight points.
unsigned	get_nlow_max () const
	Get the maxumum number of ones in ndat_per_weight points.
template<class U , class Iter >
void	excision_unpack (U &unpack, Iter &input_data, float *output_data, uint64_t nfloat, unsigned long *hist, unsigned *weights, unsigned nweights)
Public Member Functions inherited from dsp::HistUnpacker
	HistUnpacker (const char *name="HistUnpacker")
	Default constructor. More...
virtual	~HistUnpacker ()
	Virtual destructor.
void	combine (const Operation *)
	If Operation is a HistUnpacker, integrate its histograms. More...
void	reset ()
	Reset the histograms. More...
virtual void	set_ndig (unsigned ndig)
	Set the number of digitizers (histograms) More...
virtual unsigned	get_ndig () const
	Get the number of digitizers (histograms)
virtual unsigned	get_ndim_per_digitizer () const
	Get the dimension of the digitizer outputs (real or complex) More...
unsigned	get_nstate () const
	Get the number of states in the histogram.
virtual void	get_histogram (std::vector< unsigned long > &, unsigned) const
	Get the histogram for the specified digitizer.
template<typename T >
void	get_histogram (std::vector< T > &data, unsigned idig) const
	Get the histogram for the given digitizer.
unsigned long *	get_histogram (unsigned idig, unsigned expect=0)
	Get the pointer to the histogram array.
const unsigned long *	get_histogram (unsigned idig) const
double	get_histogram_mean (unsigned idig) const
	Get the centroid of the histogram for the given digitizer.
unsigned long	get_histogram_total (unsigned idig) const
	Get the total number of samples in the histogram.
void	zero_histogram ()
	Reset histogram counts to zero.
Public Member Functions inherited from dsp::Unpacker
	Unpacker (const char *name="Unpacker")
	Constructor.
virtual Unpacker *	clone () const
	Clone operator.
virtual bool	get_order_supported (TimeSeries::Order) const
	Return true if the unpacker supports the specified output order. More...
virtual void	set_output_order (TimeSeries::Order)
	Set the order of the dimensions in the output TimeSeries.
virtual bool	get_device_supported (Memory *) const
	Return true if the unpacker can operate on the specified device.
virtual void	set_device (Memory *)
	Set the device on which the unpacker will operate.
void	prepare ()
	Copy the input attributes to the output.
void	reserve ()
	Reserve the maximum amount of space required in the output.
Iterator	get_iterator (unsigned idig)
	Return the iterator for the specified digitizer.
Public Member Functions inherited from dsp::Transformation< BitSeries, TimeSeries >
	Transformation (const char *_name, Behaviour _type)
	All sub-classes must specify name and capacity for inplace operation.
virtual	~Transformation ()
	Destructor.
void	reserve ()
	Set the size of the output to that of the input by default.
void	set_input (const BitSeries *input)
	Set the container from which input data will be read.
void	set_output (TimeSeries *output)
	Set the container into which output data will be written.
Behaviour	get_type () const
	Return the Transformation type.
virtual void	set_buffering_policy (BufferingPolicy *policy)
	Set the policy for buffering input and/or output data.
bool	has_buffering_policy () const
	Returns true if buffering_policy is set.
BufferingPolicy *	get_buffering_policy () const
void	reset_min_samps ()
	Reset minimum_samps_can_process.
std::string	name (const std::string &function) const
	String preceding output in verbose mode.
virtual void	set_cerr (std::ostream &os) const
	Set verbosity ostream.
Public Member Functions inherited from dsp::Operation
	Operation (const char *name)
	All sub-classes must specify a unique name. More...
	Operation (const Operation &)
	Copy constructor.
virtual	~Operation ()
	Virtual destructor.
virtual bool	operate ()
	Call this method to operate on data Returns false on failure. More...
virtual void	add_extensions (Extensions *)
	Add any extensions.
virtual void	report () const
	Report operation statistics.
std::string	get_name () const
	Return the unique name of this operation.
double	get_total_time () const
	Return the total time spent on this Operation in seconds.
double	get_elapsed_time () const
	Get the time spent in the last invocation of operate()
virtual uint64_t	get_total_weights () const
	Return the total number of timesample weights encountered. More...
virtual uint64_t	get_discarded_weights () const
	Return the number of invalid timesample weights encountered.
int	get_id ()
	Inquire the unique instantiation id.
virtual Function	get_function () const
	Get the function classification of this operation.
virtual double	get_delay_time () const
	Get the time delay of this operation, if any, in seconds.
virtual void	set_scratch (Scratch *)
	Set the scratch space.
bool	scratch_was_set () const
virtual uint64_t	bytes_storage () const
	The number of bytes of additional storage used by the operation.
virtual uint64_t	bytes_scratch () const
	The number of bytes of scratch space used by the operation. More...
Public Member Functions inherited from OwnStream
	OwnStream (const OwnStream &)
const OwnStream &	operator= (const OwnStream &)
virtual void	set_cout (std::ostream &) 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
Public Member Functions inherited from dsp::HasInput< BitSeries >
virtual	~HasInput ()
	Destructor.
const BitSeries *	get_input () const
	Return pointer to the container from which input data will be read.
bool	has_input () const
	Returns true if input is set.
Public Member Functions inherited from dsp::HasOutput< TimeSeries >
virtual	~HasOutput ()
	Destructor.
virtual TimeSeries *	get_output () const
	Return pointer to the container into which output data will be written.
bool	has_output () const
	Returns true if output is set.

Additional Inherited Members
Public Types inherited from dsp::Unpacker
typedef Registry::List< Unpacker >	Register
	typedef used to simplify template syntax in Unpacker_registry.C
Public Types inherited from dsp::Operation
enum	Function { Producer, Procedural, Structural }
	The function of the operator. More...
Static Public Member Functions inherited from dsp::TwoBitCorrection
static TwoBitCorrection *	create (const BitSeries &input, unsigned ndat_per_weight=0, float cutoff_rms=3.0)
	Return a pointer to a new instance of the appropriate sub-class.
Static Public Member Functions inherited from dsp::Unpacker
static Unpacker *	create (const Observation *observation)
	Return a pointer to a new instance of the appropriate sub-class.
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 ()
Public Attributes inherited from dsp::Transformation< BitSeries, TimeSeries >
Callback< Transformation * >	pre_transformation
	Functions called before the transformation takes place.
Callback< Transformation * >	post_transformation
	Functions called after the transformation takes place.
Static Public Attributes inherited from dsp::HistUnpacker
static bool	keep_histogram = true
	Maintain a diagnostic histogram of digitizer statistics.
Static Public Attributes inherited from dsp::Operation
static bool	record_time = false
	Global flag enables stopwatch to record the time spent operating. More...
static bool	report_time = true
	Global flag enables report of time spent in operation on descruction. More...
static bool	verbose = false
	Global verbosity flag.
static int	operation_status = 0
	Operations can set this to non-zero in operation() if they fail.
static bool	check_state = true
	Operations should perform internal consistency checks.
static int	instantiation_count = 0
	Counts how many Operation instantiations there have been Used for setting the unique instantiation ID. More...
Protected Member Functions inherited from dsp::SubByteTwoBitCorrection
void	dig_unpack (const unsigned char *input_data, float *output_data, uint64_t ndat, unsigned long *hist, unsigned *weights=0, unsigned nweights=0)
	Default unpacking algorithm.
TwoBitLookup *	get_unpacker ()
Protected Member Functions inherited from dsp::TwoBitCorrection
void	build ()
	Build the two-bit correction look-up table and allocate histograms.
Protected Member Functions inherited from dsp::ExcisionUnpacker
void	set_limits ()
	Set nlow_min and nlow_max using current attributes.
void	unpack ()
	Unpack using dig_unpack.
template<class U , class Iterator >
void	excision_unpack (U &unpack, Iterator &input, float *output_data, uint64_t ndat, unsigned long *hist, unsigned *weights, unsigned nweights)
	Template method can be used to implement pure virtual dig_unpack.
void	not_built ()
	Derived types may not set built flag to true, but can set it to false.
Protected Member Functions inherited from dsp::HistUnpacker
virtual void	set_default_ndig ()
	Compute the default number of digitizers.
void	set_nstate_internal (unsigned _nstate)
	Set the number of states in the internal representation of the histogram.
unsigned	get_nstate_internal () const
Protected Member Functions inherited from dsp::Unpacker
virtual void	transformation ()
	The operation unpacks n-bit into floating point TimeSeries. More...
virtual void	match (const Observation *observation)
	Specialize the Unpacker for the Observation. More...
template<class T >
const T *	get_Input ()
	Provide BitSeries::input attribute access to derived classes.
Protected Member Functions inherited from dsp::Transformation< BitSeries, TimeSeries >
virtual bool	can_operate ()
	Return false if the input doesn't have enough data to proceed.
virtual void	operation ()
	Define the Operation pure virtual method.
virtual void	vchecks ()
	Makes sure input & output are okay before calling transformation()
Protected Member Functions inherited from dsp::Operation
virtual void	set_name (const std::string &_name)
	Set the name!
int	timers_index (const std::string &op_name)
	Returns the index in the 'timers' array of a particular timer.
Protected Member Functions inherited from Reference::Able
Handle *	__reference (bool active) const
void	__dereference (bool auto_delete=true) const
Static Protected Member Functions inherited from dsp::Unpacker
static Register &	get_register ()
	Return the list of registered sub-classes.
Protected Attributes inherited from dsp::SubByteTwoBitCorrection
TwoBit< 1, ShiftMask< 1 > >	unpack1
	Used to unpack one 2-bit sample from each byte.
TwoBit< 2, ShiftMask< 2 > >	unpack2
	Used to unpack two 2-bit samples from each byte.
Protected Attributes inherited from dsp::TwoBitCorrection
bool	dynamic_output_level_setting
	Perform dynamic output level setting.
Reference::To< TwoBitTable >	table
	Two-bit conversion table generator.
TwoBitFour	unpacker
	Two-bit unpacker.
Protected Attributes inherited from dsp::ExcisionUnpacker
Reference::To< WeightedTimeSeries >	weighted_output
	Set when Transformation::output is a WeightedTimeSeries.
float	cutoff_sigma
	Cut off power for impulsive interference excision.
unsigned	nlow_min
	Minumum number of low states in ndat_per_weight points.
unsigned	nlow_max
	Maximum number of low states in ndat_per_weight points.
JenetAnderson98	ja98
	The theory behind the implementation.
unsigned	current_digitizer
	The current digitized stream.
Protected Attributes inherited from dsp::Unpacker
TimeSeries::Order	output_order
	The order of the dimensions in the output TimeSeries.
Protected Attributes inherited from dsp::Transformation< BitSeries, TimeSeries >
Reference::To< BufferingPolicy >	buffering_policy
	The buffering policy in place (if any)
int64_t	minimum_samps_can_process
	If input doesn't have this many samples, operate() returns false.
Protected Attributes inherited from dsp::Operation
Scratch *	scratch
	Shared scratch space, if needed.
bool	set_scratch_called
std::string	name
	Operation name.
uint64_t	discarded_weights
	Number of time sample weights encountered that are flagged invalid.
uint64_t	total_weights
	Total number of time sample weights encountered.
RealTimer	optime
	Stop watch records the amount of time spent performing this operation.
int	id
	Unique instantiation id.
bool	prepared
	Set true when preparation optimizations are completed.
Protected Attributes inherited from dsp::HasInput< BitSeries >
Reference::To< const BitSeries >	input
	Container from which input data will be read.
Protected Attributes inherited from dsp::HasOutput< TimeSeries >
Reference::To< TimeSeries >	output
	Container into which output data will be written.

Detailed Description

Converts CPSR data from 2-bit digitized to floating point values.

Constructor & Destructor Documentation

CPSRTwoBitCorrection()

dsp::CPSRTwoBitCorrection::CPSRTwoBitCorrection

(

)

Constructor initializes base class atributes.

Null constructor.

References dsp::HistUnpacker::set_ndig(), and dsp::TwoBitCorrection::table.

Member Function Documentation

get_ndig_per_byte()

unsigned dsp::CPSRTwoBitCorrection::get_ndig_per_byte ( ) const

virtual

Over-ride the TwoBitCorrection default.

Each 2-bit sample from each digitizer is packed into one byte

Reimplemented from dsp::SubByteTwoBitCorrection.

get_output_incr()

unsigned dsp::CPSRTwoBitCorrection::get_output_incr ( ) const

virtual

Over-ride the TwoBitCorrection default.

The in-phase and quadrature components must be interleaved

Reimplemented from dsp::SubByteTwoBitCorrection.

get_output_ipol()

unsigned dsp::CPSRTwoBitCorrection::get_output_ipol ( unsigned  idig ) const

virtual

Over-ride the TwoBitCorrection default.

The first two digitizer channels are poln0, the last two are poln1

Reimplemented from dsp::SubByteTwoBitCorrection.

get_output_offset()

unsigned dsp::CPSRTwoBitCorrection::get_output_offset ( unsigned  idig ) const

virtual

Over-ride the TwoBitCorrection default.

The quadrature components must be offset by one

Reimplemented from dsp::SubByteTwoBitCorrection.

get_shift()

unsigned dsp::CPSRTwoBitCorrection::get_shift ( unsigned  idig, unsigned  isamp  ) const

virtual

Over-ride the SubByteTwoBitCorrection default.

MSB xQ xI yQ yI LSB

idig poln 0 0re = xI 1 0im = xQ 2 1re = yI 3 1im = yQ

Reimplemented from dsp::SubByteTwoBitCorrection.

---

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

• CPSRTwoBitCorrection.h
• CPSRTwoBitCorrection.C