assessmentTable

Create empty assessment table for Euro NCAP test scenario

Since R2025a

Syntax

emptyAssessmentTable = assessmentTable(euroAssessmentObj,ncapTestName)

Description

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.

Note

This function requires the Automated Driving Toolbox™ Test Suite for Euro NCAP^® Protocols support package. You can install the Automated Driving Toolbox Test Suite for Euro NCAP Protocols support package from the Add-On Explorer. For more information about installing add-ons, see Get and Manage Add-Ons.

example

Examples

collapse all

Compute Score for Euro NCAP Test Scenario

This example uses:

Open Live Script

Specify a Euro NCAP test name.

ncapTestName = "SA AEB CCFtap";

Create a Euro NCAP protocol specification object.

euroAssessmentObj = euroAssessment;

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

emptyAssessmentTable = assessmentTable(euroAssessmentObj,ncapTestName)

emptyAssessmentTable=9×2 table
                         TestDescription                         CollisionAvoidance
    _________________________________________________________    __________________

    "EgoSpeed = 2.7778m/s, Primary Target Speed = 8.3333m/s"            NaN        
    "EgoSpeed = 2.7778m/s, Primary Target Speed = 12.5m/s"              NaN        
    "EgoSpeed = 2.7778m/s, Primary Target Speed = 16.6667m/s"           NaN        
    "EgoSpeed = 4.1667m/s, Primary Target Speed = 8.3333m/s"            NaN        
    "EgoSpeed = 4.1667m/s, Primary Target Speed = 12.5m/s"              NaN        
    "EgoSpeed = 4.1667m/s, Primary Target Speed = 16.6667m/s"           NaN        
    "EgoSpeed = 5.5556m/s, Primary Target Speed = 8.3333m/s"            NaN        
    "EgoSpeed = 5.5556m/s, Primary Target Speed = 12.5m/s"              NaN        
    "EgoSpeed = 5.5556m/s, Primary Target Speed = 16.6667m/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.CollisionAvoidance(:) = 1;

Compute the score for the specified Euro NCAP test name.

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

Display the score for the specified Euro NCAP test name.

disp(score)

    AggregateScore: 1
    AvailableScore: 1

Display the updated assessment table.

disp(assessmentTableUpdated)

                         TestDescription                         CollisionAvoidance    EntryStatus    Points    Weights    Colors 
    _________________________________________________________    __________________    ___________    ______    _______    _______

    "EgoSpeed = 2.7778m/s, Primary Target Speed = 8.3333m/s"             1               "Valid"        1          1       "Green"
    "EgoSpeed = 2.7778m/s, Primary Target Speed = 12.5m/s"               1               "Valid"        1          1       "Green"
    "EgoSpeed = 2.7778m/s, Primary Target Speed = 16.6667m/s"            1               "Valid"        1          1       "Green"
    "EgoSpeed = 4.1667m/s, Primary Target Speed = 8.3333m/s"             1               "Valid"        1          1       "Green"
    "EgoSpeed = 4.1667m/s, Primary Target Speed = 12.5m/s"               1               "Valid"        1          1       "Green"
    "EgoSpeed = 4.1667m/s, Primary Target Speed = 16.6667m/s"            1               "Valid"        1          1       "Green"
    "EgoSpeed = 5.5556m/s, Primary Target Speed = 8.3333m/s"             1               "Valid"        1          1       "Green"
    "EgoSpeed = 5.5556m/s, Primary Target Speed = 12.5m/s"               1               "Valid"        1          1       "Green"
    "EgoSpeed = 5.5556m/s, Primary Target Speed = 16.6667m/s"            1               "Valid"        1          1       "Green"

Input Arguments

collapse all

`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. This value must match one of the ncapTestName values listed in the Euro NCAP Test Scenario Information tables.

Output Arguments

collapse all

`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.

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].

More About

collapse all

Euro NCAP Test Scenario Information

These tables lists the full names of Euro NCAP test scenarios, their corresponding ncapTestName values, their descriptions, and their locations in the Euro NCAP test protocol document.

Car-to-Car Collision Scenarios

