NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 41 Next »

This guide explains how to use the caBIG® Annotation and Image Markup (AIM) Template Manager for AIM Information Model Version 3.0. The intended audience for this guide is a biomedical researcher familiar with the AIM information model.

Topics in this guide include:

To Print the Guide

You can create a PDF of the guide. For instructions refer to the tip How do I print multiple pages?. If you want to print a single page, refer to How do I print a page?.

Getting Started with the AIM Template Manager

The AIM Template Manager allows you to generate a set of well-defined questions and answer choices to facilitate collecting information for a particular purpose, such as a The Cancer Genome Atlas Glioblastoma (TCGA GBM) study. These questions and answers are contained in an AIM XML template file that you can import into an AIM-enabled application. Aided by the information in the XML file, users of the AIM-enabled application can then annotate medical images using a controlled vocabulary and standard template. This results in simple and constrained annotations that are reproducible and consistent. Finally, the AIM-enabled application captures answers and then exports them as an AIM XML document or AIM DICOM SR, which can be sent to the AIM Data Service or DICOM store SCP, respectively.

You use the AIM Template Manager to design templates based on a lexicon of standard and user-definable terms. You can then collect multiple templates into template groups. You complete the process by downloading a template group as an XML file to your local computer.

Why Use the AIM Model?

Imaging reports contain both graphical drawings and medical knowledge in the form of annotations. These annotations are stored as unstructured text and separated from graphical drawings, which are typically in a proprietary format on an imaging system. Extracting this valuable medical information and combining them with drawings on another system is time-consuming and cumbersome to filter and search.

AIM begins to solve this problem by capturing the descriptive information of an image with user-generated graphical symbols placed on the image into a single common information source. AIM captures medical findings using standard vocabularies such as RadLex, SNOMED CT, DICOM, and user-defined terminology. Image information captured in the AIM model includes the anatomic entity and its characteristics, imaging observation and its characteristics, and inference. However, existing vocabularies used to describe medical images contain thousands of terms that make it difficult for users to find and then include them in their AIM annotations.

What is in an AIM Template?

An AIM template consists of a set of related questions for a study. It captures the name, version, description, UID, controlled term applied to the template, authors, and creation date of a template. It also has one or more components. Each component represents a study question that may have one or more answers. Components can be any of the following: anatomic entity, imaging observation, inference, and calculation.

Both anatomic entities and imaging observations are also described by their associated characteristics. Anatomic entity and imaging observation characteristics inherit the attributes of their respective component. Characteristics have annotator confidence that allows a user to enter a level of user’s confidence answering the question in terms of a percentage. A characteristic may also have a quantification value.

Working with Template Groups

Adding a Template Group

To add a template group

  1. Click the Template Groups tab.
  2. Below the left panel, click New template group button. The new template group window appears as shown below.
    "New template group window with no values entered yet. Contains editable Name
  3. Enter the name of the new group and optionally a version number and description in the boxes provided. The author and creation date fields are pre-populated. You can edit the author by completing this procedure and then editing the template group.
  4. Click Done. The new template group appears in the Group Name panel.

Deleting a Template Group

To edit a template group

  1. Click the Template Groups tab.
  2. Below the left panel, click Delete template group button. You are asked to confirm the deletion.
    Window that says "Are you sure you want to delete this AIM Template Group?".
  3. Click Delete to proceed with the deletion.

Editing a Template Group

To edit a template group

  1. Click the Template Groups tab.
  2. Below the left panel, click New template group button. The selected template group's description appears as shown in the example below.
    Template group window showing the current values for the example Vasari template.
  3. Change the name of the new group, version, and description as needed. Note that you can change the author.
  4. Click Done. The new template group appears in the Group Name panel.

Copying a Template Group

To copy a template group

  1. Click the Template Groups tab.
  2. Select a template group from the Group Name panel.
  3. Below the left panel, click Copy template group button. A copy of the template you selected is created with the name of Current Template Name copy and is listed in the Group Name panel.

Uploading a Template Group

To upload a template group

  1. Click the Template Groups tab.
  2. Select a template group from the Group Name panel.
  3. Below the left panel, click Upload template group button. The upload window appears, as shown below.
    Small window containing a browse button and and upload button.
  4. Click Browse to navigate to a location on your home drive where the XML file is that you want to upload. This file must have been downloaded from the AIM Template Manager.
  5. Click Upload. The template group appears in the Group Name panel.

Downloading a Template Group

To download a template group

  1. Click the Template Groups tab.
  2. Select a template group from the Group Name panel.
  3. Below the left panel, click Download template group button. You are prompted to save the XML file on your hard drive. The example below shows that Firefox prompts you to save it to your hard drive as an archive file.
    Firefox dialog box prompting you to save the file to a location you select on your hard drive.
  4. Save the file or open it to verify the contents.

Adding a Template to a Template Group

Removing a Template from a Template Group

Working with Templates

Creating a Template

Editing a Template

Deleting a Template

Building a Lexicon

  • No labels