#include <mitkCustomTagParser.h>

Collaboration diagram for mitk::CustomTagParser:

Public Member Functions
	CustomTagParser (std::string relevantFile)
	the constructor expects a path to one of the files to be loaded or the directory of the dicom files More...

mitk::PropertyList::Pointer	ParseDicomProperty (mitk::TemporoSpatialStringProperty *dicomProperty)
	parse the provided dicom property and return a property list based on the closest revision parameter mapping More...

mitk::PropertyList::Pointer	ParseDicomPropertyString (std::string dicomPropertyString)
	parse the provided string and return a property list based on the closest revision parameter mapping More...

void	SetParseStrategy (std::string parseStrategy)

void	SetRevisionMappingStrategy (std::string revisionMappingStrategy)

Static Public Member Functions
static std::string	ReadListFromFile (const std::string &filePath)

static std::string	ExtractRevision (std::string sequenceFileName)

Static Public Attributes
static const std::string	m_RevisionPropertyName
	name of the property for the data acquisition revision More...

static const std::string	m_JSONRevisionPropertyName
	name of the property for the json parameter mapping revision More...

static const std::string	m_CESTPropertyPrefix
	prefix for all CEST related property names More...

Protected Member Functions
std::string	GetRevisionAppropriateJSONString (std::string revisionString)

void	GetClosestLowerRevision (std::string revisionString)

std::string	GetClosestLowerRevision (std::string revisionString, std::vector< int > availableRevisionsVector)

bool	IsT1Sequence (std::string preparationType, std::string recoveryMode, std::string spoilingType, std::string revisionString)
	Decides whether or not the image is likely to be a T1Map, if not it is assumed to be a CEST sequence. More...

std::string	GetOffsetString (std::string samplingType, std::string offset, std::string measurements)
	Get a string filled with the properly formatted offsets based on the sampling type and offset. More...

std::vector< int >	GetExternalRevisions ()
	returns a vector revision numbers of all REVISIONNUMBER.json found beside the MitkCEST library More...

std::vector< int >	GetInternalRevisions ()
	returns a vector revision numbers of all REVISIONNUMBER.json provided as resources during the compile More...

std::string	GetExternalJSONDirectory ()
	returns the path where external jsons are expected to be located More...

Protected Attributes
std::string	m_ClosestInternalRevision
	the closest lower revision provided as resource, empty if none found More...

std::string	m_ClosestExternalRevision
	the closest lower revision provided as a json beside the library, empty if none found More...

std::string	m_DicomDataPath
	path to the dicom data More...

std::string	m_ParseStrategy
	Should the kind of data be automatically determined or should it be parsed as a specific one. More...

std::string	m_RevisionMappingStrategy
	How to handle parameter mapping based on absent revision jsons. More...

Static Protected Attributes
static const std::string	m_RevisionIndependentMapping
	revision independent mapping to inject into the revision dependent json string More...

static const std::string	m_DefaultJsonString
	default revision dependent json string if none is found More...

Detailed Description

The custom tag parser can be used to parse the custom dicom tag of the siemens private tag (0x0029, 0x1020) to extract relevant CEST data.

An initial parsing determines whether the provided string belongs to CEST data at all. To make the check and extract the revision number the following rules are applied:

Sequence name (tSequenceFileName) must either
1. start with the substring "CEST" (case insensitiv), or
2. contain the substring "_CEST" (case insensitiv).
Sequence name (tSequenceFileName) must contain the substring "_Rev" (case insensitiv).
All numbers after "_Rev" represent the revision number; until either
1. the next _, or
2. end of sequence name.

Which custom parameters to save and to which property name can be controlled by a json file. This file can be either provided as a resource for the MitkCEST module during compilation or placed next to the MitkCEST library in your binary folder.

The expected format for the file "REVISIONNUMBER.json":
{
"REVISIONNUMBER" : "revision_json",
"sWiPMemBlock.alFree[1]" : "AdvancedMode",
"sWiPMemBlock.alFree[2]" : "RetreatMode"
}

where :

REVISIONNUMBER is the revision number of this json parameter mapping (files with non digit characters in their name will be ignored)
sWiPMemBlock.alFree[1] is the name of one parameter in the private dicom tag
AdvancedMode is the name of the property the content of sWiPMemBlock.alFree[1] should be saved to

Note: It is assumed that the entire content of tag (0x0029, 0x1020) is provided and that it es hex encoded (12\23\04...).

If the sampling type is list it will try to access LIST.txt at the location provided in the constructor to read the offsets.

Definition at line 70 of file mitkCustomTagParser.h.

Constructor & Destructor Documentation

◆ CustomTagParser()

mitk::CustomTagParser::CustomTagParser ( std::string relevantFile )

the constructor expects a path to one of the files to be loaded or the directory of the dicom files

Member Function Documentation

◆ ExtractRevision()

static std::string mitk::CustomTagParser::ExtractRevision ( std::string sequenceFileName )

static

Extract the revision out of the passed sequenceFileName. If the file name is not a valid CEST file name (see rules in the class documentation) exceptions will be thrown. If the file name is valid but contains no revision number an empty string will be returned.

◆ GetClosestLowerRevision() [1/2]

void mitk::CustomTagParser::GetClosestLowerRevision ( std::string revisionString )

protected

◆ GetClosestLowerRevision() [2/2]

std::string mitk::CustomTagParser::GetClosestLowerRevision	(	std::string	revisionString,
		std::vector< int >	availableRevisionsVector
	)

protected

◆ GetExternalJSONDirectory()

