artist.util.constants
=====================

.. py:module:: artist.util.constants


Attributes
----------

.. autoapisummary::

   artist.util.constants.power_plant_position
   artist.util.constants.target_area_position_center
   artist.util.constants.target_area_normal_vector
   artist.util.constants.target_area_plane_e
   artist.util.constants.target_area_plane_u
   artist.util.constants.target_area_receiver
   artist.util.constants.target_area_cylinder_radius
   artist.util.constants.target_area_cylinder_center
   artist.util.constants.target_area_cylinder_height
   artist.util.constants.target_area_cylinder_axis
   artist.util.constants.target_area_cylinder_normal
   artist.util.constants.target_area_cylinder_opening_angle
   artist.util.constants.light_source_type
   artist.util.constants.sun_key
   artist.util.constants.light_source_number_of_rays
   artist.util.constants.light_source_distribution_parameters
   artist.util.constants.light_source_distribution_type
   artist.util.constants.light_source_distribution_is_normal
   artist.util.constants.light_source_mean
   artist.util.constants.light_source_covariance
   artist.util.constants.facets_key
   artist.util.constants.facet_control_points
   artist.util.constants.facet_degrees
   artist.util.constants.facets_translation_vector
   artist.util.constants.facets_canting
   artist.util.constants.facet_translations
   artist.util.constants.first_joint_translation_e
   artist.util.constants.first_joint_translation_n
   artist.util.constants.first_joint_translation_u
   artist.util.constants.first_joint_tilt_n
   artist.util.constants.first_joint_tilt_u
   artist.util.constants.second_joint_translation_e
   artist.util.constants.second_joint_translation_n
   artist.util.constants.second_joint_translation_u
   artist.util.constants.second_joint_tilt_e
   artist.util.constants.second_joint_tilt_n
   artist.util.constants.concentrator_translation_e
   artist.util.constants.concentrator_translation_n
   artist.util.constants.concentrator_translation_u
   artist.util.constants.kinematics_type
   artist.util.constants.rigid_body_key
   artist.util.constants.rigid_body_number_of_translation_deviation_parameters
   artist.util.constants.rigid_body_number_of_rotation_deviation_parameters
   artist.util.constants.rigid_body_number_of_actuators
   artist.util.constants.kinematics_initial_orientation
   artist.util.constants.kinematics_deviations
   artist.util.constants.translation_deviations
   artist.util.constants.rotation_deviations
   artist.util.constants.actuator_clockwise_axis_movement
   artist.util.constants.actuator_increment
   artist.util.constants.actuator_min_max_motor_positions
   artist.util.constants.actuator_initial_stroke_length
   artist.util.constants.actuator_offset
   artist.util.constants.actuator_pivot_radius
   artist.util.constants.actuator_initial_angle
   artist.util.constants.actuator_type_key
   artist.util.constants.actuator_parameters_key
   artist.util.constants.ideal_actuator_key
   artist.util.constants.ideal_actuator_int
   artist.util.constants.linear_actuator_key
   artist.util.constants.linear_actuator_int
   artist.util.constants.surface_prototype_key
   artist.util.constants.kinematics_prototype_key
   artist.util.constants.actuators_prototype_key
   artist.util.constants.heliostat_id
   artist.util.constants.heliostat_position
   artist.util.constants.heliostat_surface_key
   artist.util.constants.heliostat_kinematics_key
   artist.util.constants.heliostat_actuator_key
   artist.util.constants.prototype_key
   artist.util.constants.power_plant_key
   artist.util.constants.target_area_planar_key
   artist.util.constants.target_area_cylindrical_key
   artist.util.constants.light_source_key
   artist.util.constants.heliostat_key
   artist.util.constants.fit_nurbs_from_points
   artist.util.constants.fit_nurbs_from_normals
   artist.util.constants.kinematics_reconstruction_raytracing
   artist.util.constants.names
   artist.util.constants.positions
   artist.util.constants.surface_points
   artist.util.constants.surface_normals
   artist.util.constants.initial_orientations
   artist.util.constants.actuator_parameters_non_optimizable
   artist.util.constants.actuator_parameters_optimizable
   artist.util.constants.heliostat_group_type
   artist.util.constants.paint_increment
   artist.util.constants.paint_initial_stroke_length
   artist.util.constants.paint_offset
   artist.util.constants.paint_pivot_radius
   artist.util.constants.paint_initial_angle
   artist.util.constants.paint_actuator_type
   artist.util.constants.paint_clockwise_axis_movement
   artist.util.constants.paint_min_increment
   artist.util.constants.paint_max_increment
   artist.util.constants.linux
   artist.util.constants.windows
   artist.util.constants.mac
   artist.util.constants.number_of_heliostat_groups
   artist.util.constants.utis_crop_width
   artist.util.constants.utis_crop_height
   artist.util.constants.data_parser
   artist.util.constants.heliostat_data_mapping
   artist.util.constants.optimization
   artist.util.constants.initial_learning_rate
   artist.util.constants.initial_learning_rate_rotation_deviation
   artist.util.constants.initial_learning_rate_initial_angles
   artist.util.constants.initial_learning_rate_initial_stroke_length
   artist.util.constants.tolerance
   artist.util.constants.max_epoch
   artist.util.constants.batch_size
   artist.util.constants.log_step
   artist.util.constants.early_stopping_delta
   artist.util.constants.early_stopping_patience
   artist.util.constants.early_stopping_window
   artist.util.constants.scheduler
   artist.util.constants.scheduler_type
   artist.util.constants.exponential
   artist.util.constants.cyclic
   artist.util.constants.reduce_on_plateau
   artist.util.constants.gamma
   artist.util.constants.lr_min
   artist.util.constants.lr_max
   artist.util.constants.step_size_up
   artist.util.constants.reduce_factor
   artist.util.constants.patience
   artist.util.constants.threshold
   artist.util.constants.cooldown
   artist.util.constants.constraints
   artist.util.constants.weight_smoothness
   artist.util.constants.weight_ideal_surface
   artist.util.constants.rho_flux_integral
   artist.util.constants.rho_intercept
   artist.util.constants.rho_local_flux
   artist.util.constants.energy_tolerance
   artist.util.constants.max_flux_density
   artist.util.constants.device
   artist.util.constants.is_distributed
   artist.util.constants.is_nested
   artist.util.constants.rank
   artist.util.constants.world_size
   artist.util.constants.process_subgroup
   artist.util.constants.groups_to_ranks_mapping
   artist.util.constants.heliostat_group_rank
   artist.util.constants.heliostat_group_world_size
   artist.util.constants.ranks_to_groups_mapping
   artist.util.constants.left_node
   artist.util.constants.right_node
   artist.util.constants.aabb_min
   artist.util.constants.aabb_max
   artist.util.constants.is_leaf
   artist.util.constants.primitive_index


