Iridology Toolkit Academy

Module 1 · 8 min

Orientation & setup

You will be able to

State what the toolkit is for, and what it is not
Activate a licence and move through the scan workflow
Use the desktop shortcuts

What the toolkit is

The Iridology Analysis Toolkit captures images of both eyes and measures pupil and iris features: pupil-to-iris ratio, pupil shape and position, collarette (ANW) position, and local deformations of the pupil margin. It overlays historical iridology charts and produces PDF, text, JSON and Excel records.

It is a research and educational tool for trained practitioners. It is not a medical device, and no regulator (FDA, CE, TGA or equivalent) has cleared it for diagnosis. Every number it produces is an observation you interpret. You make the clinical decisions.

Licensing

Tier	Duration	Machines
Trial	14 days or 20 analyses, full features	1
Standard	1 year	1
Professional	Lifetime	1
Enterprise	Lifetime	Multiple

On Windows, paste your key into License Key and click Activate. Activation needs an internet connection once, to bind the key to the machine. After that the app runs offline.

The scan workflow

Licence checkPatient informationCamera mode selectorRight eye (OD)Left eye (OS)ANW wizardResults

The patient form asks for name, age and sex. Main complaints and the clinic name are optional. Age matters more than it looks: the age-normalised pupil comparison needs it. The clinic name is remembered between sessions.

Desktop shortcuts

Key	Action
`F11`	Toggle fullscreen
`Ctrl` + `H`	Open scan history
`Esc`	Go back or close a dialog

The settings icon in the title bar is available on every screen. It holds the therapy-module switches, the clinic name, language (29 languages) and PDF options.

PrivacyPatient names, images and scan records stay on the device. Licence validation sends only the licence key and activation status. When you export or share a report, your local privacy law (HIPAA, GDPR and so on) applies to that copy.

Which statement best describes the toolkit?

A cleared medical diagnostic device
A research and educational tool whose findings the practitioner interprets
An automated treatment planner
A cloud service that stores scans remotely

The toolkit is not a medical device. Its measurements are observations, and the practitioner makes the clinical decisions.

Module 2 · 14 min

Capturing great images

You will be able to

Choose the right camera source for the situation
Read the quality gate's feedback
Frame and light an eye so the measurements hold up
Import phone or archive photos correctly

Almost every questionable result traces back to the image. Two minutes spent on the capture saves you from interpreting a measurement of glare, eyelash or the wrong circle.

Capture order

The toolkit captures the right eye (OD) first, then the left eye (OS), which is the usual clinical notation. Analysis needs both eyes.

Camera sources

Source	Use it when
Quality-gated rear / front camera	Phone or tablet. This is the recommended mobile mode, because it rejects bad frames automatically.
Manual camera	You need to control the shutter yourself, you're using a macro attachment, or unusual lighting makes the gate reject good frames
USB / UVC iriscope	Dino-Lite or a compatible iriscope, on Windows or on Android over USB OTG
Import from gallery	Re-analysing archived photos, or images taken elsewhere

The quality gate

In quality-gated mode every frame is checked against five criteria at once. When all of them pass, the border turns green and the photo is taken automatically.

Criterion	Must be	Catches
Sharpness	≥ 100	Motion blur, missed focus
Brightness	30–230 of 255	Under- or over-exposure
Contrast	≥ 30	Flat, detail-less frames
Pupil confidence	≥ 30%	No detectable pupil (blink, off-target)
Centre offset	≤ 25% of frame	Eye not centred

RED at least one criterion is failing, so read the message. AMBER borderline, so make a small adjustment. GREEN everything passes and the photo is taken.

Using an iriscope

On Windows, install the DNVideoX driver before you connect a Dino-Lite for the first time.
Work at about 2–3 cm from the eye (Dino-Lite AM4115ZT).
Use the built-in LED ring. Extra lamps add corneal reflections.
Adjust the zoom slider until the pupil margin is sharp. The margin is what the deformation and P/I measurements depend on.

Capturing with a phone

Hold the phone upright (portrait) and let the eye fill the frame. A wide landscape strip leaves the iris detector very little room to search: in testing, detection confidence fell from about 0.81 in portrait to 0 in a very wide crop of the same eye.

