Default Parameters

PyEtSimul uses default anatomical and hardware parameters drawn from the literature. All spatial measurements use millimeters (mm) as the base unit.

The values below are auto-generated from the source code.

Eye Anatomy

class pyetsimul.core.default_configs.EyeAnatomyDefaults(AXIAL_LENGTH=24.75, PUPIL_RADIUS=3.0, N_AQUEOUS_HUMOR=1.336, FOVEA_ALPHA_DEG=6.0, FOVEA_BETA_DEG=2.0, EYELID_OPENNESS=1.0)[source]

Bases: object

Anatomical parameters based on Böhme et al. 2008, Boff & Lincoln 1988.

Parameters:
AXIAL_LENGTH: float = 24.75
PUPIL_RADIUS: float = 3.0
N_AQUEOUS_HUMOR: float = 1.336
FOVEA_ALPHA_DEG: float = 6.0
FOVEA_BETA_DEG: float = 2.0
EYELID_OPENNESS: float = 1.0

Spherical Cornea

class pyetsimul.core.default_configs.CorneaDefaults(ANTERIOR_RADIUS=7.98, POSTERIOR_RADIUS=6.22, REFRACTIVE_INDEX=1.376, THICKNESS_OFFSET=1.15, CORNEA_DEPTH=3.54, CENTER_TO_ROTATION=10.2, CONIC_ANTERIOR_RADIUS=7.76, CONIC_ANTERIOR_K=-0.1, CONIC_POSTERIOR_RADIUS=6.52, CONIC_POSTERIOR_K=-0.3, CONIC_THICKNESS_OFFSET=0.55)[source]

Bases: object

Corneal parameters from Böhme et al. 2008, Goncharov & Dainty 2007.

Parameters:

  • ANTERIOR_RADIUS (float)

  • POSTERIOR_RADIUS (float)

  • REFRACTIVE_INDEX (float)

  • THICKNESS_OFFSET (float)

  • CORNEA_DEPTH (float)

  • CENTER_TO_ROTATION (float)

  • CONIC_ANTERIOR_RADIUS (float)

  • CONIC_ANTERIOR_K (float)

  • CONIC_POSTERIOR_RADIUS (float)

  • CONIC_POSTERIOR_K (float)

  • CONIC_THICKNESS_OFFSET (float)

ANTERIOR_RADIUS: float = 7.98
POSTERIOR_RADIUS: float = 6.22
REFRACTIVE_INDEX: float = 1.376
THICKNESS_OFFSET: float = 1.15
CORNEA_DEPTH: float = 3.54
CENTER_TO_ROTATION: float = 10.2
CONIC_ANTERIOR_RADIUS: float = 7.76
CONIC_ANTERIOR_K: float = -0.1
CONIC_POSTERIOR_RADIUS: float = 6.52
CONIC_POSTERIOR_K: float = -0.3
CONIC_THICKNESS_OFFSET: float = 0.55

Pupil

class pyetsimul.core.default_configs.PupilDefaults(BOUNDARY_POINTS_ELLIPTICAL=100, BOUNDARY_POINTS_FACTORY=20, BOUNDARY_POINTS_REALISTIC=360, BASE_RADIUS=2.5, NONCIRCULARITY=0.0166, ELLIPSE_CONTRIBUTION=0.5, MAJOR_AXIS_ANGLE=0.0, OFFSET_FROM_LIMBUS=(0.27, 0.2), N_HARMONICS=6, REFERENCE_AGE=35.8)[source]

Bases: object

Pupil parameters based on Wyatt 1995.

Parameters:

  • BOUNDARY_POINTS_ELLIPTICAL (int)

  • BOUNDARY_POINTS_FACTORY (int)

  • BOUNDARY_POINTS_REALISTIC (int)

  • BASE_RADIUS (float)

  • NONCIRCULARITY (float)

  • ELLIPSE_CONTRIBUTION (float)

  • MAJOR_AXIS_ANGLE (float)

  • OFFSET_FROM_LIMBUS (tuple[float, float])

  • N_HARMONICS (int)

  • REFERENCE_AGE (float)

