OphthoRuler Join the beta

An iPhone and Mac app for oculofacial plastic surgery research.

Capture and organise your study photographs, record depth with LiDAR, and segment faces with built-in AI models. OphthoRuler then measures MRD1, MRD2, and other common values automatically, and analyses them with comprehensive statistics for common oculoplastic research designs.

Beta · macOS 15+ and iOS 18+

Close-up of a right eye from an Unsplash portrait, with MRD1 and MRD2 drawn from the corneal centre to the upper and lower lid margins.

R Right eye 0.0566 mm/px

MRD1
2.8 ±0.4 mm
MRD2
5.2 ±0.4 mm
PFH
8.0 ±0.5 mm
WTW
11.71 ref mm
FaceMesh model, Oculoplastic core measurement set
OphthoRuler for Mac, Annotate tab: automatically placed eyelid, brow and iris landmarks on an Unsplash portrait, right eye in red and left in blue.
OphthoRuler Capture on iPhone: the same portrait measured on the phone, with per-eye MRD1, MRD2 and fissure values.

01 · Measure

Twelve measurements built in, and a visual editor for your own.

The bundled Oculoplastic core set covers the standard periocular distances, plus palpebral fissure area, lid heights, and white-to-white. Each is built from labelled landmarks, so you can read it, change it, or build your own.

  • MRD1 mm

    Margin–reflex distance 1

    Corneal centre up to the upper lid margin, on the same vertical.

  • MRD2 mm

    Margin–reflex distance 2

    Corneal centre down to the lower lid margin.

  • PFH mm

    Palpebral fissure height

    Upper to lower lid margin through the corneal centre.

  • PFW mm

    Palpebral fissure width

    Medial to lateral canthus of the same eye.

  • ICD mm

    Intercanthal distance

    Medial canthus to medial canthus.

  • IPD mm

    Interpupillary distance

    Corneal centre to corneal centre.

  • OCD mm

    Outer canthal distance

    Lateral canthus to lateral canthus.

  • Tilt deg

    Canthal tilt

    Angle of the canthal axis against the horizontal.

  • +4

    PFA · Upper lid height · Lower lid height · WTW

MRD1, as the app defines it

Measurements are defined by editable formulas.

Every measurement is two landmarks and a method. MRD1, for example, is the vertical distance from the cornea centre to the highest point of the upper lid margin directly above it. Switch from the Visual Formula Editor to the Text Formula Editor to see the same definition written as a formula. You can duplicate or edit any measurement, or share a whole set with a collaborator.

Measure tab, zoomed to the right eye: point A at the cornea centre and point B on the upper lid margin directly above it, joined by a dashed vertical line. Definition panel for MRD1 R in Visual mode: A is Cornea centre OD, the method is vertical Δ, and B is Upper lid margin OD, qualified as highest at Cornea centre OD. New measurement bar: a name field, then Point A, a method menu set to vertical Δ, Point B, an R+L toggle, and an Add button.

02 · On the Mac

From photograph to figure, in one place.

  1. 01 Design

    Plan the study before you collect a single photo.

    A step-by-step wizard helps you set up your study: pick a design, decide how to handle both eyes, plan your visits and photo series, and define your variables. Your plan is saved as version 1, and any later change is saved as a new version, so you can always see what changed.

    New study wizard on its Design step: a grid of study designs including before versus after, longitudinal, two groups, fellow-eye, normative, and reliability studies.
  2. 02 Categorise

    Organise photographs by participant and visit.

    Group photographs into participants, encounters, and photo series, tag them, and run a model across a selection. Photographs stay in the encrypted library on your Mac.

    Categorise tab listing eight participants with one baseline photograph each, and an inspector showing the selected photograph’s series, capture time, model run, and encounter.
  3. 03 Annotate

    Landmarks are placed for you, and you can edit any of them.

    On-device models trace lid margins, brows, iris boundaries, and canthi, with the right eye in red and the left in blue. Nudge a point, redraw a curve, or run a newer model: manual edits are never overwritten.

    OphthoRuler for Mac, Annotate tab: automatically placed eyelid, brow, and iris landmarks on an Unsplash portrait, with the calibration and label-group inspector on the right.
  4. 04 Measure

    Click a value to see how it was measured.

    Choose MRD1 and the view zooms to the eye, marks both points, and shows the definition beside the number and its ± uncertainty.

    Measure tab zoomed to the right eye, showing MRD1 point A at the corneal centre and point B on the upper lid margin, with a list of measurements and uncertainties.
  5. 05 Export

    Figures ready for a manuscript.

    Export a figure with the annotated photograph, cropped views of each eye, colour-coded right and left eyes, and a table of measurements with their uncertainties. You choose where the files are saved.

    Export tab showing an A4 Oculoplastics figure with the annotated photograph, right and left eye crops, and a table of measurements.
  6. 06 Compose

    Or build your own figure.

    Pick photographs, choose the crop and layout, then switch on the measurements to draw as dimension lines. Labels move where you drag them.

    Export tab in Custom mode: a preview of a periocular crop with ICD, IPD, OCD, MRD, and fissure dimension lines drawn on it, and controls for photos, layout, crop, measurements, and label style.
  7. 07 Data

    One table per study.

    Measured columns arrive locked and labelled with their source. Add your own study variables, paste from a spreadsheet, or export CSV for R.

    Data tab showing a table of measured canthal tilt, ICD, IPD, lid height, and MRD1 values for eight participants.