Importing photos

Imports open a 4:3 cropper. Crop tightly around the eye so the iris takes up a good share of the frame. An arm's-length phone photo with a small iris in the middle cannot be rescued by enlarging it, because the detector looks for the iris edge at a set fraction of frame width. Cropping changes that fraction. Scaling does not. The app copies the imported file into its own folder, so your original is never changed.

Do

Ask the patient to fix their gaze on a distant point
Brace your hand or the device
Shift a little to move corneal reflections off the pupil margin
Let the iris fill at least half the frame width
Use the same device and distance at every visit

Avoid

Overhead lights reflecting in the cornea
Pre-cropping phone photos into wide strips
Switching to manual mode just to get past a gate that is right
Mixing devices or framings in one patient's timeline

TrickIf the gate stays amber on brightness with an iriscope, change the angle slightly rather than turning the LEDs down. The LED ring's reflection is usually what's saturating the frame.

The quality gate turns green. What happens next?

You press the shutter
The photo is taken automatically
The app switches to manual mode
Analysis starts on the live preview

Green means all five criteria pass, and the photo is taken automatically.

An arm's-length phone photo shows a small iris in the middle of a wide frame. What should you do?

Upscale the image before importing
Crop tightly around the eye in the 4:3 cropper
Import it unchanged, because the ML model corrects for it
Convert it to black and white

The detector looks for the iris at a fraction of frame width. Cropping changes that fraction. Rescaling does not.

Module 3 · 16 min

Reading the measurements

You will be able to

Interpret P/I ratio, ellipseness, decentration and anisocoria against their bands
Grade FLAT and PROT zone findings
Read the ANW ratio and the hybrid confidence score

Pupil: Dark centre. The teal line is its diameter.
Collarette: The ANW, drawn in amber here as it is in the app's chart overlay
Limbus: Outer edge of the iris. The bottom line is the iris diameter.

A schematic, not to scale. Every ratio below divides one of these diameters by the iris diameter, so the numbers don't depend on image size.

P/I ratio (pupil ÷ iris × 100)

P/I	Label
< 15%	Miosis (very constricted)
15–19.9%	Constricted
20–29.9%	Normal (adult, indoor light)
30–39.9%	Dilated
≥ 40%	Mydriasis (very dilated)

Pupils get smaller with age, so the results also compare against an age band (adults 18–39 expect about 4.5–5.5 mm, 60 and over about 3.5–4.5 mm). That comparison only appears if age was entered.

Try it: P/I and anisocoria

Enter diameters in pixels for each eye. The example values are made up. Edit them to see how the bands change.

OD · right

Pupil ⌀ px Iris ⌀ px

OS · left

Pupil ⌀ px Iris ⌀ px

Anisocoria (|OD − OS| in P/I points):

Zone findings: FLAT and PROT

The pupil margin is checked zone by zone for places where it departs from a circle. FLAT means the margin is pulled inward at that zone. PROT means it bulges outward.

Deviation	Severity
< 1.5%	Not reported
1.5–2.9%	Within limits
3.0–5.9%	Mild
6.0–9.9%	Moderate
≥ 10%	Significant

ANW (collarette) ratio

ANW ratio	Status	Traditional reading
< 25%	Spastic	Ring drawn inward, sympathetic dominance
25–35%	Normal	Balanced tone
> 35%	Atonic	Ring expanded, parasympathetic dominance

The difference between the two eyes' ANW ratios is normal up to about 5%. When one eye reads Spastic and the other Atonic, the app flags a Functional Frustration pattern.

Pupil shape, position and symmetry

Metric	Flag when	Notes
Ellipseness (minor ÷ major axis)	< 95%	The form is reported as horizontal, vertical or diagonal oval, chord-like or irregular
Decentration (offset ÷ iris radius)	≥ 5%	Direction (nasal, temporal, frontal, basal…) and angle in degrees clockwise from 12 o'clock
Anisocoria (\|OD − OS\| P/I)	≥ 2% mild · ≥ 4% moderate · ≥ 8% severe	From moderate upward, the app raises a TBI reference flag. It is a research reference, not a diagnosis.

Hybrid confidence

