ncapSpec

Obtain Euro NCAP test specifications

Since R2024a

Syntax

[variationSpec,ncapTestSpec,specInfo] = ncapSpec(ncapTestName)

Description

[variationSpec,ncapTestSpec,specInfo] = ncapSpec(ncapTestName) returns European New Car Assessment Programme (Euro NCAP^®) test specifications for an input Euro NCAP test 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.

Examples

Obtain Seed and Variation Specifications Using Euro NCAP Test Name

Specify the European New Car Assessment Programme (Euro NCAP) test name for the Vulnerable Road User Automatic Emergency Braking Crossing Car-to-Pedestrian Nearside Child Obstructed test.

ncapTestName = "VRU AEB Crossing CPNCO";

Obtain specifications for the NCAP test, which you can use to create a seed scenario and its variants.

[variationSpec,ncapTestSpec] = ncapSpec(ncapTestName)

variationSpec=22×2 table
    EgoSpeed    Lighting
    ________    ________

     2.7778     "Day"   
     4.1667     "Day"   
     5.5556     "Day"   
     6.9444     "Day"   
     8.3333     "Day"   
     9.7222     "Day"   
     11.111     "Day"   
       12.5     "Day"   
     13.889     "Day"   
     15.278     "Day"   
     16.667     "Day"   
     2.7778     "Night" 
     4.1667     "Night" 
     5.5556     "Night" 
     6.9444     "Night" 
     8.3333     "Night" 
      ⋮

ncapTestSpec = struct with fields:
       SceneSpec: [1×1 struct]
    ScenarioSpec: [1×1 struct]

Input Arguments

ncapTestName — Euro NCAP test scenario name

"valid Euro NCAP test scenario name"

Euro NCAP test scenario name, specified as one of the ncapTestName values listed in the Euro NCAP Test Scenario Information section.

Output Arguments

variationSpec — Variation parameters

table

Variation parameters, returned as an N-by-M table. Each column in the table represents a variation parameter, and each row contains a set of values for the variation parameters to use to create scenario variants. N is the number of scenario variants and M is the number of variation parameters to create a scenario variant. The table contains different parameters based on the specified ncapTestName. For more information on this table, see Variation Parameter Information.

ncapTestSpec — Seed scenario specifications for Euro NCAP test

structure

Seed scenario specifications for the Euro NCAP test, returned as a structure. The structure contains these fields, using which you can create a seed scenario for the specified Euro NCAP test ncapTestName.

• SceneSpec — Scene specifications, returned as a structure. The structure contains the RoadData, LaneData, and RoadWidth fields, which contain road and lane information. You can use this information to create a scene for the specified input Euro NCAP test name ncapTestName. For more information on returned scene specifications, see Scene Specification Information.

• ScenarioSpec — Scenario specifications, returned as a structure. The structure contains actor and event information, which you can add to a scene to create a scenario. For more information on returned scenario specifications, see Scenario Specification Information.

• SeedScenarioIndex — Row index of the seed scenario specifications in the variationSpec output table. For example, if the SeedScenarioIndex value is 11, then the 11^th row in the variationSpec table represents the seed scenario specifications.

specInfo — Euro NCAP test information

structure

Euro NCAP test information, returned as a structure. The structure contains these fields:

• NCAPTestFullName — Full name of the input Euro NCAP test ncapTestName, returned as a string scalar.

• MetaData — Metadata information of the generated scenario variants, returned as a structure. The structure contains a VariantTitles field. Each element of the field contains a string scalar that specifies the title for the scenario variant in the corresponding row of the variationSpec output table.

• EvaluationCriterion — Criterion to evaluate for the specified Euro NCAP test ncapTestName, returned as a string scalar. (since R2025a)