Module Contents
---------------

.. py:data:: power_plant_position
   :value: 'position'


   Key to access the power plant position.


.. py:data:: target_area_position_center
   :value: 'position_center'


   Key to access the target area center position.


.. py:data:: target_area_normal_vector
   :value: 'normal_vector'


   Key to access the target area normal vector.


.. py:data:: target_area_plane_e
   :value: 'plane_e'


   Key to access the target area plane in the east direction.


.. py:data:: target_area_plane_u
   :value: 'plane_u'


   Key to access the target area plane in the up direction.


.. py:data:: target_area_receiver
   :value: 'receiver'


   Key used to define that the target area is a receiver.


.. py:data:: target_area_cylinder_radius
   :value: 'cylinder_radius'


   Key to access the radius of a cylindrical target area.


.. py:data:: target_area_cylinder_center
   :value: 'cylinder_center'


   Key to access the center of a cylindrical target area.


.. py:data:: target_area_cylinder_height
   :value: 'cylinder_height'


   Key to access the height of a cylindrical target area.


.. py:data:: target_area_cylinder_axis
   :value: 'cylinder_axis'


   Key to access the cylinder axis of a cylindrical target area.


.. py:data:: target_area_cylinder_normal
   :value: 'cylinder_normal'


   Key to access the cylinder normal of a cylindrical target area.


.. py:data:: target_area_cylinder_opening_angle
   :value: 'cylinder_opening_angle'


   Key to access the opening angle of a cylindrical target area.


.. py:data:: light_source_type
   :value: 'type'


   Key to access the light source type.


