> ## Documentation Index
> Fetch the complete documentation index at: https://support.lumafield.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Uplink

> Easily store, visualize, and analyze data from any CT scanner in Voyager. Make your volumetric data and analyses accessible to your broader team, anywhere, at any time.

<video src="https://mintcdn.com/lumafield/YvLWRBpJQWtqApaZ/images/Uplink_Feature.mp4?fit=max&auto=format&n=YvLWRBpJQWtqApaZ&q=85&s=3dd3cbd7618e9212303ab178631c7172" controls={true} data-path="images/Uplink_Feature.mp4" />

<h3 id="overview-setup">
  Overview & Setup
</h3>

To start using Voyager Uplink, ensure you have the Uplink module activated in your Organization. If activated, you will see an "Upload CT Scan" button in your Project Dashboard.

<Frame>
  <img src="https://mintcdn.com/lumafield/YvLWRBpJQWtqApaZ/images/Uplink_Button.png?fit=max&auto=format&n=YvLWRBpJQWtqApaZ&q=85&s=8cb73cd289e28d67adadd544c6ec00c0" alt="Uplink Button" title="Uplink Button" style={{ width:"40%" }} className="mr-auto" width="1438" height="636" data-path="images/Uplink_Button.png" />
</Frame>

<h3 id="supported-file-formats">
  Supported File Formats
</h3>

Voyager Uplink supports three file formats for uploading your CT scan data:

* **Volume Graphics Files (.VGL + .RAW or .VOL)**
* **Volume Graphics Files (.VGL + DICOM stack)**
* **TIFF Stack**
* **TXM File**

<h4 id="volume-graphics-files-vgl-raw">
  Volume Graphics Files (.VGL + .RAW)
</h4>

<Frame>
  <img src="https://mintcdn.com/lumafield/YvLWRBpJQWtqApaZ/images/Uplink_VGL_and_Raw.png?fit=max&auto=format&n=YvLWRBpJQWtqApaZ&q=85&s=258991b5058179955d38c1b3823cb0e8" alt="Uplink VGL And Raw" title="Uplink VGL And Raw" style={{ width:"50%" }} className="mr-auto" width="1240" height="1470" data-path="images/Uplink_VGL_and_Raw.png" />
</Frame>

**Volume Graphics (.VGL + .RAW) files are often the preferred upload method** as they preserve all scan metadata and provide the fastest, most reliable upload experience. Many industrial CT scanners and processing software can Export to this format.

* Upload both the .VGL and .RAW (or .VOL) files together
* Maintains original voxel size
* Significantly faster processing compared to TIFF stacks
* Preserves scan parameters and metadata

<h4 id="volume-graphics-files-vgl-dicom-stack">
  Volume Graphics Files (.VGL + DICOM stack)
</h4>

**VGL files paired with DICOM stacks** provide another flexible upload option that combines the metadata benefits of Volume Graphics files with the widespread compatibility of DICOM format.

* Upload the .VGL file along with your DICOM stack
* Maintains original voxel size
* Leverages the standardized DICOM format from medical/industrial imaging

Zip Instructions:

1. .VGL and DICOM files need to be structured properly to Upload successfully.
2. The .VGL file can be uploaded as is.
3. The primary Reconstruction is stored as a series of .dcm files in one of the VG directories.

* Find the primary Reconstruction (usually in a folder named the same as the VGL file)
* Zip just that folder, excluding ROIs or other data. The folder should just contain .dcm files.
* Upload that folder along with your .VGL file.

<h4 id="tiff-stack">
  TIFF Stack
</h4>

For scanners or systems that don't support Volume Graphics export, you can upload a zipped folder of TIFF files (a "TIFF stack"). Voyager supports *up to* 16-bit TIFF files.

To ensure your scan data shows up in the proper orientation, use X-Y planes (also known as z-axis slices). Also, we recommend using TIFFs with higher relative contrasts to make viewing and analysis easier.

