Trinetra Tutorials

Create a case, segment the heart, explore it in 3D

Short walkthroughs that follow one congenital heart disease case from the casebook, through segmentation in Trinetra Segment, to an interactive model in Trinetra Studio, then on to virtual imaging, virtual surgery, implant planning and a finished report. Each part has a short video, then step-by-step screenshots. Click any screenshot to open it full size.

Casebook→Segment→Studio→Plan→Report
Segmented heart in Trinetra Segment, each chamber and great vessel in its own colour

Part 1 · Casebook · ~3 minutes

Creating a case in the Trinetra casebook

Slow stretches such as typing are sped up. A red badge in the corner shows the speed.

Every patient case in Trinetra starts in the casebook. A case holds the case details, its imaging files and its stage in the workflow. Everything stays on this computer ("Local only — nothing leaves this device").

Step 1Create a new case

New case
  1. Click Casebook in the top menu.
  2. Click New case, the gold button at the top right.
  3. A blank untitled case appears at the top of the list, and a New case added message confirms it.

Step 2Fill in the case details

Case details and stage
  1. Fill in the case details:
    FieldWhat to enter
    ReferenceAny identifier you use: MRN, hospital number, study ID, etc.
    TitleA short, recognisable name, e.g. "John Doe – CHD Case"
    DiagnosisThe working diagnosis. "TBD" is fine for now
    ProcedureThe planned procedure, e.g. "Surgical Repair of Defect"
    DateDefaults to today
  1. Click the Stage dropdown to set where the case is in the workflow: New → Segmenting → Planned → Discussed → Operated → Archived. New cases start at New. Stages are for your own tracking. Move a case along as it progresses, and use the Stage filters in the sidebar to see what's at each point.

Step 3Create a project

Name the project

Projects group related cases, for example by hospital, study or surgeon.

  1. Click + New project in the left sidebar.
  2. Type a name, e.g. "Cases at my Hospital".
  3. Click Save.
Project created
  1. The new project appears under Projects.
  2. A Project created message confirms it.

Step 4Put the case in the project

Assign project
  1. Go back to your case. Open the Project dropdown and choose your project instead of Unfiled.

Step 5Add tags, notes and files

Tags and notes
  1. Tags: comma-separated keywords, e.g. CHD, Surgical. Tags become filter chips at the top of the casebook.
  2. Notes: the plan, MDT discussion or outcome, e.g. "For Surgery – Needs Model".
  3. Files: drag and drop reports, letters and other documents onto the box so they're kept with the case. You can also click choose them to browse. Dragging and dropping is quickest.

Step 6Check the case

