makeSoftDelay¶

Creates a soft delay event for use with Pulseq sequences. This event modifies the duration of an empty (pure delay) block within a sequence, allowing for adjustments to timings like TE or TR. The duration is calculated using the formula: dur = input / factor + offset. This function is typically used in conjunction with Sequence.addBlock() and Sequence.applySoftDelay().

Syntax¶

function sd = makeSoftDelay(varargin)

Calling Pattern¶

mr.makeSoftDelay(...)
mr.makeSoftDelay('ParameterName', value, ...)

Parameters¶

This function accepts both positional parameters and name-value pairs.

Required Parameters¶

Parameter Name	Value Type	Description	Example	Units
`numID`	double	A numeric ID that uniquely identifies this soft delay event. It's used to link this event to specific blocks within the sequence.	`1`
`hint`	char	A string hint associated with the soft delay event. This hint should be unique for each numID to distinguish between different types of delays.	`TE_adjust`

Name-Value Pair Arguments¶

Parameter Name (string)	Value Type	Default	Description	Example
`offset`	double	`0`	A constant offset added to the calculated delay duration. This can be used to fine-tune the delay. Valid values: Any numeric value (positive or negative) (Units: seconds)	`0.001`
`factor`	double	`1`	A scaling factor applied to the input value before adding the offset. This allows for scaling of the delay. Valid values: Any numeric value (positive or negative)	`2`

Returns¶

Output	Value Type	Description
`sd`	struct	A structure containing the parameters of the created soft delay event. This structure is then used with `Sequence.applySoftDelay()` to apply the delay to the sequence.

Examples¶

% TE soft delay with offset
seq.addBlock(delayTE1, mr.makeSoftDelay(0,'TE','offset',delayTE1-TE/2, 'factor', 2));

% TR soft delay for slice timing
seq.addBlock(delayTR_1slice, mr.makeSoftDelay(1,'TR','offset',-durPerSlc,'factor',Nslices));

% TE soft delay with negative factor for dependency resolution
seq.addBlock(max_TE-min_TE-10e-6, mr.makeSoftDelay(0,'TE','factor',-1,'offset',max_TE));