• ScoringCriterion — Criteria on which to score the specified Euro NCAP test ncapTestName, returned as a structure. Depending on the specified Euro NCAP test, the returned structure contains one or more of these fields:

  • ColorLookup — Lookup table used to assign color based on obtained score while generating the test report.

  • AEBTable — Table containing vehicle under test (VUT) speed values and color lookup for assessment of Autonomous Emergency Braking (AEB) scenarios.

  • AEBWeights — Weights for each AEB test scenario for the specified Euro NCAP test ncapTestName, returned as a P-element column vector. P is the number of AEB scenario variants.

  • AEBScenarioPoints — Maximum allocated AEB points for the specified Euro NCAP test ncapTestName, returned as a scalar.

  • FCWTable — Table containing VUT speed values and color lookup for assessment of forward collision warning (FCW) scenarios.

  • FCWWeights — Weights for each FCW test scenario for the specified Euro NCAP test ncapTestName, returned as a Q-element column vector. Q is the number of FCW scenario variants.

  • FCWScenarioPoints — Maximum allocated FCW points for the specified Euro NCAP test ncapTestName, returned as a scalar.

  • Table — Table containing VUT speed values and color lookup for assessment of test scenarios.

  • Weights — Weights for each test scenario for the specified Euro NCAP test ncapTestName, returned as an R-element column vector. R is the number of test scenario variants.

  • ScenarioPoints — Maximum allocated points for the specified Euro NCAP test ncapTestName, returned as a scalar.

  • DayScenarioPoints — Maximum allocated day scenario points for the specified Euro NCAP test ncapTestName, returned as a scalar.

  • NightScenarioPoints — Maximum allocated night scenario points for the specified Euro NCAP test ncapTestName, returned as a scalar.

  (since R2025a)

For more information, see the Euro NCAP assessment protocol for vulnerable road user protection [1] and safety assist collision avoidance [2].

More About

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.

Variation Parameter Information

The returned variationSpec table contains one or more of these columns based on the specified ncapTestName.

Column	Description
Angle	Angle of the "Clothoid" trajectory with respect to the ego vehicle direction before the turn, returned as a scalar. Units are in radians.
CenterLaneMarking	Types of lane markings, returned as a string scalar or N+1-element string array. For a string scalar, the marking applies to all lanes. For a string array, N is the number of total lanes. Lane markings include options such as "Solid", "Dashed", or "Unmarked".
d1	Lateral distance traveled during curve establishment while performing a lane change, returned as a scalar. Units are in meters. For more information, see Lane Drift Parameters.
d2	Lateral distance traveled after curve establishment, but before crossing the lane edge, while performing a lane change, returned as a scalar. Units are in meters. For more information, see Lane Drift Parameters.
EgoImpactLocation	Point of collision relative to the collision side of the ego vehicle, returned as a string scalar. For example: "50%".
EgoLateralDirection	Lateral direction of the ego actor, returned as one of these options: "Right" — Ego vehicle drifts right. "Left" — Ego vehicle drifts left.
EgoLateralSpeed	Lateral speed of the ego actor, returned as a scalar. Units are in meters per second.
EgoLongitudinalSpeed	Longitudinal speed of the ego actor, returned as a scalar. Units are in meters per second.
EgoSpeed	Speed of the ego actor, returned as a scalar. Units are in meters per second.
EgoYaw	Yaw angle of the ego actor, returned as a scalar. Units are in radians.
EndRadius	Radius at the end of "Clothoid" trajectory creation, returned as a scalar. Units are in meters.
FinalAngle	Final angle of the "Clothoid" trajectory with respect to the ego vehicle direction before the turn, returned as a scalar. Units are in radians.
FinalEndRadius	Final radius at the end of "Clothoid" trajectory creation, returned as a scalar. Units are in meters.
FinalStartRadius	Final radius at the start of "Clothoid" trajectory creation, returned as a scalar. Units are in meters.
FollowingDistance	Distance between the primary target and the secondary target at the start of the simulation.
Headway	Distance between the ego and the primary actor at the start of simulation, returned as a scalar. Units are in meters.
ImpactOverlap	Collision overlap between the ego and the primary target, returned as a string scalar. For example: "50%".
InitialAngle	Initial angle of the "Clothoid" trajectory with respect to the ego vehicle direction before the turn, returned as a scalar. Units are in radians.
InitialEndRadius	Initial radius at the end of "Clothoid" trajectory creation, returned as a scalar. Units are in meters.
InitialStartRadius	Initial radius at the start of "Clothoid" trajectory creation, returned as a scalar. Units are in meters.
LaneChangeLength	Length of the lane change, returned as a scalar. Units are in meters.
LaneChangeOffset	Lateral distance traveled after performing a lane change, returned as a scalar. Units are in meters.
LateralAcceleration	Lateral acceleration while performing a lane change, returned as a scalar. Units are in meters per second-squared.
Lighting	Lighting status of the scene, returned as a string scalar, such as "Day", or "Night".
PrimaryTargetAcceleration	Acceleration of the primary target, returned as a scalar. Units are in meters per second-squared.
PrimaryTargetAccelerationDistance	Distance for which the primary target ramps up, returned as a scalar. Units are in meters.
PrimaryTargetDirection	Travel direction of the primary target, returned as one of these options: "Forward" — Primary target is heading along the direction of the lane. "Farside" — Primary target is heading towards the road that is farthest from the ego vehicle. "Nearside" — Primary target is heading towards the road that is nearest to the ego vehicle. "Same" — Primary target is heading along the same direction as the ego vehicle. "Opposite" — Primary target is heading opposite to the direction of the ego vehicle. "Nearside/Farside Perpendicular" — Primary target is moving perpendicular, from the nearside or farside, toward the ego vehicle. "Rear Farside" — Primary target is heading backward with respect to the lane direction, and far from the ego vehicle.
PrimaryTargetLongitudinalSpeed	Longitudinal speed of the primary target, returned as a scalar. Units are in meters per second.
PrimaryTargetSpeed	Speed of the primary target, returned as a scalar. Units are in meters per second.
StartRadius	Radius at the start of "Clothoid" trajectory creation, returned as a scalar. Units are in meters.
TTC	Time to collide, specified as a scalar. Units are in seconds.