Case listed under its project
  1. Click your project in the sidebar to see only its cases.
  2. The case header shows the reference, title, stage, project and tags.
  3. New tags appear as filter chips (#CHD, #Surgical). Click one to filter the list.

Step 7Open the case for segmentation

Case actions

Scroll to the bottom of the case for its actions:

  1. Open in Studio: view the case's 3D model.
  2. Open in Segment: segment the scan in Trinetra Segment. Click this now.
  3. Duplicate / Export this case.
  4. Delete case.
Starting Trinetra Segment
  1. Trinetra shows Starting Trinetra Segment… while it launches. This can take up to a minute.
Trinetra Segment

Trinetra Segment opens in its own window, running on 3D Slicer.

  1. The four tabs show the workflow: 1 Import → 2 Segment → 3 Cardiac Cycle → 4 Complete.
  2. You start on Import. Continue with Part 2 — Segmenting a cardiac case.

Part 2 · Trinetra Segment · ~10 minutes

Segmenting a cardiac case in Trinetra Segment

Slow stretches such as typing are sped up. A red badge in the corner shows the speed.

Trinetra Segment runs inside 3D Slicer and opens from the casebook (Open in Segment, see Part 1). Work left to right through the tabs: 1 Import → 2 Segment → 3 Cardiac Cycle → 4 Complete. The 3D model updates live in the right-hand panel.

Step 1Import the scan

Import tab

On the 1 Import tab, pick how to load the scan:

  1. Import DICOM folder: for a folder of DICOM files straight from PACS.
  2. Open NRRD / MHA volume: for a single volume file. This example uses one.
Choose the file
  1. Select the scan file.
  2. Click Open.

Step 2Check the scan and move to Segment

Scan loaded
  1. Active scan now shows the loaded scan.
  2. The axial, coronal and sagittal views show the CT.
  3. Click the 2 Segment tab.

Step 3Threshold the blood pool

Threshold preview

The Guided workflow buttons at the top follow the order of the page: Threshold → Islands → Split masks → Paint.

  1. Drag the left end of Threshold range until the contrast-filled blood pool is covered. You can also type the values into Minimum HU and Maximum HU.
  2. Preview threshold shows the result without saving it.
  3. The green overlay shows what's included. Aim to fill the chambers and vessels without leaking into the surrounding tissue.
Apply threshold
  1. When the range looks right (about 1470 HU and up in this example),
  2. click Apply threshold.

Step 4Separate the bones

Bone question
  1. Trinetra asks "Are the bones important for this segmentation?"
    • Yes: opens the Bone separation panel. Bone is split off into its own Chest wall mask, so you can show it alongside the heart. This example uses Yes.
    • No: skips the panel and goes straight to the Islands tool. Click the heart and Trinetra keeps it, plus anything connected to it, and removes the rest.
Bone separation

In the Bone separation panel, separate bone from the blood pool. Bone that touches the heart may still be attached:

  1. Use Islands on Blood pool: click the heart in a slice view to keep it and drop disconnected bone.
  2. Use Scissors: cut away bone that's still attached (next step).
  3. All bones are removed — create Chest wall: click once the heart is clean. The removed bone is kept as a separate Chest wall mask.
  4. Check the 3D view as you go.
Scissors
  1. With Scissors active,
  2. draw a loop around the unwanted part in the 3D view to cut it away. Rotate the model and repeat as needed. Undo is Ctrl+Z.
Clean blood pool
  1. The blood pool now shows only the heart and great vessels.

Step 5Name the splitting masks

Splitting masks
  1. Type the structures you want, separated by semicolons. For example: RA; RV; LA; LV; Ao; PA.
  2. Leave Initial blood-pool / editable-area mask set to Blood pool.
  3. Click Create named splitting masks.

Step 6Paint a seed on each structure

Painting RV
  1. Choose a mask in Paint this splitting mask, e.g. RV.
  2. Click Start painting, then paint a short stroke inside that chamber. You can paint in a 2D slice or directly on the 3D surface.
  3. Click Next mask and repeat for each structure.
  4. Paint settings: brush diameter, spherical brush, and whether painting directly in 3D is allowed.
  5. Your stroke shows on the model in the mask's colour.

Step 7Apply the split

Apply split
  1. Once every mask has a stroke, click Apply split.
  2. Trinetra grows each stroke to fill its whole structure.
Split result
  1. Each structure is now its own coloured segment (RA, RV, LA, LV, Ao, PA).
  2. Rotate the 3D view to check the boundaries. If a region went to the wrong structure, paint more on the correct mask and click Apply split again.

Step 8Complete and send to Studio

Next: complete
  1. Scroll to the bottom of the Segment tab and click Next: Complete and send to Studio.
Complete tab
  1. Check the Case name. It's filled in from the casebook.
  2. Leave Include an audit summary in the Studio report ticked to keep a record of the segmentation steps. Patient identifiers aren't logged.
  3. Click Complete segmentation for Trinetra Studio.
Save package
  1. The save dialog opens in the case's own casebook folder.
  2. Name the file.
  3. Click Save.
Saved
  1. Trinetra confirms where the case was saved. It exports each segment as an STL, plus a label map and the source CT, then opens the result in Trinetra Studio. Continue with Part 3 — Visualising in Trinetra Studio.

Part 3 · Trinetra Studio · ~5 minutes

Viewing and manipulating the model in Trinetra Studio

Slow stretches such as typing are sped up. A red badge in the corner shows the speed.

When you click Complete segmentation for Trinetra Studio (end of Part 2), the case opens in Trinetra Studio with every structure loaded as its own 3D model.

Step 1The Studio screen

Studio opens
  1. CT slice views: axial, sagittal and coronal.
  2. The 3D model.
  3. The tool bar: View, Imaging, Virtual imaging, Measure & mark, Edit history, Virtual surgery, Plan, Implant, Report, Share.
  4. Save project saves everything you change in this part.

Step 2Switch to a 3D-only layout

CT layout menu
  1. Click the CT menu in the toolbar.
  2. Choose 3D only to give the model the whole screen. Choose Four-up to bring the CT views back.
3D only
  1. The Masks tab on the right lists every structure (Blood pool, Chest wall, RA, RV, LA, LV, Ao, PA).
  2. Each structure has its own card: colours, show/hide (eye icon), delete, clipping, anatomy palette and opacity.
  3. The model fills the view.

Step 3Fade the chest wall

Chest wall colour
  1. On the Chest wall card, click the External colour swatch.
  2. Pick a colour. A neutral grey works well for bone.
Chest wall opacity and clipping
  1. Click Clipping on so it changes to Clipping ignored. The chest wall then stays whole when you cut into the heart later.
  2. Drag Opacity down (about 50%) so you can see through the ribs.

Step 4Colour each structure

Anatomy palette

For each structure (RA, RV, LA, LV, Ao, PA):

  1. Click the External swatch to pick any colour, or
  2. choose a preset from Anatomy palette (Blood pool, Myocardium, Arterial vessel, Venous vessel, Valve / fibrous tissue, Fat, and others).

Step 5Jump to standard views

Views tab
  1. On the Views tab, click A / P / S / I / R / L to snap to anterior, posterior, superior, inferior, right or left.
  2. The orientation cube in the bottom corner always shows which way you're facing.
  3. Show views & clipping opens the floating Saved Views and Clipping panel.

Step 6Clip into the heart

Clipping
  1. Click Clipping off to turn it to Clipping on. A cutting plane slices through the model.
  2. Drag Depth to move the plane deeper or shallower.
  3. Follow view: the plane stays facing you as you rotate. Lock plane: it stays fixed so you can rotate around the cut.

Because the chest wall is set to Clipping ignored, the ribs stay whole while the chambers are opened up.

Step 7Save named views

Name a view
  1. Set up the angle you want, then type a name, e.g. "Anterior With Chest Wall".
  2. Click Save view.
Saved views
  1. Each saved view keeps the camera, clipping and visibility, with a thumbnail. Click one to jump back to it.
  2. Update all pictures refreshes the thumbnails.

Step 8Add notes

Notes
  1. Open the Notes tab.
  2. Type case notes, e.g. "Double Arch". Notes are saved in the shared file alongside the meshes.

Step 9Lighting and effects

Background and light

On the left View panel, under Background & light:

  1. Backdrop: Dark, Slate or White. White suits figures and posters.
  2. Ambient and Headlight set overall brightness and the light from the camera.
  3. Ghost the cut-away: shows clipped-away parts as a faint ghost. Ghost sets how faint.
Cinematic shading
  1. Cinematic shading gives more realistic lighting, with Translucency and Environment sliders.
Torch
  1. Torch adds a side light (Strength, Azimuth, Height). Lower the headlight and raise the torch to bring out surface detail.

Step 10Save the project

Save project
  1. Click Save project to keep colours, views, clipping and notes with the case.

Part 4 · Advanced tools · ~12 minutes

Virtual imaging, virtual surgery and implants

Slow stretches such as typing are sped up. A red badge in the corner shows the speed.

These tools live in the left tool bar of Trinetra Studio. The flyout next to the 3D view gives one-click access to the same tools (Endoscope, Measure, Annulus, Scissor, Sculpt, Surface path, Route) plus Undo last edit.

Step 1Fly through with the virtual endoscope

Endoscope panel
  1. Click Virtual imaging in the left tool bar.
  2. Click Place endoscope figure, then click a point on the model's surface. Hide any structures in the way first, using the eye icon on their mask card.
  3. Click Enter figure to look out from that point.
  4. To follow a vessel, choose an imported centreline and step along it with Previous point / Next point.
Inside view
  1. You're now inside the anatomy. Drag to look around, and scroll or use the arrow keys to move forward and back. Click Exit (top of the view) or Exit figure to leave.

Step 2Simulate an echo with the echo probe

Echo probe
  1. Open Echo probe, then click Place probe on a surface and click where the probe should sit.
  2. Adjust the beam:
    • Standoff: lifts the probe off the surface, for the gap between chest wall and heart.
    • Tilt, Sweep and Rotate: aim the fan.
    • Sector: widens or narrows the fan.
    • Depth: how far the beam reaches.
  3. The inset shows the simulated echo cut: every visible mesh as a white-on-black line trace.
  4. Flip 180° turns the probe around. Face sector to me squares the fan to the screen. Save sector image saves the inset.

Step 3Cut with the scissor

Scissor
  1. Click Virtual surgery in the left tool bar.
  2. Or pick Scissor in the flyout.
  3. Choose what the cut does: Remove the region, Keep only it, or Split off into a new mask.
  4. Draw a loop around the region. The cut goes straight through along your line of sight, so rotate to the angle you want first. Undo cut or Restore all if needed.

Step 4Draw a surface path and build a patch

Surface paths
  1. Pick Surface path in the flyout.
  2. Draw on inside surfaces: off, points land on the outer wall. On, they land on the inner surface, inside a chamber.
  3. Click Start surface path (or Freehand) and click points on the surface. After three points the first turns green. Click it, or Close loop, to close the outline.
Patch built
  1. Under Patch from loop, set Rings, Dome height, Dome direction (outward/inward) and Thickness, then click Build patch. The patch appears as its own mask (e.g. patch 1).

Step 5Excise a wall on a virtual copy

Excise
  1. Under Virtual surgery, select a mask and click Copy selected mask for visual editing. The original is kept. Optionally Create wall shell to give the copy a wall thickness.
  2. Click Start excision outline, click points around the area, then Close outline and Excise visible surface. Only the frontmost visible triangles are removed.
  3. The edited copy appears as a new mask, e.g. PA (virtual surgery), marked cut.
Patch over the opening
  1. Draw a surface path around the opening and Build patch to close it. Here a patch is placed over the opened pulmonary artery.

Step 6Plan a conduit route

Route and conduit
  1. Click Plan in the left tool bar.
  2. Or pick Route in the flyout. Click Start route, click a start point (e.g. on the aorta), then Add destination and click the end point (e.g. on the PA). Add guide points to shape the path. Preview path shows it, and you can drag the purple points to adjust.
  3. Set the conduit's Outer diameter. The panel shows the inner opening and wall.
  4. Click Create sealed visual conduit. The conduit is added as its own mask.

Step 7Generate an implant

Implant generator

Click Implant, then Open implant generator. The Cardiac Implant Generator opens in its own window.

  1. Browse device families (surgical valves, TAVI, TPVR, stents, occluders, rings) or search by manufacturer or model.
  2. Pick a Size. Geometry is shown with its source: LIT (published), CALC (calculated) or ASSUMED.
  3. Click Add to active Studio project. The device appears in Studio next to the model.

Step 8Fit annulus rings and align the implant

Annulus points
  1. Pick Annulus in the flyout. Click Place annulus points and click points around the implant's rim (five is enough, more gives a better fit), then Fit current ring. Repeat on the target anatomy, e.g. the PA.
Align centrepoints

Under Annulus alignment:

  1. Mesh to move: the implant.
  2. Ring on mesh to move: the implant's annulus.
  3. Target annulus: the anatomy's annulus (e.g. PA Annulus · PA).
  4. Click Align centrepoints. The implant jumps to the target.
Fine tune
  1. Fine-tune under Move & join: Pos X/Y/Z and Rot X/Y/Z sliders, or Spin around the implant's own axis with Turn −/+. Choose Fix an annulus point while turning to pivot around the ring.

Part 5 · Report · ~6 minutes

Reporting a case

Slow stretches such as typing are sped up. A red badge in the corner shows the speed.

The Report panel turns the case into a structured report: case details, captured figures, findings and plan, plus an optional sequential segmental analysis and the segmentation audit trail.

Step 1Open the Report panel and fill in the case details

Report panel
  1. Click Report in the left tool bar.
  2. Fill in Case title, Reference / MRN (optional) and Prepared by.
  3. Under Figures, you'll caption and capture views (next step).
  4. Findings and Plan come later.

Step 2Capture figures

Captured figures
  1. Set up the model as you want it in the report. Click a saved view on the Views tab to jump straight to it.
  2. Type a caption in Caption for the next figure, then click Capture this view. Each figure is listed with its thumbnail and caption, and you can edit or remove it.
  3. Your saved views from Part 3 are a quick way to get consistent angles.

Step 3Write findings and plan

Findings and plan
  1. Findings: what the anatomy shows, e.g. "Double aortic arch case needing surgical repair".
  2. Plan: the proposed approach, e.g. "Surgical repair and arch reconstruction".
  3. Include measurements: adds measurements from Measure & mark to the report.
  4. The report tools:
    • Open report workspace: preview the report beside the 3D scene.
    • Sequential segmental analysis: build a structured description (Steps 5–6).
    • Segmentation audit log: the record of every segmentation step.
    • Save report as PDF: export an A4 PDF.

Step 4Preview the report

Live preview
  1. Click Open report workspace. The Live preview tab shows the report as it will print.
  2. The other tabs: Saved views, Captured views, Sequential analysis and Segmentation audit.
  3. The report lists every structure (anatomy), then Findings, Plan and Figures. It updates as you edit.

Step 5Sequential segmental analysis

Wizard

Click Sequential segmental analysis. It walks you through an Andersonian analysis one segment at a time.

  1. The steps on the left: cardiac position, venous connections, atrial segment, AV junction, ventricles, arterial trunks. Completed steps get a tick.
  2. Each step explains what to look at.
  3. Click the card that matches the anatomy, e.g. Apex to the left. Open Embryology — why this morphology occurs to learn more.
Dropdown questions
  1. Some steps ask direct questions, e.g. which ventricle each atrium drains into.
  2. Trinetra works out the connection label for you, e.g. Derived connection: Concordant. Use Next → to move on, or Skip — I don't know.

Step 6Add the analysis to the report

Full report
  1. Click Full report to see the result.
  2. The sequential segmental description is written out in full, e.g. Apex to the left · Usual arrangement · Concordant · Concordant.
  3. Likely diagnosis (pattern match) suggests the best-fitting pattern with a confidence level.
Append to report
  1. Tick Include in report and click Append description + schematic.
  2. The checkbox confirms it's included.
  3. A schematic drawing of the chambers and great arteries is generated and added to the report.

Step 7Check the audit trail and save

Audit in preview
  1. Back on Live preview, the report now includes the sequential analysis and the Segmentation activity audit: every segmentation step with its time. Patient identifiers are not logged.
  2. Segmentation audit log opens the full log on its own.
  3. Click Save report as PDF to export the finished report.

Trinetra runs locally. Nothing leaves this device. For research and education only, not for diagnosis or treatment decisions.