`ncapTestName`	Euro NCAP Safety Assist Automatic Emergency Braking Test Scenario Full Name	Description	Euro NCAP Test Protocol Document Location
`"SA AEB CCRs"`	Car-to-Car Rear stationary	The ego vehicle moves forward toward a stationary target vehicle, resulting in a collision between the front side of the ego and the rear side of the target.	For more information on this test, see page 16 of the Test Protocol – AEB Car-to-Car systems document.
`"SA AEB CCRm"`	Car-to-Car Rear moving	The ego vehicle moves forward toward a target vehicle traveling at a constant speed, resulting in a collision between the front side of the ego and the rear side of the target.	For more information on this test, see page 17 of the Test Protocol – AEB Car-to-Car systems document.
`"SA AEB CCRb"`	Car-to-Car Rear braking	The ego vehicle moves forward toward a target vehicle that travels at a constant speed, then decelerates, resulting in a collision between the front side of the ego and the rear side of the target.	For more information on this test, see page 17 of the Test Protocol – AEB Car-to-Car systems document.
`"SA AEB CCFtap"`	Car-to-Car Front turn-across-path	The ego vehicle turns across the path of an oncoming target vehicle traveling at a constant speed, resulting in a head-on collision.	For more information on this test, see page 18 of the Test Protocol – AEB Car-to-Car systems document.
`"SA AEB CCCscp"`	Car-to-car Crossing Straight Crossing Path	The ego and target vehicles move toward a junction on straight, perpendicular paths, resulting in a collision between the front side of the ego and one side of the target.	For more information on this test, see page 19 of the Test Protocol – AEB Car-to-Car systems document.
`"SA AEB CCFhos"`	Car-to-Car Front Head-On straight	The ego and target vehicles move toward each other in the same lane, resulting in a head-on collision.	For more information on this test, see page 22 of the Test Protocol – AEB Car-to-Car systems document.
`"SA AEB CCFhol"`	Car-to-Car Front Head-On lane change	The ego and target vehicles move toward each other, each traveling in different lanes. The target vehicle performs a lane change into the ego lane, resulting in a head-on collision.	For more information on this test, see page 22 of the Test Protocol – AEB Car-to-Car systems document.

Car-to-Pedestrian Collision Scenarios

`ncapTestName`	Euro NCAP Vulnerable Road User Automatic Emergency Braking Test Scenario Full Name	Description	Euro NCAP Test Protocol Document Location
`"VRU AEB Crossing CPFA"`	Car-to-Pedestrian Farside Adult	The ego vehicle moves forward toward an adult pedestrian running across its path from the farside, resulting in a collision between the front side of the ego vehicle and the pedestrian.	For more information on this test, see page 24 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Crossing CPNA"`	Car-to-Pedestrian Nearside Adult	The ego vehicle moves forward toward an adult pedestrian walking across its path from the nearside, resulting in a collision between the front side of the ego vehicle and the pedestrian.	For more information on this test, see page 24 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Crossing CPNCO"`	Car-to-Pedestrian Nearside Child Obstructed	The ego vehicle moves forward toward a child pedestrian walking across its path from the nearside, resulting in a collision between the front side of the ego vehicle and the pedestrian.	For more information on this test, see page 25 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Longitudinal CPLA"`	Car-to-Pedestrian Longitudinal Adult	The ego vehicle moves forward toward an adult pedestrian walking in front of it, in the same direction, resulting in a collision between the front side of the ego vehicle and the pedestrian.	For more information on this test, see page 25 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Turning CPTAns"`	Car-to-Pedestrian Turning Adult nearside same	The ego vehicle moves forward into a junction, then turns toward an adult pedestrian, starting in the same direction, walking across the junction from the nearside, resulting in a collision between the front side of the ego vehicle and the pedestrian.	For more information on this test, see page 28 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Turning CPTAno"`	Car-to-Pedestrian Turning Adult nearside opposite	The ego vehicle moves forward into a junction, then turns toward an adult pedestrian, starting in the opposite direction, walking across the junction from the nearside, resulting in a collision between the front side of the ego vehicle and the pedestrian.	For more information on this test, see page 27 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Turning CPTAfs"`	Car-to-Pedestrian Turning Adult farside same	The ego vehicle moves forward into a junction, then turns toward an adult pedestrian, starting in the same direction, walking across the junction from the farside, resulting in a collision between the front side of the ego vehicle and the pedestrian.	For more information on this test, see page 26 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Turning CPTAfo"`	Car-to-Pedestrian Turning Adult farside opposite	The ego vehicle moves forward into a junction, then turns toward an adult pedestrian, starting in the opposite direction, walking across the junction from the farside, resulting in a collision between the front side of the ego vehicle and the pedestrian.	For more information on this test, see page 27 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Reverse CPRs"`	Car-to-Pedestrian Reverse Adult/Child stationary	The ego vehicle moves rearward toward an adult or child pedestrian standing still, resulting in a collision between the rear side of the ego vehicle and the pedestrian.	For more information on this test, see page 29 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Reverse CPRm"`	Car-to-Pedestrian Reverse Adult/Child moving	The ego vehicle moves rearward toward an adult or child pedestrian walking from the nearside, resulting in a collision between the rear side of the ego vehicle and the pedestrian.	For more information on this test, see page 29 of the Test Protocol – AEB/LSS VRU systems document.