Scene Specification Information

The SceneSpec structure contains these fields:

• RoadData — Road information, returned as a structure with these fields.

  Field Name	Description
  RoadType	Type of road, returned as a string scalar, such as "StraightRoad".
  RoadLength	Length of the road, returned as a scalar. Units are in meters.
  RoadHeadingAngle	Heading angle of the road, returned as a scalar. Units are in radians.

• LaneData — Lane information, returned as a structure with these fields.

  Field Name	Description
  LeftLaneCount	Number of left lanes in the road, returned as a scalar.
  RightLaneCount	Number of right lanes in the road, returned as a scalar.
  LaneMarkings	Types of lane markings, returned as a scalar or N+1-element string array. For a scalar, the returned LaneMarkings value applies to all lanes. For a string array, N is the number of total lanes. Lane marking values can be "Solid", "Dashed", or "Unmarked".
  LaneMarkingWidths	Lane marking width, returned as an N-element numeric row vector. N is the number of total lanes. Units are in meters.

• RoadWidth — Width of the road, returned as a scalar. Units are in meters.

Scenario Specification Information

The ScenarioSpec structure contains one or more of these fields based on the specified ncapTestName.

Field	Description
Collision	Collision information, returned as a structure containing these fields. EgoSurface — Colliding surface of the ego, returned as a string scalar, such as "Front", "Back", "Right", and "Left". EgoImpactLocation — Point of collision relative to the collision side of the ego vehicle, returned as a string scalar. For example: "50%". TTC — Time to collide, specified as a scalar. Units are in seconds. PrimaryTargetSurface — Colliding surface of the primary target, returned as a string scalar, such as "Front", "Back", "Right", and "Left". PrimaryTargetImpactLocation — Point of collision relative to the collision side of the primary target, in percentage, returned as a string scalar. For example: "60%". ImpactOverlap — Collision overlap between the ego vehicle and primary target, returned as a string scalar. For example: "50%".
d1	Lateral distance traveled during curve establishment while performing a lane change, returned as a scalar. Units are in meters. For more information, see Lane Drift Parameters.
d2	Lateral distance traveled after curve establishment, but before crossing the lane edge, while performing a lane change, returned as a scalar. Units are in meters. For more information, see Lane Drift Parameters.
EgoDirection	Travel direction of the ego actor, returned as one of these options: "Forward" — Ego vehicle moves along the direction of the lane. "Nearside Turn" — Ego vehicle performs a nearside turn. "Farside Turn" — Ego vehicle performs a farside turn. "Rearward" — Ego vehicle moves rearward.
EgoLateralDirection	Lateral direction of the ego actor, returned as one of these options: "Right" — Ego vehicle moves right. "Left" — Ego vehicle moves left.
EgoLateralSpeed	Lateral speed of the ego actor, returned as a scalar. Units are in meters per second.
EgoLongitudinalDirection	Longitudinal direction of the ego actor, returned as a string scalar. For example, if the ego vehicle moves forward along the lane direction: "Forward".
EgoLongitudinalSpeed	Longitudinal speed of the ego actor, returned as a scalar. Units are in meters per second.
EgoName	Name of the ego actor, returned as a string scalar, such as "VUT".
EgoRadius	Radius of the turn while the ego vehicle follows a nonlinear road, returned as a scalar. Units are in meters.
EgoSpeed	Speed of the ego actor, returned as a scalar. Units are in meters per second.
EgoTrajectoryParameters	Trajectory parameters of the ego, returned as an N-element structure array. N is the number of ego trajectories. Each structure contains these fields. Type — Type of trajectory, returned as a string scalar, such as "Clothoid", or "ConstandRadius". StartRadius — Radius at the start of trajectory creation, returned as a scalar. Units are in meters. EndRadius — Radius at the end of trajectory creation, returned as a scalar. Units are in meters. Angle — Angle of the trajectory with respect to the ego vehicle direction before the turn, returned as a scalar. Units are in radians.
EgoYaw	Yaw angle of the actor, returned as a scalar. Units are in radians.
Headway	Distance between the ego actor and primary actor at the start of the test, returned as a scalar. Units are in meters.
Lighting	Lighting status of the scene, returned as a string scalar, such as "Day", or "Night".
Obstruction	Obstruction information, returned as an N-element structure array. N is the number of obstructions. Each structure contains these fields. Y_Offset — Distance of the ego vehicle from its adjacent actor along the y-axis. X_Offset — Distance of the ego vehicle from its adjacent actor along the x-axis.
PrimaryTargetAcceleration	Acceleration of the primary target, returned as a scalar. Units are in meters per second-squared.
PrimaryTargetAccelerationDistance	Distance for which the primary target ramps up, returned as a scalar. Units are in meters.
PrimaryTargetActorInfo	Primary target actor information, returned as a structure. This structure is optional, and returned only when the scenario contains a pedestrian, motorcyclist, or a bicyclist as a primary target. The structure contains at least these fields: ActorType — Type of the actor, returned as a string scalar, containing names such as "Pedestrian", "MotorCyclist", and "Bicyclist". ActorFullName — Full name of the actor, returned as a string scalar. Dimensions — Dimensions of the actor, returned as a two-element row vector of the form [length width]. Units are in meters. ImpactPoints — Collision impact information of the primary actor, returned as a table. The ImpactSurface and ImpactLocation columns represent the primary actor surface and location along that surface which the ego vehicle collides, respectively.
PrimaryTargetCollisionDistance	Distance traveled by the primary target before collision, returned as a scalar. Units are in meters.
PrimaryTargetDirection	Travel direction of the primary target, returned as one of these options: "Forward" — Primary target is heading along the direction of the lane. "Farside" — Primary target is heading towards the road that is farthest from the ego vehicle. "Nearside" — Primary target is heading towards the road that is nearest to the ego vehicle. "Same" — Primary target is heading along the same direction as the ego vehicle. "Opposite" — Primary target is heading opposite to the direction of the ego vehicle. "Nearside/Farside Perpendicular" — Primary target is moving perpendicular, from the nearside or farside, toward the ego vehicle. "Rear Farside" — Primary target is heading backward with respect to the lane direction, and far from the ego vehicle.
PrimaryTargetName	Name of the primary target, returned as a string scalar, such as "EPTa", "EBT", "EMT", or "GVT".
PrimaryTargetOffset	Lateral distance of the primary target from the central lane boundary, returned as a scalar. Units are in meters.
PrimaryTargetSpeed	Speed of the primary target, returned as a scalar. Units are in meters per second.
PrimaryTargetSteadyStateDistance	Distance traveled by the primary target after ramp up and before collision, returned as a scalar. Units are in meters.
PrimaryTargetTrajectoryParameters	Trajectory parameters of the primary target, returned as a structure. The structure contains these fields. LaneChangeOffset — Lateral distance traveled after performing a lane change, returned as a scalar. Units are in meters. LaneChangeLength — Length of the lane change, returned as a scalar. Units are in meters. FollowingDistance — Distance between the primary target and the secondary target at the start of the simulation, returned as a scalar. Units are in meters. LateralAcceleration — Lateral acceleration with which the primary target ramps up, returned as a scalar. Units are in meters per second-squared.
SecondaryTargetDirection	Travel direction of the secondary target, returned as one of these options: "Forward" — Secondary target is heading along the direction of the lane. "Farside" — Secondary target is heading towards the road that is farthest from the ego vehicle. "Nearside" — Secondary target is heading towards the road that is nearest to the ego vehicle. "Same" — Secondary target is heading along the same direction as the ego vehicle. "Opposite" — Secondary target is heading opposite to the direction of the ego vehicle. "Nearside/Farside Perpendicular" — Secondary target is moving perpendicular, from the nearside or farside, toward the ego vehicle.
SecondaryTargetName	Name of the secondary target, returned as a string scalar, such as "SOV".
SecondaryTargetSpeed	Speed of the secondary target, returned as a scalar. Units are in meters per second.
SmallObstructionActorInfo	Small obstruction actor information, returned as a structure. For more information on obstruction dimensions, see page 53 of the Euro NCAP Test Protocol document. The structure contains these fields: ActorType — Type of the actor, returned as a string scalar, containing names such as "Car". ActorFullName — Full name of the actor, returned as a string scalar. Dimensions — Dimensions of the actor, returned as a two-element row vector of the form [length width height]. Units are in meters. ActorCategory — Category of the actor, returned as a string scalar, containing names such as "Small Family Car", and "Small Off-road 4x4". Color — Color of the actor, returned as a string scalar, containing names such as "Dark".
LargeObstructionActorInfo	Large obstruction actor information, returned as a structure. For more information on obstruction dimensions, see page 53 of the Euro NCAP Test Protocol document. The structure contains these fields: ActorType — Type of the actor, returned as a string scalar, containing names such as "Car". ActorFullName — Full name of the actor, returned as a string scalar. Dimensions — Dimensions of the actor, returned as a two-element row vector of the form [length width height]. Units are in meters. ActorCategory — Category of the actor, returned as a string scalar, containing names such as "Small Family Car", and "Small Off-road 4x4". Color — Color of the actor, returned as a string scalar, containing names such as "Dark".

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 R2024a

