Information in this article applies to:
- uScope Navigator V4.5 and Later
Article ID: NJX1270 — Created: 21 Aug 2019 — Reviewed: 2 Mar 2022
Question
What is the file folder layout for a scanned slide job?
Answer
When you scan a slide with the uScope Navigator application, you must enter a job name (folder name) for the scanned images. This folder is created (by default) in the C:\Images\ subdirectory.
Images Folder
All scanned slides (regions of interest) are saved in job folders in <ImagesFolder> which defaults to: C:\Images\. You can change the default <ImagesFolder> on the Program Options — Application Preferences tab.
Typically, the images folder appears as follows:
C:\Images
Job1
Job2
Job3
uS-Overview.jpg
uS-Key.jpg
uS-ScanInfo.xml
uS-XxxxYyyy.(jpg|png)
JobInfo.xml
DZCombine.xml
DZCompute.xml (New in v4.6)
Deepzoom-???
MIDZ.HTML
uS-Overview.jpg
uS-Key.jpg
DZThumbnail.jpg
DZThumbnail_sq.jpg
DZInfo.xml
DZViewer.xml
DZOutput.xml
DZOutput_files
(Deep Zoom Pyramid Files)
EasyZoom (New in v4.5)
(EasyZoom (SZI) Images)
SVS (New in v4.5)
(SVS Images)
Exports (New in v4.5)
(Deep Zoom Exported ROI Images)
Job Folder
When you create a new job <JobName>, all files for that job are stored in <ImagesFolder>\<JobName>\.
After scanning, the job folder contains the following files:
- uS-Overview.jpg
This image file is the overview image of the whole slide. It is captured by the overview camera as a single, high-definition image. The scanned region of interest is outlined in green. - uS-Key.jpg
This image file is a composite of the individual fields. It is not full image resolution. it is only intended to be a guide to associating a particular field to a position in the scanned region. - uS-ScanInfo.xml
This XML file contains information about the scan. - uS-XxxxYyyy.(jpg|png)
These files are the individual fields captured while scanning the region of interest. Each image is saved in standard definition (960x540) or high definition (1920x1080) format. Images are saved as JPG (lossy, compressed) or as PNG (lossless, compressed) depending on scan settings. - JobInfo.xml
This XML file contains information about the job.
- DZCombine.xml
This XML file contains image overlap adjustment data required to properly stitch field images into a seamless mosaic. - DZCompute.xml
This XML file contains statistical and final position data for the stitched field images. - SVS Folder
This folder contains SVS images created for the region scan. - EasyZoom Folder
This folder contains EasyZoom (SZI) images created for the region scan. - Deepzoom-??? Folders
These folders contain deep zoom image sets created by the uScope Navigator application. The suffix (???) is the name of the filter used to create the deep zoom image. If no filter is used, the suffix is "unfiltered". - Exports Folder
This folder contains ROI (region of interest) image files exported from the Deep Zoom image viewer.
DeepZoom-??? Folders
Each deep zoom image you create is saved in its own folder and is given a name of DeepZoom followed by the filter name selected for the deep zoom image. The folder is named DeepZoom-unfiltered if no filter is applied.
The deep zoom folder contains the following files:
- MIDZ.HTML
This is the Deep Zoom image viewer. The image viewer is an HTML/Javascript file that you can copy to a web server (along with the other Deep Zoom folder contents) to allow users to view the Deep Zoom image. - uS-Overview.jpg
This is the image of the slide (minus the label) from the overview camera. The region scanned is outlined in green. - uS-Key.jpg
This is an image of the region scanned (after it has been stitched). It is not a full-sized image. - DZThumbnail.jpg
This image is a 3:2 (1800x1200) image of the constrained uS-Key.jpg image. - DZThumbnail_sq.jpg
This image is a cropped square image (240x240) of the DZThumbnail.jpg image.
- DZInfo.xml
This XML file contains information about each scan. Information from this file is extracted by the deep zoom image viewer and used to create the info popup and to calculate image scale. - DZViewer.xml
This XML file contains filter information for the deep zoom image viewer. - DZOutput.xml
This XML file is required by the deep zoom image viewer. If you plan to use another deep zoom image viewer, you need only this file and the DZOutput_files folder. - DZOutput_files folder
This folder contains the deep zoom image pyramid that contains the individual tiles associated with each level of the deep zoom pyramid.
Note
This folder structure applies to scans created by uScope Navigator v4.5 and later. For details regarding the folder structure for uScope Navigator v4.0 through v4.3, refer to Job Folder Structure (uScope Navigator v4.0-v4.3).