eradiate.scenes.measure.HemispherePlaneLayout

class eradiate.scenes.measure.HemispherePlaneLayout(zeniths, azimuth, *, azimuth_convention=None)

Bases: Layout

A viewing direction layout defined by a single azimuth and a vector of zenith values. Negative zenith values are mapped to (azimuth + 180°).

Parameters:

• azimuth_convention (AzimuthConvention or str, optional, default: None) – Azimuth convention used by this layout. If None, the global default configuration is used (see Configuration).

• zeniths (array-like) – A vector of zenith values. Required, no default.

  Unit-enabled field (default: ucc[‘angle’]).

• azimuth (float or quantity) – A single zenith value. Required, no default.

Fields:

• azimuth_convention (AzimuthConvention) – Azimuth convention used by this layout.

• zeniths (quantity) – A vector of zenith values.

• azimuth (quantity) – A single zenith value.

static convert(value)

Attempt to instantiate a Layout concrete class from an object.

This conversion protocol accepts:

• a dictionary of the form {"type": type_name, **kwargs};

• a (N, 2)-array or a (2,)-array;

• a (N, 3)-array or a (3,)-array.

Other values pass through the converter.

Dictionaries have their parameters forwarded to the type selected by the type parameter. A (N, 2) or (2,)-array is passed to an AngleLayout. A (N, 3) or (3,)-array is passed to a DirectionLayout.

Type key	Class
angles	AngleLayout
aring	AzimuthRingLayout
directions	DirectionLayout
grid	GridLayout
hplane	HemispherePlaneLayout

property angles

A sequence of viewing angles, corresponding to the direction sequence produced by directions, as a (N, 2) array. The last dimension is ordered as (zenith, azimuth).

Type:

quantity

property directions

A sequence of viewing directions, pointing outwards the observed target, as a (N, 3) array.

Type:

ndarray

property n_directions

Number of viewing directions defined by this layout.

Type:

int