eradiate.scenes.biosphere.Canopy#

class eradiate.scenes.biosphere.Canopy(id='canopy', size=None)[source]#

Bases: CompositeSceneElement, ABC

Abstract base class for all canopies.

Parameters:
  • id (str, optional, default: "canopy") – Identifier of the current scene element.

  • size (array-like) – Canopy extent as a 3-vector.

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

Fields:
  • id (str or None) – Identifier of the current scene element.

  • size (quantity) – Canopy extent as a 3-vector.

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 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.

property template#

Kernel dictionary template contents associated with this scene element.

Returns:

dict – A flat dictionary mapping dot-separated strings describing the path of an item in the nested scene dictionary to values. Values may be objects which can be directly used by the mitsuba.load_dict() function, or InitParameter instances which must be rendered.