User guide
How to use SpineUI
SpineUI helps you see and understand scoliosis: a 3D spine you can bend and explore, tools to measure and compare, and a place to keep your numbers. This guide explains every part, what to expect from it, and what it cannot do.
Quick start
- 1Open the 3D spine
Go to the Spine Workspace. A sample curve is already there. Drag to turn the spine, scroll or pinch to zoom, right-drag or two fingers to pan.
- 2Change the curve
Use the left panel: pick a pattern, then move the Cobb angle and rotation sliders. The model, the labels and the summary update as you go.
- 3Understand it
Open the Guide tab on the right for a step-by-step explanation in plain language, or the Anatomy tab to click the parts of the spine.
- 4Keep or share it
Press Save Configuration to keep it in your browser, the download button for a picture or PDF, or the share button for a view-only link.
Spine Workspace
OpenThe main page: an interactive 3D spine you configure, explore and explain. Everything else in SpineUI builds on it.
How to use it
- Choose a Curve Pattern (single, double, thoracic, lumbar, thoracolumbar, or Custom).
- Set the Cobb angle (0–100°), the side it bulges toward, and the vertebral rotation (0–60°) for each curve. If a curve is lopsided, move Share above the apex (see Uneven curves below).
- Turn the model with the mouse or touch, or use the Front, Side, Rear and Free 3D buttons above it.
- Read the Live Curve Summary on the right, or step through the Guide tab.
- Press Save Configuration to keep the spine in this browser. Reset puts everything back to the defaults.
What is in it
- Curve patterns
- Presets for the common patterns. Double curve adds a secondary curve that is kept anatomically compatible with the primary one.
- Custom curves
- Build any number of curves over any range of vertebrae (C1 to S1). Edits are held until you press Apply Changes; Reset discards them. Show/hide and focus work immediately. The first curve is always the primary one.
- Kyphosis and lordosis
- Seen from the side, the spine curves front to back: kyphosis in the upper back and lordosis in the lower back. The Front-to-back curves section has a slider for each (kyphosis 10–90°, lordosis 10–80°). They start at typical values (38° and 54°), so leave them alone if you only care about the sideways curve. Press View from the side to see the change, and Typical values to go back.
- Choose the apex
- In a Custom curve, the Apex setting lets you pick the vertebra where your curve is most displaced, as on your report. The curve is then built around it. Left on Automatic, the apex is the middle vertebra between the two end vertebrae. The apex has to lie between the end vertebrae, not on one of them.
- Uneven curves
- Real curves are often lopsided: for example 40° of a 70° curve above the apex and 30° below. The Share above the apex slider decides how the Cobb angle is divided. It starts at an even bend, and you can set 30–70%. The total stays the Cobb angle, and the Summary shows the angle drawn above and below the apex. Press Even split to go back. At the default, the two halves can differ by a few degrees, because the middle vertebra is not always exactly halfway.
- Live Curve Summary
- For every curve: Cobb angle, side, rotation, end vertebrae, apex, how far the apex sits from the centre line, and a general size label.
- Overlays
- Cobb annotations (end-plate lines and angle labels), level labels, and reference lines (the centre sacral vertical line and the C7 plumb line). Turn them on or off in the Layers panel.
- Anatomy layers
- Vertebrae, discs, spinal cord, nerve roots, pelvis, muscles and a translucent head. Show only what you want to look at.
- Hover and click
- Hover a vertebra to see its name, tilt and rotation. Click anything to select it and read about it in the Anatomy tab.
- Save and reset
- Save Configuration stores the spine in this browser. The unsaved working spine is kept for the browser session, so other pages see it too.
- TipOn a phone, the viewport is at the top; scroll down for the panels.
- TipEsc clears the current selection.
- Keep in mindThe model is a generic procedural spine, not your own anatomy.
- Keep in mindAngles you enter are drawn as given; the engine does not check whether they are medically plausible together.
- Keep in mindThe kyphosis and lordosis numbers are the model's own and close to, but not the same as, the clinical measurements. Vertebrae are not drawn wedge-shaped, so conditions such as Scheuermann's disease cannot be shown.
Anatomy Explorer
OpenThe Anatomy tab on the right. Click any structure to learn what it is and how the configured curve affects it.
How to use it
- Open the Anatomy tab, or just click a vertebra, disc, cord, nerve roots, pelvis, head or muscles in the 3D view.
- Read its description. Use the up and down arrow keys to step to the vertebra above or below.
- Press Isolate to fade everything else, or Focus to fly the camera to it.
What is in it
- Details per structure
- Plain-language notes on what each part does and what changes inside a curve, such as rotation, wedging and nerve-root position.
- Isolate
- Fades every other structure so you can look at one part by itself.
- Focus
- Moves the camera to frame the selection; the selection chip in the viewport has the same button.
Explain My Curve (Guide tab)
OpenA guided tour of the spine on screen. Each step explains one thing and moves the camera to it.
How to use it
- Open the Guide tab on the right.
- Press Next to move through the overview, each curve, balance, and questions to ask your care team.
- Press Copy summary to put a one-paragraph description on your clipboard.
What is in it
- One step per curve
- Where the curve runs, which way it bulges, what the Cobb angle means, how rotation shows up (for example a rib prominence) and a general size description.
- Balance step
- Whether the head sits over the pelvis from the front, and how the spine compensates above and below a curve.
- Questions to ask
- A short list to take to an appointment.
- Keep in mindIt describes the model on screen. It never diagnoses, predicts progression or advises treatment.
Treatment Simulation
OpenAn illustration of what a spine with a given amount of correction looks like in a brace or after fusion surgery.
How to use it
- Open the Treatment tab and choose Brace or Surgery.
- Brace: set the in-brace correction. A translucent shell and pressure pads appear on the convex side.
- Surgery: choose the upper and lower instrumented levels (or Fit to primary curve), set the correction, and pedicle screws and rods appear.
- Read the Before → after list. Press Off (or the × on the amber chip) to go back to the configured spine.
What is in it
- How it works
- The curves are shrunk by the percentage you choose and the normal spine engine redraws everything. Nothing else is guessed.
- What a brace reaches
- A standard thoracolumbar brace is treated as reaching curves whose apex is at T7 or lower; higher curves are left as they are, and the panel says so.
- What surgery reaches
- Curves are corrected in proportion to how much of them lies inside the instrumented levels.
- Keep in mindNot a prediction. Real results vary widely between people and treatments.
- Keep in mindThe brace correction is a percentage you choose, and the brace shell is a generic drawing: a real brace's outline and trimlines differ with the curve and between orthotists.
- Keep in mindThe simulation is never saved, shared or included in a link.
Save a picture or a PDF
OpenThe download button above the 3D view.
How to use it
- Set up the view you want (angle, layers, overlays).
- Press the download button and choose Save image (PNG) or One-page report (PDF).
What is in it
- PNG
- A high-resolution picture of the current view with a short caption of the curve numbers.
- PDF report
- One page: the 3D view, a curve table, balance numbers and, if you keep records on the dashboard, a Cobb history chart. Fictional demo records are never included.
- TipBoth are made on your device; nothing is uploaded.
- TipThe same save-image button is on the Compare page.
Share a spine (view-only link)
OpenSend someone a link that opens your spine in a viewer where they can turn it around and read the curves.
How to use it
- In the workspace, press the share button above the 3D view.
- Optionally add a title (do not put a name in it).
- Press Copy link, or Share… on a phone, and send it.
- They open it, look at it, and can open their own editable copy. Your original is never changed.
What is in it
- Serverless
- The spine is encoded in the link after the # sign, which browsers never send to any server. Nothing is stored and there is nothing to delete.
- What is in a link
- Only the curves: end vertebrae, Cobb angle, side, rotation and the above/below-apex split, the chosen apex, and the kyphosis and lordosis if you changed them, plus the optional title. No records, notes or names.
- The viewer
- Front, Side, Rear and Free 3D views, auto-rotate, a list of curves, and a button to open a copy in the workspace.
- Keep in mindAnyone with the link, and anyone they forward it to, can read the numbers.
- Keep in mindA link cannot be taken back. To stop sharing, stop passing it on.
Compare
OpenPut two spines side by side to see what differs, for example an earlier and a later visit.
How to use it
- Open Compare. It starts with your earliest and latest dashboard entries.
- Pick spine A and spine B from the menus (dashboard dates, the current workspace spine, or the saved one). Swap them with one click.
- Choose Side by side, Overlay (B as a violet ghost over A) or Morph (slide or play from A to B).
- Read What differs for the Cobb angle change per curve and the shift of the C7 centre line.
- Press the download button for a picture.
- TipAdd your own entries on the Patient Dashboard to compare real dates. Until then it shows the fictional sample entries.
- Keep in mindTwo measurements of the same X-ray commonly differ by about 3–5°, so small differences may not be real change.
- Keep in mindDashboard entries carry no rotation data, so none is drawn for them.
- Keep in mindMorph is a picture of the difference, not what happened in between. Nothing here predicts progression.
Cobb Tool
OpenMeasure a Cobb angle yourself on an X-ray image. You place the lines; the tool does the arithmetic.
How to use it
- Open the Cobb Tool and choose an image (JPG, PNG or WebP). It is shown on your device only.
- Click two points along the top end plate of the upper end vertebra, then two points along the bottom end plate of the lower end vertebra.
- Drag any circle to fine-tune. Scroll to zoom in, drag the background to pan, and use brightness, contrast and invert to see the end plates better.
- Choose the end vertebrae, and check which side the curve bulges toward (it is suggested from the tilt of the lines; you can override it).
- Press Measure another curve for more, then View on the 3D spine or Add to my records.
What is in it
- Side suggestion
- The end-plate lines converge toward the inside of the curve, which tells the tool which way it bulges. A switch handles flipped images.
- Use the result
- Send the measurements to the 3D workspace as curves, or add them to your dashboard as a user-entered self-check.
- Keep in mindThis tool is temporarily under maintenance and will be back soon.
- Keep in mindIt does not find vertebrae or analyse the image. The result is exactly as good as where you place the lines.
- Keep in mindMeasuring from a photo or screen is less accurate than a clinical reading. Your clinician's number is the one that counts.
Exercises
OpenSeventeen general movements for mobility, posture, strength and balance, performed on a 3D figure.
How to use it
- Pick a movement from the list on the left (grouped by Mobility, Posture, Strength and Balance).
- Press play or Space. Drag the timeline to scrub, and change the speed.
- For one-sided movements, choose Left or Right in the details panel.
- Change the camera (Front, Side, Rear, Free 3D), the figure, and Skin or X-ray.
- Read the steps, the typical amount and the cautions on the right.
What is in it
- Your posture
- Apply my configured posture shapes the figure's trunk from the spine in the workspace. Show my spine inside draws it in the X-ray body.
- Planted feet
- Squats sink, heel raises rise and a lifted knee leaves the other leg in place, so the figure stays grounded.
- Keep in mindGeneral demonstrations, not a treatment plan. Scoliosis-specific exercise is individual: a trained physiotherapist chooses the movements, side and cues for a particular curve.
- Keep in mindStop and seek advice if a movement causes pain, numbness, tingling, dizziness or breathlessness.
Walking Lab
OpenA rigged human walking, with the trunk shaped by your configured spine.
How to use it
- Open the Walking Lab and press play, or press Space.
- Pick a clip (walk, upright walk, jog), a figure and a speed.
- Turn on overlays for pelvis tilt, trunk lean, shoulder rotation or foot contacts, and read the live charts.
- Turn Posture on or off to compare the figure with and without the configured spine's shape.
- Keep in mindLeg movement is a generic animation. It illustrates general walking mechanics and is not a gait assessment or a prediction.
My Spine Scan
OpenRead the measurements written in a report or image, check them, and see them on the 3D spine.
How to use it
- Upload a PDF or image of a report (it is read on your device; nothing is uploaded).
- Review Measurements: the extracted values are shown beside the document. Correct anything wrong and confirm each value.
- Explore in 3D: apply the confirmed values as a new configuration, to the current one, or cancel.
- TipNo document? Choose manual entry and type the numbers from your report.
- Keep in mindOnly values you confirm are used. It reads text that a clinician wrote; it does not analyse X-ray pictures. To measure an image yourself, use the Cobb Tool.
Patient Dashboard
OpenA private log of measurements and symptoms over time, with charts and a summary for appointments.
How to use it
- Press New entry. Add a date, the Cobb angles you were told, symptoms (0–10) and notes.
- Filter by date, region or source. Open an entry to edit it, mark it clinician-verified, or View in 3D.
- Press Appointment summary to print or download a one-page summary.
- Start empty record when you want to replace the fictional sample data with your own.
What is in it
- User-entered vs verified
- Everything you type is user-entered. An entry can be marked clinician-verified with the clinician's name and reference. Verified values are drawn filled and connected; user-entered ones hollow and unconnected.
- Charts
- Cobb angle by region over time and symptom history. Editing the clinical values of a verified entry removes its verification.
- Keep in mindIt records what you type. It does not interpret trends or give medical advice.
Your data, backup and privacy
Where your information lives and how to move it.
How to use it
- Press the backup button in the header (the drive icon).
- Download backup (.json) saves your saved spine and your records in one file.
- To restore, choose a backup file, tick what to restore, and confirm. The page reloads with the restored data.
What is in it
- Local only
- Everything is stored in your own browser. There are no accounts and no uploads. Documents and images are read on your device.
- Backup file
- Imports are checked field by field before anything is written, so a damaged or foreign file is rejected.
- TipClearing site data or using a different browser or device starts you from empty. Back up first.
- Keep in mindThe backup file is not encrypted. Keep it somewhere private.
Glossary
- Cobb angle
- The standard measure of a sideways curve: the angle between the top of the upper end vertebra and the bottom of the lower end vertebra. Larger means more curved.
- End vertebrae
- The top and bottom vertebrae of a curve, the ones tilted most toward its inside.
- Apex
- The middle of a curve. On a real X-ray it is the vertebra (or disc) displaced furthest from the centre line. SpineUI takes the vertebra closest to the midpoint between the two end vertebrae, so it can differ by a level or two from a clinician's reading. In a Custom curve you can choose the apex yourself.
- Share above the apex
- How a curve's Cobb angle is divided between the part above the apex and the part below it. An even curve is 50 / 50; a lopsided one might be 57 / 43, for example 40° above and 30° below on a 70° curve. In SpineUI you set it with a slider (30–70%), and the apex is the middle vertebra between the end vertebrae unless you choose it in a Custom curve.
- Kyphosis
- The forward rounding of the upper back, seen from the side. A larger angle means a rounder upper back. In SpineUI you can set it with a slider; the typical value is 38°.
- Lordosis
- The inward curve of the lower back, seen from the side. In SpineUI you can set it with a slider; the typical value is 54°.
- Convex / concave
- A curve bulges toward its convex side. The inside of the curve is the concave side. Sides are given from the patient's point of view.
- Vertebral rotation
- The twist of vertebrae around the spine's long axis. In the chest it turns the ribs too, which can show as a rib prominence. In SpineUI it is a number you set (the peak twist at the apex, 0–60°), not a clinical grade or a scoliometer reading: those measure different things.
- R and L
- The small R and L in the 3D view mark the person's right and left. From the front, their right is on your left, the way an X-ray is shown. The Rear view flips it.
- Primary and secondary curves
- The primary (main) curve is usually the largest. Secondary curves often form above or below it as the body keeps the head centred.
- Thoracic, lumbar, thoracolumbar
- The chest (T1–T12), lower back (L1–L5) and the junction between them (around T12–L1).
- Coronal balance
- How far the base of the neck (C7) sits to the side of the centre of the pelvis, seen from the front.
- CSVL
- The centre sacral vertical line: a vertical reference line through the middle of the sacrum.
- Instrumented levels
- In a spinal fusion, the vertebrae that are fixed with screws and rods.
Questions
›Is this a medical tool?
No. It is an educational prototype that helps you see and understand terms and shapes. It does not diagnose, predict how a curve will change, or recommend treatment.
›Does it use my real spine?
No. The 3D spine is a generic model that is bent to the numbers you give it. It is not a reconstruction of your own anatomy.
›Where is my data?
Only in your browser. Nothing is sent to a server. A share link carries its numbers inside the link itself, and only when you create and send one.
›I lost my data.
Data lives in one browser. Clearing site data, a private window, or another device starts empty. Use the backup button to keep a copy.
›The 3D view does not load.
You need a browser with WebGL. Try a current Chrome, Edge, Safari or Firefox, close other heavy tabs, and reload. On very old phones the 3D may be unavailable; the written panels still work.
›Why does a comparison show a small change?
Two Cobb measurements of the same X-ray commonly differ by about 3–5°, so small differences may be measurement variation, not a real change.
›Why is the apex different from my report?
SpineUI puts the apex at the vertebra closest to the middle between the two end vertebrae you choose. A real curve is often not symmetric, and a clinician may name a disc, so the answer can differ by a level or two. Your clinician's reading is the one that counts. To match your report, use a Custom curve and set the Apex to the level your report gives.
›What do the rotation numbers mean?
The peak twist of the vertebrae at the apex of a curve, in degrees, set with a slider. It is the model's own value and does not convert from a clinical grade (such as Nash-Moe) or a scoliometer reading.
›My curve is not symmetric. Can I show that?
Yes. In the curve settings, move Share above the apex. At 50% the Cobb angle is split evenly around the apex; at 57%, a 70° curve has about 40° above the apex and 30° below. The total stays what you entered. It is kept in share links too.
›Can I use it for kyphosis or Scheuermann's disease?
Partly. You can set the kyphosis (the rounding of the upper back) and the lordosis (the curve of the lower back) with sliders, and look at the spine from the side. SpineUI does not draw wedge-shaped vertebrae, which is what defines Scheuermann's disease, so it can show a rounder back but not the cause. It is still an educational model, not a clinical one.
›Can I use it with my clinician?
Yes, as a way to talk about what you are looking at. Bring the one-page report, and always rely on your clinical team for measurements and decisions.
Ready to try it?
Open the 3D spine