PARaxial Optical fundus Scaling (PAROS)
Paros is a method to calculate the magnification of fundus images based on the optical characteristics of the patient's eye. The full method and validation are described in Pors LJ, Haasjes C, van Vught L, et al. Correction Method for Optical Scaling of Fundoscopy Images: Development, Validation, and First Implementation. Invest Ophthalmol Vis Sci. 2024;65(1):43. doi:10.1167/iovs.65.1.43
License
The code is provided as is, without any warranty, under the MIT license. This license requires that reusers give credit to the creator. It allows reusers to distribute, remix, adapt, and build upon the material in any medium or format.
Basic usage
Try it online
A basic version of PAROS can most easily be run online here: basic version
Install the library
The full package is also available on PyPI:
pip install PAROS
PAROS consists of two main functions:
fundus_camera_calibration.ipynb: a method to calibrate camera using eye phantom measurements.calculate_ocular_magnification.ipynb: a method to calculate magnification fundus images of a subject.
Implementation
The implementation of PAROS in this repository is functional for the camera in our center, and with the specific software used at our center. Both have impact on the calculated magnification. We therefore recommend calibration of the camera and software using the method described in the article mentioned below before implementation for quantitative purposes.
Camera constants
Please find here a table of known camera calibration constants; this can be added upon by other contributors.
| Camera type | CCD type | Condenser lens power [D] | First order calibration term | Pixel density [px/mm] |
|---|---|---|---|---|
| Topcon TRC-50DX | 37.6 | 0.03481 | 100 | |
| Topcon TRC-50IX | 37.7 | 0.03226 | 100 |
[!NOTE] The pixel density for the Topcon system is estimated. Since this value is only used to fit the other parameters, it does not need to be exact, but the same value should be used for both calibration and magnification calculation.
Referencing
When publishing results obtained with this package, please cite the paper that describes the full method and validation: Pors LJ, Haasjes C, van Vught L, et al. Correction Method for Optical Scaling of Fundoscopy Images: Development, Validation, and First Implementation. Invest Ophthalmol Vis Sci. 2024;65(1):43. doi:10.1167/iovs.65.1.43
Contributing
Please read our contribution guidelines prior to opening a Pull Request.
Contact
Feel free to contact us for any inquiries:
3 maintainers
Release files for PAROS 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| paros-2.0.0.tar.gz | 211.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| paros-2.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 227.3 kB
Release files / paros-2.0.0.tar.gz
| Download URL | paros-2.0.0.tar.gz |
|---|---|
| Size | 211.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
91a494f0b2f5df8556793e73b5ba2b7788230b01a6633ef64c994334e667b5db
|
|
BLAKE2b-256 checksum How to use checksums |
d344dee577a8a06e1d82accf049a211493b40e727295eee149928fdd3bd5a86f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.11 {"installer":{"name":"uv","version":"0.11.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / paros-2.0.0-py3-none-any.whl
| Download URL | paros-2.0.0-py3-none-any.whl |
|---|---|
| Size | 16.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7a46c1cc509274a54bf7e8e542331bf2e8a2cef80651c235fbab1b57a53ef207
|
|
BLAKE2b-256 checksum How to use checksums |
8b3b09064f7d83fe2ed1f06a2b0d9236d8b98b2413cde7dd0df0925231fcd02f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.11 {"installer":{"name":"uv","version":"0.11.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