.. py:data:: sun_key
   :value: 'sun'


   Key to define that the light source type is a sun.


.. py:data:: light_source_number_of_rays
   :value: 'number_of_rays'


   Key to access the number of rays for the light source.


.. py:data:: light_source_distribution_parameters
   :value: 'distribution_parameters'


   Key to access the light source distribution parameters.


.. py:data:: light_source_distribution_type
   :value: 'distribution_type'


   Key to access the light source distribution type.


.. py:data:: light_source_distribution_is_normal
   :value: 'normal'


   Key to define that the light source distribution is modelled by a multivariate normal distribution.


.. py:data:: light_source_mean
   :value: 'mean'


   Key to access the mean for the light source distribution.


.. py:data:: light_source_covariance
   :value: 'covariance'


   Key to access the covariance for the light source distribution.


.. py:data:: facets_key
   :value: 'facets'


   Key to access the facets.


.. py:data:: facet_control_points
   :value: 'control_points'


   Key to access the facet control points.


.. py:data:: facet_degrees
   :value: 'degrees'


   Key to access the facet degrees in the east and north direction.


.. py:data:: facets_translation_vector
   :value: 'position'


   Key to access the translation vector indicating the position of the facet relative to the center of the heliostat.


.. py:data:: facets_canting
   :value: 'canting'


   Key to access the facet canting in the east and north direction.


.. py:data:: facet_translations
   :value: 'facet_translations'


   Key to access the facet translation vectors.


.. py:data:: first_joint_translation_e
   :value: 'first_joint_translation_e'


   Key to access the kinematics first joint translation in the east direction.


.. py:data:: first_joint_translation_n
   :value: 'first_joint_translation_n'


   Key to access the kinematics first joint translation in the north direction.


.. py:data:: first_joint_translation_u
   :value: 'first_joint_translation_u'


   Key to access the kinematics first joint translation in the up direction.


.. py:data:: first_joint_tilt_n
   :value: 'first_joint_tilt_n'


   Key to access the kinematics first joint tilt in the north direction.


.. py:data:: first_joint_tilt_u
   :value: 'first_joint_tilt_u'


   Key to access the kinematics first joint tilt in the up direction.


.. py:data:: second_joint_translation_e
   :value: 'second_joint_translation_e'


   Key to access the kinematics second joint translation in the east direction.


.. py:data:: second_joint_translation_n
   :value: 'second_joint_translation_n'


   Key to access the kinematics second joint translation in the north direction.


.. py:data:: second_joint_translation_u
   :value: 'second_joint_translation_u'


   Key to access the kinematics second joint translation in the up direction.


.. py:data:: second_joint_tilt_e
   :value: 'second_joint_tilt_e'


   Key to access the kinematics second joint tilt in the east direction.


.. py:data:: second_joint_tilt_n
   :value: 'second_joint_tilt_n'


   Key to access the kinematics second joint tilt in the north direction.


.. py:data:: concentrator_translation_e
   :value: 'concentrator_translation_e'


   Key to access the kinematics concentrator translation in the east direction.


.. py:data:: concentrator_translation_n
   :value: 'concentrator_translation_n'


   Key to access the kinematics concentrator translation in the north direction.


.. py:data:: concentrator_translation_u
   :value: 'concentrator_translation_u'


   Key to access the kinematics concentrator translation in the up direction.


.. py:data:: kinematics_type
   :value: 'type'


   Key to access the kinematics type.


.. py:data:: rigid_body_key
   :value: 'rigid_body'


   Key to define that the rigid body kinematics is used as a kinematics type.


.. py:data:: rigid_body_number_of_translation_deviation_parameters
   :value: 9


   Number of translation deviation parameters used in the rigid body kinematics.


.. py:data:: rigid_body_number_of_rotation_deviation_parameters
   :value: 4


   Number of rotation deviation parameters used in the rigid body kinematics.


.. py:data:: rigid_body_number_of_actuators
   :value: 2


   Number of actuators used in the rigid body kinematics.


.. py:data:: kinematics_initial_orientation
   :value: 'initial_orientation'


   Key to access the initial orientation.


.. py:data:: kinematics_deviations
   :value: 'deviations'


   Key to access the kinematics deviations.


