agedi.cli.train
===============

.. py:module:: agedi.cli.train


Attributes
----------

.. autoapisummary::

   agedi.cli.train._VALID_NOISERS
   agedi.cli.train._DEFAULT_NOISER


Functions
---------

.. autoapisummary::

   agedi.cli.train.train
   agedi.cli.train._parse_override_value


Module Contents
---------------

.. py:data:: _VALID_NOISERS

.. py:data:: _DEFAULT_NOISER
   :value: 'CellPositions'


.. py:function:: train(**params) -> None

   Train an AGeDi diffusion model from the command line.

   INPUT can be a trajectory file or a YAML configuration file.

   
   Trajectory mode — build the model from CLI options:

       agedi train training_data.traj --noisers ConfinedCellPositions,Types

   
   Config mode — load all settings from a YAML file:

       agedi train my_train.yaml

   In config mode, optional KEY=VALUE pairs can be appended to override
   individual config entries without editing the file:

   
       agedi train my_train.yaml feature_size=128 epochs=200

   A ready-to-edit YAML template is available at:

   
       python -c "import agedi, pathlib; print(pathlib.Path(agedi.__file__).parent / 'conf' / 'train.yaml')"


.. py:function:: _parse_override_value(raw: str)

   Coerce a CLI override string to int, float, bool, or str.