Using the Compressed Image Uploader

The compressed image uploader is an image session import tool that was developed to rapidly import one or many image sessions that have been zipped and stored in an archival format. The compressed uploader runs in the browser without requiring a Java applet to browse your file system by using a common HTML file upload input field, and handling only a single archive at a time. The uploader unpacks the zip archive(s), reads the DICOM metadata of the enclosed scan files, and builds the session object(s) and archives the session(s).

As a convenience, the compressed image uploader can bypass the Prearchive, and can also create subject entries in your XNAT project if they do not already exist.

Expected Data Format for Compressed Uploader

Zipped data for a single session should be organized into a folder structure as follows:

    - /scans
		- /{scan_id}
			- /resources
				- /DICOM
					- /files
				- /ECAT
					- /files

The compressed uploader only handles DICOM and ECAT file resources. If your session archive contains other resource folders, for NIFTI or SNAPSHOTS for example, the contents of those folders will be ignored.

Multiple session archives for multiple subjects can be bundled together into a single archive, and that bundle can be zipped into a single parent archive, with the following structure:

	- /
	- /
	- /
	- /

Handling of PET-MR Data

The compressed uploader does not yet support splitting PET/MR sessions based on the site-wide or project-specific settings for handling PET/MR data. If you are uploading PET/MR data and need to have the data split into separate PET and MR sessions or created as a PET session rather than a PET/MR session, you should use either the upload applet or the DICOM C-STORE receiver.

Using the Compressed Uploader

To use the compressed image uploader from anywhere in XNAT, go to Upload > Images > Compressed Uploader in the top navigation. Usage of the compressed uploader is very simple.

1. Select a Project.

2. Select a Destination. Even if your project is set to move all uploaded image sessions to the prearchive, you can bypass that configuration with this setting and directly archive your session files.

3. Select a File. This should be a .zip or .tar.gz archive file somewhere on your file system. Note: if you upload a large file from a network drive, you may notice some lag in performance.

4. Begin Upload.

Once you begin your upload, a progress panel will appear.

Assuming your archive is properly formatted, the files will be extracted and reviewed and sent to the destination that you selected.