The PDF report is the primary export format. It is generated on-device using the `pdf` package and saved to the device’s Documents folder (or shared directly on mobile).
**How to generate**
On the analysis results screen, tap the **PDF** button (printer icon). A progress indicator appears while the document is assembled, then a confirmation snackbar is shown with the saved file path.
On mobile, an additional **Share** button sends the PDF directly to any app that accepts files (email, cloud storage, messaging apps).
**Report contents (in order)**
| Section | Contents |
|———|———|
| Header | Report title, app version (v5.3.0), clinic name banner (if set) |
| Patient information | Name, sex, age, age group, main complaints |
| Eye images | OD and OS photos side-by-side (compressed to ≤ 2000 px wide at 85% JPEG quality) |
| Pupil size comparison | Bilateral anisocoria table: OD%, OS%, difference%, severity label |
| Capture distance metrics | OD/OS iris diameter in pixels, size match %, distance match status |
| Right eye analysis | Grade, PI ratio + label, ellipseness, circularity, decentration; zone findings (FLAT/PROT/ANW) with severity; pupil form; ANW parameters |
| Left eye analysis | Same structure as right eye |
| Research observations | Cross-eye pattern notes (bilateral ANW, decentration patterns, etc.) |
| Observer notes | Free-text notes entered in the zone overlay dialog (if any) |
| Herbal recommendations | *(If herbal mode enabled and findings exist)* Green-header section: per-finding cards with OD/OS badge, organ, conditions, herb names and evidence reference count, disclaimer |
| Nutrition recommendations | *(If nutrition mode enabled and findings exist)* Orange-header section: key nutrients, color-coded food groups, first organ support note |
| Chiropractic correlations | *(If chiropractic mode enabled and findings exist)* Purple-header section: spinal segment, nerve roots, subluxation indicators, exercises, postural note |
| TCM correlations | *(If TCM mode enabled and findings exist)* Red-header section: organ, element, meridian clock, functions, first pattern with symptoms/formula, tonifying foods |
**Natural medicine sections are only included when:**
1. The corresponding therapy module is enabled in Settings.
2. The analysis found at least one applicable iris finding for that modality.
This keeps the PDF concise for practitioners who use only selected therapy systems.
**File name format**
PupilMetrics_<PatientName>_<YYYY-MM-DD_HH-mm>.pdf
Example: `PupilMetrics_John_Smith_2026-03-23_14-35.pdf`
