IMPORT MME DATA¶
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 | |
| Source | source_mode | select | upload | Selects where the test payload comes from. upload (default) preserves the existing behaviour. server_path reads a zip / mme file / folder already on the server filesystem. nhtsa_link downloads the consolidated NHTSA zip for a given test id by chaining the existing NHTSA importer. | |
| Server Path | server_path | text | — | Path on the server to a .zip, .mme, or folder containing the test payload. Used only when Source = server_path. The path must resolve under an allow-listed root (vault, cache, tmp); any path outside those roots is rejected. | |
| NHTSA Test ID | nhtsa_test_id | text | — | NHTSA test id used to download the consolidated payload via the existing physicaltest_nhtsa_data_importer worker. Used only when Source = nhtsa_link. | |
| Parse PDF report | parse_pdf_report | select | auto | When the source payload contains a PDF (e.g. an NHTSA test report) and this is set to auto / yes, the largest PDF inside the source is fed through the document_data_parser worker; the parser writes its KeyValue + Dataset + images back to the same physical test. | |
| PDF report extraction focus | pdf_report_extraction_focus | text | — | Optional free-text hint forwarded to document_data_parser’s extraction_focus input. Defaults to a physical-test-report focus when blank. |
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. |
| Pdf Report Path | pdf_report_path | text | Filesystem path of the PDF report the worker chained through document_data_parser, when one was detected in the source. Empty when no PDF was parsed. |
| Pdf Report Zip | pdf_report_zip | file | ZIP archive of the images extracted from the PDF report by document_data_parser, when chaining succeeded. Empty when no PDF was parsed. |
| Pdf Report Extracted | pdf_report_extracted | keyvalue | Summary of the PDF report extraction — parsed=yes/no/skipped, plus the writeback counts (keyvalue_responses_added, dataset_response_added, images_attached) reported by document_data_parser. Empty when parse_pdf_report=no. |
| 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: 9411dfd99c65. Hand-curated docs in workerexamples/ override this page when present.