How to Use the Sessions Screen in OptimaScan
The Sessions screen is the central hub within the OptimaScan app where all of your imaging sessions are securely stored, tracked, and managed.
Rather than saving image files directly to your computer's local folders, OptimaScan automatically encrypts and organizes your scans inside this secure dashboard.
What is the Sessions Screen Used For?
- Tracking Scan Progress: Monitor the real-time processing, post-processing, and uploading status of your 3D models.
- Reviewing Images: Open the sessions that are done with scanning to view the captured total-body photography images. (Note: Session images—including supplementary images—are ready for viewing immediately after the scan is complete. You do not have to wait for the 3D model to finish generating).
- Troubleshooting Scans: Instantly retry any 3D model reconstructions that failed during processing.
- Managing Storage: Delete duplicate or unwanted scan sessions to keep your database clean.
.png?width=670&height=447&name=patients-realistic-names%20(1).png)
1. Accessing the Sessions Screen
You can access the Sessions screen in two different ways depending on your current workflow:
Option A: View All Sessions (From the Patients Dashboard)
If you want to see a master list of all recent scans across all patients:
- Open the OptimaScan app on your Mac.
- From the main Patients screen, look at the top-right corner of the window.
- Click the 🕒 Sessions button (located directly to the left of the circular Refresh and Settings gear icons).
Option B: View Sessions for a Specific Patient
If you only want to see scans associated with a single patient:
- On your Patients list, locate the patient's name.
- Click the (>) icon on the far right of their row to open their profile.
- In the top navigation header of their profile page, click the Sessions button.
2. Understand Scan Status Badges
In the Sessions list, every scan row displays the Patient Name, Date & Time, and a color-coded Scan Status badge. Use the table below to understand what each status means:
| Status Badge | Icon & Color | Description |
| Generating 3D Model | 📦 Blue Outline | The system is currently compiling the captured photos into a 3D body map. |
| Waiting for 3D Model Generation | ••• Light Blue | The scan is queued and waiting for processing resources to become available. |
| Complete | Checkmark Green | The scan processed successfully and the 3D model is ready for clinical review. |
| Post-processing | ••• Light Blue | Clean up and scale the 3D model, then detect joints. |
| Uploading | ••• Light Blue | Send the finished model to the cloud. |
| Failed | Warning Triangle Red | An error occurred during image capture or processing. The 3D model could not be generated. |
| Ready to Scan | Empty Circle Grey | Either baseline model is completed and got reset for a follow-up scan after a day or a completely new scan where there is no data captured yet. |
Step 3: View, Retry, or Delete a Session
How to View Images in a Session
You can view session images immediately after scanning is complete, there is no need to wait for the 3D model to finish generating. Even when you are in the supplementary view, you can click on Sessions and review the images. Supplementary images are also included in this view.
- In the Sessions list, find a row marked with a view status badge.
- Hover over the row and click Open (or double-click the row).
- The image viewer will open, allowing you to review the captured total-body photography (TBP) and supplementary images.
How to Retry a Failed 3D Model Reconstruction
If a scan failed to process due to a temporary connection drop or a system delay, you do not need to re-scan the patient.
- Locate the row marked with the red Failed badge.
- Hover your cursor over the row to reveal the action buttons on the right side.
- Click the Retry button. The app will attempt to rebuild the 3D model using the locally saved images.
How to Delete a Session
- Locate the session you wish to remove.
- Hover your cursor over the ellipsis of patient row and click the Delete(Trash) icon on the right side.
- Click Confirm on the pop-up warning.
⚠️ Warning: Deleting a session permanently removes the scan data from your device's secure database. This action cannot be undone.
Security & Privacy Note
To protect patient privacy, all files managed within the Sessions screen are fully encrypted. Scan images cannot be previewed or opened directly from your Mac’s Finder. They can only be accessed and viewed securely through the authorized OptimaScan application interface.