eradiate.scenes.measure.PerspectiveCameraMeasure#

class eradiate.scenes.measure.PerspectiveCameraMeasure(id='measure', spectral_cfg=_Nothing.NOTHING, sampler='independent', spp=32, film_resolution=(32, 32), origin=_Nothing.NOTHING, target=_Nothing.NOTHING, up=_Nothing.NOTHING, far_clip=<Quantity(10000.0, 'kilometer')>, fov=<Quantity(50.0, 'degree')>)[source]#

Bases: Measure

Perspective camera scene element [perspective].

This scene element is a thin wrapper around the perspective sensor kernel plugin. It positions a perspective camera based on a set of vectors, specifying the origin, viewing direction and ‘up’ direction of the camera.

Parameters:

id (str, optional, default: "measure") – Identifier of the current scene element.
spectral_cfg (MeasureSpectralConfig or dict, default: MeasureSpectralConfig.new()) – Spectral configuration of the measure. Must match the current operational mode. Can be passed as a dictionary, which will be interpreted by MeasureSpectralConfig.from_dict().
sampler ({"independent", "stratified", "multijitter", "orthogonal", "ldsampler"}, default: "independent") – Mitsuba sampler used to generate pseudo-random number sequences.
spp (int, default: 32) – Number of samples per pixel.
film_resolution (array-like, default: (32, 32)) – Film resolution as a (width, height) 2-tuple.
origin (array-like, default: [1, 1, 1] m) – A 3-vector specifying the position of the camera.

Unit-enabled field (default: ucc[‘length’]).
target (array-like, default: [0, 0, 0] m) – Point location targeted by the camera.

Unit-enabled field (default: ucc[‘length’]).
up (array, default: [0, 0, 1]) – A 3-vector specifying the up direction of the camera. This vector must be different from the camera’s viewing direction, which is given by target - origin.
far_clip (quantity of float, default: 10 000 km) – Distance to the far clip plane.

Unit-enabled field (default: ucc[length]).
fov (quantity or float, default: 50°) – Camera field of view.

Unit-enabled field (default: degree).

Fields:

id (str or None) – Identifier of the current scene element.
spectral_cfg (MeasureSpectralConfig) – Spectral configuration of the measure.
sampler (str) – Mitsuba sampler used to generate pseudo-random number sequences.
spp (int) – Number of samples per pixel.
origin (quantity) – A 3-vector specifying the position of the camera.
target (quantity) – Point location targeted by the camera.
up (array) – A 3-vector specifying the up direction of the camera.
far_clip (quantity) – Distance to the far clip plane.
fov (quantity) – Camera field of view.

is_distant()#: Return True iff measure records radiometric quantities at infinite distance.

traverse(callback)#

Traverse this scene element and collect kernel dictionary template and parameter update map contributions.

Parameters:: callback (SceneTraversal) – Callback data structure storing the collected data.

update()#: Enforce internal state consistency. This method should be called when fields are modified. It is automatically called as a post-init step.

property film_resolution#

Getter for film resolution as a (int, int) pair.

Type:: tuple

property objects#

Map of child objects associated with this scene element.

Returns:: dict – A dictionary mapping object names to a corresponding object to be inserted in the Eradiate scene graph.

property params#

Returns:: dict[str, UpdateParameter] or None – A dictionary mapping parameter paths, consisting of dot-separated strings, to a corresponding update protocol.