Each eye goes through two independent pipelines: classical computer vision and an ML model. The confidence score combines capture quality, how well the classical pipeline found the boundaries, and how closely the two agree. Above 80%: the pipelines agree and the image is good. Below 50%: treat the result with caution and recapture if you can.

HabitCheck confidence before you read anything else. If it is low, do not interpret the numbers that follow. Retake the image.

Know the limitP/I depends on framing. The same eye cropped more tightly can read several points higher. Compare P/I only between images taken the same way, with the same device, distance and framing. That applies to anisocoria as well, since it is the difference between two P/I values.

The FLAT deviation in one zone is 7.2%. What severity is that?

Within limits
Mild
Moderate
Significant

Moderate is 6.0–9.9%. Mild is 3.0–5.9%, and Significant starts at 10%.

Hybrid confidence is 42%. What is the best next step?

Report the findings as usual
Treat the result with caution and recapture if possible
Turn off the ML panel
Skip the PDF

Below 50% means caution. The best response is a better image.

Module 4 · 9 min

The ANW Velchover wizard

You will be able to

Explain why local ANW patterns need your confirmation
Work through the six screens, or skip them for the right reasons

After analysis, and before the results appear, the wizard shows you the local collarette patterns the app detected in each sector. Detection on its own is noisy: 88.9% of automated geometric detections were false positives. That is why the report uses only the patterns you confirm.

The six screens

Screen	Pattern category	Clock range
1	Drawing-out, right AND left	10:30–1:30
2	Drawing-out, right iris only	10:30–1:30
3	Drawing-out, left iris only	10:30–1:30
4	Drawing-out, right OR left	Several ranges
5	Drawing-in, right OR left	Several ranges
6	Flattening, right AND left	10:30–1:30

Each screen shows both eyes with radial guide lines and a neutral circle. The collarette the app fitted is deliberately left off these screens so it doesn't steer your judgement. Chips come pre-ticked from the detector; tap to change them. Rules stop you from selecting patterns that contradict each other.

When to skip

On the first screen, Skip records an empty confirmation list, so no Velchover patterns go into the report. Skip when glare or poor focus makes the collarette impossible to judge. If one eye's collarette wasn't detected at all, the wizard doesn't appear.

Do

Look at the image yourself before you accept a pre-ticked chip
Keep screens 1 and 6 separate in your mind: same clock range, opposite deviations
Skip rather than guess on a poor image

Avoid

Clicking Next through every screen without looking
Wording findings as "indicates…". The app and report say "historically linked to…".

Good to knowBefore the ANW analysis runs, glare at the pupil margin is filled in automatically. That analysis uses the corrected image, but exports and PDFs always use your original photo.

Why doesn't the wizard draw the fitted collarette on its selection screens?

It is too slow to render
So the automated result doesn't bias your judgement
Because the collarette is always wrong
It is drawn only on Android

Only neutral guides are shown, so you judge the image rather than the detector's output.

Module 5 · 12 min

Visual tools & chart overlays

You will be able to

Choose the right visual tool for a question
Fit a historical chart to a patient's eye and add structured findings

Image tools on the results screen

Tool	Use it to
Enhance (CLAHE)	Bring out crypts, lacunae and fibre texture without blowing out bright areas
3D Relief	See bright raised fibres as ridges and crypts as valleys. Drag to rotate, scroll to zoom.
Heatmap	See where pigment is concentrated: heterochromia sectors, a darkened ciliary zone
Annotate	Draw on the iris. Undo, Clear, and Save PNG (saved as `Annotated_<Name>_<date>`).
Visual Compare	View OD and OS side by side. Mirror OD turns both nasal sides inward. Sync Pan links zoom and pan.
Gabor / LBP	Texture maps for fibre orientation and stroma pattern (research use)
Research tab	Unwrapping, crypt and furrow detection, SSIM, GLCM and more. Every detection there is a suggestion for you to verify.

Historical chart overlays

Eight authors are available: Velchover, Angerer, Bourdiol, Gunther, Jausas, Roberts, Jensen and Vida-Deck. Organ names appear in the app language. Open Chart shows one eye; Bilateral Chart shows both under the same chart.

