Main Content

ncapSpec

Generate Euro NCAP test specifications

Since R2024a

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.

example

Examples

collapse all

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

collapse all

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

Output Arguments

collapse all

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.

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 11th row in the variationSpec table represents the seed scenario specifications.

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.

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 location in the Euro NCAP test protocol document.

Car-to-Car Collision Scenarios

ncapTestNameEuro NCAP Test Scenario Full NameDescriptionEuro NCAP Test Protocol Document
"SA AEB CCRs"

Safety Assist Automatic Emergency Braking 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 Euro NCAP Test Protocol document.
"SA AEB CCRm"

Safety Assist Automatic Emergency Braking 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 Euro NCAP Test Protocol document.
"SA AEB CCRb"

Safety Assist Automatic Emergency Braking Car-to-Car Rear braking

The ego vehicle moves forward toward a target vehicle traveling at a constant speed, collides, and 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 Euro NCAP Test Protocol document.
"SA AEB CCFtap"

Safety Assist Automatic Emergency Braking 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 Euro NCAP Test Protocol document.
"SA AEB CCCscp"

Safety Assist Automatic Emergency Braking 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 Euro NCAP Test Protocol document.
"SA AEB CCFhos"

Safety Assist Automatic Emergency Braking Car-to-Car Front head-on straight

The ego and target vehicles move toward each other on a same lane, resulting in a head-on collision.

For more information on this test, see page 22 of the Euro NCAP Test Protocol document.
"SA AEB CCFhol"

Safety Assist Automatic Emergency Braking Car-to-Car Front head-on lane change

The ego and target vehicles move toward each other, each traveling on 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 Euro NCAP Test Protocol document.

Car-to-Pedestrian Collision Scenarios

ncapTestNameEuro NCAP Test Scenario Full NameDescriptionEuro NCAP Test Protocol Document
"VRU AEB Crossing CPFA"

Vulnerable Road User Automatic Emergency Braking Crossing 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 Euro NCAP Test Protocol document.
"VRU AEB Crossing CPNA"

Vulnerable Road User Automatic Emergency Braking Crossing 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 Euro NCAP Test Protocol document.
"VRU AEB Crossing CPNCO"

Vulnerable Road User Automatic Emergency Braking Crossing Car-to-Pedestrian Nearside Child Obstructed

The ego vehicle moves forward toward an 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 Euro NCAP Test Protocol document.
"VRU AEB Longitudinal CPLA"

Vulnerable Road User Automatic Emergency Braking Longitudinal Car-to-Pedestrian Longitudinal Adult

The ego vehicle moves forward toward an adult pedestrian walking in front, 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 Euro NCAP Test Protocol document.
"VRU AEB Turning CPTAns"

Vulnerable Road User Automatic Emergency Braking Turning Car-to-Pedestrian Turning Adult nearside same

The ego vehicle moves forward toward an adult pedestrian crossing its path, starting in the same direction, walking across a 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 Euro NCAP Test Protocol document.
"VRU AEB Turning CPTAno"

Vulnerable Road User Automatic Emergency Braking Car-to-Pedestrian Turning Adult nearside opposite

The ego vehicle moves forward toward an adult pedestrian crossing its path, starting in the opposite direction, walking across a 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 Euro NCAP Test Protocol document.
"VRU AEB Turning CPTAfs"

Vulnerable Road User Automatic Emergency Braking Turning Car-to-Pedestrian Turning Adult farside same

The ego vehicle moves forward toward an adult pedestrian crossing its path, starting in the same direction, walking across a 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 Euro NCAP Test Protocol document.
"VRU AEB Turning CPTAfo"

Vulnerable Road User Automatic Emergency Braking Turning Car-to-Pedestrian Turning Adult farside opposite

The ego vehicle moves forward toward an adult pedestrian crossing its path, in the opposite direction, walking across a 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 Euro NCAP Test Protocol document.
"VRU AEB Reverse CPRs"

Vulnerable Road User Automatic Emergency Braking Reverse Car-to-Pedestrian Reverse 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 Euro NCAP Test Protocol document.
"VRU AEB Reverse CPRm"

Vulnerable Road User Automatic Emergency Braking Reverse Car-to-Pedestrian Reverse 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 Euro NCAP Test Protocol document.

Car-to-Motorcyclist Collision Scenarios

ncapTestNameEuro NCAP Test Scenario Full NameDescriptionEuro NCAP Test Protocol Document
"VRU AEB Longitudinal CMRs"

