.. _auto_physicaltest_create_from_file:

*CREATE PHYSICALTEST FROM FILE*
===============================

Creates a new physical-test (experiment) record in d3VIEW by uploading one or more raw data files. Use this worker to ingest physical test results — such as CSV channel data, Excel reports, or image/video media — and register them under a named experiment with optional project assignment and automatic post-processing.

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

Tagged: ``experiment``, ``file-upload``, ``ingest``, ``physicaltest``, ``simulation``, ``test-data``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Name
     - input_name
     - text
     - —
     - ✓
     - Human-readable name for the new experiment record (e.g. 'Sled Test 042 – 56 kph'); displayed as the experiment title in d3VIEW.
   * - Description
     - input_desc
     - textarea
     - —
     - ✓
     - Free-text description of the experiment, including test conditions, specimen details, or any notes relevant to downstream analysis.
   * - Tags
     - input_tags
     - text
     - —
     - ✓
     - Comma-separated keyword tags to aid search and filtering of the experiment (e.g. 'crash,barrier,56kph').
   * - Project ID
     - input_project_id
     - remote_lookup
     - —
     - 
     - Optional project to associate the experiment with; resolved via the /api/user/projects remote lookup — leave blank to create the experiment without a project assignment.
   * - Files
     - input_files
     - file
     - —
     - ✓
     - One or more data/media files to attach to the experiment; accepted formats are PNG, JPG, GIF, MOV, MP4, XLSX, UNV, MAP, CSV, and TSV — repeatable field supporting multiple file uploads.
   * - Auto Process
     - input_auto_process
     - select
     - no
     - 
     - Whether d3VIEW should automatically parse and process the uploaded files upon creation; set to 'yes' to trigger immediate ingestion pipelines, default is 'no'.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Physicaltest Id
     - physicaltest_id
     - integer
     - Integer primary key of the newly created physical-test (experiment) record in d3VIEW; use this ID to reference the experiment in downstream workers.

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

- data.dataset.ingest
- platform.integration

.. raw:: html

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