nipype / nipype2pydra

Scripts for importing workflows written in Nipype to the Pydra dataflow engine syntax
Other
1 stars 2 forks source link

Nipype2Pydra

.. image:: https://github.com/nipype/nipype2pydra/actions/workflows/ci-cd.yml/badge.svg :target: https://github.com/nipype/nipype2pydra/actions/workflows/ci-cd.yml .. image:: https://codecov.io/gh/nipype/nipype2pydra/branch/main/graph/badge.svg?token=UIS0OGPST7 :target: https://codecov.io/gh/nipype/nipype2pydra .. image:: https://img.shields.io/pypi/pyversions/nipype2pydra.svg :target: https://pypi.python.org/pypi/nipype2pydra/ :alt: Supported Python versions .. image:: https://img.shields.io/pypi/v/nipype2pydra.svg :target: https://pypi.python.org/pypi/nipype2pydra/ :alt: Latest Version

Nipype2Pydra is a command-line tool for semi-automatically porting command interfaces and workflows written from the Nipype workflow engine to its successor Pydra. It has been designed so that any required manual-specifications are stored in separate YAML specification files, which is read ahead of the conversion, so once designed the conversion can be re-run to pick up changes in newer versions of the Nipype_ code without having to redo the manual steps.

Basic Usage

To convert a Nipype interface to a Pydra task run the nipype2pydra task command and pass it the conversion specification YAML file and the root of the package to save the generated module, e.g.::

$ nipype2pydra task ants_registration_registration.yaml /path/to/package/root

This will create a module file under the package root directory based on the output_module field in the specification, e.g::

/path/to/package/root/output/module/path

If that is missing and the nipype interface is in the standard nipype.interfaces package, then it will be stored at pydra.tasks. with the same path end.

Conversion Specifications

While the conversions aim to as automatic as possible, there are structural differences between Nipype and Pydra that require manual specification, and it might be desirable to rename some of the inputs/outputs to more intuitive names. Such specifications are stored in YAML_ format, such as the ANTs registration conversion specification,

.. code-block:: yaml

task_name: n4_bias_field_correction
nipype_name: N4BiasFieldCorrection
nipype_module: nipype.interfaces.ants.segmentation
inputs:
    omit:
    # list[str] - fields to omit from the Pydra interface
    rename:
    # dict[str, str] - fields to rename in the Pydra interface
    types:
    # dict[str, type] - override inferred types (use "mime-like" string for file-format types,
    # e.g. 'medimage/nifti-gz'). For most fields the type will be correctly inferred
    # from the nipype interface, but you may want to be more specific, particularly
    # for file types, where specifying the format also specifies the file that will be
    # passed to the field in the automatically generated unittests.
        input_image: medimage/nifti1
        mask_image: medimage/nifti1
        weight_image: medimage/nifti1
        bias_image: medimage/nifti1
    metadata:
    # dict[str, dict[str, any]] - additional metadata to set on any of the input fields (e.g. out_file: position: 1)
outputs:
    omit:
    # list[str] - fields to omit from the Pydra interface
    rename:
    # dict[str, str] - fields to rename in the Pydra interface
    types:
    # dict[str, type] - override inferred types (use "mime-like" string for file-format types,
    # e.g. 'medimage/nifti-gz'). For most fields the type will be correctly inferred
    # from the nipype interface, but you may want to be more specific, particularly
    # for file types, where specifying the format also specifies the file that will be
    # passed to the field in the automatically generated unittests.
        output_image: medimage/nifti1
        bias_image: medimage/nifti1
    callables:
    # dict[str, str] - names of methods/callable classes defined in the adjacent `*_callables.py`
    # to set to the `callable` attribute of output fields
    templates:
    # dict[str, str] - `output_file_template` values to be provided to output fields
    requirements:
    # dict[str, list[str]] - input fields that are required to be provided for the output field to be present

Detailed description of the different options to go here

Installation

Nipype2Pydra can be installed for Python >= 3.7 from PyPI with

.. code-block:: bash

$ python3 -m pip install nipype2pydra

License

This work is licensed under a Creative Commons Attribution 4.0 International License <http://creativecommons.org/licenses/by/4.0/>_

.. image:: https://i.creativecommons.org/l/by/4.0/88x31.png :target: http://creativecommons.org/licenses/by/4.0/ :alt: Creative Commons Attribution 4.0 International License

.. _Pydra: https://pydra.readthedocs.io .. _Nipype: https://nipype.readthedocs.io/en/latest/ .. _YAML: https://yaml.org