ncapSpec

Obtain Euro NCAP test specifications

Since R2024a

collapse all in page

Syntax

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

Description

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

[variationSpec,ncapTestSpec,specInfo] = ncapSpec(ncapTestName) returns European New Car Assessment Programme (Euro NCAP®) test specifications for an input Euro NCAP test name, ncapTestName.

example

[variationSpec,ncapTestSpec,specInfo] = ncapSpec(euroAssessmentObj,ncapTestName) returns Euro NCAP test specifications for an input Euro NCAP test name, ncapTestName, using the Euro NCAP assessment protocol specifications euroAssessmentObj. (since R2026a)

example

Examples

collapse all

This example uses:

Open Live Script

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
     2.7778      "Day"
     4.1667      "Day"
     5.5556      "Day"
     6.9444      "Day"
     8.3333      "Day"
     9.7222      "Day"
    11.1111      "Day"
    12.5000      "Day"
    13.8889      "Day"
    15.2778      "Day"
    16.6667      "Day"
     2.7778    "Night"
     4.1667    "Night"
     5.5556    "Night"
      ⋮


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

Since R2026a

This example uses:

Open Live Script

Specify a European New Car Assessment Programme (Euro NCAP) test name from protocol specification years 2026–2028.

ncapTestName = "CA FC CCRs";

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

euroAssessmentObj = euroAssessment(2026);

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

[variationSpec,ncapTestSpec] = ncapSpec(euroAssessmentObj,ncapTestName)
variationSpec=56×2 table
    2.7778    "125%"
    2.7778    "100%"
    2.7778     "75%"
    2.7778     "50%"
    2.7778     "25%"
    2.7778      "0%"
    2.7778    "-25%"
    5.5556    "125%"
    5.5556    "100%"
    5.5556     "75%"
    5.5556     "50%"
    5.5556     "25%"
    5.5556      "0%"
    5.5556    "-25%"
      ⋮


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

Input Arguments

collapse all

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

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

Since R2026a

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

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.

  • 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

collapse all

References

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

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

Version History

Introduced in R2024a

expand all

See Also

| | |