UsTK : Ultrasound ToolKit  version 2.0.1 under development (2023-12-07)
usImagePreScanSettings Class Reference

#include <visp3/ustk_core/usImagePreScanSettings.h>

+ Inheritance diagram for usImagePreScanSettings:

Public Member Functions

 usImagePreScanSettings ()
 
 usImagePreScanSettings (const usTransducerSettings &transducerSettings, double axialResolution)
 
 usImagePreScanSettings (const usImagePreScanSettings &other)
 
virtual ~usImagePreScanSettings ()
 
Inherited functionalities from usTransducerSettings
double getDepth () const
 
double getFieldOfView () const
 
std::string getProbeName () const
 
int getSamplingFrequency () const
 
unsigned int getScanLineNumber () const
 
double getScanLinePitch () const
 
double getTransducerRadius () const
 
usTransducerSettings getTransducerSettings () const
 
int getTransmitFrequency () const
 
bool isTransducerConvex () const
 
bool operator== (usTransducerSettings const &other)
 
bool operator!= (usTransducerSettings const &other)
 
bool scanLineNumberIsSet () const
 
void setDepth (double depth)
 
void setFieldOfView (double fieldOfView)
 
void setProbeName (std::string probeName)
 
void setSamplingFrequency (const int samplingFrequency)
 
void setScanLineNumber (unsigned int scanLineNumber)
 
void setScanLinePitch (const double scanLinePitch)
 
void setTransducerConvexity (const bool isTransducerConvex)
 
void setTransducerSettings (const usTransducerSettings &other)
 
void setTransducerRadius (const double transducerRadius)
 
void setTransmitFrequency (const int transmitFrequency)
 

Inherited functionalities from usImagePreScanSettings

double getAxialResolution () const
 
usImagePreScanSettings getImagePreScanSettings () const
 
usImagePreScanSettingsoperator= (const usImagePreScanSettings &other)
 
bool operator== (const usImagePreScanSettings &other)
 
void setAxialResolution (const double axialResolution)
 
void setImagePreScanSettings (const usImagePreScanSettings &preScanSettings)
 

Detailed Description

Settings associated to ultrasound pre-scan images implemented in usImageRF2D, usImageRF3D, usImagePreScan2D and usImagePreScan3D.

This class represents ultrasound pre-scan image settings which are:

  • the common settings implemented in usTransducerSettings corresponding to the transducer settings. We recall that these common settings are:
    • the name of the probe that could be set using setProbeName() or retrieved using getProbeName().
    • the transducer radius $R_{_T}$ in meters (value set to zero for a linear transducer). Its value could be set using setTransducerRadius() and retrieved using getTransducerRadius().
    • the scan line pitch that corresponds to the angle $\alpha_{_{SC}}$ (in radians) between two successive scan line beams when the transducer is convex, or to the distance $d_{_{SC}}$ (in meters) when the transducer is linear. To set this value use setScanLinePitch() and to get its value use getScanLinePitch().
    • the number of scan lines $n_{_{SC}}$. To set this setting use setScanLineNumber() and to access to the value use getScanLineNumber().
    • the type of ultrasound transducer used for data acquisition: convex or linear. This parameter could be set using setTransducerConvexity(). To know the transducer type use isTransducerConvex().
    • the depth that corresponds to the distance in meters between the first and the last pixel in a scan line. To set this value use setDepth() and to get the depth use getDepth().
  • and an additional axial resolution parameter called $a_{_R}$ which corresponds to the distance (in meters) between two consecutive samples along a scan line. To set this value use setAxialResolution() and to retrieve this value use getAxialResolution(). Note that $a_{_R}$ may differ for RF images and pre-scan images.

Definition at line 80 of file usImagePreScanSettings.h.

Constructor & Destructor Documentation

◆ usImagePreScanSettings() [1/3]

usImagePreScanSettings::usImagePreScanSettings ( )

Default constructor, all parameters set with default values.

Definition at line 45 of file usImagePreScanSettings.cpp.

◆ usImagePreScanSettings() [2/3]

usImagePreScanSettings::usImagePreScanSettings ( const usTransducerSettings transducerSettings,
double  axialResolution 
)

Full settings constructor.

Parameters
transducerSettingsTransducer settings.
axialResolutionImage axial resolution in meters (distance between two samples in a scan line).

Definition at line 62 of file usImagePreScanSettings.cpp.

◆ usImagePreScanSettings() [3/3]

usImagePreScanSettings::usImagePreScanSettings ( const usImagePreScanSettings other)

Copy constructor.

Parameters
otherImage settings to copy.

Definition at line 51 of file usImagePreScanSettings.cpp.

◆ ~usImagePreScanSettings()

usImagePreScanSettings::~usImagePreScanSettings ( )
virtual

Destructor.

Definition at line 79 of file usImagePreScanSettings.cpp.

Member Function Documentation

◆ getAxialResolution()

◆ getDepth()