Control	What it does
Auto-fit	Sizes the chart to the detected iris automatically
Scale slider (0.3×–2.0×)	Fine-tune the chart size
Opacity slider	Fade the chart so you can see the iris underneath
ANW ring slider	Move the amber collarette ring onto the collarette you can see
Warp to eye / chart	Warp to eye (the default) bends the chart's pupil, collarette and limbus rings onto this patient's anatomy, so the drawn borders match the zone under the cursor. The toggle resets to warp to eye each time the dialog opens.

With warp to eye on, nothing is drawn inside the patient's pupil. That is intentional, because there is no zone there.

Recording a finding with the Anomaly Picker

Tap a zone → open Add Finding → choose the anomaly type and, if there is one, a subtype → Add to Notes. The finding goes into Observer Notes as [OD] [Zone] Type › Subtype and then into the PDF and text reports.

TrickIf the chart looks off, align the ANW ring to the visible collarette first, then adjust scale. With warp on, the ring is one of the three anchor points the chart is bent to.

What does Mirror OD do in Visual Compare?

Swaps the eye labels
Flips the right-eye image so both nasal sides face inward
Mirrors the chart overlay only
Rotates the image 180°

This is the standard orientation for comparing the two eyes.

Module 6 · 10 min

Reports, history & therapy panels

You will be able to

Find, reopen and export past scans
Set up the PDF and the optional therapy modules
Add a constitutional type

Scan history

Every analysis is saved automatically when the results screen loads, so there's no save button. Open history with Ctrl+H or the Scan History button. From there you can reopen a record, regenerate its PDF, export the whole history to Excel, or open the Serial Timeline, which charts OD/OS P/I, ellipseness and confidence across one patient's visits.

Exports

Format	Best for
PDF	The full report: photos, metrics, zones, ANW, notes, constitution, therapy, disclaimers
TXT	Pasting into an EHR or an email. No photos or therapy sections.
JSON	Research pipelines and databases
Excel	The whole scan history, one row per scan

PDF settings: include images (on by default), clinic name banner, report language (follows the app language) and auto-save PDF (off by default).

Therapy panels

The herbal, nutrition (7-colour diet), chiropractic (spinal segments) and TCM (Five Elements) modules are all off by default. Switch them on in Settings. A panel appears only when a zone finding of Mild or higher points to an organ system, and the most severe zones are listed first.

SafetyHerbs can interact with medications. Always review the patient's current medications and history before acting on an herbal suggestion. Each panel's disclaimer is printed in the PDF as well.

Constitutional type (optional)

On the Both Eyes Captured screen, scroll down to the amber "Constitutional Type (Optional)" panel and pick one of the 34 types, grouped as Lymphatic, Hematogenic, Mixed, Connective Tissue, Neurogenic and Cardio-Pathological. A constitutional panel then appears in the results and the PDF. A constitution describes a tendency, not a disease, so only choose one if you have constitutional training.

You switched on the Herbal module, but no herbal panel appears after a scan. What is the most likely reason?

The database is missing
No zone finding reached Mild severity
Herbal panels only appear in TXT exports
Your licence tier doesn't include them

Panels appear only when a finding of Mild or higher points to an organ system.

Module 7 · 10 min

Checking and correcting the borders

You will be able to

Read each eye's border status and know when to open the editor
Correct the limbus, pupil and collarette, and know what each correction changes
Tell a legitimate correction from wishful editing, and know how corrections are reported

Why the borders matter

Every measurement rests on three borders found on each eye: the pupil, the limbus (the outer edge of the iris) and the collarette (ANW). The P/I ratio, the ANW ratio, the chart fit and the zone findings are all measured from them, so a border on the wrong edge makes every finding built on it wrong too. A retake does not help an eye that the detector always misses. Correcting the border does.

The automatic analysis also checks itself: if less than 75% of the traced pupil outline sits on a real edge, the eye is reported as Pupil could not be measured instead of as a confident wrong number. Correct the borders and analyse again, and that eye usually measures.

The border check on the capture page

Once both eyes are captured, the section Pupil, limbus and collarette (optional) shows an OD borders and an OS borders button. Detection runs in the background and each button shows its result. The check is optional and never blocks Analyze.

