DLASLDenoiseCBF
===============

**Purpose.** Denoise CBF volumes using a **dilated CNN** with pre-trained weights.

Inputs
------

- CBF candidate(s) under ``derivatives/<sub>/perf``:
  - Explicit file via ``cbf_file`` **or**
  - Auto-discovery using glob patterns:
    ``*aCBF*.nii*``, ``*CBF*.nii*``, ``*rCBF*.nii*``
- DL-ASL mask at 64×64×24 (see :doc:`dlasl_build_mask`) — default path ``dlasl_mask.nii.gz``.

Outputs
-------

- One denoised file per input: ``derivatives/<sub>/perf/{out_prefix}{original_name}``
- Returns a JSON-like dict with the last output path (for pipelines that pass values).

Configuration
-------------

==================  ===============================  ==============================================
Key                 Type / Default                   Meaning
==================  ===============================  ==============================================
``mask_path``       str / ``dlasl_mask.nii.gz``      Path to binary mask (abs or relative to ``perf``)
``cbf_file``        str / *None*                     Specific CBF file (abs or relative to ``perf``)
``glob_patterns``   list[str] / see code             File patterns to find CBF when ``cbf_file`` is not given
``model_selection`` int / ``1``                      ``0``→``model_068.hdf5``; otherwise ``model_099.hdf5``
``weights_dir``     str / ``.../pyasl/models``       Directory containing weight files
``out_prefix``      str / ``denoised_``              Prefix for output filenames
==================  ===============================  ==============================================

YAML example
------------

.. code-block:: yaml

    modules:
      - name: DLASLDenoiseCBF
        params:
          mask_path: dlasl_mask.nii.gz
          model_selection: 1
          out_prefix: "denoised_"