BOUNDARY_POINTS_ELLIPTICAL: int = 100
BOUNDARY_POINTS_FACTORY: int = 20
BOUNDARY_POINTS_REALISTIC: int = 360
BASE_RADIUS: float = 2.5
NONCIRCULARITY: float = 0.0166
ELLIPSE_CONTRIBUTION: float = 0.5
MAJOR_AXIS_ANGLE: float = 0.0
OFFSET_FROM_LIMBUS: tuple[float, float] = (0.27, 0.2)
N_HARMONICS: int = 6
REFERENCE_AGE: float = 35.8

Pupil Decentration

class pyetsimul.core.default_configs.PupilDecentrationDefaults(RIGHT_EYE_X_COEFF=-0.03, RIGHT_EYE_X_STD=0.07, RIGHT_EYE_Y_COEFF=-0.04, RIGHT_EYE_Y_STD=0.06, LEFT_EYE_X_COEFF=0.03, LEFT_EYE_X_STD=0.04, LEFT_EYE_Y_COEFF=-0.05, LEFT_EYE_Y_STD=0.12, BASELINE_DIAMETER=4.75)[source]

Bases: object

Pupil decentration parameters from Wildenmann & Schaeffel (2013).

Reference: Wildenmann U & Schaeffel F. Variations of pupil centration and their effects on video eye tracking. Ophthalmic Physiol Opt 2013, 33, 634-641.

Parameters:
RIGHT_EYE_X_COEFF: float = -0.03
RIGHT_EYE_X_STD: float = 0.07
RIGHT_EYE_Y_COEFF: float = -0.04
RIGHT_EYE_Y_STD: float = 0.06
LEFT_EYE_X_COEFF: float = 0.03
LEFT_EYE_X_STD: float = 0.04
LEFT_EYE_Y_COEFF: float = -0.05
LEFT_EYE_Y_STD: float = 0.12
BASELINE_DIAMETER: float = 4.75

Eyelid

class pyetsimul.core.default_configs.EyelidDefaults(LOWER_CAP_FRACTION=0.5, ELLIPSE_WIDTH_TO_HEIGHT=1.5, ELLIPSE_WIDTH_MULTIPLIER=2.0, HEIGHT_MULTIPLIER=2.0, BISECTION_ITERATIONS_PHI1=80, BISECTION_ITERATIONS_PHI2=100, BISECTION_ITERATIONS_AREA=120)[source]

Bases: object

Eyelid shape and numerical parameters.

Parameters:

  • LOWER_CAP_FRACTION (float)

  • ELLIPSE_WIDTH_TO_HEIGHT (float)

  • ELLIPSE_WIDTH_MULTIPLIER (float)

  • HEIGHT_MULTIPLIER (float)

  • BISECTION_ITERATIONS_PHI1 (int)

  • BISECTION_ITERATIONS_PHI2 (int)

  • BISECTION_ITERATIONS_AREA (int)

LOWER_CAP_FRACTION: float = 0.5
ELLIPSE_WIDTH_TO_HEIGHT: float = 1.5
ELLIPSE_WIDTH_MULTIPLIER: float = 2.0
HEIGHT_MULTIPLIER: float = 2.0
BISECTION_ITERATIONS_PHI1: int = 80
BISECTION_ITERATIONS_PHI2: int = 100
BISECTION_ITERATIONS_AREA: int = 120

Camera

class pyetsimul.core.default_configs.CameraDefaults(FOCAL_LENGTH=2880.0, PRINCIPAL_POINT_X=640.0, PRINCIPAL_POINT_Y=512.0, RESOLUTION_WIDTH=1280, RESOLUTION_HEIGHT=1024, MEASUREMENT_ERROR=0.0)[source]

Bases: object

Camera parameters for typical eye tracking configurations.

Parameters:

  • FOCAL_LENGTH (float)

  • PRINCIPAL_POINT_X (float)

  • PRINCIPAL_POINT_Y (float)

  • RESOLUTION_WIDTH (int)

  • RESOLUTION_HEIGHT (int)

  • MEASUREMENT_ERROR (float)

FOCAL_LENGTH: float = 2880.0
PRINCIPAL_POINT_X: float = 640.0
PRINCIPAL_POINT_Y: float = 512.0
RESOLUTION_WIDTH: int = 1280
RESOLUTION_HEIGHT: int = 1024
MEASUREMENT_ERROR: float = 0.0