assessmentTable

Create empty assessment table for Euro NCAP test scenario

Since R2025a

Syntax

emptyAssessmentTable = assessmentTable(euroAssessmentObj,ncapTestName)

Description

Add-On Required: This feature requires the Automated Driving Toolbox Test Suite for Euro NCAP Protocols add-on.

emptyAssessmentTable = assessmentTable(euroAssessmentObj,ncapTestName) creates an empty assessment table, emptyAssessmentTable, using the Euro NCAP^® assessment protocol specifications euroAssessmentObj for the Euro NCAP test scenario with name ncapTestName.

Examples

Compute Score for Euro NCAP Test Scenario and Generate Report

Specify a Euro NCAP test name from protocol specification years 2026–2028.

ncapTestName = "CA FC CCFtap";

Create a Euro NCAP protocol specification object for protocol specification years 2026–2028.

euroAssessmentObj = euroAssessment(2026);

Create an empty Euro NCAP assessment table for the specified Euro NCAP test name.

emptyAssessmentTable = assessmentTable(euroAssessmentObj,ncapTestName)

emptyAssessmentTable=16×2 table
     "EgoSpeed = 2.7778m/s, PrimaryTargetSpeed = 8.3333m/s"    NaN
       "EgoSpeed = 2.7778m/s, PrimaryTargetSpeed = 12.5m/s"    NaN
    "EgoSpeed = 2.7778m/s, PrimaryTargetSpeed = 16.6667m/s"    NaN
    "EgoSpeed = 2.7778m/s, PrimaryTargetSpeed = 22.2222m/s"    NaN
     "EgoSpeed = 4.1667m/s, PrimaryTargetSpeed = 8.3333m/s"    NaN
       "EgoSpeed = 4.1667m/s, PrimaryTargetSpeed = 12.5m/s"    NaN
    "EgoSpeed = 4.1667m/s, PrimaryTargetSpeed = 16.6667m/s"    NaN
    "EgoSpeed = 4.1667m/s, PrimaryTargetSpeed = 22.2222m/s"    NaN
     "EgoSpeed = 5.5556m/s, PrimaryTargetSpeed = 8.3333m/s"    NaN
       "EgoSpeed = 5.5556m/s, PrimaryTargetSpeed = 12.5m/s"    NaN
    "EgoSpeed = 5.5556m/s, PrimaryTargetSpeed = 16.6667m/s"    NaN
    "EgoSpeed = 5.5556m/s, PrimaryTargetSpeed = 22.2222m/s"    NaN
     "EgoSpeed = 6.9444m/s, PrimaryTargetSpeed = 8.3333m/s"    NaN
       "EgoSpeed = 6.9444m/s, PrimaryTargetSpeed = 12.5m/s"    NaN

Create a copy of the empty assessment table, and fill in the values of the assessment criteria in the table.

filledAssessmentTable = emptyAssessmentTable;
filledAssessmentTable.ImpactVelocity(:) = 1;

Compute the score for the specified Euro NCAP test name.

[score,assessmentTableUpdated] = ncapScore(euroAssessmentObj,ncapTestName,filledAssessmentTable);

Display the updated assessment table.

disp(assessmentTableUpdated)

                        TestDescription                        ImpactVelocity    EntryStatus    Points    Weights    Colors
    _______________________________________________________    ______________    ___________    ______    _______    ______

    "EgoSpeed = 2.7778m/s, PrimaryTargetSpeed = 8.3333m/s"           1             "Valid"        0          1       "Red" 
    "EgoSpeed = 2.7778m/s, PrimaryTargetSpeed = 12.5m/s"             1             "Valid"        0          1       "Red" 
    "EgoSpeed = 2.7778m/s, PrimaryTargetSpeed = 16.6667m/s"          1             "Valid"        0          1       "Red" 
    "EgoSpeed = 2.7778m/s, PrimaryTargetSpeed = 22.2222m/s"          1             "Valid"        0          1       "Red" 
    "EgoSpeed = 4.1667m/s, PrimaryTargetSpeed = 8.3333m/s"           1             "Valid"        0          1       "Red" 
    "EgoSpeed = 4.1667m/s, PrimaryTargetSpeed = 12.5m/s"             1             "Valid"        0          1       "Red" 
    "EgoSpeed = 4.1667m/s, PrimaryTargetSpeed = 16.6667m/s"          1             "Valid"        0          1       "Red" 
    "EgoSpeed = 4.1667m/s, PrimaryTargetSpeed = 22.2222m/s"          1             "Valid"        0          1       "Red" 
    "EgoSpeed = 5.5556m/s, PrimaryTargetSpeed = 8.3333m/s"           1             "Valid"        0          1       "Red" 
    "EgoSpeed = 5.5556m/s, PrimaryTargetSpeed = 12.5m/s"             1             "Valid"        0          1       "Red" 
    "EgoSpeed = 5.5556m/s, PrimaryTargetSpeed = 16.6667m/s"          1             "Valid"        0          1       "Red" 
    "EgoSpeed = 5.5556m/s, PrimaryTargetSpeed = 22.2222m/s"          1             "Valid"        0          1       "Red" 
    "EgoSpeed = 6.9444m/s, PrimaryTargetSpeed = 8.3333m/s"           1             "Valid"        0          1       "Red" 
    "EgoSpeed = 6.9444m/s, PrimaryTargetSpeed = 12.5m/s"             1             "Valid"        0          1       "Red" 
    "EgoSpeed = 6.9444m/s, PrimaryTargetSpeed = 16.6667m/s"          1             "Valid"        0          1       "Red" 
    "EgoSpeed = 6.9444m/s, PrimaryTargetSpeed = 22.2222m/s"          1             "Valid"        0          1       "Red" 