03 · Calibration

Every measurement records how it was calibrated.

A measurement is only as good as its scale, so every value keeps a record of how it was calibrated. On an iPhone with LiDAR or TrueDepth sensors, the scale is calculated automatically. For photos from other cameras, or from devices without a depth sensor, you can still use the cornea white-to-white or an object of known size as a reference.

  1. 01

    Default with depth

    LiDAR and TrueDepth

    The rear LiDAR scanner or the front TrueDepth camera saves a depth map with every photo. Face distance and focal length give a measured scale, with no sticker or ruler in the frame.

  2. 02

    Front camera

    Depth (3D)

    ARKit’s depth-tracked face mesh measures the face in three dimensions at capture, so the scale comes from the camera itself rather than an assumption.

  3. 03

    Any photo

    White-to-white

    The iris width is taken as the corneal diameter: 11.71 mm by default, or a value you have measured for that eye.

  4. 04

    In the frame

    Size reference

    Draw a rectangle over an object of known size in the photo and enter its dimensions.

    • Post-it 76 × 76 mm
    • 10 mm sticker
    • Coin
    • Ruler
  5. 05

    Known value

    Manual scale

    Enter millimetres per pixel directly.

iPhone Results screen showing a LiDAR depth map of a face (a colour-coded silhouette, no photograph) with the landmark overlay, calibrated from LiDAR depth, and per-eye MRD1, MRD2, PFH, PFW, PFA, canthal tilt, ICD, and OCD values.
01 LiDAR depth map
iPhone Calibration sheet on the WTW tab: the irises span 206 pixels, taken as an assumed 11.71 mm white-to-white, giving 0.0569 mm per pixel.
02 White-to-white
iPhone Calibration sheet on the Object tab, asking you to draw a rectangle over a known-size object and noting that a 2D scale is still an estimate.
03 Size reference

04 · Models

Choose the model that suits your study.

OphthoRuler is model-agnostic. Each segmentation model is a card in the Model tab, listing the landmarks it produces, the measurements that come with it, its authors, licence, and citation. Measurements reference landmark labels rather than a particular network, so the same MRD1 works whichever model placed the points.

  • Built-in

    FaceMesh

    Face and iris landmarks from a photo

    7 labels · v1.1
    Apache 2.0

  • Built-in

    LightIrisNet Pupillometer

    Pupil and iris boundaries from a visible-light photo

    3 labels · v3.0
    MIT

  • Built-in

    GazeTracking Motility

    Pupil position per gaze for the 9-gaze motility chart

    8 labels · v1.0
    MIT

  • Built-in

    Periocular-Vision

    Face landmarks from Apple’s Vision framework (fallback)

    7 labels · v1.0
    Apple

  • Soon

    Add your own model

    Package a Core ML model with its label map, licence, and citation. Share it so that other research groups can use (and cite) your model with their own studies.

  • Measurements follow labels

    Measurement sets refer to landmark labels rather than to a model. A set marked Any model works with whichever model produced those labels.

  • Authors credited on every card

    Authors, licence, model page, source repository, and paper sit beside each model, with the citation ready to copy.

  • Runs on your device

    Every model runs through Core ML on your Mac or iPhone. Photographs are never uploaded to be analysed.