std::string mitk::CustomTagParser::GetExternalJSONDirectory ( )

protected

returns the path where external jsons are expected to be located

◆ GetExternalRevisions()

std::vector<int> mitk::CustomTagParser::GetExternalRevisions ( )

protected

returns a vector revision numbers of all REVISIONNUMBER.json found beside the MitkCEST library

◆ GetInternalRevisions()

std::vector<int> mitk::CustomTagParser::GetInternalRevisions ( )

protected

returns a vector revision numbers of all REVISIONNUMBER.json provided as resources during the compile

◆ GetOffsetString()

std::string mitk::CustomTagParser::GetOffsetString	(	std::string	samplingType,
		std::string	offset,
		std::string	measurements
	)

protected

Get a string filled with the properly formatted offsets based on the sampling type and offset.

◆ GetRevisionAppropriateJSONString()

std::string mitk::CustomTagParser::GetRevisionAppropriateJSONString ( std::string revisionString )

protected

◆ IsT1Sequence()

bool mitk::CustomTagParser::IsT1Sequence	(	std::string	preparationType,
		std::string	recoveryMode,
		std::string	spoilingType,
		std::string	revisionString
	)

protected

Decides whether or not the image is likely to be a T1Map, if not it is assumed to be a CEST sequence.

◆ ParseDicomProperty()

mitk::PropertyList::Pointer mitk::CustomTagParser::ParseDicomProperty ( mitk::TemporoSpatialStringProperty * dicomProperty )

parse the provided dicom property and return a property list based on the closest revision parameter mapping

◆ ParseDicomPropertyString()

mitk::PropertyList::Pointer mitk::CustomTagParser::ParseDicomPropertyString ( std::string dicomPropertyString )

parse the provided string and return a property list based on the closest revision parameter mapping

◆ ReadListFromFile()

static std::string mitk::CustomTagParser::ReadListFromFile ( const std::string & filePath )

static

◆ SetParseStrategy()

void mitk::CustomTagParser::SetParseStrategy ( std::string parseStrategy )

◆ SetRevisionMappingStrategy()

void mitk::CustomTagParser::SetRevisionMappingStrategy ( std::string revisionMappingStrategy )

Member Data Documentation

◆ m_CESTPropertyPrefix

const std::string mitk::CustomTagParser::m_CESTPropertyPrefix

static

prefix for all CEST related property names

Definition at line 99 of file mitkCustomTagParser.h.

◆ m_ClosestExternalRevision

std::string mitk::CustomTagParser::m_ClosestExternalRevision

protected

the closest lower revision provided as a json beside the library, empty if none found

Definition at line 123 of file mitkCustomTagParser.h.

◆ m_ClosestInternalRevision

std::string mitk::CustomTagParser::m_ClosestInternalRevision

protected

the closest lower revision provided as resource, empty if none found

Definition at line 121 of file mitkCustomTagParser.h.

◆ m_DefaultJsonString

const std::string mitk::CustomTagParser::m_DefaultJsonString

staticprotected

default revision dependent json string if none is found

Definition at line 128 of file mitkCustomTagParser.h.

◆ m_DicomDataPath

std::string mitk::CustomTagParser::m_DicomDataPath

protected

path to the dicom data

Definition at line 130 of file mitkCustomTagParser.h.

◆ m_JSONRevisionPropertyName

const std::string mitk::CustomTagParser::m_JSONRevisionPropertyName

static

name of the property for the json parameter mapping revision

Definition at line 96 of file mitkCustomTagParser.h.

◆ m_ParseStrategy

std::string mitk::CustomTagParser::m_ParseStrategy

protected

Should the kind of data be automatically determined or should it be parsed as a specific one.

Definition at line 132 of file mitkCustomTagParser.h.

◆ m_RevisionIndependentMapping

const std::string mitk::CustomTagParser::m_RevisionIndependentMapping

staticprotected

revision independent mapping to inject into the revision dependent json string

Definition at line 126 of file mitkCustomTagParser.h.

◆ m_RevisionMappingStrategy

std::string mitk::CustomTagParser::m_RevisionMappingStrategy

protected

How to handle parameter mapping based on absent revision jsons.

Definition at line 134 of file mitkCustomTagParser.h.

◆ m_RevisionPropertyName

const std::string mitk::CustomTagParser::m_RevisionPropertyName

static

name of the property for the data acquisition revision

Definition at line 93 of file mitkCustomTagParser.h.

The documentation for this class was generated from the following file:

mitkCustomTagParser.h

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ CustomTagParser()

Member Function Documentation

◆ ExtractRevision()

◆ GetClosestLowerRevision() [1/2]

◆ GetClosestLowerRevision() [2/2]

◆ GetExternalJSONDirectory()

◆ GetExternalRevisions()

◆ GetInternalRevisions()

◆ GetOffsetString()

◆ GetRevisionAppropriateJSONString()

◆ IsT1Sequence()

◆ ParseDicomProperty()

◆ ParseDicomPropertyString()

◆ ReadListFromFile()

◆ SetParseStrategy()

◆ SetRevisionMappingStrategy()

Member Data Documentation

◆ m_CESTPropertyPrefix

◆ m_ClosestExternalRevision

◆ m_ClosestInternalRevision

◆ m_DefaultJsonString

◆ m_DicomDataPath

◆ m_JSONRevisionPropertyName

◆ m_ParseStrategy

◆ m_RevisionIndependentMapping

◆ m_RevisionMappingStrategy

◆ m_RevisionPropertyName