Medlea

Docs /Getting Started

Modes & Settings

Switching Between Modes

LeaRes’s dual-mode system lets you move between the medical and engineering workflows using a single toggle.

The mode toggle

The mode toggle (#panel-mode-toggle) sits at the top of the Projects and Patients window — not in the top toolbar. It is a single icon button, not a dropdown.

  • While in medical mode, its tooltip reads “Switch to engineering projects”. Clicking it moves you to the engineering workflow.
  • While in engineering mode, its tooltip reads “Switch to medical records”. Clicking it returns you to the medical workflow.

The toggle appears only if your account has access to both patients and projects.

What changes after switching

  • The ActionsTree updates to show the appropriate hierarchy (patients vs. projects).
  • The toolbar adjusts to display the tools relevant to the active mode.

Note: Switching modes changes which workflow you are working in; it does not delete data. The bridge between the two worlds is explicit — for example, a segmented anatomy can be turned into an engineering project via Store selection as project in the Segment and Reconstruct panel.

Settings Panel

Open the Settings panel from the toolbar (#settings-button). It groups account, system resources, third-party connections, data management, theme, language, and two-factor authentication. The cart icon inside this panel opens the Recharging Station — see Account, Tiers, and Credits.

Settings panel

Theme Customization

LeaRes ships four themes. Choose one with the Theme selector in the Settings panel.

ThemeBackground
LightWhite
Dark BlueLight blue
Dark MonochromeGrey — raises perceived contrast on medical images
Darker MonochromeNear-black — maximum contrast

The two monochrome themes exist for medical image review, where a neutral background makes density differences easier to read.

Theme in the 3D Viewer

The VTK.js renderer adapts to your theme choice:

  • Light: lighter background, dark edges on geometry
  • Dark themes: dark background, lighter edges for contrast

Accessibility: Dark mode can reduce blue light exposure during extended work sessions.

Two-Factor Authentication

Two-factor authentication (2FA) is configured in the Settings panel and uses a TOTP authenticator app.

To enable it:

  1. Choose Set up two-factor authentication
  2. Scan the QR code with your authenticator app, or use Copy secret key to enter it manually
  3. Enter the 6-digit code and choose Verify code and activate MFA
  4. Download the backup codes and store them somewhere safe, then confirm you saved them

Backup codes let you sign in if you lose access to your authenticator. The panel shows how many remain, and Regenerate backup codes issues a fresh set (invalidating the old ones).

To turn 2FA off, use Disable two-factor authentication — it asks for both your password and a current code.

Note: Backup codes are shown only once, at activation or regeneration. If you lose them and your authenticator, you will need an administrator to recover the account.

Notifications

The notifications area (bell icon) surfaces system messages such as:

  • Simulation completion alerts
  • AI segmentation results
  • Long-running job status updates

Click the icon to review the notification history.

Common Navigation Patterns

Loading Patient Data

  1. Open the Projects and Patients window (shown at login) and select a database.
  2. Double-click a patient to open it.
  3. Click an event/series (e.g., PRE, POST, torso) to load it in the viewer.
  4. Open Segment and Reconstruct from the toolbar to segment and overlay anatomy.

Loading Project Geometry

  1. Select a database, then double-click a project to open it.
  2. Double-click a version (e.g., version_0) to load its geometry into the viewer.
  3. Expand Materials, Boundaries, and Simulations to work on the device.

Troubleshooting Navigation Issues

If the ActionsTree becomes unresponsive:

  1. Check the console (F12 → Console tab) for errors
  2. Refresh the page (F5) to reload the interface
  3. Clear the browser cache if issues persist

3D Viewer Blank or Frozen

If the GView doesn’t render:

  1. Verify WebGL support: visit chrome://gpu (Chrome) or about:support (Firefox)
  2. Update graphics drivers: ensure GPU drivers are current
  3. Disable browser extensions: some ad-blockers interfere with WebGL
  4. Try a different browser: test in Chrome, Firefox, or Edge

Note: Some advanced rendering features, such as Surface LIC for vector flow, require WebGL2.

Data Not Loading

If clicking items doesn’t load data:

  1. Check connectivity to the backend and database
  2. Verify you’re logged in (your session may have expired)
  3. Re-select the database in the Projects and Patients window
  4. Contact support if specific datasets fail consistently