Topics in this guide include:
The AIM project was conceived and developed by imaging workspace subject matter experts at NCI's cancer Biomedical Informatics Grid (caBIG®). It is currently being supported by NCIP. AIM model 1.0 to 2.0 passed the caBIG® silver compatibility model process. All models underwent a curation process using Semantic Integration Workbench (SIW) to ensure that all new and existing classes and attributes in AIM models conform to and are interoperable with the Common Data Elements (CDEs) standard. All reviewed AIM models that the Enterprise Vocabulary Services (EVS) team approved are uploaded to the cancer Data Standards Registry and Repository (caDSR). The NCIP imaging community maintains AIM official models on NCI caDSR. Some of the earlier AIM models had been retired from CDEs because newer AIM models maintain compatibility to the prior AIM models. The active AIM models can be viewed from CDE browser and UML model browser, figure 1 and figure 2, respectively.
Figure 1. CDE Browser: https://cdebrowser.nci.nih.gov/CDEBrowser/
Figure 2. UML Model Browser: http://umlmodelbrowser.nci.nih.gov/umlmodelbrowser/
In the following sections, leaders of the imaging program at NCIP and its representatives along with the principle investigator of the AIM project describe the participants, policies, and procedures of the AIM project.
The NCIP imaging community conducts regular telephone conferences and face-to-face meetings with imaging community users and experts. The NCIP leaders also participate, exchange, and collect requirements about the use of imaging studies with other NCI communities. These groups of people are stakeholders in improving AIM interoperability and model usage. They provide requirements, suggestions, model reviews, and feedback. The imaging community is an open forum. An individual and representatives of an organization can participate in the community activities by contacting Ulrike Wagner. The current key personnel are as follows.
|Government Sponsor||Edward Helton|
|Government Project Manager||Jonathan Lin|
|Technical Project Manager||Ulrike Wagner|
|Principle Investigator||Pattanasak Mongkolwat|
The imaging community establishes a set of rules that govern the modification and enhancement of AIM models as well as AIM toolkits used to create AIM related software products. The policies meet the Center for Biomedical Informatics and Information Technology (CBIIT) open source community requirements for making NCI supported projects available for public use and contributions.
Figure 3. Requesting a JIRA Account
Figure 4. A Request Type of "User Story"
Figure 5. A Request Type of "New Feature"
Figure 6. A Request Type of "Bug"
Figure 7. A Request Type of "Improvement"
A request for enhancing or changing the AIM model and AIM-related software shall follow the following guidelines.
|Open||An issue has been submitted and reviewed by the AIM team. A member of the AIM team reviews the request and works with the requester to ensure the problem and use cases are clear and complete.|
|In Progress||An issue has been accepted and will be resolved in the AIM project.|
|Hold||An issue has been put on hold for future considerations in a next improvement and development cycle. A member of the AIM team will contact the requester.|
|Resolved as Fixed Issue||An issue has been accepted and included in the AIM project.|
|Resolved as Duplicate||An issue has been identified as a duplicated issue. The AIM team will link the duplicated issue to an existing issue.|
|Resolved as Won't Fix Issue||An issue has been identified as an issue that cannot be fixed for particular reasons. A member of the AIM team shall provide reasonable explanation and/or contact the requester.|
|Resolved as Cannot Reproduce Issue||An issue has been identified as an issue that cannot be reproduced. A member of the AIM team shall provide reasonable explanation and/or contact the requester.|
The AIM team reviews completed requests and votes to approve for inclusion in the AIM model and related software products. The AIM team reserves the rights to present to and consult with NCI imaging leadership, EVS team members, and imaging experts for a resolution. Results of the review might be approval (Resolved as Fixed Issue), reject (Resolved as Won't Fix Issue or Resolved as Duplicate), or return to requestor (Resolved as Cannot Reproduce Issue) with suggested change in direction. Any return to requestor will be delivered through the original JIRA issue. The status changes to "Resolved as Fixed Issue" or "Resolved as Won't Fix Issue or Resolved as Duplicate" based on the decision of the AIM team and its advisors.
The imaging community brings imaging experts and users of in vivo imaging together to address requirements and AIM usage. Community members use AIM library and derived AIM software products and provide feedback to the AIM team. The diagram, Figure 8, depicts the procedures of the AIM project. Any requests for improving, enhancing, and bug fixing must be entered into NCI JIRA as described in section 1.2. There are three sub-projects under the AIM project: AIM Model, AIM Enterprise Service, and AIM workstation.
New inquiry and enhancement requests for the AIM model or "AIM Model Use Cases Requirements" must be submitted to https://tracker.nci.nih.gov/browse/AIM. Once the AIM team accepts a new request to be included in AIM model, the model and accompanying documentation describing any additions and changes are released for public review and comment. The AIM team and its advisors review incoming feedback and work with requested parties who provide comments and suggestions. If need be, the AIM team releases a revised AIM model and repeats a public review process. All corresponding messages of a JIRA issue shall be entered in the NCI JIRA. After a model has been finalized, the AIM team performs the SIW  process and submits the model to the EVS team for review and approval. Once the model is approved, it is submitted to the EVS team to be published to the caDSR . At the same time, the AIM team makes a request to release a new AIM model from the NCI program officer before a public announcement can be released to the public. While the new AIM model is being submitted to caDSR, the AIM team also works on a new version of the AIM C++ software library as well as an AIM XML schema for public use. Changes to the library are also incorporated to ATB, ATS and the AIM workstation. Both the AIM library and AIM XML schema will have to go through a software quality assurance (QA) process. After they pass the QA process, the AIM team makes a request to the NCI program officer for public release of the library and schema. Once approved, the library and schema are uploaded to NCI AIM GitHub for public use. A software and schema releases will be publicly announced.
Any new software features, improvements, and bug reports must be submitted to NCI JIRA under the appropriate software products per the policy explained in "AIM Toolkits and Related Software Products Policy" in section 1.2. The AIM team and its advisors review incoming requests. The AIM team works with interested parties who provide requests and suggestions. All corresponding messages of a JIRA issue shall be entered into NCI JIRA. Accepted requests are scheduled for implementation according to available resources and time allowed for each software development cycle. Each request is associated with a version of a software release. Once a software version is ready for a release, it must go through a QA process until all identifiable software bugs have been resolved. After a software version passes the QA process, it is uploaded to the NCI SFTP. At the same time, the AIM team makes a request for software release with the NCI program officer. An announcement is issued after an approval has been granted.
Figure 8. Procedures for the AIM Project