Button shows	What to do
Detected	All three borders were found. You can still open it to check.
Check recommended (amber)	The limbus fit is weak or the pupil outline could not be traced. Open it and check.
Collarette not found	Pupil and limbus are fine, but the ANW would read Not measurable. Trace the collarette by hand.
Adjusted (green)	You corrected this eye. The × beside it (Use automatic borders) discards your changes.

Three borders, three different rules

Border	Your correction	What follows from it
Limbus	Replaces detection	Iris size, the P/I ratio and the placement of the iris chart are taken from your circle.
Pupil	Only a starting point: the app traces the real outline from your circle	The pupil's shape (ellipseness, deformation) is still measured from the image. If the outline cannot be traced, size and centre come from your circle and the shape is reported as Not measured, never as round.
Collarette	Replaces detection, and every point is used exactly as placed	The ANW ratio and form findings are measured from your trace, and the ANW card shows a Placed by hand badge.

Working in the editor

Choose the border with the Limbus, Pupil and Collarette chips (on desktop, Tab cycles through them). The readout shows the live P/I ratio, or the ANW % while the collarette is selected.
The limbus circle is coloured by the edge beneath it: green = clear edge, amber = faint, red = no edge. Red at the top and bottom is normal where the eyelids cover the iris. Fit the limbus to the side edges and let it run under the lids.
Fit through points: tap at least 3 points spread around the visible edge and the circle is fitted through them.
Pupil: place the circle on the true dark edge, not around a light reflection. Reflections on the pupil edge are the most common reason an outline will not trace.
Collarette: a ring of 12 points, one per clock hour, starts on the collarette the app found or, if none was found, 30% of the way from the pupil edge to the limbus. Drag points onto the edge and add points where you need detail. At least 6 must remain.
If the result looks implausible (the pupil outside the limbus, a P/I ratio outside 10–80%, or the collarette outside the iris), you are asked to choose Accept anyway or Keep editing.

Tracing collarette shapes

Pulling a single point inward makes a smooth dip about 60° wide, and the analysis reads it as a constriction of that zone. An indentation needs a sharp valley: trace each notch with points close together on either side of its deepest point. Follow the real edge all the way round, because the form findings come from the collarette's shape, not only its average size.

Dark-brown eyes

On dark-brown irises the app finds the pupil in the red colour channel, where brown pigment is brightest, and the collarette search retries in red when the edge is too faint. Where the collarette is still too faint, the button shows Collarette not found. That is the case the hand trace was built for.

Corrections are always reported

Whenever a border was adjusted by hand, a Borders adjusted by hand note appears on the results card, in the PDF and in the text export, stating which borders were placed and whether the pupil shape was measured. The Excel export from scan history has OD Borders and OS Borders columns, and the circles and trace are saved with the scan.

The ruleCorrect a border that is visibly on the wrong edge. Never move a correctly detected border towards the result you expect: every finding is only as reliable as the borders it is measured from.

You move the pupil circle in the border editor. What does the app do with it?

Replaces the detected pupil with your circle exactly
Uses it as a starting point and traces the real pupil outline from there
Ignores it unless you also move the limbus
Uses it only to place the iris chart

The pupil circle is a seed, so the shape is still measured from the image. Only when the outline cannot be traced do size and centre come from your circle, and then the shape is reported as Not measured.

Module 8 · 8 min

Best habits, tips & troubleshooting

A routine for every scan

Fill in age as well as name. Without it you lose the age-normalised comparison.
Set up the room: dim the overhead lights and ask the patient to fix on a distant point.
Capture OD, then OS, the same way: same device, distance and zoom.
Look at the confidence score before anything else. Below 50%, retake.
Go through the ANW wizard properly, or skip it on purpose.
Fit a chart, add findings with the Anomaly Picker, and check the Observer Notes.
Export the PDF. The history record is already saved.

Troubleshooting

