Digitizer.h
1 //-*-C++-*-
2 /***************************************************************************
3  *
4  * Copyright (C) 2007 by Willem van Straten
5  * Licensed under the Academic Free License version 2.1
6  *
7  ***************************************************************************/
8 
9 // dspsr/Kernel/Classes/dsp/Digitizer.h
10 
11 
12 #ifndef __Digitizer_h
13 #define __Digitizer_h
14 
15 #include "dsp/Transformation.h"
16 #include "dsp/TimeSeries.h"
17 #include "dsp/BitSeries.h"
18 
19 namespace dsp {
20 
22  class Digitizer : public Transformation <TimeSeries, BitSeries>
23  {
24 
25  public:
26 
28  Digitizer (const char* name = "Digitizer");
29 
31  virtual void set_nbit (int);
32 
34  int get_nbit () const;
35 
37  virtual void prepare ();
38 
40  virtual void reserve ();
41 
42  protected:
43 
44  virtual void transformation ();
45 
47  virtual void pack () = 0;
48 
49  int nbit;
50 
51  };
52 
53 }
54 
55 #endif // !defined(__Digitizer_h)
dsp::IOManager::open
virtual void open(const std::string &id)
Prepare the appropriate Input and Unpacker.
Definition: IOManager.C:38
dsp::IOManager
Produces TimeSeries data by integrating an Input with an Unpacker.
Definition: IOManager.h:26
dsp::HistUnpacker
Bit unpacker that keeps a histogram and optimal statistics.
Definition: HistUnpacker.h:25
dsp
Contains all Baseband Data Reduction Library classes.
Definition: ASCIIObservation.h:17
dsp::Transformation
Defines the interface by which Transformations are performed on data.
Definition: Transformation.h:54
dsp::File::create
static File * create(const char *filename)
Return a pointer to a new instance of the appropriate sub-class.
Definition: File.C:67
dsp::Observation::verbose
static bool verbose
Verbosity flag.
Definition: Observation.h:39
dsp::LevelMonitor::set_max_iterations
void set_max_iterations(unsigned)
Set the maximum number of iterations before giving up.
Definition: LevelMonitor.C:155
dsp::Digitizer::get_nbit
int get_nbit() const
Get the number of bits per sample (FITS BITPIX convention)
Definition: Digitizer.C:31
dsp::Observation::get_nbit
unsigned get_nbit() const
Return the number of bits per value.
Definition: Observation.h:95
CommandLine::Menu::find
Argument * find(const std::string &name)
dsp::LevelMonitor::verbose
static bool verbose
Verbosity flag.
Definition: LevelMonitor.h:38
dsp::Observation::get_interface
virtual TextInterface::Parser * get_interface()
Return a text interface that can be used to access this instance.
Definition: Observation.C:528
dsp::LevelMonitor::monitor
virtual void monitor()
Using input and converter, calculate sampling thresholds.
Definition: LevelMonitor.C:174
dsp::LevelMonitor::set_input
void set_input(IOManager *input)
Set the device to be used to plot/log the digitizer statistics.
Definition: LevelMonitor.C:63
dsp::Observation::get_rate
double get_rate() const
Return the sampling rate (time samples per second in Hz)
Definition: Observation.h:157
CommandLine::Menu::set_help_header
virtual void set_help_header(const std::string &s)
dsp::Digitizer::reserve
virtual void reserve()
Resize the output.
Definition: Digitizer.C:36
MEAL::sqrt
const ScalarMath sqrt(const ScalarMath &x)
dsp::Operation::name
std::string name
Operation name.
Definition: Operation.h:153
dsp::Observation
Stores information about digital, band-limited, time-varying signals.
Definition: Observation.h:33
dsp::Input::eod
virtual bool eod() const =0
End of data.
dsp::TimeSeries
Arrays of consecutive samples for each polarization and frequency channel.
Definition: TimeSeries.h:29
dsp::LoadToFITS::Config
Load, unpack, filterbank, re-digitize, and write to FITS.
Definition: LoadToFITS.h:71
dsp::Observation::get_bandwidth
double get_bandwidth() const
Return the bandwidth of signal in MHz (-ve = lsb; +ve = usb)
Definition: Observation.h:147
dsp::DADAOutputFile
Writes BitSeries data to a single DADA File.
Definition: DADAOutputFile.h:28
dsp::HistUnpacker::get_output_ichan
virtual unsigned get_output_ichan(unsigned idig) const
Get the output frequency channel for the given digitizer;.
Definition: HistUnpacker.C:132
dsp::HistUnpacker::get_output_ipol
virtual unsigned get_output_ipol(unsigned idig) const
Get the output polarization for the given digitizer.
Definition: HistUnpacker.C:123
dsp::LevelMonitor::set_swap_polarizations
void set_swap_polarizations(bool swap)
Swap the polarizations.
Definition: LevelMonitor.C:160
dsp::LevelMonitor::set_consecutive
void set_consecutive(bool swap)
Read data consecutively (do not seek to end on each iteration)
Definition: LevelMonitor.C:165
dsp::Operation::verbose
static bool verbose
Global verbosity flag.
Definition: Operation.h:48
dsp::BitSeries
A container for storing digitized (generally not floating point) data
Definition: BitSeries.h:35
CommandLine::Menu::add
virtual void add(Item *)
FTransform::get_library
std::string get_library()
dsp::LoadToFil::Config
Load, unpack, process and fold data into phase-averaged profile(s)
Definition: LoadToFil.h:72
CommandLine::Menu::set_version
virtual void set_version(const std::string &s)
dsp::BitStatsPlotter
Plots the histograms maintained by HistUnpacker classes.
Definition: BitStatsPlotter.h:28
dsp::LoadToFilN
Multiple LoadToFil threads.
Definition: LoadToFilN.h:22
Reference::verbose
bool verbose
dsp::LoadToFITSN
Multiple LoadToFITS threads.
Definition: LoadToFITSN.h:22
dsp::Digitizer::pack
virtual void pack()=0
Perform the digitization.
dsp::ExcisionUnpacker::set_cutoff_sigma
virtual void set_cutoff_sigma(float cutoff_sigma)
Set the cut off power for impulsive interference excision.
Definition: ExcisionUnpacker.C:286
dsp::Digitizer::prepare
virtual void prepare()
Copy the input attributes to the output.
Definition: Digitizer.C:14
dsp::Unpacker
Abstract base class of Transformations that convert n-bit to float.
Definition: Unpacker.h:42
dsp::Digitizer::set_nbit
virtual void set_nbit(int)
Set the number of bits per sample (FITS BITPIX convention)
Definition: Digitizer.C:26
dsp::Digitizer::Digitizer
Digitizer(const char *name="Digitizer")
Constructor.
Definition: Digitizer.C:62
dsp::HistUnpacker::get_ndig
virtual unsigned get_ndig() const
Get the number of digitizers (histograms)
Definition: HistUnpacker.C:38
dsp::Unpacker::get_iterator
Iterator get_iterator(unsigned idig)
Return the iterator for the specified digitizer.
Definition: Unpacker.C:129
dsp::version
const float version
The baseband/dsp version number.
Definition: dsp.C:19
dsp::LoadToQuantize
Decimates input time series.
Definition: LoadToQuantize.h:30
dsp::LoadToFITS
A single LoadToFITS thread.
Definition: LoadToFITS.h:29
TextInterface::Parser::help
virtual std::string help(bool show_default_values=false, bool show_header=false, const char *indent=0)
dsp::LevelMonitor::set_between_iterations
void set_between_iterations(double seconds)
Set the number of seconds to sleep between iterations.
Definition: LevelMonitor.C:108
dsp::ExcisionStatsPlotter
Plots the histograms maintained by ExcisionUnpacker.
Definition: ExcisionStatsPlotter.h:26
dsp::UnpackerSource::get_input
const InputType * get_input() const
Return pointer to the appropriate InputType.
Definition: UnpackerSource.h:77
dsp::LoadToFil
A single LoadToFil thread.
Definition: LoadToFil.h:30
dsp::LevelMonitor
Monitors digitizer levels and issues corrective commands.
Definition: LevelMonitor.h:32
dsp::UnpackerSource::get_unpacker
const UnpackerType * get_unpacker() const
Return pointer to the appropriate UnpackerType.
Definition: UnpackerSource.h:242
dsp::Observation::get_start_time
MJD get_start_time() const
Return the start time of the leading edge of the first time sample.
Definition: Observation.h:152
dsp::Unpacker::Iterator
Interface to Unpacker iterator implementations.
Definition: UnpackerIterator.h:24
dsp::Digitizer::transformation
virtual void transformation()
Initialize and resize the output before calling unpack.
Definition: Digitizer.C:46
dsp::ASCIIObservation
Parses Observation attributes from an ASCII header.
Definition: ASCIIObservation.h:29
CommandLine::Menu::parse
virtual void parse(int argc, char *const *argv)
dsp::ExcisionUnpacker
Excises digitized data with statistics outside of acceptable limits.
Definition: ExcisionUnpacker.h:28
dsp::TimeSeries::OrderFPT
@ OrderFPT
Frequency, Polarization, Time (default before 3 October 2008)
Definition: TimeSeries.h:47
dsp::LoadToQuantize::Config
LoadToQuantize configuration.
Definition: LoadToQuantize.h:88
Generated using doxygen 1.8.17