R2025a: Additional output fields of specInfo argument

The ncapSpec function now returns additional fields in the specInfo output structure:

• EvaluationCriterion

• ScoringCriterion

R2024b_plus: Renamed Euro NCAP Test Scenario Names

These Euro NCAP test scenarios are now renamed:

• "VRU AEB Lateral CM Oncoming" is now called "VRU LSS CM Oncoming vehicle"

• "VRU AEB Lateral CM Overtaking unintentional" is now called "VRU LSS CM Overtaking vehicle unintentional"

• "VRU AEB Lateral CM Overtaking intentional" is now called "VRU LSS CM Overtaking vehicle intentional"

R2024a_plus: Additional output fields of ncapTestSpec and specInfo arguments

The ncapSpec function now returns additional fields for these output arguments:

• ncapTestSpec — Returns the SeedScenarioIndex field, which contains the row index of the seed scenario specifications in the variationSpec output.

• specInfo — Returns the MetaData field, which contains metadata information of generated scenario variants.

R2024a_plus: Additional fields of variationSpec and scenarioSpec output tables

The variationSpec output table now returns these additional fields: Angle, EgoSpeed, EndRadius, FinalAngle, FinalEndRadius, FinalStartRadius, InitialAngle, InitialEndRadius, InitialStartRadius, and StartRadius.

The ScenarioSpec table of the ncapTestSpec output structure now returns these additional fields: PrimaryTargetActorInfo, SmallObstructionActorInfo, and LargeObstructionActorInfo. Previously, this information was in the specInfo output structure.