Cympha

Segment a CBCT scan into STL models

CBCT segmentation turns a scan into tooth, jaw bone and nerve models on your own computer, then shows them over the scan in the CBCT viewer in Cympha Studio.

Audience: Clinicians, lab managers and designers who have a CBCT scan, on a Cympha case or on their own Windows computer, and want it split into separate 3D models: each tooth, the upper and lower jaw bone, and the lower nerve canal.

You'll come away with: the models shown in Cympha Studio over the scan, ready to check slice by slice, and, when you want them, the STL files in one zip or saved to the case.

Where it happens: in three places. The segmentation runs in the Cympha Agent Manager on your Windows computer: the scan stays on that computer and is never uploaded. You start it from Cympha Studio (studio.cympha.com), from a case page on app.cympha.com, or from the Agent Manager's tray menu. Every run ends in the CBCT Segmentation workspace of Cympha Studio, on the same computer, which rebuilds the models, takes the price from your balance and shows them.

The models are AI-produced. The teeth, bone and nerve canal are an AI inference from the scan, a draft to be reviewed, never a clinical finding or recommendation. On a case page, Cympha shows the notice Experimental AI — not a clinical tool before the first run in a browser session. Check each model against the scan slices before you use it, especially the nerve canal and any tooth next to a missing or unusual tooth.


Before you start

  • A Cympha account and a balance that covers one run. Any account works, including a free one; no subscription is needed. Cympha Studio calls the balance Studio balance; app.cympha.com calls it Cympha balance. They are the same balance. Nothing is charged when a run starts: Studio takes the price once it has rebuilt the models, just before it shows them, and a failed run costs nothing. The price of one run is shown in the CBCT Segmentation workspace before you start, and on the Studio pricing page (studio.cympha.com/pricing). To top up:
    • in Cympha Studio: open the menu (three lines, top left); Studio balance is in the account area at the top;
    • on app.cympha.com: click Cympha balance in the left sidebar (clinician accounts), or click your name at the bottom of the left sidebar, then Cympha balance.
  • A Windows computer. The segmentation runs on any graphics card that supports DirectX 12, and on the processor when there is none. With an NVIDIA RTX card with 8 GB of memory it is quicker; on other computers a run can take up to 20 minutes.
  • Cympha Agent Manager 1.2.1 or later, installed on that computer and paired to the same Cympha account that you use in Studio and on app.cympha.com. See Device pairing: install and pair Cympha Agent Manager. The version is at the top of the Agent Manager's status window (right-click the Cympha icon in the Windows taskbar, then Show window).
  • Cympha Studio open on the same computer when you view the result. Studio fetches the result from the Agent Manager on the computer it runs on, so the computer that ran the segmentation is the one where you open the models.
  • For a run from a case page only: Cloud Monitoring set up, so the case's files are on the computer. Right-click the Cympha icon in the taskbar, choose Cloud Monitoring > Configure workspace…, click Choose folder… and pick the folder where cases should arrive. Monitoring starts once a folder is chosen, and each case downloads into its own folder there. Runs from Studio and from the tray menu do not need Cloud Monitoring.

The scan must be a DICOM series: loose slice files (.dcm, or CD-style names such as 00000DCM), a folder with a DICOMDIR file, or one .zip of the DICOM folder. On a case, attach the CBCT as a single .zip of the DICOM folder. To upload a large archive, see Upload via Agent — case-detail upload with optional mesh fixing.

Choose where to start. All three ways run the same segmentation and end in the same place:

  • Option A — from Cympha Studio: for a scan on your computer. The Agent Manager asks you for the folder.
  • Option B — from a case page: for a CBCT attached to a Cympha case. The Agent Manager takes the scan from the synced case folder; you can save the models back to the case.
  • Option C — from the Agent Manager's tray menu: for a scan on your computer, without opening a browser first.

