en license:mit region:us
---
license: mit
language:
- en
---

## Model Description
Please email the author on songyang.an@auckland.ac.nz describing the reason for access before sending an access request.

## Pre-requisites
1. The models and results require images from the UK Biobank dataset. 
2. The input files provided in this repository only contain the image names and simple accompanying metadata.
3. To gain access to the UK Biobank dataset, please apply for access using this link.
4. After access permission has been granted, follow the instructions from UK Biobank, https://biobank.ctsu.ox.ac.uk/crystal/ukb/docs/ukbfetch_instruct.html, in fetching the left (field ID 21015) and right (field ID 21016) fundus photographs.

## Getting started
1. Install anaconda package manager from https://www.anaconda.com/
2. Setup environment using environment.yml file. Key dependencies are pandas==1.5.1, pytorch=2.1.1, xgboost=2.0.2, and shap=0.4.3
3. Configure execute.bat CONDAPATH, ENVNAME and IMAGE_PATH variables with installation path for anaconda, name of environment, and path where UK Biobank images are stored.
4. Run execute.bat to generate results.

## Citation
