Contents

• Introduction
• System Requirements
• Installation
• Running ICSGenerator
• ICSGenerator User's Guide
• Feedback

Thank you for downloading Version 2.1 of the ICSGenerator!

ICSGenerator is a tool that enables a user to define details of a specific medical device's data information model and also capture IEEE 11073 implementation conformance information as required in the ISO/IEEE 11073-10201 Data Information Model specification.

ICSGenerator 2.1 has been tested to work on the following platforms:

• Windows XP
• Windows 2000

ICSGenerator 2.1 uses Java and XML Technologies. The following software is required:

• Java 2 SDK (Version 1.5)
• Xerces (Version 2_8_0)

1. (Recommended) Download the executable Jar File "ICSGenerator-2.1.jar" from the website (http://www.nist.gov/medicaldevices).
   Open (e.g., double click) the file to execute, and follow the self-explanatory installation instructions. Or
   
2. Download ICSGenerator-2.1.ZIP file and follow instructions below.

First unzip the ICSGENERATOR-2.1.ZIP file to create the following directories and files:

• c:/ICS/src - top level directory for the source code
• c:/ICS/src/comparingDevices - contains the java source code for comparing two devices
• c:/ICS/src/drawing - contains the java source code for creating a UML diagram of a device
• c:/ICS/src/icsDyn - contains the java source code for creating an ICS for a device
• c:/ICS/src/icsTables - contains the java source code for creating html tables listing attributes, behaviors and notifications for a device
• c:/ICS/src/modifyIcs - contains the java source code for creating an ICS for the Service Model
• c:/ICS/src/units - contains the java source for processing units of measurement
• c:/ICS/src/transport - contains the java source for generating a Transport ICS
• c:/ICS/src/pdfReport - contains the java source for generating ICS reports in PDF format
• c:/ICS/jar - contains the jar files necessary for ICSGenerator
• c:/ICS/xml - contains the xml files used by ICSGenerator. The default ICS XML File ICS-Tool.xml (an XML representation of the data model as specified in the IEEE 11073 DIM Document) resides in this directory.
• c:/ICS/xsd - directory that contains schema files for DIM MOC ICS, General ICS, Service Support ICS and Transport ICS
• c:/ICS/XSLT - directory that contains the transformation executed by ICSGenerator.
• c:/ICS/Readme_2.1.html - this file.
• c:/ICS/img - contains logo files for tool.

• cd C:/ICS/src
• CLASSPATH = .;c:/xerces-2_8_0/xercesImpl.jar;c:/xerces-2_8_0/xml-apis.jar;c:/ICS/jar/jama.jar; c:/ICS/jar/itext-1.4.3.jar;c:/ICS/jar/AsnLib.jar;c:/ICS/jar/Asn1Lib.jar; c:/ICS/jar/DimLib.jar;c:/ICS/jar/MderLib.jar

• javac icsDyn/*.java
• java icsDyn/ManagementView

Once the installation is complete, double click the ICSGenerator icon to start the tool.

The ICSGenerator interface will appear in a pop up screen.

The ICSGenerator main screen has six tabs across the top of the interface that allow the user to create/modify a DIM ICS, General ICS, Service Support ICS and Transport ICS. The remaining two tabs allow the user to create a UML diagram of the DIM ICS and compare devices DIM ICS's to see what they have in common as well as the differences in the two devices. For a detailed description of the ICSGenerator Tool refer to the ICSGenerator User's Guide.

• DIM ICS
• General ICS
• Service Support ICS
• Transport ICS
• UML Diagram
• Compare Devices

Click on the DIM ICS tab

The tool's ICS generation process is driven by an input XML file containing the data information model. The default file is a complete representation of the data information model as prescribed in the IEEE 11073 DIM specification. To initiate the process, select the XML file (data information model) you want to use as the initial model to specify your implementation conformance statements and support information.

The generation process is driven by the type of Medical Device System (MDS) selected by the user. The current version of ICSGenerator tool supports Hydra and Simple MDS.

At the top of the panel a user may select:
"New" to start the process with the default instance of the data information model. This option is usually selected the first time you use the tool.
Or
"Reload" to start the process with a previous created version of the file.

Select the MDS type to use:

"Simple" to represent a medical device that contains a single Virtual Medical Device (VMD) instance only (single purpose device).
Or
"Hydra" to represent a device that contains multiple VMD instances (multi-purpose device).
Or
"Composite Single Bed" to represent a device that contains or interfaces with one or more Simple or Hydra MDS objects at one location.

Once you have selected the MDS type, a JTree representation of the loaded XML file should appears the left side of the screen. Users can now select any of the Managed Object Classes (MOC) to see information such as Object Class, Object Name, Attributes, etc.

There are also five buttons located below the JTree to perform MOC functionality:

"Add MOC" to add a new Managed Object Class (MOC) to the tree
"Remove MOC" to remove MOC's from the tree
"Update Attributes..."to update the attributes for the selected MOC
"Update Behaviors...."to update the behaviors for the selected MOC
"Update Notifications..."to update the notifications for the selected MOC

As you add or remove selected MOC's the JTree changes to reflect the additions or removals of MOC's.

You can also add a label, Application Guidance, restrictions, etc... for a MOC by typing data into the respective boxes and clicking on "Add Changes".

You can generate the ICSTables for General ICS, Service Support ICS, DIM MOC ICS, Attribute ICS, Behavior ICS and Notification ICS by clicking on the View button.

Once you are done modifying the tree you can generate an XML representation of the JTree by clicking on the "Generate" button located near the bottom of the interface. The resultant XML code appears at the bottom of the screen. You save the file by clicking on the "Export XML File" button and following the prompts.

ICSGenerator has the capability of mapping device attributes to observation segments in HL7 messaging format. To create OBR and OBX segments click on the Map XML File to HL7 button. This file can then be saved by clicking on the Export HL7 XML File button.

Click on the General ICS tab located at the top of the interface.

The functionality is driven by an input XML file used to create a General ICS. The default file is a representation of the complete General ICS data model as prescribed in the IEEE 11073 DIM specification. To initiate the process select the XML file you want to use as the initial model to specify your implementation conformance statements and support information.

At the top of the panel select:
"New" to start the process with the default instance of the General ICS model. This option is usually selected the first time you use the tool.
Or
"Reload" to start the process with a previously created General ICS.

You can modify the Support and/or Comment field for an Index by clicking on the respective boxes and typing your Support and/or Comment text and clicking on the "Add Changes"button.

Once you are done modifying the General ICS you can generate an XML representation by clicking on the "Generate XML File" button. The XML will appear at the bottom of the screen. You can also save the file by clicking on the "Export XML File..." button and follow the prompts.

Click on the Service Support ICS tab located at the top of the interface.

The Service Support ICS process is driven by an input service support XML file. The default file is a complete representation of the Service Support ICS data model as prescribed in the IEEE 11073 DIM specification. To initiate the process select the XML file you want to use as the initial model to specify your implementation conformance statements and support information.

At the top of the panel select:
"New" to start the process with the default instance of the Service Support ICS model. This option is usually selected the first time you use the tool.
Or
"Reload" to start the process with a previously saved Service Support ICS.

You can modify the Support and/or Comment field for an Index by clicking on the respective boxes and by checking the Support column and/or typing text in the Comment field and click on the "Add Changes".

Once you are done modifying the Service Support ICS you can generate an XML representation of the Service Support ICS by clicking on the "Generate XML File" button. The XML will appear at the bottom of the screen. You can also save the file by clicking on the "Export XML File..." button and follow the prompts..

Click on the Transport ICS tab located at the top of the interface.

The Transport ICS process is driven by an input transport XML file. The default file is a complete representation of the General ICS data model as prescribed in the IEEE 11073 DIM specification. To initiate the process select the XML file you want to use as the initial model to specify your implementation conformance statements and support information.

At the top of the panel select:
"New" to start the process with the default instance of the Transport ICS model. This option is selected the first time you use the tool.
Or
"Reload" to start the process with a previously created Transport ICS.

Click on the IRDA-based Cable-Connected radio button

Select one of the following radio buttons: IrLAPICS, TinyTPICS, IrLMPICS

You can modify the Supported field for a funtion by clicking on the respective boxes and clicking on the "Add Changes"button.

Once you are done modifying the Transport ICS you can generate an XML representation of the Transport ICS by clicking on the "Generate XML File" button. The XML will appear at the bottom of the screen. Save the file by clicking on the "Export XML File..." button and follow the prompts.

After a DIM ICS is created or reloaded, click on the UML Diagram tab located at the top of the interface.

Click on the "Select a root:" drop down menu tab and pick a node as a starting point for the UML diagram.

Click on the"Draw UML Diagram"button and a UML diagram will appear starting with the root element selected.

The user can save the UML diagram by clicking on the "Export Image..."button

Click on the Compare Devices tab

Click on the "Add a device"button.

Click on the"Browser.."button and select your first file for comparison.

Click on the "Add a device"button.

Click on the"Browser.."button and select your second file for comparison.

Click on the "Compare Devices"button.

A comparison of the devices appears in the bottom portion of the screen. To see what attributes, behaviors and notifications the two devices have in common right click on the MOC. Select one of the following from the drop down list (Attributes, Behaviors, or Notifications). Note: two or more devices can be compared. Click on the "Add a device"button to add additional devices for comparison.

Save the device comparison file by clicking on the "Export comparison report..."button and follow the prompts.

Users can click on the Project tab in the upper lefthand corner of the tool and a drop down menu of choices are available. Start a new ICS by selecting New, quit the application by selecting Quit, create and export ICS reports by selecting Export PDF Report or get version and contact information by selecting About ICSGenerator.

Please click here for or a detailed description of the ICSGenerator Tool's User Guide.

Comments and recommendations for enhancements are welcome and may be sent directly to: or Sandra I. Martinez. or John J. Garguilo