NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

AIM Template Manager Concept

Annotation Concept

Component

Item being annotated; for example, Tumor Location

Characteristic

Descriptive element of that item; for example, Site of Tumor Center

Allowed Term

Word that may be used to describe the descriptive element; for example, Frontal lobe

Info
titleSaving your changes

The AIM Template Manager automatically saves your work after each selection you make. An animated image appears to indicate when a save is occurring.

Creating a Template

To create a template

  1. Click the Templates tab.
  2. Below the left panel, click New template button. The new template window appears as shown below.
    "New template window with blank fields for name
  3. Enter a name for the template and optionally any of the other fields. Note that you cannot change the author at this point but you can do so by editing the template later.
  4. Click Done.
  5. Add one or more components to the template. Components can be of any of the AIM classes, which include anatomic entity, imaging observation, inference, and calculation.
  6. Add one or more characteristics to each template component you add, as applicable (Inference and Calculation components don't have associated characteristics).
  7. Specify the allowed terms for each component characteristiccharacteristic (for Anatomic Entity and Image Observation components) or component (for Inference and Calculation components).
    Tip
    titleExpanding and collapsing

    Below the Template Components panel, click downward-pointing arrow button to expand all of the template components to see their characteristics or click right-pointing arrow button to collapse the characteristics and just see a list of components. Within the template component row, click the same buttons to expand or collapse individual elements of the component.

...

  1. Select the template to which you want to add a component from the Template Name panel.
  2. From the buttons in the Template Components panel, click Create template component button. A new Template Components section of the panel appears.
    New Template Components section before any options have been selected.
  3. Customize your template component by selecting options from the items in the table below.

    Field

    Description

    Label

    Double-click this field to add a label. A label becomes a heading in the image annotation form that users complete once the template is imported into an imaging application. For example, "Lesion".

    Description

    Explanatory text about the component; for example, "Select the type of lesion".

    AIM Class

    Select an AIM class from the list. As the image below of the expanded list shows, AIM class options are Anatomic Entity, Imaging Observation, Inference, and Calculation.
    "AIM class drop-down list expanded to show all four options.

    Min

    The minimum number of times the template will allow users this select this term when they annotate an image.

    Max

    The maximum number of times the template will allow users to select this term when they annotate an image.

    Display

    Select this box to display this component in the template.

    Confidence

    Specify the confidence interval for the value users will enter for this component. Expected values are 0 through 100.

    Authors

    The AIM Template Manager user who created this component.

    Tip
    titleSaving your work

    Each time you enter a value into a field or make a selection, The AIM Template Manager automatically saves your work after each selection you make. An animated image appears to indicate when a save is occurring.

  4. If the component is an Anatomic Entity or Imaging Observation, add a characteristic to the component. If the component is a Calculation, add the specified information about it (Description, MathML, Algorithm Name, and Algorithm Version).
  5. Specify the characteristic's allowed terms.

...

To add a characteristic to a component

  1. Create a component of the Anatomic Entity or Imaging Observation AIM class.
  2. Specify information describing the characteristic, as follows.

    Field

    Description

    Label

    Double-click this field to add a label. A label becomes a heading in the image annotation form that users complete once the template is imported into an imaging application.

    Description

    An optional description of the characteristic.

    Min

    The minimum number of times the template will allow users this select this term when they annotate an image.

    Max

    The maximum number of times the template will allow users to select this term when they annotate an image.

    Display

    Select this box to display this component in the template.

    Confidence

    Specify the confidence interval for the value users will enter for this characteristic. Expected values are 0 through 100.

    Authors

    The AIM Template Manager user who created this characteristic.

  3. Add allowed terms. You can add them manually in this field or select them from a lexicon you have created.
    • To add an allowed term manually, specify information about it into the relevant fields on the page, which are described below.

      Field

      Description

      Term

       

      Code

       

      Source

       

      Ask if Present

       

...

To specify a characteristic's allowed terms

...

  1. Add a characteristic to the component. Below the characteristic, one Allowed Terms entry row appears. If you are adding additional allowed terms, click small add button next to Allowed Terms entry row. to add another row.
  2. Double-click in the Term (code meaning) field. Enter an allowed term. If you want to use an entry in a lexicon, find it in the Search Lexicon Terms panel on the right, then click the Add allowed term to characteristic button button below the Search Lexicon Terms panel.
    Info
    titleShowing and hiding panels

    If you cannot scroll any further to the right to see all of the fields of an allowed term, you can hide the Search Lexicon Terms panel. Likewise, you can show a hidden panel. Each panel in the AIM Template Manager has a small arrow in the middle of it, shown below, that you can click to show or hide it.
    Arrow between each panel that you can click to open or close it.

...