Skip to main content

PARaxial Optical fundus Scaling (PAROS)

Project description

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

Try PAROS online

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:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

paros-2.0.0.tar.gz (211.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

paros-2.0.0-py3-none-any.whl (16.0 kB view details)

Uploaded Python 3

File details

Details for the file paros-2.0.0.tar.gz.

File metadata

  • Download URL: paros-2.0.0.tar.gz
  • Upload date:
  • Size: 211.3 kB
  • Tags: Source
  • Uploaded using 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}

File hashes

Hashes for paros-2.0.0.tar.gz
Algorithm Hash digest
SHA256 91a494f0b2f5df8556793e73b5ba2b7788230b01a6633ef64c994334e667b5db
MD5 7d1c19ce5ac6b4cb9055c3243a25af42
BLAKE2b-256 d344dee577a8a06e1d82accf049a211493b40e727295eee149928fdd3bd5a86f

See more details on using hashes here.

File details

Details for the file paros-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: paros-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 16.0 kB
  • Tags: Python 3
  • Uploaded using 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}

File hashes

Hashes for paros-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7a46c1cc509274a54bf7e8e542331bf2e8a2cef80651c235fbab1b57a53ef207
MD5 ec6eeeb719ff641c5374fcd852d46609
BLAKE2b-256 8b3b09064f7d83fe2ed1f06a2b0d9236d8b98b2413cde7dd0df0925231fcd02f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page