openlifu.plan.solution_analysis.interp_transformed_axis

openlifu.plan.solution_analysis.interp_transformed_axis(da: DataArray, focus, dim, origin=array([0., 0., 0.]), min_offset: float | None = None, max_offset: float | None = None) → DataArray[source]

Interpolate data along a focal coordinate system axis.

See get_focus_matrix for the meaning of “focal coordinate system.”

Parameters:

  • da – DataArray whose values will be sampled (presumably defined on transducer coordinates).

  • focus – A 3D point describing the focus location in the coordinates of da

  • dim – The name of the dimension of da whose corresponding focal coordinate system axis should be sampled along. For example, the “axial” dimension of a transducer corresponds to the focal axis (z-axis) in the focal coordinate system, that is, the ray from the transducer’s “effective origin” (see Transducer.get_effective_origin) to the focus center.

  • origin – A 3D point describing the “effective origin” in the coordinates of da (see Transducer.get_effective_origin for the meaning of this).

  • min_offset – How far along the negative focal dim direction to sample. By default samples as far as the coordinate grid allows.

  • max_offset – How far along the positive focal dim direction to sample. By default samples as far as the coordinate grid allows.

Returns: a 1D DataArray of interpolated values from da.