<commit_before>/* Copyright (c) 2008-2017 the MRtrix3 contributors.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, you can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * MRtrix is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty
 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 *
 * For more details, see http://www.mrtrix.org/.
 */


#include "registration/nonlinear.h"

namespace MR
{
  namespace Registration
  {

    using namespace App;

    const OptionGroup nonlinear_options =
      OptionGroup ("Non-linear registration options")


      + Option ("nl_warp", "the non-linear warp output defined as two deformation fields, where warp1 can be used to transform "
                           "image1->image2 and warp2 to transform image2->image1. The deformation fields also encapsulate any linear "
                           "transformation estimated prior to non-linear registration.")
        + Argument ("warp1").type_file_out ()
        + Argument ("warp2").type_file_out ()

      + Option ("nl_warp_full", "output all warps used during registration. This saves four different warps that map each image to a midway space and their inverses in a single 5D image file. "
                                "The 4th image dimension indexes the x,y,z component of the deformation vector and the 5th dimension indexes the field in this order: "
                                "image1->midway, midway->image1, image2->midway, midway->image2. Where image1->midway defines the field that maps image1 onto the midway space using the reverse convention "
                                "When linear registration is performed first, the estimated linear transform will be included in the comments of the image header, and therefore the entire linear and "
                                "non-linear transform can be applied (in either direction) using this output warp file with mrtransform")
        + Argument ("image").type_file_out ()

      + Option ("nl_init", "initialise the non-linear registration with the supplied warp image. The supplied warp must be in the same format as output using the -nl_warp_full option "
                            "(i.e. have 4 deformation fields with the linear transforms in the image header)")
        + Argument ("image").type_image_in ()

      + Option ("nl_scale", "use a multi-resolution scheme by defining a scale factor for each level "
                             "using comma separated values (Default: 0.25,0.5,1.0)")
        + Argument ("factor").type_sequence_float ()

      + Option ("nl_niter", "the maximum number of iterations. This can be specified either as a single number "
                             "for all multi-resolution levels, or a single value for each level. (Default: 50)")
        + Argument ("num").type_sequence_int ()

      + Option ("nl_update_smooth", "regularise the gradient update field with Gaussian smoothing (standard deviation in voxel units, Default 2.0 x voxel_size)")
        + Argument ("stdev").type_float ()

      + Option ("nl_disp_smooth", "regularise the displacement field with Gaussian smoothing (standard deviation in voxel units, Default 1.0 x voxel_size)")
        + Argument ("stdev").type_float ()

      + Option ("nl_grad_step", "the gradient step size for non-linear registration (Default: 0.5)")
        + Argument ("num").type_float (0.0001, 1.0)

      + Option ("nl_lmax", "explicitly set the lmax to be used per scale factor in non-linear FOD registration. By default FOD registration will "
                           "use lmax 0,2,4 with default scale factors 0.25,0.5,1.0 respectively. Note that no reorientation will be performed with lmax = 0.")
      + Argument ("num").type_sequence_int ();

  }
}
<commit_msg>mrregister: clarify smoothing default values<commit_after>/* Copyright (c) 2008-2017 the MRtrix3 contributors.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, you can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * MRtrix is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty
 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 *
 * For more details, see http://www.mrtrix.org/.
 */


#include "registration/nonlinear.h"

namespace MR
{
  namespace Registration
  {

    using namespace App;

    const OptionGroup nonlinear_options =
      OptionGroup ("Non-linear registration options")


      + Option ("nl_warp", "the non-linear warp output defined as two deformation fields, where warp1 can be used to transform "
                           "image1->image2 and warp2 to transform image2->image1. The deformation fields also encapsulate any linear "
                           "transformation estimated prior to non-linear registration.")
        + Argument ("warp1").type_file_out ()
        + Argument ("warp2").type_file_out ()

      + Option ("nl_warp_full", "output all warps used during registration. This saves four different warps that map each image to a midway space and their inverses in a single 5D image file. "
                                "The 4th image dimension indexes the x,y,z component of the deformation vector and the 5th dimension indexes the field in this order: "
                                "image1->midway, midway->image1, image2->midway, midway->image2. Where image1->midway defines the field that maps image1 onto the midway space using the reverse convention "
                                "When linear registration is performed first, the estimated linear transform will be included in the comments of the image header, and therefore the entire linear and "
                                "non-linear transform can be applied (in either direction) using this output warp file with mrtransform")
        + Argument ("image").type_file_out ()

      + Option ("nl_init", "initialise the non-linear registration with the supplied warp image. The supplied warp must be in the same format as output using the -nl_warp_full option "
                            "(i.e. have 4 deformation fields with the linear transforms in the image header)")
        + Argument ("image").type_image_in ()

      + Option ("nl_scale", "use a multi-resolution scheme by defining a scale factor for each level "
                             "using comma separated values (Default: 0.25,0.5,1.0)")
        + Argument ("factor").type_sequence_float ()

      + Option ("nl_niter", "the maximum number of iterations. This can be specified either as a single number "
                             "for all multi-resolution levels, or a single value for each level. (Default: 50)")
        + Argument ("num").type_sequence_int ()

      + Option ("nl_update_smooth", "regularise the gradient update field with Gaussian smoothing (standard deviation in voxel units, Default 2.0)")
        + Argument ("stdev").type_float ()

      + Option ("nl_disp_smooth", "regularise the displacement field with Gaussian smoothing (standard deviation in voxel units, Default 1.0)")
        + Argument ("stdev").type_float ()

      + Option ("nl_grad_step", "the gradient step size for non-linear registration (Default: 0.5)")
        + Argument ("num").type_float (0.0001, 1.0)

      + Option ("nl_lmax", "explicitly set the lmax to be used per scale factor in non-linear FOD registration. By default FOD registration will "
                           "use lmax 0,2,4 with default scale factors 0.25,0.5,1.0 respectively. Note that no reorientation will be performed with lmax = 0.")
      + Argument ("num").type_sequence_int ();

  }
}

{'fraction_non_alphanumeric': 0.08153630215643741, 'fraction_numerical': 0.016332780400663518, 'mean_word_length': 2.759232613908873, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 17, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2951377', 'n_tokens_mistral': 2098, 'n_tokens_neox': 1924, 'n_words': 876}