Patient Information Form
Before each scan, PupilMetrics collects the following information:
| Field | Required | Notes |
|——-|———-|——-|
| **Name** | Yes | Free-text; stored verbatim in the scan record |
| **Age** | Yes | Integer years; used to select the age-normalisation group (Section 3.2) |
| **Sex** | Yes | Male / Female toggle |
| **Main complaints** | No | Free-text field for the practitioner’s clinical notes; appears in all exported reports |
| **Practice / Clinic name** | No | Pre-filled from the last saved value; persists across sessions via SharedPreferences |
**Clinic name persistence**
The clinic name is automatically saved each time you tap **Continue** on the patient information screen. The next time you open the form, the field is pre-populated with the stored value, so you only need to enter it once per installation. To clear it, delete the text and tap Continue.
**Data scope**
Patient records live entirely on the local device — no data is transmitted to external servers. On Windows the database is stored in the app’s Application Support directory (typically `%APPDATA%\cnri\pupilmetrics\bexel_scans.db`). On Android and iOS it uses the platform’s sandboxed storage location.
### 4.1 Scan History
Every completed analysis is automatically saved to a local SQLite database the moment the results screen finishes loading. No manual save action is needed.
**Opening Scan History**
| Platform | How to open |
|———-|————-|
| **Windows** | `Ctrl + H` keyboard shortcut, or the Scan History button on the results screen |
| **Android / iOS** | Scan History button on the results screen |
**What is stored per scan**
| Field | Description |
|——-|————-|
| Patient name, sex, age | From the patient information form |
| Main complaints | Practitioner notes at time of capture |
| Scan date/time | UTC timestamp recorded at analysis completion |
| OD / OS image paths | File paths to the captured eye images (not the images themselves) |
| OD / OS result JSON | Full analysis result: PI ratio, ellipseness, decentration, ANW assessment, zone findings, confidence |
| Anisocoria JSON | Bilateral pupil size comparison result |
| Age-norm JSON | Age group, expected range, measured diameter, status |
**Searching records**
The search bar in Scan History matches against both patient name and main complaints text. The search is live — results update as you type. All results are sorted most-recent first.
**Tabs**
– **Iris Scans** — all standard analysis records (both platforms)
– **PLR Tests-Android** — pupillary light reflex video recordings (mobile only; this tab is hidden on Windows desktop because the PLR video mode requires a phone’s flash)
**Deleting a record**
Swipe a record left (mobile) or use the delete button (desktop) to remove it from the database. The associated image files are not automatically deleted from disk.
