Addons - Client Tools

 Introduction

The Yarra Client Tools (YCT) are several small command-line tools for Windows that can be helpful when working with Siemens raw-data files (aka Twix files). They are distributed in a separate package because they are targeted at advanced users. It is recommended to extract the package into the installation folder of the Yarra Client package because the tools require runtime libraries that are contained in the Yarra Client package.

If you receive an error message stating that ‘libgcc_s_dw2-1.dll’ is missing, make sure that the client tools are located inside the installation folder of the Yarra client package.

 

 yct_anonymize

The tool “yct_anonymize” can be used to anonymize a batch of Twix raw-data files. It will remove the patient name, patient ID (i.e. the medical record number), date of birth, and referring physician. In addition, the filename will be changed to a universally unique identifier ID (UUID). The same UUID will be inserted as patient name (up to the length of the original patient, as the size of the file must be preserved). This enables identifying cases in PACS through the UUID.

When anonymizing a set of files, the tool creates a CSV file that contains the original filename, the name of the anonymized file, the UUID, as well as the removed PHI such as patient name, MRN, and DOB. This file can later be used to lookup the original patient name from the UUID (e.g., in case of an accidental finding on an anonymized scan). The file can be opened with Excel or any texteditor. It should be kept in a secure location and must not be shared with people who should not have access to the PHI (e.g., collaboration partners).

The yct_anonymize tool should be used with caution. The tool has been tested to the best of our abilities. However, use of the tool is solely at the user’s own risk. We take no responsibility for possible misfunction or damages resulting from the use of the tool. If you are planning to share anonymized files with collaborators, it is recommended to double-check the files for residual PHI by opening them with a suited editor (e.g., PilotEdit can handle large files).

Currently, only raw-data files from the following software versions are supported (other versions are blocked):
VB17 VB18P VB19 VB20P VD11 VD13 VE11 XA10
New versions will be added when we get access to files from these versions, as we need to test the anonymizer.

 
Yarra Client Tools - Batch Anonymizer 0.2b2
-------------------------------------------

Usage:    yct_anonymizer [input path] [output path] [optional: patient-name replacement]

Purpose:  Anonymizes all Twix files located in [input path]. The anonymized files will be
          written into [output path]. Each anonymized file will be named by a unique ID (UUID).
          The patient name will be replaced by the UUID (while keeping the original length).
          If a name is provided as 3rd parameter, this name will be used instead to replace
          the patient name. A file in CSV format will be created (files.csv) that lists the
          original and anonymized file names, as well as the removed PHI.

Note:     Please use this tool with caution. Operation of the software is at the user's
          own risk. The authors take no responsibility of any kind.
 

 yct_dumpprot

The tool “yct_dumpprot” extracts the measurement header from a Twix file into a separate file with extension .prot. This allows analyzing the acquisition parameters using standard text editors (e.g., Notepad++), which are typically not capable of loading large Twix files. If a Twix file contains multiple measurements (multi-measurement format introduced with VD11), the headers from the individual scans will be concatenated.

 
Yarra Client Tools - Dump Protocol 0.1b2
----------------------------------------

Usage:    yct_dumpprot [twixfile]

Purpose:  Extract the scan protocol from a Twix file into a text file (with extension .prot)
 

 yct_getseqparams

The tool “yct_getseqparams” can be used to extract parameter values from a Twix file. When calling the tool with parameter “show”, it will return a default set of parameters. When adding “show all”, it will return an extensive list of parameters (including all parameters from the mrprot structure). When adding the name of one particular entry, e.g. “show BolusAgent”, only this specific value will be returned.

By piping the output, it is possible to pass the result to other commandline tools, which can be helpful when writing batch scripts. Using the option “write”, all parameter values are written into a file with the “.ini” format. Hence, the information can be conveniently processed using a standard reader for ini files. A Linux version of the tool is available as well.

 
Yarra GetSeqParams v0.1a
------------------------

Usage: yct_getseqparams [TWIX file] [command] [options]

Available commands:

    show              -- Shows relevant parameters from TWIX file
    show  [parameter] -- Shows specific parameter from TWIX file
    show  all         -- Shows all parameters from TWIX file
    write [filename]  -- Writes parameter summary into ini file