Car-to-Motorcyclist Collision Scenarios

`ncapTestName`	Euro NCAP Vulnerable Road User Automatic Emergency Braking Test Scenario Full Name	Description	Euro NCAP Test Protocol Document Location
`"VRU AEB Longitudinal CMRs"`	Car-to-Motorcyclist Rear stationary	The ego vehicle moves forward toward a motorcyclist in front, traveling in the same direction, resulting in a collision between the front side of the ego vehicle and the rear side of the motorcyclist.	For more information on this test, see page 36 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Longitudinal CMRb"`	Car-to-Motorcyclist Rear braking	The ego vehicle moves forward toward a motorcyclist in front, traveling in the same direction at a constant speed, which then decelerates, resulting in a collision between the front side of the ego and the rear side of the motorcyclist.	For more information on this test, see page 37 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Turning CMFtap"`	Car-to-Motorcyclist Front turn across path	The ego vehicle turns across the path of an oncoming motorcyclist that travels at a constant speed, resulting in a collision between the front side of the ego vehicle and the front side of the motorcyclist.	For more information on this test, see page 38 of the Test Protocol – AEB/LSS VRU systems document.

Car-to-Bicyclist Collision Scenarios

`ncapTestName`	Euro NCAP Vulnerable Road User Automatic Emergency Braking Test Scenario Full Name	Description	Euro NCAP Test Protocol Document Location
`"VRU AEB Crossing CBFA"`	Car-to-Bicyclist Farside Adult	The ego vehicle moves forward toward a bicyclist crossing its path cycling from the farside, resulting in a collision between the front side of the ego vehicle and the bicyclist.	For more information on this test, see page 30 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Crossing CBNA"`	Car-to-Bicyclist Nearside Adult	The ego vehicle moves forward toward a bicyclist crossing its path cycling from the nearside, resulting in a collision between the front side of the ego vehicle and the bicyclist.	For more information on this test, see page 31 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Crossing CBNAO"`	Car-to-Bicyclist Nearside Adult Obstructed	The ego vehicle moves forward toward a bicyclist crossing its path cycling from the nearside from behind an obstruction, resulting in a collision between the front side of the ego vehicle and the bicyclist.	For more information on this test, see page 31 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Longitudinal CBLA"`	Car-to-Bicyclist Longitudinal Adult	The ego vehicle moves forward toward a bicyclist cycling in front, in the same direction, resulting in a collision between the front side of the ego vehicle and the bicyclist.	For more information on this test, see page 32 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Turning CBTAn"`	Car-to-Bicyclist Turning Adult nearside	The ego vehicle turns toward a bicyclist crossing its path across a junction, cycling in the opposite direction, from the nearside, resulting in a collision between the front side of the ego vehicle and the bicyclist.	For more information on this test, see page 33 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU AEB Turning CBTAf"`	Car-to-Bicyclist Turning Adult farside	The ego vehicle turns toward a bicyclist crossing its path across a junction, cycling in the opposite direction, from the farside, resulting in a collision between the front side of the ego vehicle and the bicyclist.	For more information on this test, see page 33 of the Test Protocol – AEB/LSS VRU systems document.

Lane Support System Scenarios

