UsTK : Ultrasound ToolKit
version 2.0.1 under development (2024-11-21)
|
This tutorial expains how to run the virtual server and how to grab the ultrasound images on client side. It provides also help to format correctly your ultrasound sequences, so they could be read ans sent correctly with the virtual server.
To use your sequence of ultrasound images in the virtual server application, the main information to precise is the timestamps of every frame: the server uses them to respect the delay between each frame sent. The virtual server can take 2 types of image sequences as input:
Here is an example of how to load a sequence of pre-scan volumes written in metaheader format, and set to each frame a timestamp of your choice (expressed in ms since epoch):
In this example, a default timestamp is set at first frame of the sequence and then it's incremented of 100ms at each frame.
The source code can be dowloaded by running the following svn command:
Then you have to run CMake to configure your project, and finally you can compile it.
The virtual server application requires in input a path to the sequence to replay. To run it go in the directory where the application is built, and run the following command (replace /path/to/your/sequence by the path to the sequence you prepared in previous section):
If you see the following message : "TCP server Started Server now listening on port# 8080" it means that your server is running correctly. Now you can use a client application to connect to it and grabbing the images using a grabber class as shown in next section.
This section explains how to run a client application to grab the frames sent by the virtual server.
First, download the source codes of the clients using the following svn command:
Then use CMake to configure the project, and finally compile it.
To run a client application go in your binary directory (containing the applications you just built), and run the following command for example (case of pre-scan volumes sent by the server):
If all is going well, you should see the following message : "init success waiting ultrasound initialisation...", and then the volumes are coming.