.. _auto_study_create:

*CREATES A NEW STUDY*
=====================

Creates a new Study entity on the d3VIEW platform, registering it with a name, optional description, tags, and an associated response template. Use this worker at the start of a workflow to provision the study container that downstream workers will populate with simulation or test results.

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

Tagged: ``create``, ``platform``, ``registry``, ``study``, ``study_create``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Study Name
     - study_name
     - text
     - —
     - ✓
     - Human-readable name for the new study (e.g. 'Frontal_ODB_Run42'); required — the study cannot be created without it.
   * - Description
     - description
     - textarea
     - —
     - 
     - Free-text description of the study's purpose or scope; optional, leave blank if no additional context is needed.
   * - Tags
     - tags
     - textarea
     - —
     - 
     - Comma- or newline-separated keywords to tag the study for search and filtering (e.g. 'crash, odb, v2'); optional.
   * - Response Template
     - responsetemplate_id
     - remote_lookup
     - —
     - 
     - Remote-lookup reference to an existing Response Template that defines the KPI schema for this study; leave unset if no template is required.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Study Id
     - study_id
     - scalar
     - Integer or UUID identifier of the newly created study, returned by the platform; pass this value to downstream workers that need to attach data or results to the study.

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

- platform.workflow

.. raw:: html

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