---
title: "4. Patient Management & Exports"
description: "**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…"
url: "https://cnri.edu/docs/4-patient-management-exports/"
updated: "2026-03-24"
category: Patient Management
---

# 4. Patient Management & Exports

**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.