The VisAO Camera
VisAO::reconstructor Class Reference

The VisAO reconstructor. More...

#include <reconstructor.h>

+ Inheritance diagram for VisAO::reconstructor:

Public Member Functions

 reconstructor (int argc, char **argv) throw (AOException)
 
 reconstructor (std::string, const std::string &conffile) throw (AOException)
 
int set_matint (std::string matintfile)
 
int set_lambda (float lam)
 
float get_lambda ()
 
int set_filter (std::string fname)
 
std::string get_filter ()
 
int set_cal_a (float a)
 
float get_cal_a ()
 
int set_cal_b (float b)
 
float get_cal_b ()
 
int reconstruct ()
 
virtual int Run ()
 The application main loop, to be re-implemented in derived classes.
 
std::string local_command (std::string com)
 Called by __local_command after control state logic. More...
 
std::string script_command (std::string com)
 Called by __script_command after control state logic. More...
 
std::string common_command (std::string com, int cmode)
 
virtual int update_statusboard ()
 Update the reconstructor Status Board shared memory.
 
- Public Member Functions inherited from VisAO::VisAOApp_standalone
 VisAOApp_standalone () throw (AOException)
 Default constructor.
 
 VisAOApp_standalone (string name, int id, int logLevel=Logger::LOG_LEV_INFO) throw (AOException)
 Complicated constructor.
 
void set_conffile (std::string name) throw (AOException)
 
 VisAOApp_standalone (std::string name, const std::string &conffile) throw (AOException)
 Config file constructor.
 
void set_conffile (std::string name, const std::string &conffile) throw (AOException)
 For use if default constructed.
 
 VisAOApp_standalone (int argc, char **argv) throw (AOException)
 Command line constructor.
 
void usage ()
 
virtual std::string get_app_name ()
 Get the application name.
 
void log_msg (int LogLevel, std::string lmsg)
 Report an error. Also calls log_msg. Overloaded from VisAOApp_base. More...
 
virtual int Exec ()
 Installs the term and XXXX signal handlers, and calls Run(). More...
 
void signal_catcher ()
 Signal loop, normally won't need to be overridden. More...
 
virtual int start_signal_catcher (bool inherit_sched=true)
 Starts the signal catching loop. More...
 
virtual int install_sig_mainthread_catcher ()
 Install the SIG_MAINTHREAD signal catcher.
 
virtual int block_signal (int signum)
 Sets the signal mask to block signal signum.
 
virtual int block_sigio ()
 Sets the signal mask to block SIGIO and RTSIGIO.
 
virtual int kill_me ()
 Handle a timetodie condition upon exiting the signal catcher thread (e.g. tell main thread it is about to die) More...
 
- Public Member Functions inherited from VisAO::VisAOApp_base
 VisAOApp_base ()
 Default constructor.
 
virtual ~VisAOApp_base ()
 Virtual destructor.
 
int set_euid_called ()
 Changes the user id of the process to euid_called.
 
int set_euid_real ()
 Changes the user id fo the process to the real user id.
 
int set_RT_priority (int prio)
 Set the real-time priority of the current process. More...
 
int get_RT_priority ()
 Get the real-time priority of the current process.
 
int set_app_name (std::string an)
 Set the application name.
 
virtual int setup_baseApp (bool usethreads=false)
 Install fifo channels. More...
 
virtual int setup_baseApp (bool remfifo, bool locfifo, bool scrfifo, bool autfifo, bool usethreads=false)
 Create fifo names, then installs the fifo channels. More...
 
int setup_fifo_list (int nfifos)
 Allocate the fifo_list. More...
 
int connect_fifo_list ()
 Connect the fifo_list with exclusive locking. More...
 
int connect_fifo_list_nolock ()
 Connect the fifo_list without exclusive locking. More...
 
int setup_sigio ()
 Setup the SIGIO signal handling. More...
 
int setup_RTsigio ()
 Setup SIGIO signal handling using realtime signals. More...
 
int check_fifo_list_RTpending ()
 Check for pending reads for the fifo list while using the RT signals.
 
int write_fifo_channel (int ch, const char *com, int comlen, std::string *resp)
 Write data to a fifo_channel, and get a response if desired. More...
 
int write_fifo_channel (int ch, const char *com, int comlen, std::string *resp, char *sm)
 Write data to a fifo_channel, with a sequence message attached, and get a response if desired. More...
 
int get_fifo_channel_response (std::string *resp, int ch)
 Check, and wait if neccessary, for data on a fifo channel. More...
 
int set_wait_to (double to)
 Set the wait timeout for fifo channel responses. More...
 
