STIR 6.4.0
stir::CListModeDataLMF Class Reference

A class that reads the listmode data from an LMF file. More...

#include "stir_experimental/listmode/CListModeDataLMF.h"

Inheritance diagram for stir::CListModeDataLMF:

Public Member Functions

 CListModeDataLMF (const std::string &listmode_filename)
 Constructor taking a filename.
 
virtual std::time_t get_scan_start_time_in_secs_since_1970 () const
 
virtual shared_ptr< CListRecordget_empty_record_sptr () const
 Get a pointer to an empty record.
 
virtual bool has_delayeds () const
 LMF listmode data stores delayed events as well (as opposed to prompts)
 
virtual Succeeded get_next_record (CListRecord &event) const
 Gets the next record in the listmode sequence.
 
virtual Succeeded reset ()
 Call this function if you want to re-start reading at the beginning.
 
virtual SavedPosition save_get_position ()
 Save the current reading position.
 
virtual Succeeded set_get_position (const SavedPosition &)
 Set the position for reading to a previously saved point.
 
- Public Member Functions inherited from stir::ListModeData
 ListModeData ()
 Default constructor.
 
 ListModeData (shared_ptr< const ExamInfo > exam_info_sptr, shared_ptr< const ProjDataInfo > proj_data_info_sptr)
 
virtual std::string get_name () const =0
 Returns the name of the list mode data.
 
shared_ptr< ListRecordget_empty_record_sptr () const
 Get a pointer to an empty record.
 
virtual Succeeded get_next_record (ListRecord &event) const
 Gets the next record in the listmode sequence.
 
const Scannerget_scanner () const
 Get reference to scanner.
 
virtual unsigned long int get_total_number_of_events () const
 Returns the total number of events in the listmode file.
 
- Public Member Functions inherited from stir::ExamData
 ExamData ()
 ExamData.
 
 ExamData (const shared_ptr< const ExamInfo > &_this_exam)
 
virtual const ExamInfoget_exam_info () const
 
virtual shared_ptr< const ExamInfoget_exam_info_sptr () const
 Get shared pointer to exam info.
 
virtual void set_exam_info (ExamInfo const &)
 change exam info
 
void set_exam_info_sptr (shared_ptr< const ExamInfo > new_exam_info_sptr)
 
- Public Member Functions inherited from stir::DataWithProjDataInfo
 DataWithProjDataInfo ()
 Default constructor sets internal member to 0.
 
 DataWithProjDataInfo (const shared_ptr< const ProjDataInfo > &proj_data_info_sptr_v)
 
virtual const ProjDataInfoget_proj_data_info () const
 
virtual shared_ptr< const ProjDataInfoget_proj_data_info_sptr () const
 Get shared pointer to ProjData info.
 
int get_num_segments () const
 Get number of segments.
 
int get_num_axial_poss (const int segment_num) const
 Get number of axial positions per segment.
 
int get_num_views () const
 Get number of views.
 
int get_num_tangential_poss () const
 Get number of tangential positions.
 
int get_num_tof_poss () const
 Get number of TOF positions.
 
int get_min_tof_pos_num () const
 Get the index of the first timing position.
 
int get_max_tof_pos_num () const
 Get the index of the last timing position.
 
int get_tof_mash_factor () const
 Get TOG mash factor.
 
int get_min_segment_num () const
 Get minimum segment number.
 
int get_max_segment_num () const
 Get maximum segment number.
 
int get_min_axial_pos_num (const int segment_num) const
 Get mininum axial position per segmnet.
 
int get_max_axial_pos_num (const int segment_num) const
 Get maximum axial position per segment.
 
int get_min_view_num () const
 Get minimum view number.
 
int get_max_view_num () const
 Get maximum view number.
 
int get_min_tangential_pos_num () const
 Get minimum tangential position number.
 
int get_max_tangential_pos_num () const
 Get maximum tangential position number.
 

Additional Inherited Members

- Public Types inherited from stir::ListModeData
typedef ListModeData hierarchy_base_type
 typedef used by read_from_file
 
typedef unsigned int SavedPosition
 Use this typedef for save/set_get_position.
 
- Protected Member Functions inherited from stir::CListModeData
shared_ptr< ListRecordget_empty_record_helper_sptr () const override
 
Succeeded get_next (ListRecord &event) const override
 
- Protected Member Functions inherited from stir::ListModeData
virtual void set_proj_data_info_sptr (shared_ptr< const ProjDataInfo >)
 
- Protected Attributes inherited from stir::ExamData
shared_ptr< const ExamInfoexam_info_sptr
 
- Protected Attributes inherited from stir::DataWithProjDataInfo
shared_ptr< const ProjDataInfoproj_data_info_sptr
 

Detailed Description

A class that reads the listmode data from an LMF file.

Member Function Documentation

◆ get_empty_record_sptr()

shared_ptr< CListRecord > stir::CListModeDataLMF::get_empty_record_sptr ( ) const
virtual

Get a pointer to an empty record.

This is mainly/only useful to get a record of the correct type, that can then be passed to get_next_record().

Implements stir::CListModeData.

◆ has_delayeds()

virtual bool stir::CListModeDataLMF::has_delayeds ( ) const
inlinevirtual

LMF listmode data stores delayed events as well (as opposed to prompts)

Implements stir::CListModeData.

◆ get_next_record()

Succeeded stir::CListModeDataLMF::get_next_record ( CListRecord & event) const
virtual

Gets the next record in the listmode sequence.

Implements stir::CListModeData.

◆ reset()

Succeeded stir::CListModeDataLMF::reset ( )
virtual

Call this function if you want to re-start reading at the beginning.

Implements stir::ListModeData.

◆ save_get_position()

CListModeData::SavedPosition stir::CListModeDataLMF::save_get_position ( )
virtual

Save the current reading position.

Note that the return value is not related to the number of events already read. In particular, you cannot do any arithmetic on it to skip a few events. This is different from e.g. std::streampos.

Warning
There is a maximum number of times this function can be called. This is determined by the SavedPosition type. Once you save more positions, the first positions will be overwritten. There is currently no way of finding out after how many times this will happen (but it's a large number...).
These saved positions are only valid for the lifetime of the ListModeData object.
A derived class might disable this facility. It will/should then always return Succeeded::no when calling set_get_position().

Implements stir::ListModeData.

◆ set_get_position()

Succeeded stir::CListModeDataLMF::set_get_position ( const SavedPosition & )
virtual

Set the position for reading to a previously saved point.

Implements stir::ListModeData.


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