Symptom	Likely cause	Fix
Gate never turns green	Glare, blur or an off-centre eye	Read the red message, change the angle, brace your hand. Use manual mode only if the lighting is genuinely unusual.
Imported photo fails, or the P/I looks odd	The iris is too small in the frame, or the image is a wide strip	Crop tightly in the 4:3 cropper. Enlarging the image doesn't help.
P/I jumps between visits	Different framing or device	Standardise the capture before you read it as a real change
ANW wizard didn't appear	One eye's collarette wasn't detected	Recapture with less glare near the pupil margin
Chart borders don't sit on the anatomy	The ring or scale is off, or warp is set to chart	Switch to warp to eye, align the ANW ring, then adjust scale
Therapy tab missing	The module is off, or no finding reached Mild	Check Settings. No panel is the right result when nothing qualifies.

Tips from the field

Question findings that disagree with what you see. If the app reports something your own reading doesn't support, look at the capture and the fitted rings before you believe either one.
Treat the timeline as serious data. It's only as reliable as your consistency from visit to visit, so keep the same device, distance and zoom for each patient.
Use Mirror OD with Sync Pan in Visual Compare to scan both eyes for symmetry quickly.
Annotate before you export. A saved PNG with the lacuna circled explains a finding faster than a paragraph.
Enhance, then Heatmap: CLAHE shows the structure, and the heatmap shows the pigment on top of it.

A patient's P/I rose 6 points since the last visit, which used a different phone. What should you do first?

Report a significant change
Recapture with the original device and framing before reading it as a change
Lower the P/I thresholds
Delete the older scan

P/I depends on framing, so standardise the capture before you trust the difference.

Final exam · 40 questions · pass mark 80%

Final exam

Forty multiple-choice questions covering all eight modules. Answer every question, then submit to see your score and an explanation for each answer. You can retake it as often as you like, and your best score is saved in this browser.

Answered Pass mark 32 / 40

In what order does the toolkit capture the eyes?

Left (OS), then right (OD)
Right (OD), then left (OS)
Either order
Only one eye is needed

Right eye first, then left, which is the usual clinical notation. Analysis needs both eyes.

What P/I ratio is considered normal for an adult in indoor light?

10–20%
20–30%
30–40%
40–50%

20–29.9% is Normal. Below 20% is Constricted and 30% or more is Dilated.

An ANW ratio of 22% is classified as:

Atonic
Normal
Spastic
Functional Frustration

Below 25% is Spastic, 25–35% is Normal, and above 35% is Atonic.

At what anisocoria level does the TBI reference flag appear?

≥ 1%
≥ 2% (Mild)
≥ 4% (Moderate)
Only ≥ 8% (Severe)

The flag is raised from Moderate (4%) upward. It is a research reference, not a diagnosis.

Which of these is NOT one of the quality gate's five criteria?

Sharpness
Brightness
Iris colour
Centre offset

The gate checks sharpness, brightness, contrast, pupil confidence and centre offset.

What is the recommended working distance for a Dino-Lite AM4115ZT iriscope?

About 0.5 cm
About 2–3 cm
About 10 cm
About 30 cm

About 2–3 cm from the eye, using the built-in LED ring.

How should a phone be held to capture an eye?

Landscape, with the whole face in view
Portrait (upright), with the eye filling the frame
Landscape, cropped to a wide strip afterwards
Either way, with digital zoom at maximum

Portrait framing gives the iris detector its full search range. Very wide crops can make detection fail.

What does "88.9%" refer to in the ANW wizard?

Its minimum confidence
The false-positive rate of automated detection alone
The share of patients with normal ANW
The pass mark

This is why the report uses only the patterns you confirm.

Pupil ellipseness is 92%. What does the app report?

Normal: essentially circular
A pupil form anomaly
Anisocoria
Decentration

95% or above is normal. Below 95% is flagged as a form deviation.

From what decentration level is the pupil position flagged?

≥ 1%
≥ 5%
≥ 15%
≥ 25%

Below 5% is within normal limits. From 5% the direction and angle are reported.

A PROT deviation of 11% is graded as:

Mild
Moderate
Significant
Not reported

10% or more is Significant.

Where is patient data stored?

On CNRI servers
In a cloud backup
Locally on the device only
On the licence server with the key

Everything stays on the device. Licence validation sends only the key and activation status.

Where does a finding added with the Iris Anomaly Picker go?

A separate log file only
The Observer Notes, prefixed [OD] or [OS], and then into the reports
The Excel export only
Nowhere until you confirm it in the wizard

