resolve

resolve#

stimupy.utils.resolution.resolve(shape=None, visual_size=None, ppd=None)#

Resolves the full resolution, for 2 givens and 1 unknown

A resolution consists of a visual size in degrees, a shape in pixels, and specification of the number of pixels per degree. Since there is a strict geometric relation between these, shape = visual_size * ppd, if two are given, the third can be calculated using this function.

This function resolves the resolution in both dimensions.

Parameters:

  • shape (Sequence[Number, Number], Number, or None (default)) – shape [height, width] in pixels

  • visual_size (Sequence[Number, Number], Number, or None (default)) – visual size [height, width] in degrees

  • ppd (Sequence[Number, Number], Number, or None (default)) – pixels per degree [vertical, horizontal]

Returns:

  • Shape NamedTuple, with two attributes – .height: int, height in pixels .width: int, width in pixels See validate_shape

  • Visual_size NamedTuple, with two attributes – .height: float, height in degrees visual angle .width: float, width in degrees visual angle See validate_visual_size

  • ppd NamedTuple, with two attributes – .vertical: int, vertical pixels per degree (ppd) .horizontal: int, horizontal pixels per degree (ppd) see validate_ppd

Contents