.. _auto_matrix_createfromstring:

*CREATE A MATRIX FROM A CSV STRING*
===================================

Parses a CSV-formatted text string and constructs a numeric matrix object for downstream processing. Use this worker when matrix data arrives as plain text (e.g., copied from a spreadsheet or generated inline) and needs to be converted into a structured matrix type.

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

Classification: **process**.

Tagged: ``csv``, ``matrix``, ``parse``, ``string_to_matrix``, ``text_input``, ``transformations``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Matrix In Text Form
     - matrixin_text_form
     - text
     - —
     - 
     - CSV-formatted string representing the matrix, where rows are newline-delimited and columns are comma-separated (e.g., '1,2,3\n4,5,6'); required to produce any output — leave default null only if the matrix will be provided at runtime.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - matrix_createfromstring_output_1
     - matrix_createfromstring_output_1
     - matrix
     - Structured matrix object parsed from the input CSV string, with rows and columns corresponding to the newline- and comma-delimited values; consumed by downstream matrix math or ML workers.

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

- data.dataset.transform
- data.io.csv

.. raw:: html

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