62. Edit a VPlan

You can only edit the VPlans that you have created, not VPlans created by other project team members.

You can add sections to the VPlan that group similar entities together. For example, you might want to separate out the global metrics from metrics collected by scenarios that test AV or ADAS functions.

Within the global metrics section, you can separate metrics collected during sut.car.drive(), such as distance traveled, from other data, such as the map used during the run, the SUT version and so on.

To edit a VPlan:

1. Edit a VPlan doing one of the following:

   • Click the hamburger icon at the top of the window, and then click VPlans.

   • In a workspace, click the down arrow on the VPlan tab and select the Edit VPlan from the VPlan options.

2. Perform any of the following actions:

   • Provide permissions in VPlan
   • Add a new section.
   • Add a section that references another section.
   • Add metric items by name or by dragging and dropping.
   • Modify section attributes.
   • Create custom VPlan attributes
   • Manage VPlans.

3. Click Save.

62.1 Rearrange existing sections or metric items

To rearrange sections or metric items, press the Alt key and drag and drop any section or metric item in the VPlan into a new position.

62.2 Add a new section

There are two types of sections:

• Generic sections
• Checker sections

Generic sections are marked with a folder icon, while checker sections are marked with a check icon.

There are no metric items associated with checkers. However, in order to make the VPlan complete, you can note where checkers are defined by creating a checker section and adding to that section any checkers, such as those defined with collect().

To add a new section:

1. Click the Add item or section (+) icon next to an existing section and select the type of section you want to create.

2. When the new section appears, type in a name.

62.3 Add a section that references another section

In complex VPlans, you might need to include the same section in multiple places of the same VPlan. For example, you might want to analyze aspects of the cut in and slow() scenario in various contexts, such as in a complete list of scenarios and in a list of AEB scenarios.

Copying a section and pasting it in a different location requires manual updates in multiple locations if changes occur. To avoid this, you can copy a section as a reference. Any changes made in a referenced section automatically appear in all referencing sections.

You can use this same feature to include a section, even an entire VPlan, within a different VPlan.

62.3.1 Copy a section as a reference

1. Hover the cursor over the section node and click the Copy As Reference icon.

2. Select the target section in the current VPlan or in a different VPlan, and click the Paste icon.

62.3.2 Navigate to a referenced section

Hover over a section copied by reference and click the Show Referenced Section icon.

Focus will shift to the referenced section. If the source is in a different VPlan, it opens in a new tab with the references section highlighted.

62.4 Add metric items

Click the Filter icon at the top right of the Metrics model pane to filter metric items by:

• Mapping: Displays items that are already mapped to the VPlan or not.
• Metrics Type: Displays coverage items or record/KPI items.

62.4.1 Add metric items by typing names

1. Click the Add Item or Section (+) icon of the section and choose Add Child Item, or click it on an item and choose Add Sibling Item.

2. Type in a regular expression that matches the names of the items you want to add.

   You can use the * wildcard.
   For example sut.sut_at_highway_exit.end.* refers to all metric items sampled at the end event of the sut.sut_at_highway_exit() scenario.

62.4.2 Add metric items from the metrics model

Select a metric item in the Metrics model and drag it into the appropriate VPlan section.