Cympha
All docs

Open a .cyp in Studio and refine the plan

A designer opens the doctor's .cyp in Cympha Studio with the same camera angle, colours and photos, then moves to OrthoPlus, GuideMia's clear aligner software, for the staging work.

Audience: Designers who have just picked up an assignment and want to see the case in the same scene the doctor was looking at — same camera angle, same measurements, same photo gallery — before touching anything.

You'll come away knowing: where the .cyp file lands on disk, how to open it in Cympha Studio, how to read the inherited view, and how to switch into OrthoPlus for ortho-specific refinements before saving the result back.

Time required: About eight minutes the first time. Two minutes per case once the round-trip feels natural.

Before you start

You need:

  • A Cympha account in role Designer (or Lab Manager standing in for one). If you're still pending approval, see A designer's first day on Cympha — your assignments queue is empty until your lab manager approves you.
  • Cympha Agent Manager installed and showing Paired in the tray. Install + pair walkthrough: Install and pair Cympha Agent Manager.
  • A configured Cloud Monitoring workspace. Right-click the tray icon → Cloud Monitoring → Configure workspace… and pick a folder with Choose folder…. The dialog shows (not set) until you choose one — there is no default path — and picking a folder starts monitoring automatically.
  • A desktop copy of GuideMia OrthoPlus if the case is orthodontic / aligner. Studio (the browser app) lets you look, measure, and re-frame the scene; OrthoPlus is where you actually move teeth.

You should already have at least one case showing in My Assignments at app.cympha.com/assignments with status Designing. Open it once before you read on — you'll be moving between this case detail page and the desktop the whole time.

Step 1 — Find the case folder on disk

When the agent polls Cympha and sees a case is assigned to you, it materialises the case as a subfolder under your workspace:

{workspace}/{category}/{PatientName_Date_caseID}/

A real path looks like:

D:\CymphaWorkspace\ortho\Lara_Bianchi_2026-05-28_a31f4c\

The category prefix is the case type — a folder like ortho, alignerbot, or implant. Inside, you'll typically see:

  • The upper and lower scan meshes the doctor uploaded.
  • A lab_slip.pdf — the consolidated order, always refreshed when case data changes.
  • Any photos, X-rays, or accessory files the doctor attached.
  • And — when the doctor built the case in Cympha Studio via Create Cympha Case — a .cyp, the Studio project that captures their scene. Cases submitted through the ordinary new-case form (plain STL uploads) don't have one; if there's no .cyp in your folder, that's why, and you'll work from the meshes directly.

If the folder isn't there yet, open the tray menu → Cloud Monitoring → Show panel and check the status line. If it says Paired, polling for cases, give it 60 seconds. If it says Not paired or Idle, re-pair via the install doc.

Step 2 — Open the .cyp in Studio

The .cyp is a Cympha Studio project file. It re-creates the scene the doctor was last looking at, including:

  • Camera angle and zoom. The same vantage point — buccal, occlusal, lingual, three-quarter — they saved before sharing.
  • Mesh appearance. Tooth/gingiva colours, transparency, any annotations the doctor drew.
  • Photo gallery. Sibling files like .png / .jpg / .webp next to the .cyp show up as the doctor's photo set, in the order they last arranged them.
  • Measurements. Any tooth-to-tooth or arch-width measurements the doctor placed.

To open it: go to studio.cympha.com (Studio opens and renders without a sign-in) and use Open project…, then pick the .cyp from the case's workspace folder on disk. Studio restores the saved scene.

You should land on a scene that looks like the screenshot the doctor would describe to you over the phone — not a generic top-down occlusal view.

Why bother with the .cyp instead of just opening the meshes? Two reasons. First, the doctor's framing tells you what they care about (a single midline, a posterior cant, a third-molar collision); jumping straight into OrthoPlus loses that context. Second, the photo gallery is right there — you can flip from the 3D scene to a clinical photo and back without leaving the browser.

Step 3 — Read the inherited view