`ncapTestName`	Euro NCAP Safety Assist/Vulnerable Road User Lane Support System Test Scenario Full Name	Description	Euro NCAP Test Protocol Document Location
`"SA LSS LKA Solid Line"`	Lane Keep Assist Solid line	The ego vehicle drifts beyond a solid lane marking into the adjacent lane.	For more information on this test, see page 17 of the Test Protocol – Lane Support Systems document.
`"SA LSS LKA Dashed Line"`	Lane Keep Assist Dashed line	The ego vehicle drifts beyond a dashed lane marking into the adjacent lane.	For more information on this test, see page 17 of the Test Protocol – Lane Support Systems document.
`"SA LSS ELK Solid Line"`	Emergency Lane Keeping Solid line	The ego vehicle drifts beyond a solid lane marking into the adjacent lane.	For more information on this test, see page 15 of the Test Protocol – Lane Support Systems document.
`"SA LSS ELK Road Edge"`	Emergency Lane Keeping Road Edge	The ego vehicle drifts beyond a road edge, moving out of the road.	For more information on this test, see page 15 of the Test Protocol – Lane Support Systems document.
`"SA LSS ELK Oncoming vehicle"`	Emergency Lane Keeping Oncoming vehicle	The ego vehicle drifts into the adjacent lane, toward an oncoming target vehicle.	For more information on this test, see page 15 of the Test Protocol – Lane Support Systems document.
`"SA LSS ELK Overtaking vehicle intentional"`	Emergency Lane Keeping Overtaking vehicle intentional	The ego vehicle intentionally overtakes a target traveling in the same direction in a lane adjacent to the driver side of the ego vehicle.	For more information on this test, see page 16 of the Test Protocol – Lane Support Systems document.
`"SA LSS ELK Overtaking vehicle unintentional"`	Emergency Lane Keeping Overtaking vehicle unintentional	The ego vehicle unintentionally overtakes a target vehicle traveling in the same direction in a lane adjacent to the driver side of the ego vehicle.	For more information on this test, see page 16 of the Test Protocol – Lane Support Systems document.
`"VRU LSS CM Oncoming vehicle"`	Car-to-Motorcyclist oncoming	The ego vehicle drifts out of lane toward a motorcyclist traveling in the opposite direction, resulting in a collision between the front side of the ego vehicle and the front side of the motorcyclist.	For more information on this test, see page 39 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU LSS CM Overtaking vehicle unintentional"`	Car-to-Motorcyclist overtaking unintentional	The ego vehicle unintentionally overtakes a motorcyclist traveling in the same direction in a lane adjacent to the driver side of the ego vehicle.	For more information on this test, see page 41 of the Test Protocol – AEB/LSS VRU systems document.
`"VRU LSS CM Overtaking vehicle intentional"`	Car-to-Motorcyclist Overtaking intentional	The ego vehicle intentionally overtakes a motorcyclist traveling in the same direction in a lane adjacent to the driver side of the ego vehicle.	For more information on this test, see page 41 of the Test Protocol – AEB/LSS VRU systems document.

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 example. For more information on how to compute assessment criteria values, see the AEB 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. https://www.euroncap.com/media/79885/euro-ncap-assessment-protocol-vru-v114.pdf.

[2] European New Car Assessment Programme (Euro NCAP). Assessment Protocol - Safety Assist Collision Avoidance, Implementation 2023, Version 10.4.1, February 2024. https://www.euroncap.com/media/80154/euro-ncap-assessment-protocol-sa-collision-avoidance-v1041.pdf.

Version History

Introduced in R2025a

assessmentTable

Syntax

Description

Examples

Compute Score for Euro NCAP Test Scenario

Input Arguments

euroAssessmentObj — Euro NCAP assessment protocol specifications euroAssessment object

ncapTestName — Euro NCAP test scenario name character vector | string scalar

Output Arguments

emptyAssessmentTable — Euro NCAP assessment table table

More About

Euro NCAP Test Scenario Information

Tips

References

Version History

See Also

`euroAssessmentObj` — Euro NCAP assessment protocol specifications
`euroAssessment` object

`ncapTestName` — Euro NCAP test scenario name
character vector | string scalar

`emptyAssessmentTable` — Euro NCAP assessment table
table