<Note>
  A .zip folder can be created from a folder containing your TIFF files on [Windows File Explorer](https://support.microsoft.com/en-us/windows/zip-and-unzip-files-f6dde0a7-0fec-8294-e1d3-703ed85e7ebc#:~:text=To%20zip%20\(compress\)%20files,%3E%20Compressed%20\(zipped\)%20folder.) or [Mac Finder](https://support.apple.com/guide/mac-help/zip-and-unzip-files-and-folders-on-mac-mchlp2528/mac).
</Note>

<h3 id="upload">
  Upload
</h3>

Uploading your scans / volumetric data requires *editor* access to Voyager. Once uploaded, any Viewer or Editor with access can view scans and Analysis Results.

<Frame>
  <img src="https://mintcdn.com/lumafield/YvLWRBpJQWtqApaZ/images/Uplink_Upload.gif?s=0bc176077f70ed37d1c84d6e56955703" alt="Uplink Upload" className="mr-auto" width="3024" height="1652" data-path="images/Uplink_Upload.gif" />
</Frame>

To Upload your scan:

1. **Select the "Upload CT Scan" button** in the bottom left corner of the Project Dashboard.
2. **Choose your scan files:**
   * **For Volume Graphics files (.VGL + .RAW):** Select both the .VGL and .RAW files
   * **For Volume Graphics files (.VGL + DICOM):** Select the .VGL file and your DICOM stack
   * **For TIFF stacks:** Choose the zip folder that contains your TIFF files
3. **Input your Project details.** Name your Project and select the Organization and workplace location for your Project.
4. **Input your desired voxel size (TIFF stacks only).** Both Volume Graphics formats (.VGL + .RAW and .VGL + DICOM) automatically preserve their original voxel size. For TIFF stacks, Voyager supports isotropic voxels and applies the same input to the x, y, and z dimensions. Inputting the correct voxel sizing helps accurately represent your scan for dimensioning purposes.
5. **Select "Upload".**

<h3 id="scan-processing">
  Scan Processing
</h3>

At this point, the dialog box should switch to “uploading Scan …”. Depending on the size of your zip folder and network speed, the Upload speed can vary.

Once uploaded, Voyager starts processing your data. You will see a "running" indicator that shows up under the Project thumbnail. Your zip folder size and data complexity may affect processing latency. You will see a thumbnail of your scan and a "done" indicator when Voyager has successfully processed your 3D scan or an "error" indicator if an issue has been encountered.

<Warning>
  If your scan receives an "error" indicator or takes more than 15 minutes to process and the Project thumbnail remains empty, it is possible the scan failed to process. Please reach out to [support@lumafield.com](mailto:support@lumafield.com) so we can work with you to solve either issue.
</Warning>

Just like with any other Project in Voyager, you can now click on the Project to view and analyze. Scan and Upload away!

<h3 id="resuming-an-upload">
  Resuming an Upload
</h3>

If you lose connectivity, you can resume your scan upload.

1. **Click on the “Upload CT Scan” button.**
2. In the lower left corner of the dialog box, **click on “Resume Partial Upload”**.
3. From the list of recent scan uploads, **click on “Select File to Resume Upload”** of the Project and reselect the zip folder. The Upload should resume from where it left off.

<Frame>
  <img src="https://mintcdn.com/lumafield/YvLWRBpJQWtqApaZ/images/Uplink_Resume_Partial_Upload.png?fit=max&auto=format&n=YvLWRBpJQWtqApaZ&q=85&s=3bead4f6c5dbd6fa3b3a78cf98766732" alt="Uplink Resume Partial Upload" title="Uplink Resume Partial Upload" style={{ width:"40%" }} className="mr-auto" width="1402" height="296" data-path="images/Uplink_Resume_Partial_Upload.png" />
</Frame>

<h3 id="changing-voxel-size">
  Changing voxel size
</h3>

If the voxel size of the uploaded volume is incorrect, it can be adjusted by selecting the Uploaded Volume object in the Data Panel and clicking the Adjust Voxel Size button in the Resolution section of the Attributes Panel and submitting the correct voxel size.

<Frame>
  <img src="https://mintcdn.com/lumafield/YvLWRBpJQWtqApaZ/images/Uplink_Neanderthal_Teeth.gif?s=101cb73c166df52054aabac82a439902" alt="Uplink Neanderthal Teeth" width="3024" height="1652" data-path="images/Uplink_Neanderthal_Teeth.gif" />
</Frame>
