.. _auto_nhtsa_crashdata_finder:

*NHTSA CRASHDATA FINDER*
========================

Searches the canonical NHTSA front-impact Simlytiks dataset (default columns aligned with nhtsa_090525.d3Zip) by vehicle, test, and driver-injury filters and returns the matched rows plus summary counts, per-make / per-rating histograms, and three pre-computed curve groups (disp-vs-accel cross plot, accel-vs-time, disp-vs-time). Execution is gated on a d3VIEW-issued license key — the platform only releases data when the install's NHTSA_CRASHDATA_LICENSE_KEY sitevariable matches the key d3VIEW shipped with the worker. End users never type a password; an authorized admin pastes the key into /admin/settings/general once per install.

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

Tagged: ``nhtsa``, ``crash``, ``frontal``, ``injury``, ``occupant``, ``filter``, ``search``, ``star_rating``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Vehicle Make
     - make
     - select
     - —
     - ✓
     - Multi-select of vehicle makes (TOYOTA, HONDA, FORD, ...). Empty selection keeps all. Options auto-populated from the canonical NHTSA dataset on first form render.
   * - Vehicle Model
     - model
     - select
     - —
     - 
     - 
   * - Body Type
     - body_type
     - select
     - —
     - 
     - Multi-select of body styles (FOUR DOOR SEDAN, SUV, PICKUP TRUCK, ...). Empty keeps all.
   * - Test Laboratory
     - test_lab
     - select
     - —
     - 
     - Multi-select of labs that ran the test (CALSPAN, KARCO, MGA, ...). Empty keeps all.
   * - Overall Frontal Star Rating
     - ncap_overall_rating
     - select
     - —
     - 
     - 
   * - Model Year
     - model_year_range
     - range
     - *(complex)*
     - 
     - Inclusive range for model year. [0, 0] means no constraint.
   * - Vehicle Weight (kg)
     - vehicle_weight_range
     - range
     - *(complex)*
     - 
     - Inclusive range for vehicle test weight. [0, 0] means no constraint.
   * - HIC Driver
     - hic_range
     - range
     - *(complex)*
     - 
     - Inclusive range for HIC Driver. [0, 0] means no constraint.
   * - NIJ Driver
     - nij_range
     - range
     - *(complex)*
     - 
     - Inclusive range for NIJ Driver. [0, 0] means no constraint.
   * - Chest Deflection (mm)
     - chest_deflection_range
     - range
     - *(complex)*
     - 
     - Inclusive range for chest deflection. [0, 0] means no constraint.
   * - Femur Peak Force (kN)
     - femur_force_range
     - range
     - *(complex)*
     - 
     - Inclusive range for femur peak force. [0, 0] means no constraint.
   * - Include Time-History Curves
     - include_curves
     - select
     - no
     - 
     - 
   * - Columns to include in records output
     - output_columns
     - select
     - *(complex)*
     - 
     - Which columns from the matched rows to include in the records output. Empty selection = include all columns. Options auto-populated from the canonical NHTSA dataset on first form render.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Matched Records
     - records
     - dataset
     - Subset of the input dataset where every row passes every active filter; columns preserved.
   * - Match Count
     - count
     - scalar
     - Number of rows that passed every filter.
   * - Histogram by Make
     - histogram_by_make
     - dataset
     - Two-column dataset (make, count) sorted descending by count.
   * - Histogram by Overall NCAP Rating
     - histogram_by_rating
     - dataset
     - Two-column dataset (rating, count) sorted descending by count.
   * - Accel vs Time (per matched record)
     - accel_vs_time_curves
     - vector
     - CurveGroup of acceleration-vs-time curves passed through unchanged from the dataset's accel-curve column. Empty unless include_curves=yes.
   * - Disp vs Time (per matched record)
     - disp_vs_time_curves
     - vector
     - CurveGroup of displacement-vs-time curves passed through unchanged. Empty unless include_curves=yes.
   * - Disp vs Accel (cross plot)
     - disp_vs_accel_curves
     - vector
     - CurveGroup of pre-computed disp-vs-accel cross plots passed through unchanged. Empty unless include_curves=yes.

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

- data.dataset.filter
- data.dataset.summarize
- engineering.crash.dynamics
- engineering.occupant.injury
- 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>nhtsa_crashdata_finder</code>. Schema hash: <code>db64e8ee871d</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>