niwrap-afni 0.6.2__py3-none-any.whl → 0.7.0__py3-none-any.whl

niwrap_afni/afni/clust_exp_stat_parse_py.py

@@ -6,7 +6,7 @@ import pathlib
 from styxdefs import *
 
 CLUST_EXP_STAT_PARSE_PY_METADATA = Metadata(
-    id="49f4672da2d43b66b47563c0d330449527488d04.boutiques",
+    id="c7ab6b5b185b8575bcc32b1e9ea87332591bb445.boutiques",
     name="ClustExp_StatParse.py",
     package="afni",
     container_image_tag="afni/afni_make_build:AFNI_24.2.06",
@@ -14,7 +14,23 @@ CLUST_EXP_STAT_PARSE_PY_METADATA = Metadata(
 
 
 ClustExpStatParsePyParameters = typing.TypedDict('ClustExpStatParsePyParameters', {
-    "__STYXTYPE__": typing.Literal["ClustExp_StatParse.py"],
+    "@type": typing.NotRequired[typing.Literal["afni/ClustExp_StatParse.py"]],
+    "statdset": InputPathType,
+    "meanbrik": float,
+    "threshbrik": float,
+    "subjdset": InputPathType,
+    "subjtable": InputPathType,
+    "master": InputPathType,
+    "prefix": typing.NotRequired[str | None],
+    "pval": typing.NotRequired[float | None],
+    "minvox": typing.NotRequired[float | None],
+    "atlas": typing.NotRequired[str | None],
+    "session": typing.NotRequired[str | None],
+    "noshiny": bool,
+    "overwrite": bool,
+})
+ClustExpStatParsePyParametersTagged = typing.TypedDict('ClustExpStatParsePyParametersTagged', {
+    "@type": typing.Literal["afni/ClustExp_StatParse.py"],
     "statdset": InputPathType,
     "meanbrik": float,
     "threshbrik": float,
@@ -29,43 +45,11 @@ ClustExpStatParsePyParameters = typing.TypedDict('ClustExpStatParsePyParameters'
     "noshiny": bool,
     "overwrite": bool,
 })
-
-
-def dyn_cargs(
-    t: str,
-) -> typing.Any:
-    """
-    Get build cargs function by command type.
-    
-    Args:
-        t: Command type.
-    Returns:
-        Build cargs function.
-    """
-    return {
-        "ClustExp_StatParse.py": clust_exp_stat_parse_py_cargs,
-    }.get(t)
-
-
-def dyn_outputs(
-    t: str,
-) -> typing.Any:
-    """
-    Get build outputs function by command type.
-    
-    Args:
-        t: Command type.
-    Returns:
-        Build outputs function.
-    """
-    return {
-        "ClustExp_StatParse.py": clust_exp_stat_parse_py_outputs,
-    }.get(t)
 
 
 class ClustExpStatParsePyOutputs(typing.NamedTuple):
     """
-    Output object returned when calling `clust_exp_stat_parse_py(...)`.
+    Output object returned when calling `ClustExpStatParsePyParameters(...)`.
     """
     root: OutputPathType
     """Output root folder. This is the root folder for all outputs."""
@@ -103,7 +87,7 @@ def clust_exp_stat_parse_py_params(
     session: str | None = None,
     noshiny: bool = False,
     overwrite: bool = False,
-) -> ClustExpStatParsePyParameters:
+) -> ClustExpStatParsePyParametersTagged:
     """
     Build parameters.
     
@@ -127,7 +111,7 @@ def clust_exp_stat_parse_py_params(
         Parameter dictionary
     """
     params = {
-        "__STYXTYPE__": "ClustExp_StatParse.py",
+        "@type": "afni/ClustExp_StatParse.py",
         "statdset": statdset,
         "meanbrik": meanbrik,
         "threshbrik": threshbrik,
@@ -167,56 +151,56 @@ def clust_exp_stat_parse_py_cargs(
     cargs.append("ClustExp_StatParse.py")
     cargs.extend([
         "-StatDSET",
-        execution.input_file(params.get("statdset"))
+        execution.input_file(params.get("statdset", None))
     ])
     cargs.extend([
         "-MeanBrik",
-        str(params.get("meanbrik"))
+        str(params.get("meanbrik", None))
     ])
     cargs.extend([
         "-ThreshBrik",
-        str(params.get("threshbrik"))
+        str(params.get("threshbrik", None))
     ])
     cargs.extend([
         "-SubjDSET",
-        execution.input_file(params.get("subjdset"))
+        execution.input_file(params.get("subjdset", None))
     ])
     cargs.extend([
         "-SubjTable",
-        execution.input_file(params.get("subjtable"))
+        execution.input_file(params.get("subjtable", None))
     ])
     cargs.extend([
         "-master",
-        execution.input_file(params.get("master"))
+        execution.input_file(params.get("master", None))
     ])
-    if params.get("prefix") is not None:
+    if params.get("prefix", None) is not None:
         cargs.extend([
             "-prefix",
-            params.get("prefix")
+            params.get("prefix", None)
         ])
-    if params.get("pval") is not None:
+    if params.get("pval", None) is not None:
         cargs.extend([
             "-p",
-            str(params.get("pval"))
+            str(params.get("pval", None))
         ])
-    if params.get("minvox") is not None:
+    if params.get("minvox", None) is not None:
         cargs.extend([
             "-MinVox",
-            str(params.get("minvox"))
+            str(params.get("minvox", None))
         ])
-    if params.get("atlas") is not None:
+    if params.get("atlas", None) is not None:
         cargs.extend([
             "-atlas",
-            params.get("atlas")
+            params.get("atlas", None)
         ])
-    if params.get("session") is not None:
+    if params.get("session", None) is not None:
         cargs.extend([
             "-session",
-            params.get("session")
+            params.get("session", None)
         ])
-    if params.get("noshiny"):
+    if params.get("noshiny", False):
         cargs.append("-NoShiny")
-    if params.get("overwrite"):
+    if params.get("overwrite", False):
         cargs.append("-overwrite")
     return cargs
 
@@ -236,23 +220,25 @@ def clust_exp_stat_parse_py_outputs(
     """
     ret = ClustExpStatParsePyOutputs(
         root=execution.output_file("."),
-        table_mean=execution.output_file(params.get("prefix") + "_p_uncor_" + str(params.get("pval")) + "_mean.csv") if (params.get("prefix") is not None and params.get("pval") is not None) else None,
-        group_table=execution.output_file(params.get("prefix") + "_GroupTable.csv") if (params.get("prefix") is not None) else None,
-        v_3dclust_output=execution.output_file(params.get("prefix") + "_p_uncor_" + str(params.get("pval")) + "_3dclust.1D") if (params.get("prefix") is not None and params.get("pval") is not None) else None,
-        clusters_output=execution.output_file(params.get("prefix") + "_p_uncor_" + str(params.get("pval")) + "_clusters.csv") if (params.get("prefix") is not None and params.get("pval") is not None) else None,
-        statinfo_output=execution.output_file(params.get("prefix") + "_StatInfo.csv") if (params.get("prefix") is not None) else None,
-        thresholded_dataset=execution.output_file(params.get("prefix") + "_p_uncor_" + str(params.get("pval")) + ".nii.gz") if (params.get("prefix") is not None and params.get("pval") is not None) else None,
-        thresholded_mask_dataset=execution.output_file(params.get("prefix") + "_p_uncor_" + str(params.get("pval")) + "_mask.nii.gz") if (params.get("prefix") is not None and params.get("pval") is not None) else None,
-        master_copy=execution.output_file(params.get("prefix") + "_master.nii.gz") if (params.get("prefix") is not None) else None,
+        table_mean=execution.output_file(params.get("prefix", None) + "_p_uncor_" + str(params.get("pval", None)) + "_mean.csv") if (params.get("prefix") is not None and params.get("pval") is not None) else None,
+        group_table=execution.output_file(params.get("prefix", None) + "_GroupTable.csv") if (params.get("prefix") is not None) else None,
+        v_3dclust_output=execution.output_file(params.get("prefix", None) + "_p_uncor_" + str(params.get("pval", None)) + "_3dclust.1D") if (params.get("prefix") is not None and params.get("pval") is not None) else None,
+        clusters_output=execution.output_file(params.get("prefix", None) + "_p_uncor_" + str(params.get("pval", None)) + "_clusters.csv") if (params.get("prefix") is not None and params.get("pval") is not None) else None,
+        statinfo_output=execution.output_file(params.get("prefix", None) + "_StatInfo.csv") if (params.get("prefix") is not None) else None,
+        thresholded_dataset=execution.output_file(params.get("prefix", None) + "_p_uncor_" + str(params.get("pval", None)) + ".nii.gz") if (params.get("prefix") is not None and params.get("pval") is not None) else None,
+        thresholded_mask_dataset=execution.output_file(params.get("prefix", None) + "_p_uncor_" + str(params.get("pval", None)) + "_mask.nii.gz") if (params.get("prefix") is not None and params.get("pval") is not None) else None,
+        master_copy=execution.output_file(params.get("prefix", None) + "_master.nii.gz") if (params.get("prefix") is not None) else None,
     )
     return ret
 
 
 def clust_exp_stat_parse_py_execute(
     params: ClustExpStatParsePyParameters,
-    execution: Execution,
+    runner: Runner | None = None,
 ) -> ClustExpStatParsePyOutputs:
     """
+    ClustExp_StatParse.py
+    
     Parser for statistical data sets and subject data sets, generating several
     outputs for further analysis.
     
@@ -262,10 +248,12 @@ def clust_exp_stat_parse_py_execute(
     
     Args:
         params: The parameters.
-        execution: The execution object.
+        runner: Command runner.
     Returns:
         NamedTuple of outputs (described in `ClustExpStatParsePyOutputs`).
     """
+    runner = runner or get_global_runner()
+    execution = runner.start_execution(CLUST_EXP_STAT_PARSE_PY_METADATA)
     params = execution.params(params)
     cargs = clust_exp_stat_parse_py_cargs(params, execution)
     ret = clust_exp_stat_parse_py_outputs(params, execution)
@@ -290,6 +278,8 @@ def clust_exp_stat_parse_py(
     runner: Runner | None = None,
 ) -> ClustExpStatParsePyOutputs:
     """
+    ClustExp_StatParse.py
+    
     Parser for statistical data sets and subject data sets, generating several
     outputs for further analysis.
     
@@ -317,8 +307,6 @@ def clust_exp_stat_parse_py(
     Returns:
         NamedTuple of outputs (described in `ClustExpStatParsePyOutputs`).
     """
-    runner = runner or get_global_runner()
-    execution = runner.start_execution(CLUST_EXP_STAT_PARSE_PY_METADATA)
     params = clust_exp_stat_parse_py_params(
         statdset=statdset,
         meanbrik=meanbrik,
@@ -334,13 +322,13 @@ def clust_exp_stat_parse_py(
         noshiny=noshiny,
         overwrite=overwrite,
     )
-    return clust_exp_stat_parse_py_execute(params, execution)
+    return clust_exp_stat_parse_py_execute(params, runner)
 
 
 __all__ = [
     "CLUST_EXP_STAT_PARSE_PY_METADATA",
     "ClustExpStatParsePyOutputs",
-    "ClustExpStatParsePyParameters",
     "clust_exp_stat_parse_py",
+    "clust_exp_stat_parse_py_execute",
     "clust_exp_stat_parse_py_params",
 ]

niwrap_afni/afni/column_cat.py

@@ -6,7 +6,7 @@ import pathlib
 from styxdefs import *
 
 COLUMN_CAT_METADATA = Metadata(
-    id="60f78df842e251663f740e6de4d861794e3c7350.boutiques",
+    id="f276139fcea6d48fa99c7886640fd1482c3c318e.boutiques",
     name="column_cat",
     package="afni",
     container_image_tag="afni/afni_make_build:AFNI_24.2.06",
@@ -14,48 +14,22 @@ COLUMN_CAT_METADATA = Metadata(
 
 
 ColumnCatParameters = typing.TypedDict('ColumnCatParameters', {
-    "__STYXTYPE__": typing.Literal["column_cat"],
+    "@type": typing.NotRequired[typing.Literal["afni/column_cat"]],
+    "line_number": typing.NotRequired[float | None],
+    "separator_string": typing.NotRequired[str | None],
+    "input_files": list[InputPathType],
+})
+ColumnCatParametersTagged = typing.TypedDict('ColumnCatParametersTagged', {
+    "@type": typing.Literal["afni/column_cat"],
     "line_number": typing.NotRequired[float | None],
     "separator_string": typing.NotRequired[str | None],
     "input_files": list[InputPathType],
 })
-
-
-def dyn_cargs(
-    t: str,
-) -> typing.Any:
-    """
-    Get build cargs function by command type.
-    
-    Args:
-        t: Command type.
-    Returns:
-        Build cargs function.
-    """
-    return {
-        "column_cat": column_cat_cargs,
-    }.get(t)
-
-
-def dyn_outputs(
-    t: str,
-) -> typing.Any:
-    """
-    Get build outputs function by command type.
-    
-    Args:
-        t: Command type.
-    Returns:
-        Build outputs function.
-    """
-    return {
-        "column_cat": column_cat_outputs,
-    }.get(t)
 
 
 class ColumnCatOutputs(typing.NamedTuple):
     """
-    Output object returned when calling `column_cat(...)`.
+    Output object returned when calling `ColumnCatParameters(...)`.
     """
     root: OutputPathType
     """Output root folder. This is the root folder for all outputs."""
@@ -67,7 +41,7 @@ def column_cat_params(
     input_files: list[InputPathType],
     line_number: float | None = None,
     separator_string: str | None = None,
-) -> ColumnCatParameters:
+) -> ColumnCatParametersTagged:
     """
     Build parameters.
     
@@ -80,7 +54,7 @@ def column_cat_params(
         Parameter dictionary
     """
     params = {
-        "__STYXTYPE__": "column_cat",
+        "@type": "afni/column_cat",
         "input_files": input_files,
     }
     if line_number is not None:
@@ -105,17 +79,17 @@ def column_cat_cargs(
     """
     cargs = []
     cargs.append("column_cat")
-    if params.get("line_number") is not None:
+    if params.get("line_number", None) is not None:
         cargs.extend([
             "-line",
-            str(params.get("line_number"))
+            str(params.get("line_number", None))
         ])
-    if params.get("separator_string") is not None:
+    if params.get("separator_string", None) is not None:
         cargs.extend([
             "-sep",
-            params.get("separator_string")
+            params.get("separator_string", None)
         ])
-    cargs.extend([execution.input_file(f) for f in params.get("input_files")])
+    cargs.extend([execution.input_file(f) for f in params.get("input_files", None)])
     return cargs
 
 
@@ -141,12 +115,14 @@ def column_cat_outputs(
 
 def column_cat_execute(
     params: ColumnCatParameters,
-    execution: Execution,
+    runner: Runner | None = None,
 ) -> ColumnCatOutputs:
     """
-    Catenate files horizontally. Each line of output is the concatenation of each
-    current line from the input files, all on the same line, separated by a space or
-    a user-defined separator.
+    column_cat
+    
+    Catenate files horizontally. Each line of output is the concatenation of
+    each current line from the input files, all on the same line, separated by a
+    space or a user-defined separator.
     
     Author: AFNI Developers
     
@@ -154,10 +130,12 @@ def column_cat_execute(
     
     Args:
         params: The parameters.
-        execution: The execution object.
+        runner: Command runner.
     Returns:
         NamedTuple of outputs (described in `ColumnCatOutputs`).
     """
+    runner = runner or get_global_runner()
+    execution = runner.start_execution(COLUMN_CAT_METADATA)
     params = execution.params(params)
     cargs = column_cat_cargs(params, execution)
     ret = column_cat_outputs(params, execution)
@@ -172,9 +150,11 @@ def column_cat(
     runner: Runner | None = None,
 ) -> ColumnCatOutputs:
     """
-    Catenate files horizontally. Each line of output is the concatenation of each
-    current line from the input files, all on the same line, separated by a space or
-    a user-defined separator.
+    column_cat
+    
+    Catenate files horizontally. Each line of output is the concatenation of
+    each current line from the input files, all on the same line, separated by a
+    space or a user-defined separator.
     
     Author: AFNI Developers
     
@@ -189,20 +169,18 @@ def column_cat(
     Returns:
         NamedTuple of outputs (described in `ColumnCatOutputs`).
     """
-    runner = runner or get_global_runner()
-    execution = runner.start_execution(COLUMN_CAT_METADATA)
     params = column_cat_params(
         line_number=line_number,
         separator_string=separator_string,
         input_files=input_files,
     )
-    return column_cat_execute(params, execution)
+    return column_cat_execute(params, runner)
 
 
 __all__ = [
     "COLUMN_CAT_METADATA",
     "ColumnCatOutputs",
-    "ColumnCatParameters",
     "column_cat",
+    "column_cat_execute",
     "column_cat_params",
 ]

niwrap_afni/afni/compare_surfaces.py

@@ -6,7 +6,7 @@ import pathlib
 from styxdefs import *
 
 COMPARE_SURFACES_METADATA = Metadata(
-    id="653d6f831efb2cdba11144f083f4857fcc5112b4.boutiques",
+    id="bb94c4839cb49074e0946b62165af328d09020b8.boutiques",
     name="CompareSurfaces",
     package="afni",
     container_image_tag="afni/afni_make_build:AFNI_24.2.06",
@@ -14,7 +14,25 @@ COMPARE_SURFACES_METADATA = Metadata(
 
 
 CompareSurfacesParameters = typing.TypedDict('CompareSurfacesParameters', {
-    "__STYXTYPE__": typing.Literal["CompareSurfaces"],
+    "@type": typing.NotRequired[typing.Literal["afni/CompareSurfaces"]],
+    "spec_file": InputPathType,
+    "hemisphere": typing.Literal["L", "R"],
+    "volume_parent_1": InputPathType,
+    "volume_parent_2": InputPathType,
+    "file_prefix": typing.NotRequired[str | None],
+    "one_node": typing.NotRequired[float | None],
+    "node_range": typing.NotRequired[list[float] | None],
+    "no_consistency_check": bool,
+    "no_volreg": bool,
+    "no_transform": bool,
+    "set_environment_variable": typing.NotRequired[str | None],
+    "trace": bool,
+    "extreme_trace": bool,
+    "no_memory_trace": bool,
+    "yes_memory_trace": bool,
+})
+CompareSurfacesParametersTagged = typing.TypedDict('CompareSurfacesParametersTagged', {
+    "@type": typing.Literal["afni/CompareSurfaces"],
     "spec_file": InputPathType,
     "hemisphere": typing.Literal["L", "R"],
     "volume_parent_1": InputPathType,
@@ -31,43 +49,11 @@ CompareSurfacesParameters = typing.TypedDict('CompareSurfacesParameters', {
     "no_memory_trace": bool,
     "yes_memory_trace": bool,
 })
-
-
-def dyn_cargs(
-    t: str,
-) -> typing.Any:
-    """
-    Get build cargs function by command type.
-    
-    Args:
-        t: Command type.
-    Returns:
-        Build cargs function.
-    """
-    return {
-        "CompareSurfaces": compare_surfaces_cargs,
-    }.get(t)
-
-
-def dyn_outputs(
-    t: str,
-) -> typing.Any:
-    """
-    Get build outputs function by command type.
-    
-    Args:
-        t: Command type.
-    Returns:
-        Build outputs function.
-    """
-    return {
-        "CompareSurfaces": compare_surfaces_outputs,
-    }.get(t)
 
 
 class CompareSurfacesOutputs(typing.NamedTuple):
     """
-    Output object returned when calling `compare_surfaces(...)`.
+    Output object returned when calling `CompareSurfacesParameters(...)`.
     """
     root: OutputPathType
     """Output root folder. This is the root folder for all outputs."""
@@ -93,7 +79,7 @@ def compare_surfaces_params(
     extreme_trace: bool = False,
     no_memory_trace: bool = False,
     yes_memory_trace: bool = False,
-) -> CompareSurfacesParameters:
+) -> CompareSurfacesParametersTagged:
     """
     Build parameters.
     
@@ -123,7 +109,7 @@ def compare_surfaces_params(
         Parameter dictionary
     """
     params = {
-        "__STYXTYPE__": "CompareSurfaces",
+        "@type": "afni/CompareSurfaces",
         "spec_file": spec_file,
         "hemisphere": hemisphere,
         "volume_parent_1": volume_parent_1,
@@ -164,53 +150,53 @@ def compare_surfaces_cargs(
     cargs.append("CompareSurfaces")
     cargs.extend([
         "-spec",
-        execution.input_file(params.get("spec_file"))
+        execution.input_file(params.get("spec_file", None))
     ])
     cargs.extend([
         "-hemi",
-        params.get("hemisphere")
+        params.get("hemisphere", None)
     ])
     cargs.extend([
         "-sv1",
-        execution.input_file(params.get("volume_parent_1"))
+        execution.input_file(params.get("volume_parent_1", None))
     ])
     cargs.extend([
         "-sv2",
-        execution.input_file(params.get("volume_parent_2"))
+        execution.input_file(params.get("volume_parent_2", None))
     ])
-    if params.get("file_prefix") is not None:
+    if params.get("file_prefix", None) is not None:
         cargs.extend([
             "-prefix",
-            params.get("file_prefix")
+            params.get("file_prefix", None)
         ])
-    if params.get("one_node") is not None:
+    if params.get("one_node", None) is not None:
         cargs.extend([
             "-onenode",
-            str(params.get("one_node"))
+            str(params.get("one_node", None))
         ])
-    if params.get("node_range") is not None:
+    if params.get("node_range", None) is not None:
         cargs.extend([
             "-noderange",
-            *map(str, params.get("node_range"))
+            *map(str, params.get("node_range", None))
         ])
-    if params.get("no_consistency_check"):
+    if params.get("no_consistency_check", False):
         cargs.append("-nocons")
-    if params.get("no_volreg"):
+    if params.get("no_volreg", False):
         cargs.append("-novolreg")
-    if params.get("no_transform"):
+    if params.get("no_transform", False):
         cargs.append("-noxform")
-    if params.get("set_environment_variable") is not None:
+    if params.get("set_environment_variable", None) is not None:
         cargs.extend([
             "-setenv",
-            params.get("set_environment_variable")
+            params.get("set_environment_variable", None)
         ])
-    if params.get("trace"):
+    if params.get("trace", False):
         cargs.append("-trace")
-    if params.get("extreme_trace"):
+    if params.get("extreme_trace", False):
         cargs.append("-TRACE")
-    if params.get("no_memory_trace"):
+    if params.get("no_memory_trace", False):
         cargs.append("-nomall")
-    if params.get("yes_memory_trace"):
+    if params.get("yes_memory_trace", False):
         cargs.append("-yesmall")
     return cargs
 
@@ -230,19 +216,21 @@ def compare_surfaces_outputs(
     """
     ret = CompareSurfacesOutputs(
         root=execution.output_file("."),
-        distance_output_file=execution.output_file(params.get("file_prefix") + "_distance.txt") if (params.get("file_prefix") is not None) else None,
-        color_output_file=execution.output_file(params.get("file_prefix") + "_color.txt") if (params.get("file_prefix") is not None) else None,
+        distance_output_file=execution.output_file(params.get("file_prefix", None) + "_distance.txt") if (params.get("file_prefix") is not None) else None,
+        color_output_file=execution.output_file(params.get("file_prefix", None) + "_color.txt") if (params.get("file_prefix") is not None) else None,
     )
     return ret
 
 
 def compare_surfaces_execute(
     params: CompareSurfacesParameters,
-    execution: Execution,
+    runner: Runner | None = None,
 ) -> CompareSurfacesOutputs:
     """
-    Calculates distance at each node in Surface 1 (S1) to Surface 2 (S2) along the
-    local surface normal at each node in S1. Superseded by SurfToSurf.
+    CompareSurfaces
+    
+    Calculates distance at each node in Surface 1 (S1) to Surface 2 (S2) along
+    the local surface normal at each node in S1. Superseded by SurfToSurf.
     
     Author: AFNI Developers
     
@@ -250,10 +238,12 @@ def compare_surfaces_execute(
     
     Args:
         params: The parameters.
-        execution: The execution object.
+        runner: Command runner.
     Returns:
         NamedTuple of outputs (described in `CompareSurfacesOutputs`).
     """
+    runner = runner or get_global_runner()
+    execution = runner.start_execution(COMPARE_SURFACES_METADATA)
     params = execution.params(params)
     cargs = compare_surfaces_cargs(params, execution)
     ret = compare_surfaces_outputs(params, execution)
@@ -280,8 +270,10 @@ def compare_surfaces(
     runner: Runner | None = None,
 ) -> CompareSurfacesOutputs:
     """
-    Calculates distance at each node in Surface 1 (S1) to Surface 2 (S2) along the
-    local surface normal at each node in S1. Superseded by SurfToSurf.
+    CompareSurfaces
+    
+    Calculates distance at each node in Surface 1 (S1) to Surface 2 (S2) along
+    the local surface normal at each node in S1. Superseded by SurfToSurf.
     
     Author: AFNI Developers
     
@@ -313,8 +305,6 @@ def compare_surfaces(
     Returns:
         NamedTuple of outputs (described in `CompareSurfacesOutputs`).
     """
-    runner = runner or get_global_runner()
-    execution = runner.start_execution(COMPARE_SURFACES_METADATA)
     params = compare_surfaces_params(
         spec_file=spec_file,
         hemisphere=hemisphere,
@@ -332,13 +322,13 @@ def compare_surfaces(
         no_memory_trace=no_memory_trace,
         yes_memory_trace=yes_memory_trace,
     )
-    return compare_surfaces_execute(params, execution)
+    return compare_surfaces_execute(params, runner)
 
 
 __all__ = [
     "COMPARE_SURFACES_METADATA",
     "CompareSurfacesOutputs",
-    "CompareSurfacesParameters",
     "compare_surfaces",
+    "compare_surfaces_execute",
     "compare_surfaces_params",
 ]