It is appended to Observer Notes with an eye prefix and included in the PDF and text reports.

What does "Warp to eye" in the chart overlay do?

Stretches the photo to fit the chart
Bends the chart's pupil, collarette and limbus rings onto the patient's anatomy
Rotates the chart to 12 o'clock
Switches between OD and OS

It is on by default, so the drawn borders match the zone the lookup names.

What is the best first step when a result has hybrid confidence below 50%?

Interpret it as usual
Recapture the image if you can
Raise the thresholds in Settings
Export only the TXT report

Low confidence means the pipelines disagree or the image is poor, so a better capture comes first.

When do the therapy panels appear?

Always, for every scan
When the module is on and a zone finding is Mild or higher
Only for Professional licences
Only when a constitutional type is chosen

The modules are off by default. When switched on, they are driven by qualifying zone findings.

Where do you choose a constitutional type?

On the patient information form
On the Both Eyes Captured screen
In the ANW wizard
In Settings → Language

The optional amber panel is on the Both Eyes Captured screen, below the two images.

How do you save a scan to history?

Press Ctrl+S
Export the PDF
Nothing: it is saved automatically when results load
Tick "save" in the patient form

Every completed analysis is saved to the local database automatically.

You want to compare a patient's P/I across visits. Which habit matters most?

Always using the highest zoom
Capturing with the same device, distance and framing each time
Enhancing with CLAHE before analysis
Using gallery import only

P/I depends on framing, so comparisons are only valid between images captured the same way.

What is the correct wording for a confirmed Velchover pattern in a report?

"This indicates liver disease"
"Historical studies according to Velchover linked this pattern to…"
"Diagnosis: …"
"The software has detected…"

The toolkit avoids the word "indicates". Findings are historical associations, not diagnoses.

When do you check and correct an eye's borders?

After analysis, with the Annotate tool on the results screen
On the capture page, after both eyes are captured and before Analyze
In Settings, before the first capture
Only from scan history, after the scan is saved

The OD borders and OS borders buttons appear once both eyes are captured. Correcting before analysis means every measurement is taken from the corrected borders.

An eye's border button shows Check recommended in amber. What does that mean?

The eye cannot be analysed until you fix it
The image is not an eye
The limbus fit is weak or the pupil outline could not be traced, so open the editor and check
You have already adjusted this eye

Amber is advice, not a block: the border check is optional and never stops Analyze. A corrected eye shows Adjusted in green.

You place the limbus circle by hand. What happens to it?

It replaces detection: iris size, the P/I ratio and the chart placement are taken from your circle
It is only a hint, and the detector searches again near it
Only the chart overlay uses it
Only the PDF report changes

The limbus correction replaces detection outright, so everything that depends on the iris border follows your circle.

Why does a hand-placed pupil circle not simply replace the detected pupil?

The pupil changes size too quickly to draw
A drawn circle would erase the pupil's real shape, so the app traces the outline from your circle and still measures ellipseness and deformation from the image
The pupil is not used in the P/I ratio
Only the limbus can be edited

If your circle became the pupil, every corrected pupil would be perfectly round and its shape findings would vanish. The circle tells the app where to look, and the image supplies the shape.

The editor says the pupil outline can't be traced from where you placed the circle. How is the pupil's shape reported?

As perfectly round
Copied from the other eye
As Not measured, with size and centre taken from your circle
The analysis is cancelled

A shape that was not measured is never reported as round. Size and centre still come from your circle, so the P/I ratio is available.

The limbus circle is drawn red at the top and bottom. What should you do?

Shrink the circle until it is green all the way round
Nothing special: the eyelids cover the iris there, so fit the circle to the side edges and let it run under the lids
Retake the photo
Switch to the Pupil chip

Red means no edge was found under that part of the circle, which is expected where the lids cover the iris. The side edges are rarely covered, so fit to those.

On a dark-brown eye the ANW reads Not measurable and the button shows Collarette not found. What is the right move?

Accept that the ANW can never be measured on brown eyes
Choose a different chart author
Select the Collarette chip and trace the collarette by hand
Retake the photo with the LEDs turned off