Spend 30–60 seconds in Studio before you do anything:

  • Cycle the camera with the cube widget (top-right) or the Front / Left / Right / Upper / Lower preset buttons. Note which view the doctor left set as the active camera — that's what they considered the "headline" view.
  • Click through the photos in the gallery pane. Compare the patient's actual mouth to the rendered scan. Look for soft-tissue notes (lip line, gingival recession) that won't show up on the mesh.
  • Re-read the case parameters in the right-hand panel — plan range, occlusal class, extractions, attachment preference. These come straight from the AlignerBot or ortho intake form and override anything in the chat.

If something in the brief is ambiguous, open the Case Chat (on the case detail page back in the Cympha tab — shared with the lab manager and the doctor) and ask now, before you spend 20 minutes in OrthoPlus designing the wrong thing.

Step 4 — Switch to OrthoPlus for the actual ortho work

Studio is read-and-measure. For tooth movement you switch to OrthoPlus.

Open OrthoPlus on the same workstation and open the case from its workspace folder. OrthoPlus picks up the same meshes and any existing .gos (the OrthoPlus project file).

If this is the first design pass and no .gos exists yet, OrthoPlus walks the automatic scan repair → AI segmentation → automatic tooth setup chain, then drops you into the treatment-planning stage. For the full new-case walk see OrthoPlus — your first aligner case end-to-end.

Make your refinements: staging, attachment positions, IPR, refinement passes, whatever the case needs. Save as you go — OrthoPlus writes the .gos back to the same case folder.

Step 5 — Get the deliverable back to the cloud

Understand what does and doesn't travel. The .gos project file stays local — it is not on the agent's upload list and will never appear on the case in Cympha. Your cloud deliverables are the review and transfer artefacts OrthoPlus exports:

  • A .gvw review file. Export it into the case folder and the agent uploads it automatically — no click needed. Be aware this is a trigger: a .gvw arriving via the agent on a case in Designing requests Plan approval by itself, so export it when the plan is actually ready for the doctor.
  • A .gos.gpk transfer pack (produced by OrthoPlus's save-for-transfer at phase completion). Like most other file types (.stl, .xml, .pdf, …) it waits in the agent's Cloud Monitor panel for you to click Upload — open the tray icon → Cloud Monitoring → Show panel and look under New in workspace.

Once a file uploads, it appears in the Files panel on the case detail page in your browser. Don't wait for the .gos itself to show up there — by design, it never will.

What happens next

  • If you haven't uploaded a .gvw yet, the case is still in status Designing and the customer doesn't see anything new on their side. To push it forward, follow Save and request approval.
  • The .cyp round-trip. If you re-arrange the Studio scene (new camera, new annotations, new photo order), saving back updates the .cyp — but only the camera/annotation/photo state, not the underlying meshes. The doctor opening the case next sees your annotated view, not theirs.

Troubleshooting

The case folder didn't appear in my workspace. Open the tray menu → Cloud Monitoring → Show panel. If the status line says Not paired, re-pair the agent (see the install doc). If it says Paired but the case isn't materialising, the case may still be in Submitted or Intake Review — the agent only downloads cases whose holder is you, in Designing.

Studio opens but the scene is blank. The .cyp travels with a sibling asset folder; if the scans aren't yet downloaded or the .cyp arrived without its siblings, the scene comes up empty. Check the workspace folder — every file listed in the case detail's Files panel should be on disk. If not, click Cloud Monitoring → Show panel in the tray and look for download errors.

OrthoPlus doesn't see the case folder. OrthoPlus needs the patient-folder structure the agent creates; pointing it at a flat folder of .stl files won't trigger the case-aware flow. Open the workspace folder in File Explorer and verify the subfolder name matches PatientName_Date_caseID/.

Studio shows the doctor's camera angle but no photos. The doctor didn't attach photos to this case — that's expected for design-only AlignerBot cases. Photos are optional in the intake form. If you expected photos, message the doctor through the customer chat thread.

My saved .gos isn't appearing on Cympha. It never will — the .gos project file isn't on the agent's upload list, by design. The files that travel to the cloud are the exported deliverables: the .gvw review file (uploads automatically) and the .gos.gpk transfer pack (waits for your Upload click in the Cloud Monitor panel).

Related how-tos: Save and request approval for the next step, Cympha Studio cookbooks for deeper Studio workflows, and OrthoPlus — your first aligner case end-to-end for the OrthoPlus-side walk-through.

CymphaLMSCymphaStudio