UsTK : Ultrasound ToolKit
version 2.0.1 under development (2024-11-21)
|
#include <visp3/ustk_core/usImagePreScan2D.h>
Public Member Functions | |
usImagePreScan2D () | |
usImagePreScan2D (unsigned int height, unsigned int width) | |
usImagePreScan2D (const vpImage< Type > &image, const usImagePreScanSettings &preScanSettings) | |
usImagePreScan2D (const usImagePreScan2D &other) | |
virtual | ~usImagePreScan2D () |
unsigned int | getBModeSampleNumber () const |
usImagePreScan2D< Type > & | operator= (const usImagePreScan2D< Type > &other) |
bool | operator== (const usImagePreScan2D< Type > &other) |
bool | operator!= (const usImagePreScan2D< Type > &other) |
void | setData (const vpImage< Type > image) |
void | setScanLineNumber (unsigned int scanLineNumber) |
void | resize (const unsigned int h, const unsigned int w) |
void | resize (const unsigned int h, const unsigned int w, const Type val) |
Inherited functionalities from usImagePreScanSettings | |
double | getAxialResolution () const |
usImagePreScanSettings | getImagePreScanSettings () const |
bool | operator== (const usImagePreScanSettings &other) |
void | setAxialResolution (const double axialResolution) |
void | setImagePreScanSettings (const usImagePreScanSettings &preScanSettings) |
Inherited functionalities from usTransducerSettings | |
bool | operator== (usTransducerSettings const &other) |
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 | scanLineNumberIsSet () const |
void | setDepth (double depth) |
void | setFieldOfView (double fieldOfView) |
void | setProbeName (std::string probeName) |
void | setSamplingFrequency (const int samplingFrequency) |
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) |
2D pre-scan ultrasound image.
This class represents a 2D pre-scan ultrasound image. This image is nothing more than a vpImage that contains ultrasound 2D pre-scan data and additional settings that give information about the acquisition process done by the transducer. The bitmap storage is done in row-major.
The settings associated to an usImagePreScan2D image are the one implemented in usImagePreScanSettings. We recall that these settings are:
The following figure summarize these settings and shows the structure of an usImagePreScan2D image:
The following example shows how to build a 2D pre-scan ultrasound image from a vpImage and from acquisition settings.
Definition at line 105 of file usImagePreScan2D.h.
usImagePreScan2D< Type >::usImagePreScan2D |
Basic constructor, all settings set to default values.
Definition at line 141 of file usImagePreScan2D.h.
usImagePreScan2D< Type >::usImagePreScan2D | ( | unsigned int | height, |
unsigned int | width | ||
) |
Constructor from image size.
height | Image height. |
width | Image width. |
Definition at line 159 of file usImagePreScan2D.h.
References usTransducerSettings::setScanLineNumber().
usImagePreScan2D< Type >::usImagePreScan2D | ( | const vpImage< Type > & | image, |
const usImagePreScanSettings & | preScanSettings | ||
) |
Constructor from an image and pre-scan settings.
image | Image you want to set. |
preScanSettings | Pre-scan settings you want to set. |
Definition at line 171 of file usImagePreScan2D.h.
References usTransducerSettings::getScanLineNumber().
usImagePreScan2D< Type >::usImagePreScan2D | ( | const usImagePreScan2D< Type > & | other | ) |
Copy constructor.
other | 2D pre-scan image you want to copy. |
Definition at line 148 of file usImagePreScan2D.h.
|
virtual |
Destructor.
Definition at line 181 of file usImagePreScan2D.h.
|
inherited |
Axial resolution getter.
Definition at line 120 of file usImagePreScanSettings.cpp.
Referenced by usMHDSequenceReader::acquire(), usPreScanToPostScan2DConverter::convert(), usMHDSequenceReader::getImage(), usNetworkGrabberPreScan3D::includeFrameInVolume(), usNetworkGrabberRF3D::includeFrameInVolume(), usPreScanToPostScan3DConverter::init(), usImagePreScanSettings::operator=(), usImagePreScanSettings::operator==(), usImageIo::read(), usImageIo::write(), and usMHDSequenceWriter::write().
unsigned int usImagePreScan2D< Type >::getBModeSampleNumber |
Get the number of A-samples of B-Mode samples in a scan line.
Definition at line 227 of file usImagePreScan2D.h.
Referenced by usPostScanToPreScan2DConverter::convert(), usPreScanToPostScan2DConverter::convert(), usImageIo::read(), and usImageIo::write().
|
inherited |
Setter for depth : distance in meters between first and last pixel in a scan line.
Definition at line 289 of file usTransducerSettings.cpp.
Referenced by usPostScanToPreScan2DConverter::convert(), usPreScanToPostScan2DConverter::convert(), usRFToPreScan3DConverter::convert(), usNetworkGrabberPreScan2D::dataArrived(), usNetworkGrabberPreScan3D::includeFrameInVolume(), usNetworkGrabberRF3D::includeFrameInVolume(), usPostScanToPreScan2DConverter::init(), usPreScanToPostScan2DConverter::init(), and usTransducerSettings::operator=().
|
inherited |
Getter for the transducer field of view (based on scan line number and pitch).
Definition at line 244 of file usTransducerSettings.cpp.
Referenced by usPostScanToPreScan2DConverter::convert(), usPostScanToPreScan2DConverter::init(), usPreScanToPostScan2DConverter::init(), usImageDisplayWidgetRobotControl::updateConfidenceAngle(), and usImageDisplayWidgetQmlOverlayServoing::updateConfidenceAngle().
|
inherited |
Definition at line 122 of file usImagePreScanSettings.cpp.
|
inherited |
Getter for the probe name.
Definition at line 232 of file usTransducerSettings.cpp.
|
inherited |
Getter for sampling frequency : frequency used to sample the echo of the ultrasound wave.
Definition at line 305 of file usTransducerSettings.cpp.
Referenced by usTransducerSettings::operator=(), usTransducerSettings::operator==(), usImageIo::read(), usImageIo::write(), usMHDSequenceWriter::write(), and usImageSettingsXmlParser::writeMainClass().
|
inherited |
Getter for the scan line number.
Definition at line 216 of file usTransducerSettings.cpp.
Referenced by usPixelMeterConversion::convert(), usMeterPixelConversion::convert(), usPostScanToPreScan2DConverter::convert(), usPreScanToPostScan2DConverter::convert(), usNetworkGrabberPreScan3D::includeFrameInVolume(), usNetworkGrabberRF3D::includeFrameInVolume(), usTransducerSettings::operator=(), usTransducerSettings::operator==(), usImageIo::read(), usImagePreScan2D< Type >::usImagePreScan2D(), usImagePreScan3D< Type >::usImagePreScan3D(), usImageRF2D< Type >::usImageRF2D(), usImageRF3D< Type >::usImageRF3D(), usImageIo::write(), usMHDSequenceWriter::write(), and usImageSettingsXmlParser::writeMainClass().
|
inherited |
Get the scan line pitch (m).
Definition at line 182 of file usTransducerSettings.cpp.
Referenced by usPixelMeterConversion::convert(), usMeterPixelConversion::convert(), usPreScanToPostScan2DConverter::convert(), usNetworkGrabberPreScan3D::includeFrameInVolume(), usNetworkGrabberRF3D::includeFrameInVolume(), usPostScanToPreScan2DConverter::init(), usPreScanToPostScan2DConverter::init(), usTransducerSettings::operator=(), usTransducerSettings::operator==(), usImageIo::read(), usImageDisplayWidgetRobotControl::updateConfidenceAngle(), usImageDisplayWidgetQmlOverlayServoing::updateConfidenceAngle(), usImageIo::write(), usMHDSequenceWriter::write(), and usImageSettingsXmlParser::writeMainClass().
|
inherited |
Get the probe transducer radius (m).
Definition at line 163 of file usTransducerSettings.cpp.
Referenced by usPixelMeterConversion::convert(), usMeterPixelConversion::convert(), usPostScanToPreScan2DConverter::convert(), usPreScanToPostScan2DConverter::convert(), usNetworkGrabberPreScan3D::includeFrameInVolume(), usNetworkGrabberRF3D::includeFrameInVolume(), usPostScanToPreScan2DConverter::init(), usPreScanToPostScan2DConverter::init(), usTransducerSettings::operator=(), usTransducerSettings::operator==(), usImageIo::read(), usImageIo::write(), usMHDSequenceWriter::write(), and usImageSettingsXmlParser::writeMainClass().
|
inherited |
Getter for transducer settings : allows heritating classes to get the transducer settings.
Definition at line 295 of file usTransducerSettings.cpp.
|
inherited |
Getter for transmit frequency : frequency of the ultrasound wave used.
Definition at line 311 of file usTransducerSettings.cpp.
Referenced by usTransducerSettings::operator=(), usTransducerSettings::operator==(), usImageIo::read(), usImageIo::write(), usMHDSequenceWriter::write(), and usImageSettingsXmlParser::writeMainClass().
|
inherited |
Returns the probe transducer type.
Definition at line 201 of file usTransducerSettings.cpp.
Referenced by usPixelMeterConversion::convert(), usMeterPixelConversion::convert(), usPostScanToPreScan2DConverter::convert(), usPreScanToPostScan2DConverter::convert(), usPostScanToPreScan2DConverter::init(), usPreScanToPostScan2DConverter::init(), usPreScanToPostScan3DConverter::init(), usTransducerSettings::operator=(), usTransducerSettings::operator==(), usImageIo::read(), usTransducerSettings::setTransducerConvexity(), usImageIo::write(), usMHDSequenceWriter::write(), and usImageSettingsXmlParser::writeMainClass().
bool usImagePreScan2D< Type >::operator!= | ( | const usImagePreScan2D< Type > & | other | ) |
Comparison operator.
Definition at line 208 of file usImagePreScan2D.h.
|
inherited |
Compare two probe transducer settings.
Definition at line 125 of file usTransducerSettings.cpp.
References usTransducerSettings::operator==().
usImagePreScan2D< Type > & usImagePreScan2D< Type >::operator= | ( | const usImagePreScan2D< Type > & | other | ) |
Copy operator.
Definition at line 186 of file usImagePreScan2D.h.
References usImagePreScanSettings::operator=().
bool usImagePreScan2D< Type >::operator== | ( | const usImagePreScan2D< Type > & | other | ) |
Comparison operator.
Definition at line 200 of file usImagePreScan2D.h.
|
inherited |
Comparison operator.
other | usImagePreScanSettings to compare with. |
Definition at line 97 of file usImagePreScanSettings.cpp.
References usImagePreScanSettings::getAxialResolution().
Referenced by usImageRF2D< Type >::operator==().
|
inherited |
Compare two probe transducer settings.
Definition at line 111 of file usTransducerSettings.cpp.
References usTransducerSettings::getSamplingFrequency(), usTransducerSettings::getScanLineNumber(), usTransducerSettings::getScanLinePitch(), usTransducerSettings::getTransducerRadius(), usTransducerSettings::getTransmitFrequency(), and usTransducerSettings::isTransducerConvex().
Referenced by usTransducerSettings::operator!=(), and usImagePostScan3D< Type >::operator==().
void usImagePreScan2D< Type >::resize | ( | const unsigned int | h, |
const unsigned int | w | ||
) |
Resize the 2D pre-scan image.
Updates also the transducer scan line number that corresponds to the image width.
h | Image height. |
w | Image width. |
Definition at line 261 of file usImagePreScan2D.h.
References usTransducerSettings::setScanLineNumber().
Referenced by usMHDSequenceReader::acquire(), usPostScanToPreScan2DConverter::convert(), usRFToPreScan2DConverter::convert(), usNetworkGrabberPreScan2D::dataArrived(), usNetworkGrabberPreScan3D::dataArrived(), usImagePreScan3D< Type >::getFrame(), usMHDSequenceReader::getImage(), usImageIo::read(), and usScanlineConfidence2D::run().
void usImagePreScan2D< Type >::resize | ( | const unsigned int | h, |
const unsigned int | w, | ||
const Type | val | ||
) |
Resize the 2D pre-scan image and set all the pixel to a given value.
Updates also the transducer scan line number that corresponds to the image width.
h | Image height. |
w | Image width. |
val | Value set to each pixel. |
Definition at line 275 of file usImagePreScan2D.h.
References usTransducerSettings::setScanLineNumber().
|
inherited |
Getter to know if the scan line number is set (usefull in case of field of view setter call).
Definition at line 277 of file usTransducerSettings.cpp.
Referenced by usTransducerSettings::operator=().
|
inherited |
Axial resolution setter.
axialResolution | Axial resloution to assign to the settings. |
Definition at line 115 of file usImagePreScanSettings.cpp.
Referenced by usMHDSequenceReader::acquire(), usPostScanToPreScan2DConverter::convert(), usRFToPreScan3DConverter::convert(), usNetworkGrabberPreScan2D::dataArrived(), usNetworkGrabberPreScan3D::dataArrived(), usNetworkGrabberRF3D::dataArrived(), usMHDSequenceReader::getImage(), and usImageIo::read().
void usImagePreScan2D< Type >::setData | ( | const vpImage< Type > | image | ) |
Setter for the image data.
image | The image to set. |
Definition at line 236 of file usImagePreScan2D.h.
|
inherited |
Setter for depth : distance in meters between first and last pixel in a scan line.
depth | Distance in meters. |
Definition at line 283 of file usTransducerSettings.cpp.
Referenced by usMHDSequenceReader::acquire(), usPreScanToPostScan2DConverter::convert(), usNetworkGrabberPreScan2D::dataArrived(), usNetworkGrabberPreScan3D::dataArrived(), usNetworkGrabberRF3D::dataArrived(), usMHDSequenceReader::getImage(), and usImageIo::read().
|
inherited |
Setter for the transducer field of view (updates the scan line pitch).
fieldOfView | The transducer field of view in radians if the transducer is convex, in meters if the transducer is linear. |
Definition at line 265 of file usTransducerSettings.cpp.
Referenced by usPostScanToPreScan2DConverter::convert().
|
inherited |
Copy constructor.
preScanSettings | Pre-scan settings to copy. |
Definition at line 71 of file usImagePreScanSettings.cpp.
Referenced by usMHDSequenceReader::acquire(), usPostScanToPreScan2DConverter::convert(), usRFToPreScan2DConverter::convert(), usRFToPreScan3DConverter::convert(), usImageRF3D< Type >::getFrame(), usMHDSequenceReader::getImage(), usImageIo::read(), usScanlineConfidence2D::run(), and usImageRF2D< Type >::usImageRF2D().
|
inherited |
Setter for the probe name.
probeName | Name of the probe. |
Definition at line 238 of file usTransducerSettings.cpp.
|
inherited |
Setter for sampling frequency : frequency used to sample the echo of the ultrasound wave.
samplingFrequency | Frequency in Hz. |
Definition at line 317 of file usTransducerSettings.cpp.
Referenced by usMHDSequenceReader::acquire(), usNetworkGrabberPreScan2D::dataArrived(), usNetworkGrabberPreScan3D::dataArrived(), usNetworkGrabberRF3D::dataArrived(), usMHDSequenceReader::getImage(), usImageIo::read(), usImageSettingsXmlParser::readMainClass(), and usImageSettingsXmlParser::setImageSettings().
void usImagePreScan2D< Type >::setScanLineNumber | ( | unsigned int | scanLineNumber | ) |
Set the transducer scan line number.
Resize also the image width that is equal to the scan line number.
scanLineNumber | Number of scan lines acquired by the transducer. |
Definition at line 248 of file usImagePreScan2D.h.
References usTransducerSettings::setScanLineNumber().
Referenced by usPostScanToPreScan2DConverter::convert(), and usImageIo::read().
|
inherited |
Set the scan line pitch.
scanLinePitch | If the probe transducer is convex, this parameters refers to the angle in radians between two successive scan lines acquired by the transducer. If the probe is linear, this parameters refers to the distance in meters between two successive scan lines acquired by the transducer. |
Definition at line 171 of file usTransducerSettings.cpp.
Referenced by usMHDSequenceReader::acquire(), usPreScanToPostScan2DConverter::convert(), usNetworkGrabberPreScan2D::dataArrived(), usNetworkGrabberPreScan3D::dataArrived(), usNetworkGrabberRF3D::dataArrived(), usMHDSequenceReader::getImage(), usImageIo::read(), usImageSettingsXmlParser::readMainClass(), and usImageSettingsXmlParser::setImageSettings().
|
inherited |
Set the probe transducer type.
isTransducerConvex | True if the transducer is convex, false if the transducer is linear. Sets the probe transducer radius to 0 in case of a linear transducer. |
Definition at line 189 of file usTransducerSettings.cpp.
References usTransducerSettings::isTransducerConvex().
Referenced by usMHDSequenceReader::acquire(), usPostScanToPreScan2DConverter::convert(), usPreScanToPostScan2DConverter::convert(), usNetworkGrabberPreScan2D::dataArrived(), usNetworkGrabberPreScan3D::dataArrived(), usNetworkGrabberRF3D::dataArrived(), usMHDSequenceReader::getImage(), usImageIo::read(), usImageSettingsXmlParser::readMainClass(), and usImageSettingsXmlParser::setImageSettings().
|
inherited |
Set the probe transducer radius (m).
transducerRadius | Probe transducer radius in meters. The probe transducer radius is set to 0 in case of a linear probe. See isTransducerConvex() and setProbeConvex(bool) for more information. |
Definition at line 157 of file usTransducerSettings.cpp.
Referenced by usMHDSequenceReader::acquire(), usPostScanToPreScan2DConverter::convert(), usPreScanToPostScan2DConverter::convert(), usNetworkGrabberPreScan2D::dataArrived(), usNetworkGrabberPreScan3D::dataArrived(), usNetworkGrabberRF3D::dataArrived(), usMHDSequenceReader::getImage(), usImageIo::read(), usImageSettingsXmlParser::readMainClass(), and usImageSettingsXmlParser::setImageSettings().
|
inherited |
Assignment operator.
other | Settings you want to assign. |
Definition at line 210 of file usTransducerSettings.cpp.
Referenced by usPreScanToPostScan3DConverter::convert().
|
inherited |
Setter for transmit frequency : frequency of the ultrasound wave used.
transmitFrequency | Frequency in Hz. |
Definition at line 326 of file usTransducerSettings.cpp.
Referenced by usMHDSequenceReader::acquire(), usNetworkGrabberPreScan2D::dataArrived(), usNetworkGrabberPreScan3D::dataArrived(), usNetworkGrabberRF3D::dataArrived(), usMHDSequenceReader::getImage(), usImageIo::read(), usImageSettingsXmlParser::readMainClass(), and usImageSettingsXmlParser::setImageSettings().