Option A — Start from Cympha Studio

  1. Open Cympha Studio at studio.cympha.com/app, or go straight to the workspace with studio.cympha.com/app/?workspace=cbct-segmentation. Sign in with your Cympha account: if you are signed out, the panel reads "Sign in to your Cympha account to segment a CBCT." and shows Sign in.
  2. Click the workspace switcher, next to the menu button at the top left, and choose CBCT Segmentation (marked Premium). The CBCT Segmentation panel opens at the right of the 3D view (at the bottom on a narrow screen). Exit, at the top right of the panel, returns to 3D Processing.
  3. The panel checks your Agent Manager and your last run ("Checking your Agent and your last segmentation…"). When an Agent Manager paired to your account is running, the panel reads Segment a CBCT on this computer, with "Agent online:" and the computer's name, and the price line. If it reads Cympha Agent Manager is not running on this computer instead, see "If something doesn't work".
  4. Click Segment a CBCT on this computer. The panel changes to Waiting for the Agent: "Select the CBCT DICOM folder in the Agent's dialog on" the computer's name.
  5. On the computer, the Agent Manager opens the Select CBCT DICOM folder dialog. On a computer without an NVIDIA RTX card with 8 GB, its title adds "(on this computer segmentation can take up to 20 minutes)". Pick the folder that holds the CBCT slices (or the folder with the zipped DICOM) and confirm.
  6. The panel heading changes to Segmenting on the computer's name, with "Running for … min". You can keep working or close Studio. The run continues in the Agent Manager, and Studio picks up the result when you come back (see "When it finishes").

If several computers are paired to your account and running, the first one to check in takes the job and opens the dialog. Run the segmentation with only the computer that holds the scan running its Agent Manager.

Option B — Start from a case page

Step 1 — Open the case and check the CBCT is there

  1. On app.cympha.com, click Dashboard in the left sidebar.
  2. Click the case's row in the case table. The case page opens.
  3. Scroll to the Files section and check that the CBCT .zip is listed. If it is not, upload it first.

At the right end of the Files heading row is a cluster of buttons: X-Ray Analysis, then Segment CBCT (violet cube icon), then Studio Workspace. On a lab account, Check models comes first.

Step 2 — Start the segmentation

  1. Click Segment CBCT.
  2. The first time in a browser session, the notice Experimental AI — not a clinical tool opens. Read it and click I understand — continue.
  3. The message "Sent to your computer — segmentation will start within ~20 seconds." confirms the request. Nothing is charged at this point.

Step 3 — Follow the run on the case page

The Segment CBCT button now shows where the job is:

  • Queued — waiting for your computer…: Cympha is waiting for your Agent Manager to pick up the job. If the case has not reached the computer yet, the Agent Manager waits for the next case sync and picks it up then.
  • Running on computer name…: the computer has taken the job.
  • Open in Studio and Run again: the run has finished. Go on to "When it finishes".
  • Segment CBCT with "Segmentation failed:" and the reason, or "Segmentation timed out": the run did not finish. See "If something doesn't work".

On the computer, the Agent Manager reads the scan from a DICOM subfolder of the case folder if there is one, otherwise from the case folder itself, and unpacks the .zip when there are no loose slices.

Option C — Start from the Agent Manager tray menu

  1. Right-click the Cympha icon in the Windows taskbar and choose CBCT Segmentation….
  2. In Select CBCT DICOM folder, pick the folder that holds the CBCT slices (or the folder with the zipped DICOM) and confirm. If you close the dialog without choosing, nothing starts.
  3. The run starts. Hover over the tray icon to see the stage and progress, for example "CBCT Segmentation: Packing DICOM".
  4. When it ends, a tray notice reads "CBCT segmentation finished. Open Cympha Studio to view it." Open Cympha Studio on this computer and go on to "When it finishes".