Model tab: the list of four installed models (FaceMesh, LightIrisNet Pupillometer, GazeTracking Motility, and Periocular-Vision), with the FaceMesh card showing the labels it produces, its bundled measurements, authors, Apache 2.0 licence, citation, and the Oculoplastic core measurement set.

05 · On the iPhone

Capture on the iPhone, check on the spot.

On-screen guides frame the face or a single eye, photo series step through each gaze, and the landmark model runs on the phone, so you can check a capture before the participant leaves.

  • A

    Quick measurements

    Oculoplastics, levator function, pupillometer, and a 9-gaze motility panel, each with its own guide.

  • B

    Guided photo series

    Primary, up-, down-, and side gaze in order, with retakes one tap away.

  • C

    Pupillometry in light and dark

    Flash-lit pairs, then each eye again under an infrared flashlight for dark diameters.

  • D

    Edit by touch

    Drag a lid point or resize an iris and watch MRD1 or WTW update as you go.

Pupillometer camera guide on iPhone with a right eye framed inside the almond-shaped reticle and concentric iris and pupil guides.
01 Pupillometer guide
iPhone results screen with the on-device landmark overlay and per-eye MRD1, MRD2, PFH, PFW, PFA, and canthal tilt values.
02 Results on the phone
iPhone landmark editor resizing the right iris boundary with touch knobs, showing a live white-to-white readout.
03 Touch editing

06 · Analyse

Statistics that account for two eyes per participant.

Describe your study in plain language. OphthoRuler chooses a suitable model, accounts for the fellow eye, draws the figures, and drafts the methods text with every number linked to its result.

  1. 01 Design

    Start from your study design.

    Choose from ten study designs, each described by the question it answers. The model, figures, tables, and manuscript wording follow from that choice.

    Study setup, Design step: a grid of study designs, each with its research question and an oculoplastic example, with Before vs after (one group) selected.
  2. 02 Eyes

    Decide how the two eyes are counted.

    Choose how each participant’s eyes enter the analysis: both eyes in a clustered model, one prespecified eye, the affected eye, or the mean of the two. Treating every eye as an independent patient is not offered.

    Study setup, Eye strategy step: both eyes with a clustered model (recommended), prespecified single eye, affected or worse eye, and patient mean of both eyes.
  3. 03 Endpoint

    Lock your primary endpoint in advance.

    Pick the measurement, the timepoint, and the comparison for your primary endpoint, then lock it. Secondary endpoints use the same model, with optional Holm or Benjamini–Hochberg adjustment. Changing a locked plan creates a new, recorded version.

    Study setup, Data and endpoint step: MRD1 as the measurement, pre-op baseline, post-op 3 months as the primary timepoint, the primary endpoint locked, and MRD2 as a secondary endpoint with Holm adjustment.
  4. 04 Results

    Results with every participant plotted.

    The headline result is an effect estimate with its 95% confidence interval, shown alongside the model and the sample sizes. Figures plot each participant, not only the mean.

    Analyse results for the synthetic before-versus-after ptosis study: MRD1 change of 2.19 mm (95% CI 1.99 to 2.38) from a linear mixed model, a secondary MRD2 endpoint, and a paired-change plot of all 24 participants.
  5. 05 Figures

    Adjust figures to fit the journal.

    Edit titles, axis labels, point size, and palette, including the colour-blind-safe Okabe–Ito palette. Figures export as vector SVG and 300 dpi PNG.

    The Customise figure popover over the paired-change plot, with title and axis label fields, an Okabe–Ito colour-blind palette, individual points and mean marker toggles, and point size and width sliders.
  6. 06 Guidance

    Explanations written for your data.

    Warnings and notes are specific to your data. For example, canthal tilt is an angle, so it is summarised on a circle with a mean direction and a circular SD, and the app explains why.

    Normative canthal tilt analysis: a reference range with directional statistics, and guidance cards explaining clustering of both eyes, age-specific reference limits, and circular statistics for angles.
  7. 07 Tables

    Tables that count participants and eyes separately.

    Table 1 reports participants and eyes separately. Table 2 lists every endpoint with its estimate, interval, p-value, and model.

    Tables for a synthetic fellow-eye study: participant and eye-level characteristics for 20 participants and 40 eyes, and the primary outcome with its estimate and 95% confidence interval.
  8. 08 Manuscript

    Methods and results drafted for you.

    The Methods and Results are automatically drafted for you based on the selected study design, analyses, and generated results. The app lets you export everything as a report bundle with documents, figures, and tables included.

    The Manuscript pane: generated Methods and Results text for the synthetic before-versus-after study.
  9. 09 Guide

    A built-in statistics guide.

    Plain-language articles cover every model, the two-eye problem, circular statistics, reliability, diagnostic accuracy, and multiple comparisons, one click from any result.

    The built-in Statistics guide open at “Why two eyes are not two patients”, with a topic list covering study designs, models, angles, and circular statistics.