Vulnerable Road User Automatic Emergency Braking Longitudinal Car-to-Motorcyclist Reverse stationary

The ego vehicle moves forward toward a motorcyclist in front, traveling in the same direction. It results 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 Euro NCAP Test Protocol document.
"VRU AEB Longitudinal CMRb"

Vulnerable Road User Automatic Emergency Braking Longitudinal Car-to-Motorcyclist Reverse 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 Euro NCAP Test Protocol document.
"VRU AEB Turning CMFtap"

Vulnerable Road User Automatic Emergency Braking Turning 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 Euro NCAP Test Protocol document.
"VRU AEB Lateral CM Oncoming"

Vulnerable Road User Automatic Emergency Braking Lateral 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 Euro NCAP Test Protocol document.
"VRU AEB Lateral CM Overtaking unintentional"

Vulnerable Road User Automatic Emergency Braking Lateral Car-to-Motorcyclist Overtaking unintentional

The ego vehicle unintentionally overtakes a motorcyclist traveling in the same direction on a lane adjacent to the driver side of the ego vehicle.

For more information on this test, see page 41 of the Euro NCAP Test Protocol document.
"VRU AEB Lateral CM Overtaking intentional"

Vulnerable Road User Automatic Emergency Braking Lateral Car-to-Motorcyclist Overtaking intentional

The ego vehicle intentionally overtakes a motorcyclist traveling in the same direction on a lane adjacent to the driver side of the ego vehicle.

For more information on this test, see page 41 of the Euro NCAP Test Protocol document.

Car-to-Bicyclist Collision Scenarios

ncapTestNameEuro NCAP Test Scenario Full NameDescriptionEuro NCAP Test Protocol Document
"VRU AEB Crossing CBFA"

Vulnerable Road User Automatic Emergency Braking Crossing 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 Euro NCAP Test Protocol document.
"VRU AEB Crossing CBNA"

Vulnerable Road User Automatic Emergency Braking Crossing 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 Euro NCAP Test Protocol document.
"VRU AEB Crossing CBNAO"

Vulnerable Road User Automatic Emergency Braking Crossing 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 Euro NCAP Test Protocol document.
"VRU AEB Longitudinal CBLA"

Vulnerable Road User Automatic Emergency Braking Longitudinal 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 and the bicyclist.

For more information on this test, see page 32 of the Euro NCAP Test Protocol document.
"VRU AEB Turning CBTAn"

Vulnerable Road User Automatic Emergency Braking Turning 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 and the bicyclist.

For more information on this test, see page 33 of the Euro NCAP Test Protocol document.
"VRU AEB Turning CBTAf"

Vulnerable Road User Automatic Emergency Braking Turning 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 Euro NCAP Test Protocol document.

Lane Support System Scenarios

ncapTestNameEuro NCAP Test Scenario Full NameDescriptionEuro NCAP Test Protocol Document
"SA LSS LKA Solid Line"

Safety Assist Lane Support System 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 Euro NCAP Test Protocol document.
"SA LSS LKA Dashed Line"

Safety Assist Lane Support System 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 Euro NCAP Test Protocol document.
"SA LSS ELK Solid Line"

Safety Assist Lane Support System 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 Euro NCAP Test Protocol document.
"SA LSS ELK Road Edge"

Safety Assist Lane Support System 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 Euro NCAP Test Protocol document.
"SA LSS ELK Oncoming vehicle"

Safety Assist Lane Support System Emergency Lane Keeping Oncoming vehicle

The ego vehicle drifts towards an oncoming target into the adjacent lane.

For more information on this test, see page 15 of the Euro NCAP Test Protocol document.
"SA LSS ELK Overtaking vehicle intentional"

Safety Assist Lane Support System Emergency Lane Keeping Overtaking vehicle intentional

The ego vehicle intentionally overtakes a target traveling in the same direction on a lane adjacent to the driver side of the ego vehicle.

For more information on this test, see page 16 of the Euro NCAP Test Protocol document.
"SA LSS ELK Overtaking vehicle unintentional"

Safety Assist Lane Support System Emergency Lane Keeping Overtaking vehicle unintentional

The ego vehicle unintentionally overtakes a target vehicle traveling in the same direction on a lane adjacent to the driver side of the ego vehicle.

For more information on this test, see page 16 of the Euro NCAP Test Protocol document.

Variation Parameter Information

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

ColumnDescription
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 NameDescription
    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 NameDescription
    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.

FieldDescription
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".

Version History

Introduced in R2024a

expand all