double get_wait_to ()
 Get the wait timeout for fifo channel responses. More...
 
virtual int request_control (int cmode)
 Calls request_control(cmode, 0).
 
virtual int request_control (int cmode, bool override)
 Attempts to change the control type. More...
 
virtual std::string __remote_command (std::string com, char *seqmsg)
 Processing for remote commands. More...
 
virtual std::string remote_command (std::string com)
 Called by __remote_command after control state logic. More...
 
virtual std::string remote_command (std::string com, char *seqmsg)
 
virtual std::string __local_command (std::string com, char *seqmsg)
 Processing for local commands. More...
 
virtual std::string local_command (std::string com, char *seqmsg)
 
virtual std::string __script_command (std::string com, char *seqmsg)
 Processing for script commands - not normally overriden. More...
 
virtual std::string script_command (std::string com, char *seqmsg)
 
virtual std::string auto_command (std::string com, char *seqmsg)
 Processing for auto commands - to be overriden. More...
 
virtual std::string post_auto_command (std::string com, char *seqmsg=0)
 Processing for auto commands - not normally overriden. More...
 
std::string control_mode_string ()
 Convenience function to return the control type string, e.g. "REMOTE".
 
std::string control_mode_response ()
 Convenience function to return the control type response string, e.g. "A\n".
 
virtual void error_report (int LogLevel, std::string emsg)
 Report an error. Also calls log_msg. More...
 
VisAO::profilerget_profile ()
 
int get_use_profiler ()
 
int start_profiler ()
 
void * get_statusboard_shmemptr ()
 Get the status board shared memory pointer. More...
 
int set_statusboard_shmemkey (key_t mkey)
 Set the status board shared memory key. Does nothing else. More...
 
key_t get_statusboard_shmemkey ()
 Get the status board shared memory key. More...
 
virtual void dataLogger (timeval tv)
 Log data at intervals.
 

Protected Member Functions

void Create ()
 Processes the config file.
 
- Protected Member Functions inherited from VisAO::VisAOApp_base
int create_statusboard (size_t sz)
 Creates and attaches to the statusboard shared memory. More...
 
std::string getDataFileName ()
 
int checkDataFileOpen ()
 

Protected Attributes

recmat rmat
 
int valid_recmat
 
std::string recFileName
 
int n_modes
 
int ho_middle
 
int slopes_shmem_key
 The key for the shared memory for slopes.
 
sharedim_stack< unsigned char > slopes_sis
 The shared memory ring buffer for slopes storage.
 
sharedim< unsigned char > slopes_sim
 Shared memory image of slopes (a vector actually)
 
sharedim_stack< float > strehl_sis
 Shared memory ring buffer for strehl data.
 
sharedim< float > * strehl_sim
 Shared memory image, from ring buffer, for strehl data.
 
sharedim< float > strehl_simavg
 Shared memory image, from ring buffer, for strehl data.
 
float lambda
 
float lamgain
 
std::string filter_name
 
fir_filter fir
 
float cal_a
 
float cal_b
 
float sumv
 
float rawstrehl
 
float filtstrehl
 
float filt_tip
 
float tilt_tilt
 
float tt_wfe
 
float ho1_wfe
 
float ho2_wfe
 
float filt_tt_wfe
 
float filt_ho1_wfe
 
float filt_ho2_wfe
 
float rms_tt_wfe
 
float rms_ho1_wfe
 
float rms_ho2_wfe
 
rmsAccumulator< float > rmsAccum
 
float * strehldata
 
float * wfedata
 
float * slopes
 
int strehls_shmem_key
 Pointer to the slopes vector.
 
int num_strehls
 
std::string ping_fifo_path
 
pthread_mutex_t reconMutex
 
VisAO::reconstructor_status_boardrsb
 
VisAO::aosystem_status_boardaosb
 
bool FSPing_enabled
 
- Protected Attributes inherited from VisAO::VisAOApp_standalone
std::string init_file
 
Config_File * init_vars
 
pthread_t main_thread
 Identifier for the main thread.
 
pthread_t signal_thread
 Identifier for the separate signal handling thread.
 
pthread_mutex_t signal_mutex
 Mutex for the condition signaling.
 
pthread_cond_t signal_cond
 Condition for telling main thread that something changed.
 
double signalth_sleeptime
 
- Protected Attributes inherited from VisAO::VisAOApp_base
std::string app_name
 The name of the application.
 
double pause_time
 Time to pause during application main loop.
 
fifo_list fl
 The list of named-pipe fifos used for inter-process comms.
 