Examples of supported study designs

Each design ships with a Sample Study of synthetic data, so you can explore the study design before collecting any real data.

  • Built around your design

    Pick one of ten study designs, from before-and-after to diagnostic validation. The analysis follows from your question.

  • Estimates with intervals

    Every result is an effect estimate with a 95% confidence interval, not only a p-value.

  • Plain-language warnings

    The app flags small samples, unlocked endpoints, and data leakage, and says why.

  • Checked against R

    Mixed models, ICC, Bland–Altman, ROC, and risk models are cross-validated against reference R implementations.

07 · Privacy

Your data stays on your devices.

There is no OphthoRuler server. The developers never see your photographs, participants, or numbers.

  • On-device models

    AI models are run locally on your Mac or iPhone using Core ML. No image is uploaded to the internet to be analysed.

  • End-to-end encrypted

    Photographs and study records are encrypted with AES-256-GCM using a password only you know.

  • No internet connection needed

    All photos, AI models, and statistical analyses are carried out locally on your iPhone and Mac.

  • Local-network sync

    Mac and iPhone pair by QR code and sync over your own network, encrypted in transit. No cloud.

  • Metadata stripped

    EXIF, GPS, and maker notes are removed on capture and import. A face is still identifiable, so this reduces risk but does not de-identify a photo.

  • No accounts

    You own your data. Your data and photos are never uploaded anywhere by OphthoRuler. All data is stored locally on your iPhone and Mac by default.

Research use only

OphthoRuler is Research Software.

OphthoRuler is experimental research software. It has not been submitted for medical-device authorisation, is not certified against any privacy or health-data standard, and can be wrong.

  • Do not use it to diagnose, screen, monitor, treat, or plan care for anyone.
  • Check every value it produces before you rely on it or publish it.
  • Ethics approval, consent, and data protection for your study remain yours to obtain.
Read the disclaimer and terms

06 · Questions

Common questions.

Who is OphthoRuler for?

Researchers in oculoplastics, ophthalmology, and facial anthropometry who photograph eyes and need consistent, reproducible periocular measurements and a sound way to analyse them.

What do I need to run it?

A Mac with macOS 15 or later for annotation, measurement, export, and analysis, and optionally an iPhone with iOS 18 or later for guided capture. The two sync directly over your local network.

How accurate are the measurements?

The app reports every value with a propagated ± uncertainty and records how it was calibrated. Accuracy depends on calibration, head pose, lens and focus, and the landmarks themselves. It also depends on the quality of the segmentation, whether from the AI model you chose or from landmarks you edited by hand. Check the output, and edit landmarks where the model is wrong. As new and improved AI models are developed, they can be installed and used within OphthoRuler.

Is OphthoRuler for clinical use?

No. OphthoRuler is not a medical device and must not be used to diagnose, screen, monitor, or plan treatment. We built OphthoRuler to facilitate research studies in oculoplastic surgery. It is your responsibility to obtain REB/IRB approval to use OphthoRuler in your studies.

Where is my data stored?

Only on your own devices, encrypted with your password. There is no cloud service and no developer access. Exports go only where you save them. This also means that if you lose your password we are unable to help you recover your data. Make sure you keep multiple backups in various formats and locations.

Can I add my own measurements or models?

Yes. Measurements are built from landmarks in a visual editor (with a text view of the underlying formula) that you can inspect, duplicate, and edit, and measurement sets can be imported and exported. Bundled models ship with their licences and citations; adding and sharing your own models is coming during the beta.

How do I get it?

OphthoRuler is in beta. Join the waitlist below and tell us a little about your research. We will be in touch as places open.

Try it on your next study.

Beta · macOS 15+ and iOS 18+

Join the beta waitlist

Tell us a little about your research. We open places in small groups and will email you when yours is ready.