The collarette edge is often too faint to detect on dark-brown irises, even after the red-channel retry. Your trace replaces detection, and the ANW card then shows Placed by hand.

You want the analysis to record an indentation of the collarette. How do you trace it?

Pull one point inward
Place points close together on either side of the notch's deepest point
Delete the points around the notch
Shrink the whole ring

One pulled point makes a smooth dip about 60° wide, which reads as a constriction. An indentation needs a sharp valley, so pin the notch with close points on both sides.

How does someone reading a report know that a border was placed by hand?

They can't: corrections are silent
Only the operator sees it, on screen
The images are watermarked “edited”
A Borders adjusted by hand note on the results card, PDF and text export, a Placed by hand badge on the ANW card, and OD/OS Borders columns in the Excel export

Every finding that rests on a person's placement is labelled as such, so a reader can always tell measured borders from placed ones.

When is a manual border correction not appropriate?

The limbus circle sits on the pupil edge
The pupil outline wraps around a light reflection
The borders sit on the right edges, but you expected a different P/I ratio
The collarette was not found on a dark-brown iris

Correct borders that are visibly on the wrong edge. Moving a correctly detected border towards the result you expect turns a measurement into an opinion.

A patient's name is entered but their age is left blank. What do you lose?

The scan history record
The age-normalised comparison
The ability to capture the left eye
The PDF export

The age-normalised pupil comparison needs the patient's age, so fill it in as well as the name.

How should the room be set up before capturing?

Overhead lights on full and the patient looking at the lens
Overhead lights dimmed and the patient fixing on a distant point
All lights off and the screen at full brightness
A bright window behind the patient

Dim the overhead lights and ask the patient to fix on a distant point, then capture each eye the same way.

What should stay the same when you capture OD and then OS?

Nothing, each eye is independent
Only the device
Device, distance and zoom
Only the zoom

Capture both eyes the same way, with the same device, distance and zoom, so the two sides can be compared fairly.

The quality gate never turns green. What do you do first?

Switch straight to manual mode
Restart the app
Read the red message, change the angle and brace your hand
Raise the zoom as far as it goes

The usual causes are glare, blur or an off-centre eye. Read the message, change the angle and brace your hand. Use manual mode only if the lighting is genuinely unusual.

An imported photo fails, or its P/I looks odd. What is the fix?

Enlarge the image first
Crop tightly in the 4:3 cropper
Convert it to black and white
Import it twice

The iris is usually too small in the frame, or the image is a wide strip. Cropping tightly fixes it. Enlarging the image does not.

The ANW wizard didn't appear for a scan. What is the likely cause?

One eye's collarette wasn't detected
The scan history is full
The chart overlay is set to Jensen
The PDF hasn't been exported yet

The wizard needs a detected collarette. Recapture with less glare near the pupil margin.

The chart borders don't sit on the anatomy. What do you try?

Recapture both eyes at once
Change the PDF layout
Delete the older scan
Switch to warp to eye, align the ANW ring, then adjust the scale

Either the ring or the scale is off, or warp is set to chart. Switch to warp to eye, align the ANW ring, then adjust the scale.

The Therapy tab is missing on a result. What should you check?

Whether the scan was exported to PDF
Whether the patient's age was entered
Whether the module is on in Settings, and whether any finding reached Mild
Whether the chart overlay is open

The tab is hidden when the module is off or no finding reached Mild. If nothing qualifies, no panel is the right result.

The app reports a finding that doesn't match what you can see. What is the best response?

Trust the app, it is a measurement
Trust your own reading and ignore the app
Look at the capture and the fitted rings before believing either
Delete the scan and start again

Question findings that disagree with what you see. Check the capture and the fitted rings before you believe either the app or your own reading.

What is the quickest way to scan both eyes for symmetry in Visual Compare?

Mirror OD with Sync Pan
Export both images and overlay them by hand
Run the Heatmap on one eye only
Switch the chart to Velchover

Mirror OD with Sync Pan lines the two irides up and moves them together, so any asymmetry stands out.

This course teaches how to operate the Iridology Analysis Toolkit. The traditional associations it mentions are historical interpretations, not diagnostic claims. The toolkit is a research and educational tool, not a medical device.