std::string com_path
 The control fifo path base name.
 
std::string com_path_remote
 The path for the remote control fifos.
 
std::string com_path_local
 The path for the local control fifos.
 
std::string com_path_script
 The path for the script control fifos.
 
std::string com_path_auto
 The path for the auto control fifos.
 
double wait_to
 The timeout for waiting on responses from FIFOs in seconds.
 
std::ostringstream logss
 Conveninence string stream for building log messages.
 
VisAO::profilerprofile
 
std::string profile_path
 
int use_profiler
 
void * statusboard_shmemptr
 The pointer to the shared memory block for the statusboard.
 
key_t statusboard_shmemkey
 The key used to lookup the shared memory.
 
int statusboard_shmemid
 The ID of the shared memory block.
 
std::ofstream dataof
 
bool dataFileOpen
 
double dataFileOpenTime
 
double data_log_time_length
 
std::string data_save_path
 
std::string data_file_prefix
 

Additional Inherited Members

- Public Types inherited from VisAO::VisAOApp_base
enum  control_modes {
  CMODE_NONE, CMODE_REMOTE, CMODE_LOCAL, CMODE_SCRIPT,
  CMODE_AUTO, CMODE_max
}
 The control modes.
 
- Static Public Member Functions inherited from VisAO::VisAOApp_standalone
static const std::string & ConfigFile ()
 
static const std::string & MyName ()
 
static const std::string & MyFullName ()
 
static int ID ()
 
static Config_File & ConfigDictionary ()
 
static int Verbosity ()
 
static string getConffile (string identity)
 Return configuration file path based on identity.
 
- Public Attributes inherited from VisAO::VisAOApp_base
pthread_mutex_t my_mutex
 Mutex used by the threaded versions of the standard command handlers.
 
- Static Protected Member Functions inherited from VisAO::VisAOApp_standalone
static void SetMyName (const std::string &name)
 
static void SetConfigFile (const std::string &conffile) throw (Config_File_Exception)
 
static void SetID (int id)
 
- Static Protected Attributes inherited from VisAO::VisAOApp_standalone
static Logger * _logger = NULL
 
- Static Protected Attributes inherited from VisAO::VisAOApp_base
static int control_mode = VisAOApp_base::CMODE_NONE
 The current control mode. More...
 
static int default_control_mode = -1
 The default control mode. More...
 

Detailed Description

This class provides a framework for a reconstructing wavefronts from slopes computed elsewhere, nominally by the BCU39 and provided by the framegrabber39 process. Receives pings from the framegrabber39 process when a new frame arrives. Sends pings to the frameselector process.

See VisAOApp_standalone for command line arguments. There are no additional command line arguments for reconstructor.

This is a standalone VisAOApp, so it doesn't depend on MsgD.

The following configuration values are optional:

  • ping_fifo_path string [fifos] - path, relative to VISAO_ROOT, specifying where to create the input and output pings
  • bcu39_shmem_key int [DATA_framegrabber39] - shared memory key for the framegrabber 39 frames circular buffer
  • strehls_shmem_key int [DATA_strehls] - shared memory key for the Strehls circular buffer
  • num_strehls int [2500] - number of Strehls to store in the Strehls circular buffer
  • rec_tech int [REC_ATLAS] - if 0 (REC_ATLAS), then the CPU is used for reconstruction. if 1 (REC_GPU) then the GPU is used for reconstruction.
  • tel_diam double [6.5] - primary diamter
  • median_r0 double [8.0] - median Fried parameter
  • median_r0_lam double [0.55] - wavelength at which median Fried parameter
  • fitting_A double [0.232555] - fitting error A coefficient (Males et al, SPIE, 2012)
  • fitting_B double [-0.840466] - fitting error B coefficient (Males et al, SPIE, 2012)
  • reflection_gain double [2.] - gain to go from surface to phase WFE. (normally 2, but it's 4 on the CRO due to double pass)

Definition at line 82 of file reconstructor.h.

Member Function Documentation

std::string VisAO::reconstructor::local_command ( std::string  com)
virtual

This should be overriden by derived classes.

Parameters
comis the command string to be processed.
Returns
the application response.

Reimplemented from VisAO::VisAOApp_base.

Definition at line 502 of file reconstructor.cpp.

std::string VisAO::reconstructor::script_command ( std::string  com)
virtual

This should be overriden by derived classes.

Parameters
comis the command string to be processed.
Returns
the application response.

Reimplemented from VisAO::VisAOApp_base.

Definition at line 511 of file reconstructor.cpp.


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