.. py:data:: translation_deviations
   :value: 'translation_deviations'


   Key to access the kinematics translation deviations.


.. py:data:: rotation_deviations
   :value: 'rotation_deviations'


   Key to access the kinematics rotation deviations.


.. py:data:: actuator_clockwise_axis_movement
   :value: 'clockwise_axis_movement'


   Key to access the actuator clockwise parameter.


.. py:data:: actuator_increment
   :value: 'increment'


   Key to access the actuator increment parameter.


.. py:data:: actuator_min_max_motor_positions
   :value: 'min_max_motor_positions'


   Key to access the minimum and maximum motor positions of an actuator.


.. py:data:: actuator_initial_stroke_length
   :value: 'initial_stroke_length'


   Key to access the actuator initial stroke length parameter.


.. py:data:: actuator_offset
   :value: 'offset'


   Key to access the actuator offset parameter.


.. py:data:: actuator_pivot_radius
   :value: 'pivot_radius'


   Key to access the actuator pivot radius parameter.


.. py:data:: actuator_initial_angle
   :value: 'initial_angle'


   Key to access the actuator initial angle parameter.


.. py:data:: actuator_type_key
   :value: 'type'


   Key to access the actuator type.


.. py:data:: actuator_parameters_key
   :value: 'parameters'


   Key to access the actuator parameters.


.. py:data:: ideal_actuator_key
   :value: 'ideal'


   Key defining that the actuator used is an ideal actuator.


.. py:data:: ideal_actuator_int
   :value: 1


   Int defining that the actuator used is an ideal actuator.


.. py:data:: linear_actuator_key
   :value: 'linear'


   Int defining that the actuator used is a linear actuator.


.. py:data:: linear_actuator_int
   :value: 0


.. py:data:: surface_prototype_key
   :value: 'surface'


   Key to access the surface prototype.


.. py:data:: kinematics_prototype_key
   :value: 'kinematics'


   Key to access the kinematics prototype.


.. py:data:: actuators_prototype_key
   :value: 'actuator'


   Key to access the actuators prototype.


.. py:data:: heliostat_id
   :value: 'id'


   Key to access the heliostat ID.


.. py:data:: heliostat_position
   :value: 'position'


   Key to access the heliostat position.


.. py:data:: heliostat_surface_key
   :value: 'surface'


   Key to access the heliostat surface.


.. py:data:: heliostat_kinematics_key
   :value: 'kinematics'


   Key to access the heliostat kinematics.


.. py:data:: heliostat_actuator_key
   :value: 'actuator'


   Key to access the heliostat actuator.


.. py:data:: prototype_key
   :value: 'prototypes'


   Key to access the prototypes.


.. py:data:: power_plant_key
   :value: 'power_plant'


   Key to access the power plant.


.. py:data:: target_area_planar_key
   :value: 'target_areas_planar'


   Key to access the target areas.


.. py:data:: target_area_cylindrical_key
   :value: 'target_areas_cylindrical'


   Key to access the target areas.


.. py:data:: light_source_key
   :value: 'lightsources'


   Key to access the light sources.


.. py:data:: heliostat_key
   :value: 'heliostats'


   Key to access the heliostats.


.. py:data:: fit_nurbs_from_points
   :value: 'point_cloud'


   Defines that the NURBS should be learnt using a point cloud.


.. py:data:: fit_nurbs_from_normals
   :value: 'deflectometry'


   Defines that the NURBS should be learnt using deflectometry data.


.. py:data:: kinematics_reconstruction_raytracing
   :value: 'raytracing'


   Defines that the kinematics reconstructor uses ray tracing.


.. py:data:: names
   :value: 'names'


   Key to access heliostat names.


.. py:data:: positions
   :value: 'positions'


   Key to access heliostat positions.


.. py:data:: surface_points
   :value: 'surface_points'


   Key to access surface points.


.. py:data:: surface_normals
   :value: 'surface_normals'


   Key to access surface normals.


.. py:data:: initial_orientations
   :value: 'initial_orientations'


   Key to access initial orientations of heliostats.


.. py:data:: actuator_parameters_non_optimizable
   :value: 'actuator_parameters_non_optimizable'


   Key to access non-optimizable actuator parameters of heliostats.