◆ getFieldOfView()

◆ getImagePreScanSettings()

usImagePreScanSettings usImagePreScanSettings::getImagePreScanSettings ( ) const

Definition at line 122 of file usImagePreScanSettings.cpp.

◆ getProbeName()

std::string usTransducerSettings::getProbeName ( ) const
inherited

Getter for the probe name.

Returns
Name of the probe.

Definition at line 232 of file usTransducerSettings.cpp.

◆ getSamplingFrequency()

int usTransducerSettings::getSamplingFrequency ( ) const
inherited

Getter for sampling frequency : frequency used to sample the echo of the ultrasound wave.

Returns
Sampling frequency Frequency in Hz.

Definition at line 305 of file usTransducerSettings.cpp.

Referenced by usTransducerSettings::operator=(), usTransducerSettings::operator==(), usImageIo::read(), usImageIo::write(), usMHDSequenceWriter::write(), and usImageSettingsXmlParser::writeMainClass().

◆ getScanLineNumber()

◆ getScanLinePitch()

◆ getTransducerRadius()

◆ getTransducerSettings()

usTransducerSettings usTransducerSettings::getTransducerSettings ( ) const
inherited

Getter for transducer settings : allows heritating classes to get the transducer settings.

Returns
The transducer settings.

Definition at line 295 of file usTransducerSettings.cpp.

◆ getTransmitFrequency()

int usTransducerSettings::getTransmitFrequency ( ) const
inherited

Getter for transmit frequency : frequency of the ultrasound wave used.

Returns
Transmit frequency in Hz.

Definition at line 311 of file usTransducerSettings.cpp.

Referenced by usTransducerSettings::operator=(), usTransducerSettings::operator==(), usImageIo::read(), usImageIo::write(), usMHDSequenceWriter::write(), and usImageSettingsXmlParser::writeMainClass().

◆ isTransducerConvex()

◆ operator!=()

bool usTransducerSettings::operator!= ( usTransducerSettings const &  other)
inherited

Compare two probe transducer settings.

Returns
False if the settings are the same, true otherwise.

Definition at line 125 of file usTransducerSettings.cpp.

References usTransducerSettings::operator==().

◆ operator=()

◆ operator==() [1/2]

bool usImagePreScanSettings::operator== ( const usImagePreScanSettings other)

Comparison operator.

Parameters
otherusImagePreScanSettings to compare with.

Definition at line 97 of file usImagePreScanSettings.cpp.

References getAxialResolution().

Referenced by usImageRF2D< Type >::operator==().

◆ operator==() [2/2]

◆ scanLineNumberIsSet()

bool usTransducerSettings::scanLineNumberIsSet ( ) const
inherited

Getter to know if the scan line number is set (usefull in case of field of view setter call).

Returns
Boolean to know if the scan line number is set or not.

Definition at line 277 of file usTransducerSettings.cpp.

Referenced by usTransducerSettings::operator=().

◆ setAxialResolution()

◆ setDepth()

◆ setFieldOfView()

void usTransducerSettings::setFieldOfView ( double  fieldOfView)
inherited

Setter for the transducer field of view (updates the scan line pitch).

Parameters
fieldOfViewThe transducer field of view in radians if the transducer is convex, in meters if the transducer is linear.
Warning
Be sure to use setScanLineNumber() to update the scan line number before the field of view since this method computes the scan line pitch from the field of view and the scan line pitch.
usTransducerSettings transducerSettings;
transducerSettings.setScanLineNumber(128);
transducerSettings.setFieldOfView(vpMath::rad(57.0)); // field of view is 57 deg
Generic class for 2D ultrasound data common settings associated to the type of probe transducer used ...
void setFieldOfView(double fieldOfView)
void setScanLineNumber(unsigned int scanLineNumber)
Examples
tutorial-servo-target-confidence.cpp, tutorial-servo-target.cpp, tutorial-sonosite-confidence-control.cpp, and tutorial-sonosite-confidence-map.cpp.

Definition at line 265 of file usTransducerSettings.cpp.

Referenced by usPostScanToPreScan2DConverter::convert().

◆ setImagePreScanSettings()

◆ setProbeName()

void usTransducerSettings::setProbeName ( std::string  probeName)
inherited

◆ setSamplingFrequency()

◆ setScanLineNumber()

◆ setScanLinePitch()

void usTransducerSettings::setScanLinePitch ( const double  scanLinePitch)
inherited

◆ setTransducerConvexity()

◆ setTransducerRadius()

◆ setTransducerSettings()

void usTransducerSettings::setTransducerSettings ( const usTransducerSettings other)
inherited

Assignment operator.

Parameters
otherSettings you want to assign.
See also
operator=()
Examples
tutorial-ultrasonix-qt-grabbing-RF-scan-conversion.cpp.

Definition at line 210 of file usTransducerSettings.cpp.

Referenced by usPreScanToPostScan3DConverter::convert().

◆ setTransmitFrequency()