Skip to content

tutorials.2

Vincent Le Garrec edited this page Oct 10, 2025 · 4 revisions

Tutorial - Open/Save an URX file

This tutorial demonstrates how to open and exisiting URX file, read the content of the file, change some values and save the result to a new URX file.

Python

import pathlib

import ultrasound_rawdata_exchange as urx


# read the input file
dataset = urx.loadFromFile("rca.urx")

# print values
print(dataset.acquisition.description)
print(dataset.acquisition.excitations[0].sampling_frequency)

# change values
dataset.acquisition.description = "Learning to modify values ..."

# save the output file
urx.saveToFile("rca-python.urx", dataset, urx.WriterOptions(False, False, False))

MATLAB

% read the input file
dataset = urx.loadFromFile('rca.urx');

% print values
dataset.acquisition.description
dataset.acquisition.excitations(1).samplingFrequency

% change values
dataset.acquisition.description = "Learning to modify values ...";

% save the output file
urx.saveToFile('rca-matlab.urx', dataset, false, false, false)

C++

#include <ios>
#include <iostream>
#include <memory>
#include <ostream>
#include <string>
#include <utility>
#include <vector>

#include <urx/acquisition.h>
#include <urx/dataset.h>
#include <urx/detail/double_nan.h>
#include <urx/excitation.h>
#include <urx/utils/io/reader.h>
#include <urx/utils/io/writer.h>
#include <urx/utils/io/writer_options.h>

int main(int argc, char** argv) {
  // read the input file
  const std::shared_ptr<urx::Dataset> dataset =
      urx::utils::io::reader::loadFromFile("rca.urx");

  // print values
  std::cout << dataset->acquisition.description << "\n";
  std::cout << dataset->acquisition.excitations[0]->sampling_frequency << "\n";

  // change values
  dataset->acquisition.description = "Learning to modify values ...";

  urx::utils::io::writer::saveToFile("rca-cpp.urx", *dataset, {false, false, false});

  return 0;
}
Clone this wiki locally