.. py:data:: actuator_parameters_optimizable
   :value: 'actuator_parameters_optimizable'


   Key to access optimizable actuator parameters of heliostats.


.. py:data:: heliostat_group_type
   :value: 'type'


   Key to access the heliostat group type.


.. py:data:: paint_increment
   :value: 'increment'


   Key to access the actuators increment in a ``PAINT`` heliostat_properties.json file.


.. py:data:: paint_initial_stroke_length
   :value: 'initial_stroke_length'


   Key to access the actuators initial stroke length in a ``PAINT`` heliostat_properties.json file.


.. py:data:: paint_offset
   :value: 'offset'


   Key to access the actuators offset in a ``PAINT`` heliostat_properties.json file.


.. py:data:: paint_pivot_radius
   :value: 'pivot_radius'


   Key to access the actuators pivot radius in a ``PAINT`` heliostat_properties.json file.


.. py:data:: paint_initial_angle
   :value: 'initial_angle'


   Key to access the actuators initial angle in a ``PAINT`` heliostat_properties.json file.


.. py:data:: paint_actuator_type
   :value: 'type_axis'


   Key to access the actuator type in a ``PAINT`` heliostat_properties.json file.


.. py:data:: paint_clockwise_axis_movement
   :value: 'clockwise_axis_movement'


   Key to access the actuators axis movement direction in a ``PAINT`` heliostat_properties.json file.


.. py:data:: paint_min_increment
   :value: 'min_increment'


   Key to access the actuators minimum increment in a ``PAINT`` heliostat_properties.json file.


.. py:data:: paint_max_increment
   :value: 'max_increment'


   Key to access the actuators maximum increment in a ``PAINT`` heliostat_properties.json file.


.. py:data:: linux
   :value: 'Linux'


   Key to access the Linux OS name.


.. py:data:: windows
   :value: 'Windows'


   Key to access the Windows OS name.


.. py:data:: mac
   :value: 'Darwin'


   Key to access the Mac OS name.


.. py:data:: number_of_heliostat_groups
   :value: 'number_of_heliostat_groups'


   Key to access the number of heliostat groups for distributed setup.


.. py:data:: utis_crop_width
   :value: 6


   Key to access the crop width used in utis.


.. py:data:: utis_crop_height
   :value: 6


   Key to access the crop height used in utis.


.. py:data:: data_parser
   :value: 'data_parser'


   Key to access a data parser.


.. py:data:: heliostat_data_mapping
   :value: 'heliostat_data_mapping'


   Key to access a heliostat data mapping.


.. py:data:: optimization
   :value: 'optimization'


   Key to access the dict for the optimization.


.. py:data:: initial_learning_rate
   :value: 'initial_learning_rate'


   Key to access the initial learning rate of an optimizer.


.. py:data:: initial_learning_rate_rotation_deviation
   :value: 'initial_learning_rate_rotation_deviation'


   Key to access the initial learning rate for the rotation deviations.


.. py:data:: initial_learning_rate_initial_angles
   :value: 'initial_learning_rate_initial_angles'


   Key to access the initial learning rate for the initial angles.


.. py:data:: initial_learning_rate_initial_stroke_length
   :value: 'initial_learning_rate_initial_stroke_length'


   Key to access the initial learning rate for the initial stroke lengths.


.. py:data:: tolerance
   :value: 'tolerance'


   Key to access the tolerance of an optimization.


.. py:data:: max_epoch
   :value: 'max_epoch'


   Key to access the maximum epoch number of an optimization.


.. py:data:: batch_size
   :value: 'batch_size'


   Key to access the batch size for a ray tracer.


.. py:data:: log_step
   :value: 'log_step'


   Key to access the step for log statements of an optimization.


.. py:data:: early_stopping_delta
   :value: 'early_stopping_delta'


   Key to access the early stopping delta of an optimization.


.. py:data:: early_stopping_patience
   :value: 'early_stopping_patience'


   Key to access the early stopping patience of an optimization.


.. py:data:: early_stopping_window
   :value: 'early_stopping_window'


   Key to access the early stopping window.


.. py:data:: scheduler
   :value: 'scheduler'


   Key to access the learning rate scheduler.


.. py:data:: scheduler_type
   :value: 'scheduler_type'


   Key to access the scheduler type.


