IMPORT DATA FROM MME FILE¶
Ingests a physical test dataset from an MME binary file, importing channel time-history data, images, and videos into the d3VIEW physical-test registry. Use this worker to create or replace a physical-test record from MME-format crash or component test data with optional curve scaling and channel-code decoration.
When to use¶
Tagged: channel, clip, curve_scaling, ffmpeg, import, mme, physical_test_import, physicaltest.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Test Name | test_name | text | Physicaltest-<%UID%>-<%DATE%> | Human-readable name assigned to the new physical-test record; defaults to an auto-generated string combining a unique ID and the current date — leave default unless a specific name is required. | |
| MME File | mme_file | file | — | ✓ | Required MME binary file (.mme) containing the physical-test channel data, metadata, images, and/or videos to be imported. |
| Import Options | import_options | select | all | Multi-select list controlling what content is extracted from the MME file: ‘all’ imports everything; individual options restrict import to channel data, images, or videos only — defaults to ‘all’. | |
| Video Conversion Options | ffmpeg_options | text | -c:a aac -pix_fmt rgb24 | ✓ | FFmpeg command-line flags used when transcoding embedded videos during import; default ‘-c:a aac -pix_fmt rgb24’ is suitable for most cases — only change if a different codec or pixel format is needed. |
| Template ID | template_id | remote_lookup | — | Optional response-template ID (looked up via remote registry) to map imported channels to named KPIs; leave null to skip template-based response mapping. | |
| Remove Existing | remove_if_exists | select | yes | Controls whether an existing physical-test record with the same name is deleted before re-import; set to ‘yes’ (default) to overwrite or ‘no’ to abort on collision. | |
| Add Channel Code | add_channel_code | select | no | Optionally prepends or appends the ISO channel code to each channel name during import; set to ‘none’ (default) to leave channel names unchanged, ‘prepend’ to prefix, or ‘append’ to suffix. | |
| Clip At X=0 | clipx_at_zero | select | yes | When set to ‘yes’ (default), clips all imported time-history curves so that data before t=0 is discarded; set to ‘no’ to retain the full pre-trigger signal. | |
| Clip X-max | clipx_max | scalar | 1.0 | Upper time limit (in the curve’s native time units, default 1.0) beyond which imported time-history data is truncated; increase for longer test durations. | |
| X-Scale Factor | xsf | scalar | 1.0 | Multiplicative scale factor applied to the X-axis (time) of all imported curves; default 1.0 applies no scaling — adjust to convert time units (e.g., 0.001 for ms → s). | |
| TSFFSY | time_sf | scalar | 1.0 | Time-dependent Y-axis scale factor (TSFFSY); scales the Y values as a function of time — default 1.0 applies no scaling. | |
| MSFFSY | mass_sf | scalar | 1.0 | Mass-based Y-axis scale factor (MSFFSY); used to normalise channel amplitudes by specimen mass — default 1.0 applies no scaling. | |
| LSFFSY | length_sf | scalar | 1.0 | Length Scale factor for scaling Y | |
| How to name the responses | name_from | select | Channel code | Choose attribute to name the response | |
| Channel Name Mapper | name_mapper | mapper | — | Can include x_sf and y_sf columns to scale the individual responses | |
| Overwrite Channel Name Before Mapping | name_overwrite_attr | text | — | This allows renaming the channel name before mapping | |
| Add Direction | add_direction | select | no | Add direction to the response name | |
| Add Dimension | add_dimension | select | no | Add dimension to the response name | |
| Systemmodel | systemmodel_id | remote_lookup | — | Associates this test to a Systemmodel |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Physicaltest Id | physicaltest_id | integer | Integer primary key of the newly created (or replaced) physical-test record in the d3VIEW physicaltests registry. |
| Num Responses | num_responses | integer | Integer count of time-history response channels successfully imported from the MME file. |
| Responses | responses | dataset | Dataset listing all imported response channels with their metadata (channel name, unit, sampling rate, etc.). |
| Template Id | template_id | responsetemplate | Identifier of the response template that was applied during import; null if no template was specified. |
| Transformed Responses | transformed_responses | dataset | Dataset of response channels after any curve scaling (XSF, clip, mass/time scale factors) and channel-code decoration have been applied. |
| Records | records | dataset | Dataset of all database records created or updated in the physical-test registry as a result of this import. |
| Logs | logs | dataset | Dataset containing line-by-line import log messages, warnings, and errors generated during MME file processing. |
Disciplines¶
- cae.postprocessing.extraction
- data.curve.transform
- data.dataset.ingest
Auto-generated from platform schema. Worker id: physicaltest_import_mme_data. Schema hash: 4aabc8a9749e. Hand-curated docs in workerexamples/ override this page when present.