Session 2.1: Annotations

Note: This training deck is primarily composed of instructional screenshots (numbered dialog boxes, toolbar callouts, field highlights). The text below preserves all extractable slide text — titles, bullet points, discussion/exercise headings, and table content. Where a slide is dominated by an unlabeled screenshot, only the caption and step-list text could be extracted; screenshot visual detail itself is not represented.

Session 2.1: Annotations

SESSION 2.1 OUTLINE

2.1.1: Annotations 2.1.2: Dashboard 2.1.3: Model Parameters 2.1.4: Narratives 2.1.5: Assumptions 2.1.6: Comments 2.1.7: Annotations Report

---

Session 2.1: Annotations

DISCUSSION 2.1.1 ANNOTATIONS

What is Annotations?

Annotations track actions conducted in MADE. Any assumptions in modelling the system can be captured and associated with the model item. Historical events and knowledge about the system can be documented.

   E.g. If green smoke and high temperature are observed, inspect the pipe from the condenser

---

Session 2.1: Annotations

EXERCISE 2.1.1 ANNOTATIONS

To open the Annotations Editor:

Method 1: Select Modeling Annotations from the main menu Method 2: Double-click Annotations icon in bottom left corner of MADE

---

Session 2.1: Annotations

DISCUSSION 2.1.2 DASHBOARD

The Dashboard shows the following metrics:

Analysis Quality Index: Coverage, Quality and resulting Confidence level of the model output Data sources: Visual breakdown of the types of data sources Recent Events: Changes to parameters in a model that are tracked

---

Session 2.1: Annotations

DISCUSSION 2.1.3 MODEL PARAMETERS

Used to annotate any changes in the model Can also be used to search for annotations and filter by various properties

---

Session 2.1: Annotations

EXERCISE 2.1.3 MODEL PARAMETERS

To search and annotate an action to a model parameter:

   Select the Model Parameters tab
   Enter Mission Profile into the Item/Event Description search box
   Find the event Mission Profile Name Changed

---

Session 2.1: Annotations

EXERCISE 2.1.3 MODEL PARAMETERS (CONTINUED)

   Double-click on the Mission Profile Name Changed annotation event in the table

          This opens the Annotation Details editor

   Select Engineer from the Information Source drop down menu
   Enter the following narrative: Mock Mission Profile scenario provided for training purposes.
   Select

---

Session 2.1: Annotations

EXERCISE 2.1.3 MODEL PARAMETERS (CONTINUED)

To annotate multiple model parameters:

   Type Item into the Item/Event Description field
   Left-click the top result then shift-click the bottom result
   Right-click a highlighted change
   Select
   Select the source as: OEM
   Enter the source as: From OEM schematics.
   Select

---

Session 2.1: Annotations

DISCUSSION 2.1.4 NARRATIVES

Used to add additional information to the model e.g. Functional Narrative

---

Session 2.1: Annotations

EXERCISE 2.1.4 NARRATIVES

To enter a new narrative:

  Select to open the Narrative Types editor
  Ensure all narratives are selected, then select
  Enter into the Item Name/Narrative Text search box: Fuel Tank
  Double-click the Fuel Tank with the Category Item to open the

     Edit Narrative Text editor
  Enter the following text: Modeled as a tank that contains return

                                   fuel and supplies fuel for operation.
  Select

---

Session 2.1: Annotations

DISCUSSION 2.1.5 ASSUMPTIONS

Used to capture any assumptions or constraints of the model Can be used to document modeling decisions

---

Session 2.1: Annotations

EXERCISE 2.1.5 ASSUMPTIONS

To enter a new assumption:

  Select the button to the left of the table to open the Add New
    Assumptions editor

  Expand the Item Type tree to MADE Training  Vehicle System
  Select the Vehicle System
  Enter the narrative: Only select subsystems have been modeled

                             for this concept system to reduce modeling
                             time for MADE training.
  Select

---

Session 2.1: Annotations

DISCUSSION 2.1.5 COMMENTS

Used to pass general information to other modellers/users Used as notes/reminders for the modeling tasks

---

Session 2.1: Annotations

EXERCISE 2.1.5 COMMENTS

To add comments:

  Select the button to the left of the table to open the Add New
    Comment editor

  Expand the Item Type tree to MADE Training  Vehicle System
    System Model

  Select the System Model
  Enter the narrative: The simulation parameters are not added to the

                             model, they will be added in training session 2.2.
  Select

---

Session 2.1: Annotations

DISCUSSION 2.1.6 EVENT LOG

Lists all annotation actions based on a date range

---

Session 2.1: Annotations

DISCUSSION 2.1.7 ANNOTATIONS REPORT

Summarises annotations by item, type, status and source Displays information from:

   Dashboard
   Model Parameters Table

---

Session 2.1: Annotations

EXERCISE 2.1.7 ANNOTATIONS REPORT

To generate an Annotations report:

Select Reports Report Wizard from the main menu

Under Data Quality Analysis select Annotation Report

Select to proceed to item selection page

Select `Vehicle System' item

Select to set report formatting

Select to run report

---

Session 2.1: Annotations

SESSION 2.1 SUMMARY

2.1.1: Annotations 2.1.2: Dashboard 2.1.3: Model Parameters 2.1.4: Narratives 2.1.5: Assumptions 2.1.6: Comments 2.1.7: Annotations Report