The MIRC ZipObject
The MIRC ZipObject is a collection of files wrapped in a zip file. It is intended to encapsulate groups of related files, for instance several data files which are the results of analysis of clinical trial data. To carry information that allows applications to know how to relate a ZipObject to other data, each ZipObject must contain a manifest. A manifest is an XML text file named manifest.xml, located in the root of zip file's directory tree (e.g. with no path information).
The root element of a manifest can have any name. By convention, it is called manifest.
The root element has several attributes:
- uid is required. It defines a unique identifier for the ZipObject. The DICOM UID format is strongly suggested, but there is no technical requirement imposed by the RSNA MIRC implementation on the format.
- study-uid is required in clinical trial data submissions. It provides a reference to the study. This RSNA MIRC implementation uses this attribute to link the ZipObject to the MIRCdocument containing the other objects associated with the same study. If the ZipObject contains results obtained from the analysis of DICOM images from a specific study, the DICOM StudyInstanceUID must be used. If the ZipObject is not used as part of a clinical trial data submission, this attribute is optional.
- pt-id is optional. For ZipObjects which encapsulate data for a single patient, this identifier may be included.
- pt-name is optional. For ZipObjects which encapsulate data for a single patient, this attributemay be included.
- description is optional. It provides a free text description of the ZipObject. The RSNA MIRC implementation presents this text in the table of object references in a MIRCdocument.
- date is optional. It provides a date for the ZipObject. The date must be in the format specified by ISO 8601 (YYYY-MM-DD).
- version is optional. It provides a version reference for the manifest format. This could be used by software as an aid in interpreting its contents.
- type is optional. It can be used to distinguish between ZipObjects of different types. No enumerated values of the type attribute are defined.
The manifest root element has no required child elements. The intention is that each manifest contain whatever child elements are appropriate to describe the contents of the ZipObject and their relationships with each other as well as external objects, but there is no required standard format. It is expected that each application (e.g., each clinical trial or research project) will invent its own manifest consistent with the attributes defined above.
An example of a simple manifest is:
<manifest uid="220.127.116.11.5" study-uid="18.104.22.168.5.1" description="Analytical results" />
A more complex manifest might be:
<manifest uid="22.214.171.124.5" study-uid="126.96.36.199.5.1" description="Analytical results" date="2006-11-06" version="1"> <patient-id>123</patient-id> <series> <series-uid>188.8.131.52.5.2</series-uid> <instance-uid>184.108.40.206.5.4</instance-uid> <instance-uid>220.127.116.11.5.5</instance-uid> <instance-uid>18.104.22.168.5.6</instance-uid> <instance-uid>22.214.171.124.5.7</instance-uid> </series> <series> <series-uid>126.96.36.199.5.3</series-uid> <instance-uid>188.8.131.52.5.8</instance-uid> <instance-uid>184.108.40.206.5.9</instance-uid> </series> </manifest>
Important note: The RSNA MIRC implementation does not provide anonymization for ZipObjects.
The RSNA MIRC software provides a ZipObject class, org.rsna.mircsite.util.ZipObject, which provides access to the manifest, certain manifest attributes, and all the files within the zip file. See The RSNA MIRC Source Code for instructions on obtaining the source code.