.. py:data:: exponential
   :value: 'exponential'


   Key to access an exponential learning rate scheduler.


.. py:data:: cyclic
   :value: 'cyclic'


   Key to access a cyclic learning rate scheduler.


.. py:data:: reduce_on_plateau
   :value: 'reduce_on_plateau'


   Key to access a reduce on plateau learning rate scheduler.


.. py:data:: gamma
   :value: 'gamma'


   Key to access gamma of an exponential learning rate scheduler.


.. py:data:: lr_min
   :value: 'min'


   Key to access the minimum learning rate of a learning rate scheduler.


.. py:data:: lr_max
   :value: 'max'


   Key to access the maximum learning rate of a learning rate scheduler.


.. py:data:: step_size_up
   :value: 'step_size_up'


   Key to access the step size up parameter of a cyclic learning rate scheduler.


.. py:data:: reduce_factor
   :value: 'reduce_factor'


   Key to access the reduce factor of a reduce on plateau learning rate scheduler.


.. py:data:: patience
   :value: 'patience'


   Key to access the patience of a reduce on plateau learning rate scheduler.


.. py:data:: threshold
   :value: 'threshold'


   Key to access the threshold of a reduce on plateau learning rate scheduler.


.. py:data:: cooldown
   :value: 'cooldown'


   Key to access the cooldown parameter of a reduce on plateau learning rate scheduler.


.. py:data:: constraints
   :value: 'constraints'


   Key to access the constraints dict.


.. py:data:: weight_smoothness
   :value: 'weight_smoothness'


   Key to access the weight for the smoothness regularizer.


.. py:data:: weight_ideal_surface
   :value: 'weight_ideal_surface'


   Key to access the weight for the ideal surface regularizer.


.. py:data:: rho_flux_integral
   :value: 'rho_flux_integral'


   Key to access rho for the flux integral constraint.


.. py:data:: rho_intercept
   :value: 'rho_intercept'


   Key to access rho for the spillage constraint.


.. py:data:: rho_local_flux
   :value: 'rho_local_flux'


   Key to access rho for the local flux constraint.


.. py:data:: energy_tolerance
   :value: 'energy_tolerance'


   Key to access the tolerance for the energy constraint.


.. py:data:: max_flux_density
   :value: 'max_flux_density'


   Key to access the maximum allowed flux density.


.. py:data:: device
   :value: 'device'


   Key to access the device.


.. py:data:: is_distributed
   :value: 'is_distributed'


   Flag for the distributed setup.


.. py:data:: is_nested
   :value: 'is_nested'


   Flag for the nested distributed setup.


.. py:data:: rank
   :value: 'rank'


   Key to access the rank in a ddp setup.


.. py:data:: world_size
   :value: 'world_size'


   Key to access the world size in a ddp setup.


.. py:data:: process_subgroup
   :value: 'process_subgroup'


   Key to access the process subgroup in a ddp setup.


.. py:data:: groups_to_ranks_mapping
   :value: 'groups_to_ranks_mapping'


   Key to access the mapping from heliostat groups to ranks.


.. py:data:: heliostat_group_rank
   :value: 'heliostat_group_rank'


   Key to access the rank within a process subgroups.


.. py:data:: heliostat_group_world_size
   :value: 'heliostat_group_world_size'


   Key to access the world size within a process subgroups.


.. py:data:: ranks_to_groups_mapping
   :value: 'ranks_to_groups_mapping'


   Key to access the mapping from ranks to heliostat groups.


.. py:data:: left_node
   :value: 'left'


   Key to access the left nodes in a binary radix tree used for blocking.


.. py:data:: right_node
   :value: 'right'


   Key to access the right nodes in a binary radix tree used for blocking.


.. py:data:: aabb_min
   :value: 'aabb_min'


   Key to access the minimum of the axis aligned bounding boxes.


.. py:data:: aabb_max
   :value: 'aabb_max'


   Key to access the maximum of the axis aligned bounding boxes.


.. py:data:: is_leaf
   :value: 'is_leaf'


   Key to access the leaf property of the binary radix trees used in blocking.


.. py:data:: primitive_index
   :value: 'primitive_index'


   Key to access the blocking primitives indices.