.. _auto_madymo_parse_parameters_from_file:

*PARSES GROUP_DEFINE PARAMETERS FROM MADYMO*
============================================

Parses a Madymo XML input file and extracts all GROUP_DEFINE elements, retrieving their VAR_NAME and VALUE attributes as a structured parameter dataset. Use this worker to enumerate tunable Madymo parameters before setting up a design exploration or parameter sweep.

When to use
-----------

Tagged: ``group_define``, ``madymo``, ``parameter_extraction``, ``value``, ``var_name``, ``xml_parsing``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Madymo File
     - file_input
     - file
     - —
     - ✓
     - Madymo XML input file (.xml) from which GROUP_DEFINE parameter blocks will be parsed; required — must be a valid Madymo deck containing at least one GROUP_DEFINE element.
   * - Constants
     - constants
     - scalar
     - —
     - 
     - Comma-separated list of VAR_NAME values to treat as fixed constants and exclude from the output parameter set; leave blank to include all discovered parameters.
   * - Min Percentage
     - min_percentage
     - scalar
     - 0.8
     - 
     - Lower-bound multiplier applied to each parameter's nominal VALUE to compute its minimum range (e.g. default 0.8 = −20 %); leave as default unless a different lower bound is required.
   * - Max Percentage
     - max_percentage
     - scalar
     - 1.2
     - 
     - Upper-bound multiplier applied to each parameter's nominal VALUE to compute its maximum range (e.g. default 1.2 = +20 %); leave as default unless a different upper bound is required.
   * - Step Percentage
     - step_percentage
     - scalar
     - 0.1
     - 
     - Fractional step size between min and max expressed as a proportion of the nominal VALUE (e.g. default 0.1 = 10 % increments); used when generating discrete sweep levels for each parameter.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Parameters
     - parameters
     - dataset
     - Tabular dataset where each row represents one extracted GROUP_DEFINE parameter, containing at minimum the VAR_NAME, nominal VALUE, computed minimum, maximum, and step columns ready for downstream DOE or optimisation workers.

Disciplines
-----------

- cae.preprocessing.deck_authoring
- data.dataset.ingest

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>madymo_parse_parameters_from_file</code>. Schema hash: <code>72711324f684</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>