While it runs on your computer

  • The first run on a computer downloads the segmentation engine, about 311 MB, without asking. The tray icon's tooltip shows Downloading CBCT engine with a percentage, then Installing CBCT engine. Later runs start straight away. When a new engine version is released, the next run downloads it once.

  • A start notice from the tray, on computers without an NVIDIA RTX card with 8 GB: "CBCT segmentation started. On this computer it can take up to 20 minutes; you can keep working." On a computer with such a card, a run from a case page shows "Picked up a segmentation job from Cympha. Open Cympha Studio to view it when the worker finishes (≈8 min)."

  • Progress is in the tray icon's tooltip; Show window in the tray menu shows the full log.

  • Where the result goes: a folder named after the job, inside a cympha_segmentation folder:

    • for a case: in the case folder (<case folder>\cympha_segmentation\<job>\);
    • for a folder you picked: next to that folder (<parent folder>\cympha_segmentation\<job>\).

    It holds dicom.zip (the scan, packed for Studio), stage2.nii.gz (the segmentation) and labels.json (the run's details). There are no STL files here: Studio builds the models from these files. Leave the folder where it is. The Agent Manager serves it to Cympha Studio on the same computer for 7 days after the run. Cloud Monitoring does not upload these files to the case.

  • To stop a run: right-click the tray icon and choose Cancel CBCT Segmentation (greyed out unless a run is in progress). Click Yes to confirm. The partial output is discarded and nothing is charged.

Agent Manager 1.2.1 removes the segmentation software folder that earlier versions left on the computer (about 5 GB) by itself, shortly after it starts.

When it finishes: open, pay and view in Studio

Find out that it finished

Every run, whatever way it was started, is reported in several places:

  • The Agent Manager's tray notice on the computer: "CBCT segmentation finished. Open Cympha Studio to view it."
  • The notification bell in the header bar of app.cympha.com: "CBCT segmentation finished. Open Cympha Studio to view it." Click it to open Cympha Studio on this run.
  • An email to the account that started the run, with Open Cympha Studio.
  • In Cympha Studio, in any other workspace: a notice at the bottom right, CBCT segmentation finished, "The result is ready on" the computer's name. Click Open to switch to CBCT Segmentation, or Later to dismiss it.
  • On the case page (Option B): the button reads Open in Studio. On lab accounts, the case's Activity Log also reads CBCT segmentation finished. with a link to open it in Cympha Studio.

A run that stopped is reported the same way, as "CBCT segmentation failed" or "No computer picked up the segmentation", and in Studio as CBCT segmentation did not finish.

Open the result

Open it on the computer that ran the segmentation, with its Agent Manager running:

  • from Studio's notice: Open;
  • from a case page: Open in Studio (Studio opens in a new tab);
  • from the bell or the email: click it;
  • or open Studio and switch to CBCT Segmentation yourself. With Studio already open in this workspace, the panel moves on by itself.

The panel then goes through these stages on its own:

  1. Fetching the result from the Agent: progress per file, then "Loading the CBCT…". Studio clears the scene first, so models loaded earlier are removed, and loads the CBCT as if you had opened it with Open DICOM….
  2. Rebuilding the models: one structure at a time, for example "Lower tooth 3 (12 of 30)", with the current step. Exports are paused meanwhile ("Exports are paused while the CBCT segmentation is being rebuilt and paid for.").
  3. Models ready: "… models rebuilt. Paying … from the Studio balance shows them." Studio takes the price from your balance straight away; the button reads Paying… while it does. Once paid, the models appear.

If the balance does not cover the run, the Studio balance window opens and the panel reads "Top up the balance, then come back to this tab: the payment is tried again." Top up there by card. When you return to the Studio tab, the payment is tried again by itself; you can also click Pay and show the models.

A case your account has already paid for is not charged again when you run it again: the button reads Show the models.

View the models

The panel reads Models in the scene and lists every model with its colour: Maxilla, Mandible, Upper jaw (closed), Lower jaw (closed), Lower nerve, and Upper tooth / Lower tooth with a number. Measuring, Show in 2D and exporting are free for this result.

  • Check against the scan: right-click a model and choose Show in 2D to see its outline on the slices, then step through the slices and compare. Use the CBCT viewer in Studio explains the slice panes.
  • The closed jaws start hidden: "The closed Upper jaw and Lower jaw models are hidden; show them from the model list." Open the model browser (the books icon in the action buttons at the right of Studio's second row) and click Show model on their rows.
  • Download all STL files, under Download the models: saves one zip with every model as STL and a manifest.json, named cbct-segmentation-case-<case number>.zip for a case, otherwise after the job.
  • Save models to the case (runs from a case page only): uploads every model as STL and a manifest.json to the case's files. Nothing is uploaded until you click it. "… files saved to the case." confirms it.
  • Done closes the panel and switches to 3D Processing; the models stay in the scene. Segment another CBCT starts over.

Open it again later

When you open CBCT Segmentation again, the panel shows Your last segmentation is paid, "Finished … on" the computer's name, "Opening it again is free.", and Open again. Click it to load the scan and the models again at no charge. This works for your most recent run, on the computer that ran it, for 7 days.

What you get

| Shown in Studio | File name (zip and case) | What it is | |---|---|---| | Maxilla | maxilla.stl | Upper jaw bone, with the tooth sockets. | | Mandible | mandible.stl | Lower jaw bone, with the tooth sockets. | | Upper jaw (closed) | upper_jaw.stl | Upper bone with the upper teeth merged in, one solid model. Hidden at first. | | Lower jaw (closed) | lower_jaw.stl | Lower bone with the lower teeth merged in, one solid model. Hidden at first. | | Lower nerve | lower_nerve.stl | The lower (inferior alveolar) nerve canal. | | Upper tooth 1, 2… / Lower tooth 1, 2… | tooth_us_01.stl to tooth_us_32.stl | One model per tooth found. |

Tooth numbers are not dental tooth numbers. Studio says so in the panel: "Teeth are numbered in order around the arch (1 = the first tooth found), not by a dental numbering system." The numbers in the file names follow the same arch order, upper teeth 01–16 and lower teeth 17–32, counted differently from the names in the panel. Identify each tooth on the scan, not by its number.

The manifest.json lists every file with its structure and display name.

One run at a time

Each Cympha account can have one segmentation queued or running at a time, across all its paired computers. While one is active:

  • on the same case, Segment CBCT shows its progress;
  • on any other case, the button shows Busy on computer name (or Segmentation in progress) and cannot be clicked;
  • a second request from a case page shows "Already running on computer name — wait for it to finish." or "Already segmenting or queued — wait for it to finish.";
  • in Studio, Segment a CBCT on this computer follows the run in progress instead: "A segmentation is already running on … ; Studio will show its result.";
  • from the tray menu, a notice reads "A CBCT segmentation is already running on computer name."

If something doesn't work

  • Studio reads "Cympha Agent Manager is not running on this computer": no Agent Manager paired to your account has checked in during the last few minutes. Follow the steps in the panel: Download the installer, pair it (tray menu: Pair to Cympha…), keep it running, then click Re-check. Set-up guide opens Device pairing: install and pair Cympha Agent Manager.
  • "The Agent on this computer could not be reached. The job ran on …": the Agent Manager is not running on the computer where Studio is open. Start it from the Start menu (Cympha Agent Manager) and click Retry, or open Studio on the computer that ran the job.
  • "The Agent on this computer does not hold this result: the job ran on …, or it is older than 7 days.": open Studio on the computer that ran the job. A result older than 7 days cannot be opened; run the segmentation again.
  • "The job finished, but the Agent did not report where the result is.": the computer runs an Agent Manager older than 1.2.1. Update it (see Device pairing: install and pair Cympha Agent Manager, "Updates") and run the segmentation again.
  • "Top up the balance, then come back to this tab: the payment is tried again.": the balance is lower than the price. Top up in the Studio balance window, or under Cympha balance on app.cympha.com, then return to the Studio tab. "The payment failed: …": click Pay and show the models again.
  • The segmentation failed: "The Agent reported: No DICOM files found in …": the folder holds no DICOM slices and no .zip. Pick the folder that holds the slice files, or attach the CBCT to the case as a single .zip of the DICOM folder. Click Try again. Nothing is charged for a failed run ("Nothing was charged.").
  • "The folder selection was cancelled in the Agent.": the Select CBCT DICOM folder dialog was closed, or the run was cancelled from the tray menu. Click Try again and start a new run.
  • "The Agent stopped reporting and the job timed out." (Studio) or "Segmentation timed out" (case page): the computer stopped, slept or lost its connection during the run, or no computer picked the job up. The bell and the email say which: "No computer picked up the segmentation" means no Agent Manager took a Studio job within 10 minutes, or a case job within 30 minutes. Check that the Agent Manager is running and paired, then start again.
  • The case page stays on Queued — waiting for your computer…: check, in order: the Agent Manager is running on the computer; it is paired to the account you are signed in with; Cloud Monitoring has a workspace folder; the case has reached that folder. The log (tray menu > Show window) says when the case folder is not on the computer yet.
  • The case has several .zip files and the run fails: with no loose slices in the case folder, the Agent Manager unpacks the first .zip it finds, which may not be the CBCT. On the computer, put the DICOM slices in a DICOM subfolder of the case folder, then click Segment CBCT again.
  • "The result could not be shown" with "The CBCT could not be loaded.", "The reconstruction failed: …" or "The label volume holds no structure to rebuild.": click Retry. Nothing is charged until the models are shown.
  • A warning under the progress, such as "The labels and the scan agree poorly (bone density check); compare the models with the scan.": Studio could not line the models up with the scan with full confidence. Check them with Show in 2D before using them.
  • "Saving to the case stopped at …" or "The download stopped at …": click Save again or Download all STL files again.
  • The tray notice reads "Not paired to Cympha": pair the Agent Manager again (Device pairing: install and pair Cympha Agent Manager).

Related

  • Device pairing: install and pair Cympha Agent Manager
  • Use the CBCT viewer in Studio
  • Cympha Studio essentials — find your way around your first time
  • Upload via Agent — case-detail upload with optional mesh fixing
  • Create a case from a cloud folder
CymphaCasesCymphaStudio