Generate a report showing the consolidated assessment results for the Euro NCAP test.

ncapReport(euroAssessmentObj,ncapTestName);

Export the report as a PNG image.

exportReport(euroAssessmentObj,ncapTestName,"results.png")

Input Arguments

euroAssessmentObj — Euro NCAP assessment protocol specifications

euroAssessment object

Euro NCAP assessment protocol specifications, specified as a euroAssessment object.

ncapTestName — Euro NCAP test scenario name

character vector | string scalar

Euro NCAP test scenario name, specified as a character vector or string scalar, representing a valid Euro NCAP test scenario name. The list of valid Euro NCAP test scenario names depends on the protocol specification year specified by the Year property of euroAssessmentObj.

• 2023 — See the Euro NCAP Test Scenario Information section of Euro NCAP Test Scenarios for Protocol Specification Years 2023–2025, which lists the full names of the valid Euro NCAP test scenarios, their corresponding ncapTestName values, and their descriptions for protocol specification years 2023–2025.

• 2026 — See the Euro NCAP Test Scenario Information section of Euro NCAP Test Scenarios for Protocol Specification Years 2026–2028, which lists the full names of Euro NCAP test scenarios, their corresponding ncapTestName values, and their descriptions for protocol specification years 2026–2028. (since R2026a)

For more information on the Euro NCAP test scenarios, see Euro NCAP Car Safety Protocols.

Output Arguments

emptyAssessmentTable — Euro NCAP assessment table

table

Euro NCAP assessment table, returned as a table with empty assessment criteria values.

The returned table has N rows. N is the number of test scenario variants for the specified Euro NCAP test ncapTestName. The first column of the table, TestDescription, specifies the description of the test scenario, such as the speeds of the actors. Depending on which Euro NCAP test name ncapTestName you specify, the function appends one or more of these assessment criteria columns to the table, with values of NaN. For information on how to replace the NaN values, see Tips.

• ImpactVelocity — Impact velocity, returned as a numeric scalar. This value is the velocity at which the front or rear of the ego vehicle collides with a target. Units are in meters per second.

• RelativeImpactVelocity — Relative impact velocity, returned as a numeric scalar. This value is the velocity at which the front or rear of the ego vehicle collides with a target, relative to the velocity of the target. You can compute the RelativeImpactVelocity by subtracting the longitudinal velocity of the test target from ImpactVelocity at the time of collision. Units are in meters per second.

• TTC — Time to collision (TTC), returned as a numeric scalar. This value is the remaining time before the ego vehicle collides with the target, assuming both the ego and target continue to travel with their current speed. Units are in seconds.

• CollisionAvoidance — Collision avoidance flag, returned as a logical 1 (true) or 0 (false). This value indicates specifies the status of the collision avoidance. If the ego vehicle avoids collision, this value is 1. Otherwise, this value is 0.

• DTLE — Distance to lane edge (DTLE), returned as a numeric scalar. This value is the lateral distance between the lane edge and outermost edge of the tire, before the ego vehicle crosses the lane edge. Units are in meters.

• LateralSeperation — Lateral separation, returned as a numeric scalar. This value is the lateral separation distance between the ego vehicle and the oncoming or overtaking target. Units are in meters.

• SpeedReduction — Speed reduction of the ego vehicle, returned as a numeric scalar. This value is the reduction in the ego vehicle speed due to collision mitigation, computed as the difference between the ego vehicle speed at the start of the test and the ego vehicle speed at collision. Units are in meters per second. (since R2026a)

These columns define the Euro NCAP assessment criteria used to evaluate scores. For more information, see the Euro NCAP assessment protocol for vulnerable road user protection [1] and safety assist collision avoidance [2].

Tips

You must replace the NaN fields of the returned table with appropriate values, and specify the updated table as the assessmentTable input argument of the ncapScore function, to get Euro NCAP assessment scores. For more information, see the Compute Score for Euro NCAP Test Scenario and Generate Report example. For more information on how to compute assessment criteria values, see the Euro NCAP Testing with RoadRunner Scenario example.

References

[1] European New Car Assessment Programme (Euro NCAP). Assessment Protocol - Vulnerable Road User Protection, Implementation 2023, Version 11.4, December 2023.

[2] European New Car Assessment Programme (Euro NCAP). Assessment Protocol - Safety Assist Collision Avoidance, Implementation 2023, Version 10.4.1, February 2024.

Version History

Introduced in R2025a

R2026a_plus: New Euro NCAP tests for protocol specification years 2026–2028

The assessmentTable function now supports Euro NCAP tests for protocol specification years 2026–2028. For more information on supported Euro NCAP test scenarios for protocol specification years 2026–2028, see Euro NCAP Test Scenarios for Protocol Specification Years 2026–2028.