Add "ExternalTransform" component and ElastixRegistrationMethod::SetExternalInitialTransform

[N-Dekker]

Adds a component that allows specifying an ITK transform by its address in memory. The transform is then not converted to the corresponding elastix AdvancedTransform. Instead, it is only "adapted", meaning that its TransformPoint is still called directly, when using the transform. This component is only meant to be used with the elastix/transformix library, not with the elastix/transformix executable. It only serves as input transform, so it is meant not to be adjusted during registration.

Adds a SetExternalInitialTransform member function to ElastixRegistrationMethod, allowing to specify any ITK transform (for example an itk::DisplacementFieldTransform) as initial transform. Aims to address the following issue:

• Allow ITK DisplacementFieldTransform as input to library interface #874

[N-Dekker]

The GitHub Actions CI failures appear unrelated to this PR:

ERROR: THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE. If you have updated the package versions, please update the hashes. Otherwise, examine the package contents carefully; someone may have tampered with them.
    SimpleITK from https://files.pythonhosted.org/packages/d4/e8/f37a48af6c4df67a8bbbbab6f21cb0a30ae024d383a3c2a4d76f90e29e46/SimpleITK-2.2.1-cp37-cp37m-win_amd64.whl (from -r D:\a\elastix\elastix/Elastix-source/Testing/PythonTests/requirements.txt (line 2)):
        Expected sha256 4878f5c032d638d7833901d8d3f79d4c6ed90d041d1fcc1b074dd6e4b7c9abc2
             Got        93b4fffc1582d3d799d0f808a5469576c963eeb8533bc35b0d4d3385182d0f27

[N-Dekker]

Discussed with @mstaring and @stefanklein at the internal weekly elastix sprint of last Monday, 14 August.

[N-Dekker]

@mstaring @stefanklein Now that we have ElastixRegistrationMethod::SetExternalInitialTransform, would it be useful to add a "SetExternalTransform" member function to TransformixFilter as well? TransformixFilter already has a SetTransform that accepts an ITK transform as input. But only if it can be converted to an existing elastix component (Translation, Affine, Euler, Similarity, Bspline). TransformixFilter::SetExternalTransform would support any arbitrary ITK transform.

[stefanklein]

Yes, that would be useful I think! From: Niels Dekker ***@***.***> Sent: Thursday, August 17, 2023 1:44 PM To: SuperElastix/elastix ***@***.***> Cc: Stefan Klein ***@***.***>; Mention ***@***.***> Subject: Re: [SuperElastix/elastix] Add "ExternalTransform" component and `ElastixRegistrationMethod::SetExternalInitialTransform` (PR #944) Waarschuwing: Deze e-mail is afkomstig van buiten de organisatie. Klik niet op links en open geen bijlagen, tenzij u de afzender herkent en weet dat de inhoud veilig is. Caution: This email originated from outside of the organization. Do not click links or open attachments unless you recognize the sender and know the content is safe. @mstaring<https://github.com/mstaring> @stefanklein<https://github.com/stefanklein> Now that we have ElastixRegistrationMethod::SetExternalInitialTransform, would it be useful to add a "SetExternalTransform" member function to TransformixFilter as well? TransformixFilter already has a SetTransform that accepts an ITK transform as input. But only if it can be converted to an existing elastix component (Translation, Affine, Euler, Similarity, Bspline). TransformixFilter::SetExternalTransform would support any arbitrary ITK transform. - Reply to this email directly, view it on GitHub<#944 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AAF2LNLWKUFB7ZX3WCR3XUDXVX7X7ANCNFSM6AAAAAA3LFCHRI>. You are receiving this because you were mentioned.Message ID: ***@***.******@***.***>>

[mstaring]

good idea!

…

________________________________ From: Stefan Klein ***@***.***> Sent: 17 August 2023 13:46 To: SuperElastix/elastix ***@***.***> Cc: Staring, M. (RADI) ***@***.***>; Mention ***@***.***> Subject: Re: [SuperElastix/elastix] Add "ExternalTransform" component and `ElastixRegistrationMethod::SetExternalInitialTransform` (PR #944) Yes, that would be useful I think! From: Niels Dekker ***@***.***> Sent: Thursday, August 17, 2023 1:44 PM To: SuperElastix/elastix ***@***.***> Cc: Stefan Klein ***@***.***>; Mention ***@***.***> Subject: Re: [SuperElastix/elastix] Add "ExternalTransform" component and `ElastixRegistrationMethod::SetExternalInitialTransform` (PR #944) Waarschuwing: Deze e-mail is afkomstig van buiten de organisatie. Klik niet op links en open geen bijlagen, tenzij u de afzender herkent en weet dat de inhoud veilig is. Caution: This email originated from outside of the organization. Do not click links or open attachments unless you recognize the sender and know the content is safe. @mstaring<https://github.com/mstaring> @stefanklein<https://github.com/stefanklein> Now that we have ElastixRegistrationMethod::SetExternalInitialTransform, would it be useful to add a "SetExternalTransform" member function to TransformixFilter as well? TransformixFilter already has a SetTransform that accepts an ITK transform as input. But only if it can be converted to an existing elastix component (Translation, Affine, Euler, Similarity, Bspline). TransformixFilter::SetExternalTransform would support any arbitrary ITK transform. - Reply to this email directly, view it on GitHub<#944 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AAF2LNLWKUFB7ZX3WCR3XUDXVX7X7ANCNFSM6AAAAAA3LFCHRI>. You are receiving this because you were mentioned.Message ID: ***@***.******@***.***>> — Reply to this email directly, view it on GitHub<#944 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AAFRMFC4MAZM5HVTIZ6KBBTXVX77TANCNFSM6AAAAAA3LFCHRI>. You are receiving this because you were mentioned.Message ID: ***@***.***>

[N-Dekker]

Here it is, the TransformixFilter::SetExternalTransform pull request:

• ENH: Add SetExternalTransform to TransformixFilter #948